DOCS

Kom i gang

Kom i gang med Collect

Collect afgifter, skatter og gebyrer fra modtagere før levering.

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

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

Konfigurer en ORDER_CREATED webhook for at blive underrettet, så snart et tilbud konverteres til en ordre:

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
  }
}

Payloadet vil inkludere et typefelt. Tjek payload.type === "COLLECT" for at håndtere kun Collect ordrer:

javascript

1
2
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 DashboardIndstillingerEmail 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.

Var denne side nyttig?