Erste Schritte mit Collect

So funktioniert es 

Zonos Collect integriert sich in Ihren bestehenden landed cost Workflow. Wenn Sie quoteType: COLLECT zu Ihrer landedCostCalculateWorkflow Mutation hinzufügen, funktioniert die Anfrage identisch zu einer standardmäßigen landed cost Berechnung; sie gibt alle gleichen Daten zurück, löst jedoch zusätzlich den Collect Workflow aus.

Der Prozess ist einfach: Geben Sie quoteType: COLLECT in Ihrer Anfrage an, und das System generiert automatisch einen Zahlungswagen, sendet den Link zum Wagen an die E-Mail der Zielperson und wandelt das Angebot in eine Bestellung um, sobald die Zahlung abgeschlossen ist.

Erstellen Sie ein Collect Angebot 

Verwenden Sie denselben GraphQL-Workflow, den Sie bereits kennen, fügen Sie einfach einen Parameter hinzu. Das Hinzufügen von quoteType: COLLECT zu Ihrem landedCostCalculateWorkflow Eingabewert löst den gesamten Collect Prozess aus und behält dabei alle bestehenden Funktionen bei. Das Feld links in der Antwort gibt die checkout Sitzungs-URL zurück, die Sie speichern und bei Bedarf für die Nachverfolgung mit dem Zahlungsempfänger verwenden können.

mutation {
  partyCreateWorkflow(
    input: [
      {
        person: { companyName: "Acme Electronics" }
        location: {
          line1: "123 Commerce Blvd"
          locality: "San Francisco"
          administrativeAreaCode: "CA"
          postalCode: "94102"
          countryCode: US
        }
        type: ORIGIN
      }
      {
        person: {
          firstName: "Emma"
          lastName: "Thompson"
          email: "emma.thompson@example.co.uk"
        }
        location: {
          line1: "45 High Street"
          locality: "Manchester"
          administrativeAreaCode: "ENG"
          postalCode: "M1 1AA"
          countryCode: GB
        }
        type: DESTINATION
      }
    ]
  ) {
    type
    id
    organization
  }

  itemCreateWorkflow(
    input: [
      {
        amount: 149.99
        currencyCode: USD
        countryOfOrigin: CN
        quantity: 2
        productId: "WH-1000XM4"
        hsCode: "8518.30"
        description: "Wireless Noise Cancelling Headphones"
      }
    ]
  ) {
    id
    amount
    quantity
    description
  }

  cartonizeWorkflow {
    id
  }

  shipmentRatingCreateWorkflow(
    input: {
      serviceLevelCode: "fedex.international_priority"
      amount: 45.00
      currencyCode: USD
    }
  ) {
    id
    amount
  }

  landedCostCalculateWorkflow(
    input: {
      endUse: NOT_FOR_RESALE
      method: DDP
      tariffRate: ZONOS_PREFERRED
      quoteType: COLLECT
    }
  ) {
    id
    landedCostGuaranteeCode
    links {
      key
      url
    }
    amountSubtotals {
      duties
      fees
      taxes
      landedCostTotal
    }
    fees {
      amount
      currency
      type
      item {
        productId
      }
    }
  }
}

Webhooks

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

mutation {
  webhookCreate(
    input: {
      status: ENABLED
      type: ORDER_CREATED
      url: "https://your.endpoint.com/zonos-webhooks"
    }
  ) {
    id
    status
    url
  }
}

Das Nutzlast wird ein Typ-Feld enthalten. Überprüfen Sie payload.type === "COLLECT" um nur Collect Bestellungen zu verarbeiten:

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

Dashboard-Management 

Angebote und Bestellungen: Collect Angebote und Bestellungen werden mit "COLLECT" Abzeichen im Dashboard angezeigt. Sie können nach dem Angebotstyp filtern, um collect-spezifische Angebote anzuzeigen und zu verwalten sowie 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ängererfahrung 

Wenn Sie ein Collect Angebot erstellen, erhält Ihr Kunde eine automatisierte E-Mail mit einem sicheren Zahlungslink. Der Zahlungswagen zeigt Abgaben, Steuern und Gebühren mit voller Transparenz an, während die Preisgestaltung Ihrer Produkte privat bleibt.

Für vollständige Details zum Zahlungsprozess, unterstützten Ländern und Sprachen sowie Anpassungsoptionen siehe den Leitfaden zur Empfängererfahrung.