Aan de slag met Collect

Hoe het werkt 

Zonos Collect integreert in uw bestaande landed cost workflow. Wanneer u quoteType: COLLECT toevoegt aan uw landedCostCalculateWorkflow mutatie, functioneert de aanvraag identiek aan een standaard landed cost berekening; het retourneert alle dezelfde gegevens, maar activeert daarnaast de Collect workflow.

Het proces is eenvoudig: specificeer quoteType: COLLECT in uw aanvraag, en het systeem genereert automatisch een betalingswagentje, stuurt de link naar het wagentje naar het e-mailadres van de bestemmingspartij, en converteert de offerte naar een bestelling zodra de betaling is voltooid.

Maak een Collect offerte 

Gebruik dezelfde GraphQL workflow waarmee u al bekend bent, voeg gewoon één parameter toe. Door quoteType: COLLECT toe te voegen aan uw landedCostCalculateWorkflow invoer, activeert u het volledige Collect proces terwijl u alle bestaande functionaliteit behoudt. Het links veld in de respons retourneert de checkout sessie-URL, die u kunt opslaan en gebruiken voor follow-up met de betalende partij indien nodig.

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

Configure een ORDER_CREATED webhook om een melding te ontvangen zodra een offerte wordt omgezet in een bestelling:

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

De payload zal een type veld bevatten. Controleer payload.type === "COLLECT" om alleen orders van het type Collect te verwerken:

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

Dashboardbeheer 

Offertes en bestellingen: Collect offertes en bestellingen worden weergegeven met "COLLECT" badges in het Dashboard. U kunt filteren op het type offerte om collect-specifieke offertes te bekijken en te beheren en de betalingsstatus te volgen.

E-mail branding: Pas de e-mail branding aan voor Collect betalingswagentjes onder Dashboard → Instellingen → E-mail Sjablonen

Ontvanger ervaring 

Wanneer u een Collect offerte aanmaakt, ontvangt uw klant een geautomatiseerde e-mail met een veilige betalingslink. Het betalingswagentje toont rechten, belastingen en kosten met volledige transparantie, terwijl de prijsstelling van uw product privé blijft.

Voor volledige details over het betalingsproces, ondersteunde landen en talen, en aanpassingsopties, zie de Gids voor de ontvanger ervaring.