Bereid de invoer voor de mutatie voor
Bij het aanmaken van een carrierBillingInvoice zijn er verschillende velden die vereist zijn voor het succesvol aanmaken van de factuur. Deze zijn hieronder vermeld:
Vereiste velden
amount: Het totaalbedrag dat verschuldigd is voor de factuur.currencyCode: De valuta waarin de bedragen voor de factuur zijn weergegeven.lineItemsamount: Het bedrag dat verschuldigd is voor een factuurlijn. De bedragen voor elk van delineItemsmoeten overeenkomen met hetamountvoor de factuur.chargeType: Dit is een waarde die het type kosten voor de factuurlijn vertegenwoordigt. Dit zijn doorgaansSHIPPING.trackingNumber: Het trackingnummer dat aan de factuurlijn is gekoppeld.
payorAccountNumber: Het rekeningnummer van de Zonos klant waarvoor u de factuur aanmaakt.referenceNumber: Het referentienummer voor de factuur.
Beheer facturen via de API
De volgende mutaties kunnen worden gebruikt om nieuwe facturen aan te maken, lopende facturen te annuleren of een lijst van facturen op te vragen.
Factuur aanmaken
Annuleer factuur
Facturen opvragen
Zodra u een lijst heeft van alle kosten die aan een klant gefactureerd moeten worden, gebruikt u de volgende mutatie om die factuur aan te maken.
Mutatie
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
}
}
}
Antwoord
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"
}
]
}
]
}
}
Verzendkosten factureren
Genereer verzendfacturen voor Zonos klanten.GraphQL
BINNENKORT BESCHIKBAAR
Als een klant zich heeft aangemeld voor een verzendaccount dat wordt aangeboden via Zonos, kunt u facturen voor verzendkosten aanmaken via de API. U kunt kosten aggregeren en facturen aanmaken op elke frequentie die u kiest. Met die informatie zal Zonos vervolgens die klanten namens u factureren.