변환 입력 준비
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는 귀하를 대신하여 해당 고객에게 송장을 발행합니다.