DOCS
Collect•
StartseiteFür Logistikdienstleister Zonos Collect Erste Schritte

Erste Schritte mit Collect

Zölle, Steuern und Gebühren von Empfängern vor der Zustellung einziehen.

Funktionsweise 

Zonos Collect integriert sich in Ihren bestehenden Landed-Cost-Workflow. Wenn Sie quoteType: COLLECT zu Ihrer landedCostCalculateWorkflow-Mutation hinzufügen, funktioniert die Anfrage identisch wie eine Standard-Landed-Cost-Berechnung; sie liefert dieselben Daten, löst aber zusätzlich den Collect-Workflow aus.

Der Prozess ist einfach: Geben Sie quoteType: COLLECT in Ihrer Anfrage an, und das System erstellt automatisch einen Zahlungswagen, sendet den Warenkorb-Link an die E-Mail-Adresse des Empfängers und wandelt das Angebot nach Zahlungsabschluss in eine Bestellung um.

Collect-Angebot erstellen 

Verwenden Sie denselben GraphQL-Workflow, den Sie bereits kennen – fügen Sie nur einen Parameter hinzu. Mit quoteType: COLLECT in Ihrem landedCostCalculateWorkflow-Input wird der gesamte Collect-Prozess ausgelöst, während alle bestehenden Funktionen erhalten bleiben. Das Feld links in der Antwort liefert die Checkout-Session-URL, die Sie speichern und bei Bedarf für die Nachverfolgung mit dem Zahler verwenden können.

1mutation CollectQuote(
2$parties: [PartyCreateWorkflowInput!]!
3$items: [ItemCreateWorkflowInput!]!
4$shipmentRating: ShipmentRatingCreateWorkflowInput!
5$landedCost: LandedCostCalculateWorkflowInput!
6) {
7 partyCreateWorkflow(input: $parties) {
8 type
9 id
10 organization
11 }
12 
13 itemCreateWorkflow(input: $items) {
14 id
15 amount
16 quantity
17 description
18 }
19 
20 cartonizeWorkflow {
21 id
22 }
23 
24 shipmentRatingCreateWorkflow(input: $shipmentRating) {
25 id
26 amount
27 }
28 
29 landedCostCalculateWorkflow(input: $landedCost) {
30 id
31 landedCostGuaranteeCode
32 links {
33 key
34 url
35 }
36 amountSubtotals {
37 duties
38 fees
39 taxes
40 landedCostTotal
41 }
42 fees {
43 amount
44 currency
45 type
46 item {
47 productId
48 }
49 }
50 }
51}

Webhooks

Konfigurieren Sie einen ORDER_CREATED-Webhook, um benachrichtigt zu werden, sobald ein Angebot in eine Bestellung umgewandelt wird:

1mutation CreateOrderWebhook($input: WebhookCreateInput!) {
2 webhookCreate(input: $input) {
3 id
4 status
5 url
6 }
7}

Die Nutzlast enthält ein Typ-Feld. Prüfen Sie payload.type === "COLLECT", um nur Collect-Bestellungen zu verarbeiten:

javascript

if (payload.type === 'COLLECT') {
}

Dashboard-Verwaltung 

Angebote und Bestellungen: Collect-Angebote und -Bestellungen werden im Dashboard mit „COLLECT“-Badges angezeigt. Sie können nach Angebotstyp filtern, um Collect-spezifische Angebote anzuzeigen und den Zahlungsstatus zu überwachen.

E-Mail-Branding: Passen Sie das E-Mail-Branding für Collect-Zahlungswagen unter Dashboard → Einstellungen → E-Mail-Vorlagen an

Empfängererlebnis 

Wenn Sie ein Collect-Angebot erstellen, erhält Ihr Kunde eine automatisierte E-Mail mit einem sicheren Zahlungslink. Der Zahlungswagen zeigt Zölle, Steuern und Gebühren vollständig transparent an, hält aber Ihre Produktpreise vertraulich.

Vollständige Details zum Zahlungsprozess, unterstützten Ländern und Sprachen sowie Anpassungsoptionen finden Sie im Leitfaden zum Empfängererlebnis.

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentRatingCreateWorkflowInput WebhookCreateInput

MUTATIONS

cartonizeWorkflow itemCreateWorkflow landedCostCalculateWorkflow partyCreateWorkflow shipmentRatingCreateWorkflow webhookCreate

War diese Seite hilfreich?

Holen Sie sich Unterstützung·Rechtsdokumente·© 2026 Zonos
Auf dieser Seite:
  • Erste Schritte mit Collect
  • Funktionsweise
  • Collect-Angebot erstellen
  • Dashboard-Verwaltung
  • Empfängererlebnis