DOCS
Collect•
AccueilPour les prestataires logistiques Zonos Collect Commencer

Commencer avec Collect

Collectez droits, taxes et frais auprès des destinataires avant la livraison.

Comment ça fonctionne 

Zonos Collect s'intègre à votre workflow Landed Cost existant. Lorsque vous ajoutez quoteType : COLLECT à votre mutation landedCostCalculateWorkflow, la requête fonctionne comme un calcul Landed Cost 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.

1mutation CollectQuote(
2$parties: [PartyCreateWorkflowInput!]!
3$items: [ItemCreateWorkflowInput!]!
4$shipmentRating: ShipmentRatingCreateWorkflowInput!
5$landedCost: LandedCostCalculateWorkflowInput!
6) {
7 partyCreateWorkflow(input: $parties) {
8 type
9 id
10 organization
11 }
12 
13 itemCreateWorkflow(input: $items) {
14 id
15 amount
16 quantity
17 description
18 }
19 
20 cartonizeWorkflow {
21 id
22 }
23 
24 shipmentRatingCreateWorkflow(input: $shipmentRating) {
25 id
26 amount
27 }
28 
29 landedCostCalculateWorkflow(input: $landedCost) {
30 id
31 landedCostGuaranteeCode
32 links {
33 key
34 url
35 }
36 amountSubtotals {
37 duties
38 fees
39 taxes
40 landedCostTotal
41 }
42 fees {
43 amount
44 currency
45 type
46 item {
47 productId
48 }
49 }
50 }
51}

Webhooks

Configurez un webhook ORDER_CREATED pour être notifié dès qu'un devis devient une commande :

1mutation CreateOrderWebhook($input: WebhookCreateInput!) {
2 webhookCreate(input: $input) {
3 id
4 status
5 url
6 }
7}

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. Vous pouvez filtrer par type de devis pour afficher et gérer les devis spécifiques à Collect et suivre le statut des paiements.

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.

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentRatingCreateWorkflowInput WebhookCreateInput

MUTATIONS

cartonizeWorkflow itemCreateWorkflow landedCostCalculateWorkflow partyCreateWorkflow shipmentRatingCreateWorkflow webhookCreate

Cette page a-t-elle été utile?

Obtenir de l'aide·Documents juridiques·© 2026 Zonos
Sur cette page :
  • Commencer avec Collect
  • Comment ça fonctionne
  • Créer un devis Collect
  • Gestion Dashboard
  • Expérience destinataire