准备变更输入
在创建 carrierBillingInvoice 时，有几个字段是创建发票所必需的。以下是所需字段：
所需字段
amount: 发票的总金额。currencyCode: 发票金额所用的货币。lineItemsamount: 发票行的应付金额。每个lineItems的金额必须与发票的amount匹配。chargeType: 代表发票行费用类型的值。通常为SHIPPING。trackingNumber: 与发票行相关的追踪号码。
payorAccountNumber: 您为其创建发票的 Zonos 客户的账户号码。referenceNumber: 发票的参考号码。
通过 API 管理发票
以下变更可用于创建新发票、作废待处理发票或查询发票列表。
创建发票
作废发票
查询发票
一旦您拥有所有需要开具给客户的费用列表，请使用以下变更创建该发票。
变更
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
}
}
}
响应
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"
}
]
}
]
}
}
发票运费
为 Zonos 客户生成运费发票。GraphQL
即将推出
如果客户已注册通过 Zonos 提供的运输账户，您可以通过 API 创建运费发票。您可以聚合费用并以您选择的任何频率创建发票。使用这些信息，Zonos 将代表您向这些客户开具发票。