Mutasyon girişi hazırlama
carrierBillingInvoice oluştururken, faturanın başarılı bir şekilde oluşturulması için gereken birkaç alan vardır. Bunlar aşağıda listelenmiştir:
Gerekli alanlar
amount: Fatura için toplam tutar.currencyCode: Faturadaki tutarların temsil edildiği para birimi.lineItemsamount: Fatura kalemi için ödenecek tutar. Her birlineItemsiçin tutarlar, faturanınamountile eşleşmelidir.chargeType: Bu, fatura kalemi için ücret türünü temsil eden bir değerdir. GenellikleSHIPPINGolacaktır.trackingNumber: Fatura kalemi ile ilişkili takip numarası.
payorAccountNumber: Faturayı oluşturduğunuz Zonos müşterisinin hesap numarası.referenceNumber: Fatura için referans numarası.
API aracılığıyla faturaları yönetme
Yeni, iptal bekleyen veya bir fatura listesini sorgulamak için aşağıdaki mutasyonlar kullanılabilir.
Fatura oluştur
İptal faturası
Fatura sorgula
Müşteriye fatura edilmesi gereken tüm ücretlerin bir listesini aldıktan sonra, o faturayı oluşturmak için aşağıdaki mutasyonu kullanın.
Mutasyon
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
}
}
}
Yanıt
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"
}
]
}
]
}
}
Fatura nakliye ücretleri
Zonos müşterileri için nakliye faturaları oluşturun.GraphQL
YAKINDA
Eğer bir müşteri Zonos aracılığıyla sunulan bir nakliye hesabına kaydolmuşsa, API aracılığıyla nakliye ücretleri için faturalar oluşturabilirsiniz. Ücretleri bir araya getirebilir ve istediğiniz sıklıkta faturalar oluşturabilirsiniz. Bu bilgileri kullanarak, Zonos bu müşterilere sizin adınıza fatura kesecektir.