Siapkan input mutasi
Saat membuat carrierBillingInvoice, ada beberapa bidang yang diperlukan agar faktur dapat dibuat dengan sukses. Ini tercantum di bawah ini:
Bidang yang diperlukan
amount: Jumlah total yang harus dibayar untuk faktur.currencyCode: Mata uang yang digunakan untuk jumlah dalam faktur.lineItemsamount: Jumlah yang harus dibayar untuk satu baris faktur. Jumlah untuk masing-masinglineItemsharus sesuai denganamountuntuk faktur.chargeType: Ini adalah nilai yang mewakili jenis biaya untuk baris faktur. Ini biasanya adalahSHIPPING.trackingNumber: Nomor pelacakan yang terkait dengan baris faktur.
payorAccountNumber: Nomor akun pelanggan Zonos yang Anda buatkan faktur.referenceNumber: Nomor referensi untuk faktur.
Kelola faktur melalui API
Mutasi berikut dapat digunakan untuk membuat faktur baru, membatalkan yang tertunda, atau menanyakan daftar faktur.
Buat faktur
Batal faktur
Kueri faktur
Setelah Anda memiliki daftar semua biaya yang perlu ditagihkan kepada pelanggan, gunakan mutasi berikut untuk membuat faktur tersebut.
Mutasi
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
}
}
}
Respon
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"
}
]
}
]
}
}
Biaya pengiriman faktur
Hasilkan faktur pengiriman untuk pelanggan Zonos.GraphQL
SEGERA HADIR
Jika seorang pelanggan telah mendaftar untuk akun pengiriman yang ditawarkan melalui Zonos, Anda dapat membuat faktur untuk biaya pengiriman melalui API. Anda dapat mengagregasi biaya dan membuat faktur dengan frekuensi yang Anda pilih. Menggunakan informasi tersebut, Zonos kemudian akan menagih pelanggan tersebut atas nama Anda.