DOCS

Kom igång

Kom igång med Collect

Collect avgifter, skatter och kostnader från mottagare före leverans.

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
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

1
2
3
4
5
6
7
8
9
10
11
12
13
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

1
2
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 DashboardInställningarE-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.

Var den här sidan till hjälp?