DOCS
Collect•
AccueilPour les prestataires logistiques Zonos Collect Premiers pas

Premiers pas avec Collect

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

Fonctionnement 

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

Le processus est simple : précisez quoteType : COLLECT dans votre requête, et le système génère automatiquement un panier de paiement, envoie le lien du panier à l'adresse courriel de la partie destinataire et convertit la soumission en commande une fois le paiement effectué.

Créer une soumission Collect 

Utilisez le même flux de travail GraphQL que vous connaissez déjà, en ajoutant simplement un paramètre. L'ajout de quoteType: COLLECT à l'entrée de landedCostCalculateWorkflow déclenche l'ensemble du processus Collect tout en conservant toutes les fonctionnalités existantes. Le champ links de la réponse renvoie l'URL de la session de paiement, que vous pouvez conserver et utiliser pour faire un suivi auprès du payeur au besoin.

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 avisé dès qu'une soumission est convertie en commande :

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

La charge utile comprendra un champ type. Vérifiez payload.type === "COLLECT" pour ne traiter que les commandes Collect :

javascript

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

Gestion dans le Dashboard 

Soumissions et commandes : les soumissions et commandes Collect s'affichent avec des badges « COLLECT » dans le Dashboard. Vous pouvez filtrer par type de soumission pour afficher et gérer les soumissions propres à Collect et suivre l'état des paiements.

Image de marque des courriels : ajustez l'image de marque des courriels des paniers de paiement Collect sous Dashboard → Settings → Email Templates

Expérience du destinataire 

Lorsque vous créez une soumission Collect, votre client reçoit un courriel automatique contenant un lien de paiement sécurisé. Le panier de paiement affiche les droits, taxes et frais en toute transparence, tout en gardant confidentiels les prix de vos produits.

Pour tous les détails sur le processus de paiement, les pays et langues pris en charge ainsi que les options de personnalisation, consultez le guide Expérience du 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 vous a-t-elle été utile?

Obtenir du soutien·Documents juridiques·© 2026 Zonos
Sur cette page :
  • Premiers pas avec Collect
  • Fonctionnement
  • Créer une soumission Collect
  • Gestion dans le Dashboard
  • Expérience du destinataire