Sådan fungerer det
Zonos Collect integreres i dit eksisterende landed cost workflow. Når du tilføjer quoteType: COLLECT til din landedCostCalculateWorkflow mutation, fungerer anmodningen identisk med en standard landed cost beregning; den returnerer alle de samme data, men udløser desuden Collect workflowet.
Processen er enkel: angiv quoteType: COLLECT i din anmodning, og systemet genererer automatisk en betalingskurv, sender kurvlinket til den bestemmende parts e-mail og konverterer tilbuddet til en ordre, når betalingen er gennemført.
Opret et Collect tilbud
Brug det samme GraphQL workflow, du allerede er bekendt med, bare tilføj én parameter. Ved at tilføje quoteType: COLLECT til din landedCostCalculateWorkflow input udløser hele Collect processen, mens alle eksisterende funktioner opretholdes. Feltet links i svaret returnerer checkout session URL'en, som du kan gemme og bruge til opfølgning med betaleren efter behov.
MUTATION
GraphQL
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
Konfigurer en ORDER_CREATED webhook for at blive underrettet, så snart et tilbud konverteres til en ordre:
MUTATION
GraphQL
mutation {
webhookCreate(
input: {
status: ENABLED
type: ORDER_CREATED
url: "https://your.endpoint.com/zonos-webhooks"
}
) {
id
status
url
}
}
Payloadet vil inkludere et typefelt. Tjek payload.type === "COLLECT" for at håndtere kun Collect ordrer:
javascript
if (payload.type === 'COLLECT') {
}
Dashboard management
Tilbud og ordrer: Collect tilbud og ordrer vises med "COLLECT" badges i Dashboard. Du kan filtrere efter tilbudstype for at se og administrere collect-specifikke tilbud og overvåge betalingsstatus.
Email branding: Juster email branding for Collect betalingskurve under Dashboard → Indstillinger → Email Skabeloner
Consignee experience
Når du opretter et Collect tilbud, modtager din kunde en automatiseret email med et sikkert betalingslink. Betalingskurven viser afgifter, skatter og gebyrer med fuld gennemsigtighed, mens dine produktpriser forbliver private.
For komplette detaljer om betalingsprocessen, understøttede lande og sprog samt tilpasningsmuligheder, se Consignee experience guide.
Kom i gang med Collect
Collect afgifter, skatter og gebyrer fra modtagere før levering.