Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

1. Card (Mô tả tính năng)

Tôi muốn hệ thống BPM truyền được thông tin các hợp đồng ký sang hệ thống xContracttải lên file hợp đồng gốc hoặc file phụ lục đính kèm lên server của xContract để lấy mã file (UUID/URL) phục vụ cho việc tạo hợp đồng

2. Confirmation/ Acceptance Criteria (Tiêu chí nghiệm thu)

  1. Tôi muốn hệ thống BPM truyền thông tin file hợp đồng cần ký sang xContract bao gồm các trường:

Param

Type

Require

Description

title

String

Tên hợp đồng

contract_number

String

Số hợp đồng

file_sign

object

Thông tin file ký hợp đồng

File_sign.base64

Base64

Base64 file pdf ký

file_sign.name

String

Tên file

file_sign.url

String

link file

file_attach

object

Thông tin file đính kèm ( Các file bổ sung kèm theo như Phụ lục,...)

File attach.base64

Base64

Base64 file pdf đính kèm

file_ attach.name

String

Tên file đính kèm

type_valid

Loại thời hạn hợp đồng:

  • 1: Có thời hạn bắt đầu từ ngày ký trong N tháng
  • 2: Có thời hạn ký bắt đầu từ ngày A trong N tháng
  • 3: Có thời hạn từ ngày A đến ngày B

month_valid

Bắt buộc nếu type_valid khác 3

Số tháng hiệu lực

start_valid_time

Bắt buộc nếu type_valid khác 1

Thời hạn bắt đầu hợp đồng

expire_time

Bắt buộc nếu type_valid =3

Ngày kết thúc hiệu lực

type_send

Hình thức gửi hợp đồng:

  • 1: Gửi theo thứ tự
  • 2. Gửi đồng thời

is_send_copy_done

Gửi bản sao cho các bên tham gia khi hoàn thành

  • 1: Có gửi
  • 2: Không gửi

note

Nội dung ghi chú gửi kèm email

system

Hệ thống tích hợp

Mặc định đối trác truyền =1

create_source

Nguồn tạo

  • 1: C1-QLBH
  • 2: QLDV

3: Khác

Đối tác truyền mặc định là 3

is_not_send_mail

Không gửi mail luồng ký

  • 1: true
  • 2: false

Đối tác truyền mặc định là 2

details

object

Mảng thông tin bên tham gia

Có thể nhiều bên tham gia

details.step

string

Bước ký, tương ứng với từng bên ký ví dụ 1,2, 3..

details.page

string

Trang ký, ví dụ 1,2,3…

details.widthPdf

string

kích thước chiều rộng file

đơn vị px

details.heightPdf

string

kích thước chiều cao file

đơn vị px

details.x

string

khoảng cách từ cạnh trái pdf đến cạnh trái ô ký

details.y

string

khoảng cách từ cạnh trên pdf đến cạnh trên ô ký

details.px

string

khoảng cách từ cạnh phải pdf đến cạnh phải ô ký

details.py

string

khoảng cách từ cạnh trên pdf đến cạnh trên ô ký

details.height

string

chiều cao ô ký

details.width

string

chiều rộng ô ký

details.sign_type

string

loại hình ký:

  • 1: ký số
  • 2: Ký thường

details.time

string

Thời hạn ký (ngày)

details.type_join

string

Loại bên tham gia

  • 1: Tài khoản nội bộ
  • 2: Đối tác ngoài

details.value_internal_uuid

Bắt buộc nếu type_join =1

ID user ký nội bộ

details.type

Bắt buộc nếu type_join =2

Loại bên tham gia chi tiết:

  • 1: Đối tác tổ chức
  • 2: Đối tác cá nhân
  • 3: Đối tác khác

details.value_partner_uuid

Bắt buộc nếu details.type # 3

Id đối tác

details.value_partner_email

Bắt buộc nếu details.type = 3

Email đối tác

details.value_partner_name

Tên đối tác

value_present_fullname

Người đại diện đối tác

file

file

File tài liệu tải lên (Hỗ trợ định dạng: pdf, doc, docx, png, jpg...). Dung lượng tối đa 50MB

file_type

int

Loại file tải lên:

1: File ký gốc

2: File phụ lục đính kèm

file_name

string

Không

Tên file muốn lưu trên hệ thống (Nếu để trống sẽ lấy theo tên gốc của file upload)

Với trường hợp thành công trả về các thông tin:

Field

Type

Description

status

string

Trạng thái tải lên 1: Thành công

message

string

Thông báo trạng thái

data

object

Dữ liệu thông tin file đã tải lên

data.uuid_file

string

Mã định danh duy nhất của file trên hệ thống xContract

data.file_name

string

Tên file

data.file_url

string

Đường dẫn tĩnh (URL) để truy cập/tải file

timestamp

string

Thời gian hoàn tất

2. Thông tin tích hợp chi tiết tại mục 1.4 API tạo hợp đồng tài upload file  tài liệu : Tài liệu tích hợp hệ thống xContract_ROX_Ver2Ver3.docx

3. Conversation (Mô tả chi tiết)

...