DOCS

Auszahlungen anzeigen

Erfahren Sie, wie Sie Ihre Auszahlungsdetails für Checkout abrufen und verstehen.

Rufen Sie Ihre Auszahlungsberichte ganz einfach im Zonos Dashboard auf. Auszahlungen werden regelmäßig erstellt und bieten bei der Nutzung von Zonos Checkout eine detaillierte Aufschlüsselung von Transaktionen, Gebühren und Nettobeträgen. Auszahlungen erfolgen in der lokalen Währung, die Sie bei der Einrichtung Ihres Kontos ausgewählt haben. Diese Berichte helfen Ihnen, Ihre Finanzunterlagen abzustimmen und Ihre Einnahmen zu verfolgen.

Weitere Berichte, etwa zu Bestelldetails und einer Aufschlüsselung der Landed-Cost-Berechnungen, finden Sie unter Reports. Wie Sie diese nutzen, erfahren Sie unter Herunterladbare Berichte.

Auf Auszahlungsdaten zugreifen 

So finden Sie eine Auszahlung in Dashboard und zeigen sie an:

  1. Gehen Sie zu Dashboard -> Payouts.
  2. Wählen Sie die Auszahlung aus, die Sie anzeigen möchten. Wird sie nicht sofort angezeigt, filtern Sie nach Datum oder Betrag, um die Suche einzugrenzen. (Das Datum ist das Eingangsdatum der Auszahlung.)
  3. Sehen Sie sich in Dashboard die Auszahlungsübersicht und die Liste der Transaktionen an.
  4. Für weitere Details klicken Sie auf Export transactions, um eine CSV-Datei mit dem Payout summary oder den Payout details herunterzuladen.
    1. Legacy-Export: Das bisherige Berichtsformat ist auf der jeweiligen Auszahlungsseite noch bis zum 31. Juli 2025 verfügbar, um den Übergang zu unseren neuen Berichten zu erleichtern.

Mehrere Auszahlungen

So zeigen Sie Informationen über mehrere Auszahlungen hinweg an:

  1. Gehen Sie zu Dashboard -> Payouts.
  2. Klicken Sie oben rechts auf Export.
  3. Wählen Sie den gewünschten Berichtstyp aus: Payout summary oder Payout details.
  4. Passen Sie die Datumsbereiche an. Die Datumsbereiche basieren auf dem Transaktionsdatum der Bestellung (nicht auf dem Eingangsdatum der Auszahlung).
  5. Klicken Sie auf Generate report.

Auszahlungsübersicht 

Die Auszahlungsseite bietet einen kompakten Überblick über Ihre Auszahlung, sodass Sie die wichtigsten Details schnell erfassen können, ohne einen Bericht exportieren zu müssen.

Jede Auszahlung ist in fünf Komponenten aufgeteilt, die anschließend summiert werden:

  • Payments: Transaktionen, bei denen Gelder eingegangen sind.
  • Refunds: Transaktionen, bei denen Gelder zurückerstattet wurden.
  • Charges: Von der Auszahlung abgezogene Gebühren, etwa Transaktionsgebühren oder Anpassungen.
  • Credits: Auf Ihre Auszahlung angerechnete Erstattungen, etwa Rückerstattungen zu viel berechneter Gebühren oder andere Gutschriften auf Ihr Konto.
  • Failed previous payout: Wenn eine frühere Auszahlung fehlgeschlagen ist und später mit einer nachfolgenden Auszahlung gesendet wurde, enthält diese Zeile die entsprechenden Details.

Für jede Komponente werden folgende Details angezeigt:

  • Items: Der Gesamtbetrag, den Käufer im Auszahlungszeitraum für Produkte bezahlt haben.
  • Shipping: Der Gesamtbetrag, den Käufer im Auszahlungszeitraum für den Versand bezahlt haben.
  • Discount: Die Summe der Rabatte, die im Auszahlungszeitraum auf Bestellungen angewendet wurden.
  • Duty, taxes, fees: Der Gesamtbetrag, den Käufer im Auszahlungszeitraum für Zölle, Steuern und sonstige Gebühren bezahlt haben.
  • Guarantee: Der Gesamtbetrag, den Zonos zur Deckung garantierter Zölle, Steuern und Gebühren eingezogen hat, die Zonos in Ihrem Namen bezahlt hat. Diese Kosten werden von Zonos garantiert.
  • Transaction fee: Die Gesamtgebühren für die Nutzung der Checkout-Dienste, einschließlich Betrugsschutz (ohne Zahlungsabwicklungsgebühren).
  • Merchant fee: Die Summe der von der Auszahlung abgezogenen Zahlungsabwicklungsgebühren.
  • Other: Die Summe aller sonstigen Gebühren im Auszahlungszeitraum, mit Memos, die Details enthalten.
  • Total: Der Nettogesamtbetrag der Auszahlung.

Für weitere Details exportieren Sie den CSV-Bericht.

Auszahlungsbeispiel

Transaktionen innerhalb einer Auszahlung

Jede Transaktion der Auszahlung ist im Abschnitt Transactions aufgeführt. Auf einen Blick sind pro Transaktion folgende Details verfügbar:

  • Date: Das Datum der Transaktion.
  • Order number: Die Zonos-Bestellnummer, die der Transaktion zugeordnet ist.
  • Items: Der Betrag, den der Käufer für Produkte bezahlt hat.
  • Shipping: Der Betrag, den der Käufer für den Versand bezahlt hat.
  • Discount: Alle auf die Bestellung angewendeten Rabatte.
  • Duty, taxes, fees: Der Betrag, den der Käufer für Zölle, Steuern und sonstige Gebühren bezahlt hat.
  • Guarantee: Der Betrag, den Zonos zur Deckung garantierter Zölle, Steuern und Gebühren einzieht, die Zonos in Ihrem Namen bezahlt. Diese Kosten werden von Zonos garantiert.
  • Transaction fee: Die Gebühr für die Nutzung der Checkout-Dienste, einschließlich Betrugsschutz (ohne Zahlungsabwicklungsgebühren).
  • Merchant fee: Die Gebühr für die Zahlungsabwicklung.
  • Other: Sonstige Gebühren mit einem Memo, das den Grund erläutert.
  • Total: Der Nettogesamtbetrag der in der Auszahlung enthaltenen Transaktion.

Aufschlüsselung der Zonos-Gebühren pro Transaktion

Klicken Sie auf die Bestellnummer einer Transaktion, um eine detaillierte Aufschlüsselung anzuzeigen, einschließlich Produktbeträgen, Versandkosten, Zöllen, Steuern und einzeln aufgeführten Gebühren (durchlaufende Kosten werden nicht angezeigt). Werden keine Gebühren angezeigt, fallen für diese Transaktion möglicherweise keine an (z. B. bei Rückerstattungen oder DDU-Bestellungen).

CSV-Berichte exportieren 

Sie können zwei Arten von Berichten exportieren: Payout summary und Payout detail. Einen Vergleich finden Sie auf der Seite Herunterladbare Berichte.

Einzelne Auszahlung exportieren

So exportieren Sie eine CSV-Datei einer bestimmten Auszahlung:

  1. Gehen Sie zu Dashboard -> Payouts
  2. Öffnen Sie die gewünschte Auszahlung
  3. Klicken Sie auf einer beliebigen Auszahlungsseite auf Export transactions
  4. Wählen Sie zwischen Payout summary und Payout detail
  5. Dadurch werden nur die Daten dieser bestimmten Auszahlung exportiert

Mehrere Auszahlungszeiträume

So exportieren Sie eine CSV-Datei über mehrere Auszahlungszeiträume hinweg:

  1. Gehen Sie zu Dashboard -> Payouts
  2. Klicken Sie oben rechts auf Export
  3. Wählen Sie Payout summary oder Payout detail
  4. Wählen Sie Ihren Datumsbereich (basierend auf dem Transaktionsdatum der Bestellung)
  5. Klicken Sie auf Generate report

Hinweis: Das bisherige Berichtsformat ist auf den einzelnen Auszahlungsseiten noch bis zum 31. Juli 2025 verfügbar, um den Übergang zu unseren neuen Berichten zu erleichtern.

Berichtstypen

Bericht „Payout summary“

Der Bericht „Payout summary“ bietet eine umfassende Ansicht jeder Bestellung. Jede Bestellung wird in einer eigenen Zeile aufgeführt, sodass Sie die Summen und Gebühren einzelner Bestellungen leicht nachverfolgen können. Dieser Bericht eignet sich ideal für eine schnelle Abstimmung und zeigt Ihnen den Nettobetrag, den Sie für jede Bestellung erhalten. Nachfolgend finden Sie eine Liste der Spalten im Bericht:

Spalte↕Beschreibung↕
account_nameDer Name Ihres Zonos-Kontos
payout_dateDas Datum, an dem die Auszahlung verarbeitet wurde
arrival_dateDas Datum, an dem die Auszahlung auf Ihrem Konto eingegangen ist
payout_numberEindeutige Kennung der Auszahlung
payout_totalGesamtbetrag der Auszahlung
currencyWährungscode der Auszahlung (z. B. USD)
transaction_idEindeutige Kennung der Transaktion
transaction_dateDatum, an dem die Transaktion stattfand
order_numberZonos-Bestellkennung
order_referenceBestellreferenznummer Ihrer Plattform
order_dateDatum, an dem die Bestellung aufgegeben wurde
transaction_typeTransaktionstyp (ORDER, ORDER_REFUND, ORDER_CANCEL)
item_orderDer Gesamtbetrag, den Käufer für Produkte bezahlt haben
shipping_orderDer Gesamtbetrag, den Käufer für den Versand bezahlt haben
discount_orderAuf die Bestellung angewendete Rabatte
duty_tax_fee_orderDer Gesamtbetrag, den Käufer für Zölle, Steuern und sonstige Gebühren bezahlt haben
guaranteeDer Gesamtbetrag, den Zonos zur Deckung garantierter Zölle, Steuern und Gebühren eingezogen hat
transaction_feeDie Gesamtgebühren für die Nutzung der Checkout-Dienste
merchant_feeDie gesamten Zahlungsabwicklungsgebühren
otherSonstige Gebühren mit Memos, die Details enthalten
settledDer endgültig abgerechnete Betrag für die Bestellung
memoZusätzliche Informationen zur Transaktion

Bericht „Payout detail“

Zusätzlich zum Zusammenfassungsbericht können Sie für jede Auszahlung einen ausführlicheren Detailbericht herunterladen. Dieser Bericht bietet eine zeilenweise Aufschlüsselung der Transaktionen und Gebühren, die mit der Auszahlung verbunden sind. Kosten, die sich gegenseitig aufheben (etwa Steuern, die ein Käufer zahlt und die Zonos einbehält, um sie im Namen des Händlers abzuführen), sind in diesem Bericht nicht enthalten. Häufig gibt es mehrere Zeilen pro Bestellung, da jeder Gebührentyp in einer eigenen Zeile aufgeführt wird. Der Detailbericht ist hilfreich, um Ihre Finanzunterlagen abzustimmen und die mit jeder Transaktion verbundenen Gebühren nachzuvollziehen.

Gebührentypen im Bericht „Payout detail“

Nachfolgend finden Sie eine Liste der möglichen Positionen in einem Bericht „Payout detail“ und ihre Beschreibungen:

Gebührentyp↕Typ↕Beschreibung↕
ZONOS_MERCHANT_PROCESSINGZonos-AbrechnungsgebührHändlergebühren für die Zahlungsabwicklung.
ZONOS_TRANSACTIONZonos-AbrechnungsgebührTransaktionsgebühr für Zonos Checkout.
CURRENCY_CONVERSION_FEEZonos-AbrechnungsgebührFX-Terminprämie zur Absicherung des Wechselkursrisikos.
ZONOS_LANDED_COSTZonos-AbrechnungsgebührGebühr für die Zonos Landed Cost Guarantee.
ZONOS_LANDED_COST_GUARANTEEZonos-AbrechnungsgebührGarantiegebühr für Landed-Cost-Berechnungen.
ADVANCEMENTCarrier-GebührVom Versanddienstleister berechnet – weitere Details in der Spalte memo der Auszahlung.
BROKERAGE_FEECarrier-GebührVom Versanddienstleister berechnet – weitere Details in der Spalte memo der Auszahlung.
SHIPPING_AMOUNTZwischensummenpositionVersandsumme der Bestellung, damit die Gebührenzeilen in der Summe den Bestellbetrag ergeben.
PRODUCT_AMOUNTZwischensummenpositionWarenkorbsumme der Bestellung, damit die Gebührenzeilen in der Summe den Bestellbetrag ergeben.
DUTY_TAX_AMOUNTZwischensummenpositionZoll-/Steuersumme der Bestellung vor Einbehaltungen, damit die Gebührenzeilen in der Summe den Bestellbetrag ergeben.
TAXZwischensummenpositionSteuersumme der Bestellung, damit die Gebührenzeilen in der Summe den Bestellbetrag ergeben. Einbehalten zur Abführung.
DUTYZwischensummenpositionZollsumme der Bestellung, damit die Gebührenzeilen in der Summe den Bestellbetrag ergeben. Einbehalten zur Abführung.
GUARANTEE_PERCENTZonos-AbrechnungsgebührProzentuale Garantiegebühr für Zölle und Steuern.
GUARANTEE_ORDERZonos-AbrechnungsgebührPauschale Garantiegebühr pro Bestellung.
TRANSACTION_ORDERZonos-AbrechnungsgebührPauschale Transaktionsgebühr pro Bestellung.
TRANSACTION_PERCENTZonos-AbrechnungsgebührProzentuale Transaktionsgebühr.

Transaktionstypen

Die Auszahlungsberichte enthalten verschiedene Transaktionstypen:

Transaktionstyp↕Beschreibung↕
ORDERReguläre Bestelltransaktionen, bei denen Gelder eingegangen sind.
ORDER_REFUNDTransaktionen, bei denen Gelder an den Kunden zurückerstattet wurden.
ORDER_CANCELTransaktionen, bei denen Bestellungen vor der Verarbeitung storniert wurden.
ChargeTransaktionen, die keiner Bestellung zugeordnet sind und eine Belastung darstellen.
CreditTransaktionen, die keiner Bestellung zugeordnet sind und eine Gutschrift darstellen.

Auszahlungsdetails über die API abrufen 

Zusätzlich zum Export von CSV-Berichten aus Dashboard können Sie dieselbe Aufschlüsselung der Auszahlungsdetails programmatisch über die Zonos GraphQL API abrufen. Das ist nützlich, um Auszahlungsdaten automatisch mit Ihren eigenen Buchhaltungs- oder Abstimmungssystemen zu synchronisieren.

Benachrichtigung über den Webhook ORDER_PAYOUT_DETAILS_READY

Abonnieren Sie den Webhook ORDER_PAYOUT_DETAILS_READY, um benachrichtigt zu werden, sobald die Positionsdetails einer Auszahlung abgefragt werden können. Wenn Sie ihn erhalten, ist die Aufschlüsselung der Auszahlung endgültig und kann sicher abgerufen werden. Der Webhook liefert die payoutId, mit der Sie die Details abrufen – die Details selbst enthält er nicht. Im Webhooks-Leitfaden erfahren Sie, wie Sie Webhooks einrichten.

1{
2 "payoutId": "payout_xxxxxxxxxxxxx",
3 "eventType": "ORDER_PAYOUT_DETAILS_READY"
4}

Auszahlungsdetails abfragen

Übergeben Sie die payoutId an die Abfrage orderPayoutDetails. Sie gibt eine paginierte Verbindung von OrderPayoutDetailItem-Positionen zurück – eine Zeile pro Transaktion – und entspricht damit dem CSV-Bericht Payout detail, der oben unter CSV-Berichte exportieren beschrieben ist.

1query OrderPayoutDetails($payoutId: String!, $first: Int, $after: String) {
2 orderPayoutDetails(payoutId: $payoutId, first: $first, after: $after) {
3 totalAmount
4 edges {
5 cursor
6 node {
7 accountName
8 payoutDate
9 arrivalDate
10 payoutNumber
11 currency
12 transactionId
13 transactionDate
14 orderNumber
15 orderReference
16 orderDate
17 transactionType
18 detailType
19 payee
20 payor
21 amount
22 memo
23 }
24 }
25 pageInfo {
26 hasNextPage
27 endCursor
28 }
29 }
30}

Die Verbindung stellt außerdem das Feld totalAmount bereit – die Summe von amount über alle für Ihre Organisation sichtbaren Positionen –, sodass Sie den Auszahlungsgesamtbetrag erhalten, ohne jede Seite selbst summieren zu müssen.

Große Auszahlungen paginieren

Eine einzelne Auszahlung kann viele Transaktionen enthalten. Verwenden Sie die Argumente first und after, um die Ergebnisse seitenweise abzurufen, und folgen Sie pageInfo.endCursor, bis pageInfo.hasNextPage den Wert false hat.

War diese Seite hilfreich?