Prepara l'input della mutazione
Quando crei un carrierBillingInvoice, ci sono diversi campi richiesti affinché la fattura venga creata con successo. Questi sono elencati di seguito:
Campi richiesti
amount: L'importo totale dovuto per la fattura.currencyCode: La valuta in cui sono rappresentati gli importi per la fattura.lineItemsamount: L'importo dovuto per una riga della fattura. Gli importi per ciascuno deilineItemsdevono corrispondere all'amountper la fattura.chargeType: Questo è un valore che rappresenta il tipo di addebito per la riga della fattura. Questi saranno tipicamenteSHIPPING.trackingNumber: Il numero di tracciamento associato alla riga della fattura.
payorAccountNumber: Il numero di conto del cliente Zonos per cui stai creando la fattura.referenceNumber: Il numero di riferimento per la fattura.
Gestisci le fatture tramite l'API
Le seguenti mutazioni possono essere utilizzate per creare nuove fatture, annullare quelle in sospeso o interrogare un elenco di fatture.
Crea fattura
Annulla fattura
Interrogare fatture
Una volta che hai un elenco di tutte le spese che devono essere fatturate a un cliente, utilizza la seguente mutazione per creare quella fattura.
Mutazione
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
}
}
}
Risposta
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"
}
]
}
]
}
}
Spese di spedizione della fattura
Genera fatture di spedizione per i clienti di Zonos.GraphQL
IN ARRIVO
Se un cliente si è registrato per un account di spedizione offerto tramite Zonos, puoi creare fatture per le spese di spedizione tramite l'API. Puoi aggregare le spese e creare fatture con la cadenza che preferisci. Utilizzando queste informazioni, Zonos fatturerà quei clienti per tuo conto.