Commencez avec Collect

Comment ça fonctionne 

Zonos Collect s'intègre dans votre flux de travail existant de landed cost. Lorsque vous ajoutez quoteType: COLLECT à votre mutation landedCostCalculateWorkflow, la demande fonctionne de manière identique à un calcul standard de landed cost ; elle renvoie toutes les mêmes données, mais déclenche en plus le flux de travail de Collect.

Le processus est simple : spécifiez quoteType: COLLECT dans votre demande, et le système génère automatiquement un panier de paiement, envoie le lien du panier à l'email de la partie destinataire, et convertit le devis en commande une fois le paiement effectué.

Créer un devis Collect 

Utilisez le même flux de travail GraphQL que vous connaissez déjà, il suffit d'ajouter un paramètre. Ajouter quoteType: COLLECT à votre entrée landedCostCalculateWorkflow déclenche l'ensemble du processus Collect tout en maintenant toutes les fonctionnalités existantes. Le champ links dans la réponse renvoie l'URL de la session checkout, que vous pouvez stocker et utiliser pour un suivi avec le payeur si nécessaire.

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 un ORDER_CREATED webhook pour être notifié dès qu'un devis se transforme en commande :

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

La carga útil inclura un campo de tipo. Verifique payload.type === "COLLECT" para gestionar solo pedidos de Collect :

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

Gestion du tableau de bord 

Devis et commandes : les devis et commandes Collect s'affichent avec des badges "COLLECT" dans le tableau de bord. Vous pouvez filtrer par type de devis pour visualiser et gérer les devis spécifiques à collect et suivre l'état des paiements.

Marque d'email : Ajustez la marque d'email pour les paniers de paiement Collect sous Tableau de bord → Paramètres → Modèles d'email

Expérience du consignataire 

Lorsque vous créez un devis Collect, votre client reçoit un email automatisé avec un lien de paiement sécurisé. Le panier de paiement affiche les droits, taxes et frais avec une transparence totale tout en gardant vos prix de produit privés.

Pour des détails complets sur le processus de paiement, les pays et langues pris en charge, et les options de personnalisation, consultez le guide de l'expérience du consignataire.