Przygotuj dane wejściowe mutacji
Podczas tworzenia carrierBillingInvoice istnieje kilka pól, które są wymagane, aby faktura została pomyślnie utworzona. Poniżej przedstawiono te pola:
Wymagane pola
amount: Całkowita kwota do zapłaty za fakturę.currencyCode: Waluta, w której przedstawione są kwoty na fakturze.lineItemsamount: Kwota do zapłaty za pozycję faktury. Kwoty dla każdej zlineItemsmuszą odpowiadaćamountdla faktury.chargeType: Jest to wartość, która reprezentuje typ opłaty za pozycję faktury. Zazwyczaj będą toSHIPPING.trackingNumber: Numer śledzenia związany z pozycją faktury.
payorAccountNumber: Numer konta klienta Zonos, dla którego tworzysz fakturę.referenceNumber: Numer referencyjny dla faktury.
Zarządzaj fakturami za pośrednictwem API
Poniższe mutacje mogą być używane do tworzenia nowych, unieważniania oczekujących lub zapytania o listę faktur.
Utwórz fakturę
Anuluj fakturę
Zapytaj o faktury
Gdy masz listę wszystkich opłat, które należy wystawić klientowi, użyj poniższej mutacji, aby utworzyć tę fakturę.
Mutacja
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
}
}
}
Odpowiedź
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"
}
]
}
]
}
}
Opłaty za wysyłkę na fakturze
Generuj faktury za wysyłkę dla klientów Zonos.GraphQL
WKRÓTCE
Jeśli klient zarejestrował się na konto wysyłkowe oferowane przez Zonos, możesz tworzyć faktury za opłaty wysyłkowe za pośrednictwem API. Możesz agregować opłaty i tworzyć faktury w dowolnym wybranym przez siebie rytmie. Na podstawie tych informacji Zonos wystawi faktury tym klientom w Twoim imieniu.