Chuẩn bị đầu vào cho phép biến
Khi tạo một carrierBillingInvoice, có một số trường là bắt buộc để hóa đơn được tạo thành công. Các trường này được liệt kê dưới đây:
Các trường bắt buộc
amount: Tổng số tiền phải trả cho hóa đơn.currencyCode: Loại tiền tệ mà các khoản tiền cho hóa đơn được thể hiện.lineItemsamount: Số tiền phải trả cho một dòng hóa đơn. Các khoản tiền cho mỗilineItemsphải khớp vớiamountcủa hóa đơn.chargeType: Đây là giá trị đại diện cho loại phí cho dòng hóa đơn. Những giá trị này thường làSHIPPING.trackingNumber: Số theo dõi liên quan đến dòng hóa đơn.
payorAccountNumber: Số tài khoản của khách hàng Zonos mà bạn đang tạo hóa đơn.referenceNumber: Số tham chiếu cho hóa đơn.
Quản lý hóa đơn qua API
Các phép biến sau đây có thể được sử dụng để tạo hóa đơn mới, hủy hóa đơn đang chờ hoặc truy vấn danh sách hóa đơn.
Tạo hóa đơn
Hủy hóa đơn
Truy vấn hóa đơn
Khi bạn có danh sách tất cả các khoản phí cần lập hóa đơn cho một khách hàng, hãy sử dụng phép biến sau để tạo hóa đơn đó.
Phép biến
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
mutation {
carrierBillingInvoiceCreate(
input: [
{
amount: 60
currencyCode: USD
payorAccountNumber: "123456"
referenceNumber: "13"
status: PENDING
metadata: [{ key: "testkey", value: "testvalue" }]
lineItems: [
{
amount: 30
chargeType: SHIPPING
currencyCode: USD
trackingNumber: "12345"
}
{
amount: 30
chargeType: SHIPPING
currencyCode: USD
trackingNumber: "6789"
}
]
}
]
) {
id
organizationId
amount
status
metadata {
key
value
}
lineItems {
id
description
amount
currencyCode
trackingNumber
}
}
}
Phản hồi
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
{
"data": {
"carrierBillingInvoiceCreate": [
{
"id": "cbi_bc4c59c1-6fed-4408-8dad-5df2fd3ad813",
"organizationId": "organization_e54e9553-4e1f-4bad-ab55-6ab53b8ba2cc",
"amount": 60,
"status": "PENDING",
"metadata": [
{
"key": "testkey",
"value": "testvalue"
}
],
"lineItems": [
{
"id": "cbi_line_item_fd0abe87-28d5-4075-b7a8-68125141ade0",
"description": "SHIPPING Charge",
"amount": 30,
"currencyCode": "USD",
"trackingNumber": "12345"
},
{
"id": "cbi_line_item_156db74c-48c6-4251-beb9-6fe10a2bd6d0",
"description": "SHIPPING Charge",
"amount": 30,
"currencyCode": "USD",
"trackingNumber": "6789"
}
]
}
]
}
}
Các khoản phí vận chuyển hóa đơn
Tạo hóa đơn vận chuyển cho khách hàng của Zonos.GraphQL
SẮP CÓ
Nếu một khách hàng đã đăng ký tài khoản vận chuyển được cung cấp thông qua Zonos, bạn có thể tạo hóa đơn cho các khoản phí vận chuyển thông qua API. Bạn có thể tổng hợp các khoản phí và tạo hóa đơn theo bất kỳ chu kỳ nào bạn chọn. Sử dụng thông tin đó, Zonos sẽ lập hóa đơn cho những khách hàng đó thay mặt bạn.