Bereiten Sie die Eingabe für die Mutation vor
Beim Erstellen einer carrierBillingInvoice
gibt es mehrere Felder, die erforderlich sind, damit die Rechnung erfolgreich erstellt werden kann. Diese sind unten aufgeführt:
Erforderliche Felder
amount
: Der Gesamtbetrag, der für die Rechnung fällig ist.currencyCode
: Die Währung, in der die Beträge für die Rechnung angegeben sind.lineItems
amount
: Der fällige Betrag für eine Rechnungszeile. Die Beträge für jede derlineItems
müssen mit demamount
für die Rechnung übereinstimmen.chargeType
: Dies ist ein Wert, der die Art der Gebühr für die Rechnungszeile darstellt. Diese sind typischerweiseSHIPPING
.trackingNumber
: Die Sendungsnummer, die mit der Rechnungszeile verbunden ist.
payorAccountNumber
: Die Kontonummer des Zonos-Kunden, für den Sie die Rechnung erstellen.referenceNumber
: Die Referenznummer für die Rechnung.
Verwalten Sie Rechnungen über die API
Die folgenden Mutationen können verwendet werden, um neue Rechnungen zu erstellen, ausstehende Rechnungen zu stornieren oder eine Liste von Rechnungen abzufragen.
Rechnung erstellen
Rechnung stornieren
Rechnungen abfragen
Sobald Sie eine Liste aller Gebühren haben, die einem Kunden in Rechnung gestellt werden müssen, verwenden Sie die folgende Mutation, um diese Rechnung zu erstellen.
Mutation
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
}
}
}
Antwort
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"
}
]
}
]
}
}
Versandkostenrechnung
Erstellen Sie Versandrechnungen für Zonos-Kunden.GraphQL
Bald verfügbar
Wenn ein Kunde ein Versandkonto, das über Zonos angeboten wird, angemeldet hat, können Sie Rechnungen für Versandkosten über die API erstellen. Sie können die Gebühren aggregieren und Rechnungen in einem beliebigen Rhythmus erstellen, den Sie wählen. Mit diesen Informationen wird Zonos dann diese Kunden in Ihrem Namen in Rechnung stellen.