DOCS

Invoice shipping charges

/

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.

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 der lineItems müssen mit dem amount für die Rechnung übereinstimmen.
    • chargeType: Dies ist ein Wert, der die Art der Gebühr für die Rechnungszeile darstellt. Diese sind typischerweise SHIPPING.
    • 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"
          }
        ]
      }
    ]
  }
}

War diese Seite hilfreich?