Danh sách
Danh sách hợp đồng bán
HTTP Request
[GET] /api/v6/sale_contracts
Query Parameters
Fields
Fields | Type | Description |
---|---|---|
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 |
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 |
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 |
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 ($) |
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_date | string | Ngày tạo |
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 |
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 |
total_payment | float | Doanh thu |
total_sale_order_real_amount | float | Tổng doanh thu đơn hàng bán |
total_sale_order_remain_amount | float | Tổng tiền đơn hàng bán còn lại (chưa thanh toán) |
total_sale_order_f_amount | float | Tổng tiền đơn hàng bán đã thanh toán |
performed | string | Đã thực hiện |
number_performed | float | Số tiền đã thực hiện (dạng số) |
custom_fields | object | Định nghĩa dữ liệu |
Filtering
Fields | Support | Type | Description |
---|---|---|---|
id | eq,in | integer | Định danh |
valid | eq | integer | Hợp đồng hợp lệ |
expiration_year | eq | integer | Năm hợp đồng kết thúc |
expiration_month | eq | integer | Tháng hợp đồng kết thúc |
expiration_day | eq | integer | Ngày hợp đồng kết thúc |
Sort
Sort (field) | Direction |
---|---|
id | asc,desc |
Limit & Offset
Type | Description | |
---|---|---|
Limit | integer | Lấy bao nhiêu bản ghi |
Offset | integer | Bỏ qua bao nhiêu bản ghi |
Example
HTTP Request
GET api/v6/sale_contracts?fields=contract_code&limit=1&offset=1&filtering[id]=1 HTTP/1.1
Host: example.getflycrm.com
Authorization: Bearer token
Status
200 OK
Response
{
"data": [
{
"id": 1,
"contract_code": "CONTRACT CODE"
}
],
"has_more": false,
"offset": 1,
"limited": 1
}
Danh sách hợp đồng mua
HTTP Request
[GET] /api/v6/purchase_contracts
Query Parameters
Fields
Fields | Type | Description |
---|---|---|
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 |
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 |
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 |
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 ($) |
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_date | string | Ngày tạo |
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 |
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 |
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ố) |
custom_fields | object | Định nghĩa dữ liệu |
Filtering
Fields | Support | Type | Description |
---|---|---|---|
id | eq,in | integer | Định danh |
valid | eq | integer | Hợp đồng hợp lệ |
expiration_year | eq | integer | Năm hợp đồng kết thúc |
expiration_month | eq | integer | Tháng hợp đồng kết thúc |
expiration_day | eq | integer | Ngày hợp đồng kết thúc |
Sort
Sort (field) | Direction |
---|---|
id | asc,desc |
Limit & Offset
Type | Description | |
---|---|---|
Limit | integer | Lấy bao nhiêu bản ghi |
Offset | integer | Bỏ qua bao nhiêu bản ghi |
Example
HTTP Request
GET api/v6/purchase_contracts?fields=contract_code&limit=1&offset=1&filtering[id]=1 HTTP/1.1
Host: example.getflycrm.com
Authorization: Bearer token
Status
200 OK
Response
{
"data": [
{
"id": 1,
"contract_code": "CONTRACT CODE"
}
],
"has_more": false,
"offset": 1,
"limited": 1
}