Chi tiết hợp đồng mua

1. Thông Tin API

• Endpoint: /api/v6.1/purchase_contract
• Method: GET
• Authentication: Yêu cầu X-API-KEY
• Header:
  • X-API-KEY: <your_api_key>

---

2. Tham Số Request

Tham số	Loại	Mô tả
fields	string	Danh sách các trường dữ liệu cần lấy
contract_id	integer	Định danh hợp đồng cần truy vấn
contract_code	string	Mã hợp đồng cần truy vấn

Ví dụ request:

curl --location 'https://example.com/api/v6.1/purchase_contract?fields=id,contract_code,contract_name&contract_id=4' \
--header 'X-API-KEY: YOUR_API_KEY'

---

3. Response

{
    "id": 4,
    "contract_code": "HDM001",
    "contract_name": "Hợp đồng mua mẫu",
    "contract_status": 1,
    "contract_status_label": "Chờ duyệt",
    "effective_date": "2025-01-01",
    "expiration_date": "2025-12-31",
    "vendor_account_id": 532,
    "vendor_account_name": "Nhà cung cấp A",
    "vendor_account_address": "Địa chỉ",
    "vendor_account_phone": "09871717231",
    "buyers_account_id": 1,
    "buyers_account_name": "Getfly",
    "total_payment": 10000000,
    "payment_methods": 1,
    "payment_methods_name": "Chuyển khoản",
    "custom_fields": {}
}

---

4. Mô Tả Trường Dữ Liệu

4.1. Thông tin hợp đồng

Trường	Kiểu dữ liệu	Mô tả
id	integer	Định danh
contract_code	string	Mã hợp đồng
contract_name	string	Tên hợp đồng
expiration_day_remain	integer	Số ngày hợp đồng còn lại
number_of_contract	integer	Số hợp đồng
contract_status	integer	Trạng thái hợp đồng
contract_status_label	string	Nhãn trạng thái hợp đồng
new_contract_label	string	Nhãn loại hợp đồng
contract_type	integer	Loại hợp đồng
effective_date	string	Ngày có hiệu lực
expiration_date	string	Ngày hết hiệu lực
contract_date	string	Ngày tạo
contract_terms	array	Danh sách điều khoản
quote_id	integer	Định danh báo giá
quote_code	string	Mã báo giá
payment_methods	integer	Hình thức thanh toán hợp đồng
payment_methods_name	string	Tên hình thức thanh toán hợp đồng
start_actual_time	string	Ngày thực tế hợp đồng bắt đầu có hiệu lực
end_actual_time	string	Ngày thực tế hợp đồng hết hiệu lực
contract_used	integer	Mã loại sử dụng hợp đồng
contract_used_label	string	Loại sử dụng hợp đồng
actual_value	float	Giá trị thực hiện
project_name	string	Dự án
project_address	string	Địa điểm dự án
contract_origin_code	string	Mã hợp đồng gốc
payment_periods	array	Danh sách kỳ thanh toán
contract_parent_id	integer	Định danh hợp đồng liên quan
contract_parent	integer	Hợp đồng liên quan
contract_children	array	Danh sách hợp đồng con

4.2. Thông tin khách hàng (Bên A)

Trường	Kiểu dữ liệu	Mô tả
vendor_account_id	integer	Định danh khách hàng
vendor_account_name	string	Tên khách hàng
vendor_account_address	string	Địa chỉ khách hàng
vendor_account_phone	string	Số điện thoại khách hàng
vendor_account_fax	string	Số fax khách hàng
vendor_account_manager	integer	Người phụ trách khách hàng
vendor_account_manager_name	string	Tên người phụ trách khách hàng
vendor_contact_name	string	Tên người đại diện bên A
vendor_contact_title	string	Chức vụ liên hệ khách hàng
vendor_contact_id	integer	Định danh người đại diện bên A
vendor_positions	string	Chức vụ người đại diện bên A
vendor_bank_address	string	Địa chỉ ngân hàng bên A
vendor_bank_account_number	string	Số tài khoản ngân hàng bên A
vendor_sic_code	string	Mã số thuế khách hàng

4.3. Thông tin công ty (Bên B)

Trường	Kiểu dữ liệu	Mô tả
buyers_account_id	integer	Định danh công ty
buyers_account_name	string	Tên công ty
buyers_account_address	string	Địa chỉ công ty
buyers_account_phone	string	Số điện thoại công ty
buyers_account_fax	string	Số fax công ty
buyers_contact_name	string	Tên người đại diện bên B
buyers_contact_id	integer	Định danh người đại diện bên B
buyers_positions	string	Chức vụ người đại diện bên B
buyers_bank_address	string	Địa chỉ ngân hàng bên B
buyers_bank_account_number	string	Số tài khoản ngân hàng bên B
buyers_sic_code	string	Mã số thuế công ty

4.4. Thông tin tài chính

Trường	Kiểu dữ liệu	Mô tả
after_vat	integer	Áp dụng chiết khấu sau thuế?
discount	float	Chiết khấu (%)
discount_amount	float	Chiết khấu thành tiền ($)
vat	float	VAT (%)
vat_amount	float	VAT thành tiền ($)
total_payment	float	Doanh thu
total_purchase_order_real_amount	float	Tổng doanh thu đơn hàng mua
total_purchase_order_remain_amount	float	Tổng tiền đơn hàng mua còn lại (chưa thanh toán)
total_purchase_order_f_amount	float	Tổng tiền đơn hàng mua đã thanh toán
performed	string	Đã thực hiện
number_performed	float	Số tiền đã thực hiện (dạng số)

4.5. Thông tin người dùng

Trường	Kiểu dữ liệu	Mô tả
create_user	integer	Định danh người tạo hợp đồng
create_user_display_name	string	Tên người tạo hợp đồng
approved_by	integer	Định danh người duyệt hợp đồng
approved_at	string	Thời gian duyệt
approved_by_display_name	string	Tên người duyệt hợp đồng
custom_fields	object	Định nghĩa dữ liệu

---

5. Ghi Chú

• API trả về chi tiết một hợp đồng mua dựa trên một trong hai: contract_id hoặc contract_code (không gửi đồng thời).
• Trường custom_fields chứa các dữ liệu tùy chỉnh của hợp đồng.