Inizia con Collect

Come funziona 

Zonos Collect si integra nel tuo flusso di lavoro esistente per il landed cost. Quando aggiungi quoteType: COLLECT alla tua mutazione landedCostCalculateWorkflow, la richiesta funziona in modo identico a un calcolo standard del landed cost; restituisce tutti gli stessi dati, ma attiva anche il flusso di lavoro di Collect.

Il processo è semplice: specifica quoteType: COLLECT nella tua richiesta, e il sistema genera automaticamente un carrello di pagamento, invia il link del carrello all'email della parte destinataria e converte il preventivo in un ordine una volta completato il pagamento.

Crea un preventivo per Collect 

Utilizza lo stesso flusso di lavoro GraphQL con cui sei già familiare, basta aggiungere un parametro. Aggiungere quoteType: COLLECT all'input della tua landedCostCalculateWorkflow attiva l'intero processo di Collect mantenendo tutte le funzionalità esistenti. Il campo links nella risposta restituisce l'URL della sessione checkout, che puoi memorizzare e utilizzare per il follow-up con il pagatore secondo necessità.

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
      }
    }
  }
}

Webhook

Configura un ORDER_CREATED webhook per ricevere notifiche non appena un preventivo viene convertito in un ordine:

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

El payload incluirá un campo de tipo. Verifique payload.type === "COLLECT" para manejar solo pedidos de Collect:

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

Gestione del dashboard 

Preventivi e ordini: i preventivi e gli ordini di Collect vengono visualizzati con i badge "COLLECT" nel Dashboard. Puoi filtrare per tipo di preventivo per visualizzare e gestire i preventivi specifici per collect e monitorare lo stato dei pagamenti.

Branding email: Regola il branding email per i carrelli di pagamento di Collect sotto Dashboard → Impostazioni → Modelli Email

Esperienza del destinatario 

Quando crei un preventivo di Collect, il tuo cliente riceve un'email automatica con un link di pagamento sicuro. Il carrello di pagamento visualizza dazi, tasse e commissioni con piena trasparenza mantenendo i prezzi dei tuoi prodotti privati.

Per dettagli completi sul processo di pagamento, paesi e lingue supportati e opzioni di personalizzazione, consulta la guida all'esperienza del destinatario.