Chuyển tới nội dung chính

Danh sách

Danh sách hợp đồng bán​

HTTP Request​

[GET] /api/v6/sale_contracts

Query Parameters​

Fields​

FieldsTypeDescription
idintegerĐịnh danh
contract_codestringMã hợp đồng
contract_namestringTên hợp đồng
expiration_day_remainintegerSố ngày hợp đồng còn lại
number_of_contractintegerSố hợp đồng
contract_statusintegerTrạng thái hợp đồng
contract_status_labelstringNhãn trạng thái hợp đồng
new_contract_labelstringNhãn loại hợp đồng
contract_typeintegerLoại hợp đồng
effective_datestringNgày có hiệu lực
expiration_datestringNgày hết hiệu lực
vendor_account_idintegerĐịnh danh khách hàng
vendor_account_namestringTên khách hàng
vendor_account_addressstringĐịa chỉ khách hàng
vendor_account_phonestringSố điện thoại khách hàng
vendor_account_faxstringSố fax khách hàng
vendor_account_managerintegerNgười phụ trách khách hàng
vendor_account_manager_namestringTên người phụ trách khách hàng
vendor_contact_namestringTên người đại diện bên A
vendor_contact_titlestringChức vụ liên hệ khách hàng
vendor_contact_idintegerĐịnh danh người đại diện bên A
vendor_positionsstringChức vụ người đại diện bên A
vendor_bank_addressstringĐịa chỉ ngân hàng bên A
vendor_bank_account_numberstringSố tài khoản ngân hàng bên A
vendor_sic_codestringMã số thuế khách hàng
buyers_account_idintegerĐịnh danh công ty
buyers_account_namestringTên công ty
buyers_account_addressstringĐịa chỉ công ty
buyers_account_phonestringSố điện thoại công ty
buyers_account_faxstringSố fax công ty
buyers_contact_namestringTên người đại diện bên B
buyers_contact_idintegerĐịnh danh người đại diện bên B
buyers_positionsstringChức vụ người đại diện bên B
buyers_bank_addressstringĐịa chỉ ngân hàng bên B
buyers_bank_account_numberstringSố tài khoản ngân hàng bên B
buyers_sic_codestringMã số thuế công ty
after_vatintegerÁp dụng chiết khấu sau thuế?
discountfloatChiết khấu (%)
discount_amountfloatChiết khấu thành tiền ($)
vatfloatVat (%)
vat_amountfloatVat thành tiền ($)
contract_termsarrayDanh sách điều khoản
quote_idintegerĐịnh danh báo giá
quote_codestringMã báo giá
payment_methodsintegerHình thức thanh toán hợp đồng
payment_methods_namestringTên hình thức thanh toán hợp đồng
start_actual_timestringNgày thực tế hợp đồng bắt đầu có hiệu lực
end_actual_timestringNgày thực tế hợp đồng hết hiệu lực
contract_usedintegerMã loại sử dụng hợp đồng
contract_used_labelstringLoại sử dụng hợp đồng
actual_valuefloatGiá trị thực hiện
project_namestringDự án
project_addressstringĐịa điểm dự án
contract_origin_codestringMã hợp đồng gốc
payment_periodsarrayDanh sách kỳ thanh toán
contract_datestringNgày tạo
create_userintegerĐịnh danh người tạo hợp đồng
create_user_display_namestringTên người tạo hợp đồng
approved_byintegerĐịnh danh người duyệt hợp đồng
approved_atstringThời gian duyệt
approved_by_display_namestringTên người duyệt hợp đồng
contract_parent_idintegerĐịnh danh hợp đồng liên quan
contract_parentintegerHợp đồng liên quan
contract_childrenarrayDanh sách Hợp đồng con
total_paymentfloatDoanh thu
total_sale_order_real_amountfloatTổng doanh thu đơn hàng bán
total_sale_order_remain_amountfloatTổng tiền đơn hàng bán còn lại (chưa thanh toán)
total_sale_order_f_amountfloatTổng tiền đơn hàng bán đã thanh toán
performedstringĐã thực hiện
number_performedfloatSố tiền đã thực hiện (dạng số)
custom_fieldsobjectĐịnh nghĩa dữ liệu

Filtering​

FieldsSupportTypeDescription
ideq,inintegerĐịnh danh
valideqintegerHợp đồng hợp lệ
expiration_yeareqintegerNăm hợp đồng kết thúc
expiration_montheqintegerTháng hợp đồng kết thúc
expiration_dayeqintegerNgày hợp đồng kết thúc

Sort​

Sort (field)Direction
idasc,desc

Limit & Offset​

TypeDescription
LimitintegerLấy bao nhiêu bản ghi
OffsetintegerBỏ 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​

FieldsTypeDescription
idintegerĐịnh danh
contract_codestringMã hợp đồng
contract_namestringTên hợp đồng
expiration_day_remainintegerSố ngày hợp đồng còn lại
number_of_contractintegerSố hợp đồng
contract_statusintegerTrạng thái hợp đồng
contract_status_labelstringNhãn trạng thái hợp đồng
new_contract_labelstringNhãn loại hợp đồng
contract_typeintegerLoại hợp đồng
effective_datestringNgày có hiệu lực
expiration_datestringNgày hết hiệu lực
vendor_account_idintegerĐịnh danh khách hàng
vendor_account_namestringTên khách hàng
vendor_account_addressstringĐịa chỉ khách hàng
vendor_account_phonestringSố điện thoại khách hàng
vendor_account_faxstringSố fax khách hàng
vendor_account_managerintegerNgười phụ trách khách hàng
vendor_account_manager_namestringTên người phụ trách khách hàng
vendor_contact_namestringTên người đại diện bên A
vendor_contact_titlestringChức vụ liên hệ khách hàng
vendor_contact_idintegerĐịnh danh người đại diện bên A
vendor_positionsstringChức vụ người đại diện bên A
vendor_bank_addressstringĐịa chỉ ngân hàng bên A
vendor_bank_account_numberstringSố tài khoản ngân hàng bên A
vendor_sic_codestringMã số thuế khách hàng
buyers_account_idintegerĐịnh danh công ty
buyers_account_namestringTên công ty
buyers_account_addressstringĐịa chỉ công ty
buyers_account_phonestringSố điện thoại công ty
buyers_account_faxstringSố fax công ty
buyers_contact_namestringTên người đại diện bên B
buyers_contact_idintegerĐịnh danh người đại diện bên B
buyers_positionsstringChức vụ người đại diện bên B
buyers_bank_addressstringĐịa chỉ ngân hàng bên B
buyers_bank_account_numberstringSố tài khoản ngân hàng bên B
buyers_sic_codestringMã số thuế công ty
after_vatintegerÁp dụng chiết khấu sau thuế?
discountfloatChiết khấu (%)
discount_amountfloatChiết khấu thành tiền ($)
vatfloatVat (%)
vat_amountfloatVat thành tiền ($)
contract_termsarrayDanh sách điều khoản
quote_idintegerĐịnh danh báo giá
quote_codestringMã báo giá
payment_methodsintegerHình thức thanh toán hợp đồng
payment_methods_namestringTên hình thức thanh toán hợp đồng
start_actual_timestringNgày thực tế hợp đồng bắt đầu có hiệu lực
end_actual_timestringNgày thực tế hợp đồng hết hiệu lực
contract_usedintegerMã loại sử dụng hợp đồng
contract_used_labelstringLoại sử dụng hợp đồng
actual_valuefloatGiá trị thực hiện
project_namestringDự án
project_addressstringĐịa điểm dự án
contract_origin_codestringMã hợp đồng gốc
payment_periodsarrayDanh sách kỳ thanh toán
contract_datestringNgày tạo
create_userintegerĐịnh danh người tạo hợp đồng
create_user_display_namestringTên người tạo hợp đồng
approved_byintegerĐịnh danh người duyệt hợp đồng
approved_atstringThời gian duyệt
approved_by_display_namestringTên người duyệt hợp đồng
contract_parent_idintegerĐịnh danh hợp đồng liên quan
contract_parentintegerHợp đồng liên quan
contract_childrenarrayDanh sách Hợp đồng con
total_paymentfloatDoanh thu
total_purchase_order_real_amountfloatTổng doanh thu đơn hàng mua
total_purchase_order_remain_amountfloatTổng tiền đơn hàng mua còn lại (chưa thanh toán)
total_purchase_order_f_amountfloatTổng tiền đơn hàng mua đã thanh toán
performedstringĐã thực hiện
number_performedfloatSố tiền đã thực hiện (dạng số)
custom_fieldsobjectĐịnh nghĩa dữ liệu

Filtering​

FieldsSupportTypeDescription
ideq,inintegerĐịnh danh
valideqintegerHợp đồng hợp lệ
expiration_yeareqintegerNăm hợp đồng kết thúc
expiration_montheqintegerTháng hợp đồng kết thúc
expiration_dayeqintegerNgày hợp đồng kết thúc

Sort​

Sort (field)Direction
idasc,desc

Limit & Offset​

TypeDescription
LimitintegerLấy bao nhiêu bản ghi
OffsetintegerBỏ 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
}