DOCS

Aan de slag

Aan de slag met Collect

Innen van invoerrechten, belastingen en kosten van geadresseerden vóór levering.

Hoe het werkt 

Zonos Collect integreert in uw bestaande landed cost-workflow. Wanneer u quoteType: COLLECT toevoegt aan uw landedCostCalculateWorkflow-mutatie, werkt het verzoek identiek aan een standaard landed cost-berekening; het retourneert dezelfde data, maar triggert ook de Collect-workflow.

Het proces is eenvoudig: specificeer quoteType: COLLECT in uw verzoek; het systeem genereert automatisch een betaalwagen, stuurt de wagenlink naar het e-mailadres van de bestemmingspartij en zet de offerte om in een order zodra betaling is voltooid.

Een Collect-offerte aanmaken 

Gebruik dezelfde GraphQL-workflow die u al kent, voeg slechts één parameter toe. quoteType: COLLECT in uw landedCostCalculateWorkflow-input triggert het hele Collect-proces met behoud van alle bestaande functionaliteit. Het veld links in het antwoord retourneert de checkout session URL, die u kunt opslaan en gebruiken voor follow-up met de betaler.

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

Configure an ORDER_CREATED webhook to get notified as soon as any quote converts to an order:

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

The payload will include a type field. Check payload.type === "COLLECT" to handle only Collect orders:

javascript

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

Dashboard-beheer 

Quotes and orders: Collect quotes and orders display with "COLLECT" badges in Dashboard. You can filter by the quote type to view and manage collect-specific quotes and monitor payment status.

Email branding: Adjust the email branding for Collect payment carts under DashboardSettingsEmail Templates

Consignee experience 

When you create a Collect quote, your customer receives an automated email with a secure payment link. The payment cart displays duties, taxes, and fees with full transparency while keeping your product pricing private.

For complete details on the payment process, supported countries and languages, and customization options, see the Consignee experience guide.

Boek een demo

Was deze pagina nuttig?