Hur det fungerar
Zonos Collect integreras i din befintliga landed cost arbetsflöde. När du lägger till quoteType: COLLECT till din landedCostCalculateWorkflow mutation, fungerar begäran identiskt med en standard landed cost beräkning; den returnerar all samma data, men utlöser dessutom Collect arbetsflödet.
Processen är enkel: specificera quoteType: COLLECT i din begäran, och systemet genererar automatiskt en betalningsvagn, skickar vagnens länk till den mottagande partens e-post och konverterar offerten till en beställning när betalningen är genomförd.
Skapa en Collect offert
Använd samma GraphQL arbetsflöde som du redan är bekant med, lägg bara till en parameter. Genom att lägga till quoteType: COLLECT till din landedCostCalculateWorkflow indata utlöser hela Collect processen samtidigt som all befintlig funktionalitet bibehålls. Fältet links i svaret returnerar checkout sessionens URL, som du kan lagra och använda för uppföljning med betalaren vid 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
Konfigurera en ORDER_CREATED webhook för att få meddelande så snart en offert omvandlas till en beställning:
MUTATION
GraphQL
mutation {
webhookCreate(
input: {
status: ENABLED
type: ORDER_CREATED
url: "https://your.endpoint.com/zonos-webhooks"
}
) {
id
status
url
}
}
Payloaden kommer att inkludera ett fält för typ. Kontrollera payload.type === "COLLECT" för att hantera endast beställningar av typen Collect:
javascript
if (payload.type === 'COLLECT') {
}
Dashboardhantering
Offerter och beställningar: Collect offerter och beställningar visas med "COLLECT" märken i Dashboard. Du kan filtrera efter offerttyp för att visa och hantera collect-specifika offerter och övervaka betalningsstatus.
E-postbranding: Justera e-postbrandingen för Collect betalningsvagnar under Dashboard → Inställningar → E-postmallar
Mottagarupplevelse
När du skapar en Collect offert, får din kund ett automatiserat e-postmeddelande med en säker betalningslänk. Betalningsvagnen visar avgifter, skatter och kostnader med full transparens samtidigt som din produktprissättning förblir privat.
För fullständiga detaljer om betalningsprocessen, stödda länder och språk, samt anpassningsalternativ, se Mottagarupplevelseguide.
Kom igång med Collect
Collect avgifter, skatter och kostnader från mottagare före leverans.