Comment ça fonctionne
Zonos Collect s'intègre à votre workflow de coût d'acquittement existant. Lorsque vous ajoutez quoteType : COLLECT à votre mutation landedCostCalculateWorkflow, la requête fonctionne comme un calcul de coût d'acquittement standard ; elle renvoie les mêmes données et déclenche en plus le workflow Collect.
Le processus est simple : spécifiez quoteType: COLLECT dans votre requête, et le système génère automatiquement un panier de paiement, envoie le lien à l'e-mail du destinataire et convertit le devis en commande une fois le paiement finalisé.
Créer un devis Collect
Utilisez le même workflow GraphQL que vous connaissez, en ajoutant un seul paramètre. L'ajout de quoteType: COLLECT à l'entrée landedCostCalculateWorkflow déclenche l'ensemble du processus Collect tout en conservant les fonctionnalités existantes. Le champ links de la réponse renvoie l'URL de session de paiement, que vous pouvez stocker et utiliser pour le suivi avec le payeur si nécessaire.
mutation CollectQuote($parties: [PartyCreateWorkflowInput!]!$items: [ItemCreateWorkflowInput!]!$shipmentRating: ShipmentRatingCreateWorkflowInput!$landedCost: LandedCostCalculateWorkflowInput!) { partyCreateWorkflow(input: $parties) { type id organization } itemCreateWorkflow(input: $items) { id amount quantity description } cartonizeWorkflow { id } shipmentRatingCreateWorkflow(input: $shipmentRating) { id amount } landedCostCalculateWorkflow(input: $landedCost) { id landedCostGuaranteeCode links { key url } amountSubtotals { duties fees taxes landedCostTotal } fees { amount currency type item { productId } } }}Webhooks
Configurez un webhook ORDER_CREATED pour être notifié dès qu'un devis devient une commande :
mutation CreateOrderWebhook($input: WebhookCreateInput!) { webhookCreate(input: $input) { id status url }}La charge utile inclut un champ type. Vérifiez payload.type === "COLLECT" pour ne traiter que les commandes Collect :
javascript
if (payload.type === 'COLLECT') {
}
Gestion Dashboard
Devis et commandes : les devis et commandes Collect affichent des badges « COLLECT » dans le Dashboard. You can filter by the quote type to view and manage collect-specific quotes and monitor payment status.
Image de marque e-mail : ajustez l'image de marque des paniers Collect sous Dashboard → Settings → Email Templates
Expérience destinataire
Lorsque vous créez un devis Collect, votre client reçoit un e-mail automatique avec un lien de paiement sécurisé. Le panier de paiement affiche droits, taxes et frais en toute transparence tout en gardant vos prix produits privés.
Pour tous les détails sur le processus de paiement, pays et langues pris en charge et options de personnalisation, consultez le guide Expérience destinataire.
Commencer avec Collect
Collectez droits, taxes et frais auprès des destinataires avant la livraison.