DOCS

Beregne landed cost - GraphQL

Landed Cost•
HjemFor logistikktjenesteleverandører Landed Cost Beregne landed cost - GraphQL

Beregn en landed cost

Beregne avgifter, skatter og gebyrer med GraphQL.

GraphQL

Zonos beregner den totale landed cost for internasjonale forsendelser—inkludert avgifter, skatter og eventuelle tilleggsgebyrer som kreves av toll, meglere eller transportører. I de fleste tilfeller garanterer vi disse beregningene ved å betale den endelige regningen selv og belaste deg nøyaktig det vi har beregnet. I noen tilfeller kan du bruke vår landed cost uten garanti, noe som betyr at du påtar deg ansvaret for eventuelle forskjeller mellom vår beregning og de faktiske kostnadene.

Forbered forespørselen 

Beregning av en landed cost API krever flere innganger, som vi har organisert i arbeidsflyter. Når du er ferdig, vil du kunne gjøre en enkelt forespørsel for å returnere en landed cost basert på forsendelsesdestinasjonen, varer i handlekurven og fraktopplysninger.

Hver arbeidsflyt har sine egne nødvendige innganger. GraphQL lar deg sende mer data enn nødvendig, men bare visse felt er påkrevd for å returnere en landed cost. Disse er tydelig merket i vår API-referanse for å se alle mulige felt.

Merk at noen felt er betinget nødvendige hvis du ønsker at beregningen din skal være garantert.

Nedenfor har vi skissert alle felt som kreves for å beregne en garantert landed cost. Sørg for at denne informasjonen er inkludert før du gjør forespørselen din.

Nødvendige innganger for garanterte beregninger

partyCreateWorkflowInput

partyCreateWorkflowInput identifiserer de involverte partene og deres lokasjoner. Se hele skjemaet i vår GraphQL API referanse. Nødvendige felt er:

  • location
    • administrativeAreaCode: Koden for staten eller provinsen, i to bokstaver. Kun nødvendig for CA og BR.
    • countryCode: Den to-bokstavers ISO-koden for landet.
    • line1: Den første linjen i adressen.
    • postalCode: Postnummeret eller postkoden for adressen.
  • person
    • email: E-postadressen til personen.
    • firstName: Fornavnet til personen.
    • lastName: Etternavnet til personen.
    • phone: Telefonnummeret til personen.
  • type
    • DESTINATION: location & person informasjon for forsendelsesdestinasjonen.
    • ORIGIN: location informasjon for forsendelsesopprinnelsen. person tilknyttet forsendelsesopprinnelsen er ikke nødvendig.
itemCreateWorkflowInput

itemCreateWorkflowInput lister opp varene i handlekurven. Det er mange valgfrie felt (se alle muligheter i vår API-referanse), men feltene nedenfor er nødvendige.

  • amount: Prisen på varen.
  • currencyCode: Valutakoden for varebeløpet.
  • quantity: Antallet av varen.
  • Ett av følgende (hva som helst som er satt som din vare nøkkelpreferanse. Din vare nøkkel kobler informasjon lagret i Katalog til varen i handlekurven og brukes under etikettopprettelse.)
    • productId: Varen sitt produkt-ID.
    • sku: Varen sitt SKU.

measurements (WEIGHT, LENGTH, WIDTH, HEIGHT) er kun nødvendig hvis du ønsker å kartongifisere varene dine når du får en fraktvurdering.

cartonsCreateWorkflowInput

cartonsCreateWorkflowInput krever kun selve inngangen. Se hele skjemaet i vår GraphQL API referanse for å se alle verdier som kan sendes. Det er viktig å sende dimensjonene og vekten av kartongen hvis Zonos beregner fraktkostnaden.

shipmentRatingCreateWorkflowInput

Denne arbeidsflyten brukes når du allerede kjenner frakttjenesten og kostnaden; hvis du vil at Zonos skal beregne disse kostnadene for tjenester du har aktivert, bytt ut denne arbeidsflyten og bruk shipmentRatingCalculateWorkflow i stedet.

shipmentRatingCreateWorkflowInput kommuniserer fraktkostnaden. Se hele skjemaet i vår GraphQL API referanse. Nødvendige felt er:

  • amount: Fraktkostnaden.
  • currencyCode: Valutakoden for fraktkostnaden.
  • serviceLevelCode: Koden som indikerer frakttjenestenivået som brukes i fraktvurderingen.
landedCostWorkflowInput

landedCostWorkflowInput dikterer preferanser for landed cost beregningen. Se hele skjemaet i vår GraphQL API referanse. Nødvendige felt er:

  • calculationMethod: Indikerer din preferanse for hvordan du planlegger å sende: DDP (forhåndsbetalte avgifter og skatter) eller DAP (enten avgifter og skatter betales ved levering, eller hvis en remitteringsordning gjelder, betales de via et skatte-ID).
    • Hvis du bruker vår landed cost garanti, bør denne verdien alltid være DDP_PREFERRED, som vil gi et DDP-tilbud når det er mulig, og et DAP-tilbud hvis et DDP-tilbud ikke er tillatt. Å bruke DAP i stedet kan resultere i at landed costs ikke lenger er garantert, da dette vanligvis resulterer i avgifter og skatter betalt ved levering.
  • endUse: Indikerer om varene selges til en annen bedrift (FOR_RESALE) eller for sluttbruk med en forbruker (NOT_FOR_RESALE).
  • tariffRate: Indikerer metoden som Zonos skal bruke for å beregne tariffratene for dette tilbudet, i tilfelle det er et spekter av tariffsatser som kan brukes. *Når du bruker vår landed cost garanti, bør dette alltid være ZONOS_PREFERRED.

Legg til beregnet frakt: Hvis du vil at Zonos skal beregne fraktkostnaden for deg, bytt ut shipmentRatingCreateWorkflow med shipmentRatingCalculateWorkflow. Legg til cartonizeWorkflow hvis du vil at Zonos skal sortere varene dine i kartonger før du finner fraktkostnaden (brukes for dimensjonsvekt).

HS-kode og fraktalternativer

GraphQL gir deg fleksibiliteten til å tilpasse forespørselen etter dine preferanser. Det finnes et par alternativer for hvordan du inkluderer HS-koder og fraktkostnader i forespørselen.

HS-koder

HS-koder påvirker tollsatser og er derfor påkrevd. Du kan sende HS-koden for hvert enkelt produkt eller la Classify generere dem.

Send HS-koder for hvert produkt

Zonos anbefaler sterkt å bruke produktspecifikke HS-koder, da dette fører til et mer nøyaktig landed cost tilbud. Hvis du kjenner HS-kodene dine, send hsCode for hvert item under itemCreateWorkflow.

Hvis du sender en HS-kode, vil Zonos validere den underveis når du får et landed cost tilbud. Hvis HS-koden du oppga er ugyldig (det vil si at den ikke eksisterer), vil Zonos re-classify produktet ditt underveis og bruke den nye, gyldige HS-koden i stedet for den du oppga.

Hvis du trenger hjelp til å generere HS-koder for produktene dine, lær om Zonos Classify og hvordan du ber om en klassifisering.

Generer HS-koder med Classify

Hvis du ikke sender Zonos en hsCode, vil vi først sjekke Zonos Katalog for å se om du har en HS-kode lagret for produktet ditt. Hvis du ikke har det, vil vi kalle Classify for å generere en klassifisering som driver beregningen av landed cost basert på følgende itemCreateWorkflow produktdetaljfelt: description, category, og material. Hvis produktdetaljfeltene dine ikke er detaljerte nok til å generere en klassifisering basert på Classify's confidence scoring, vil standard HS-koden som er tildelt butikken din bli brukt.

Fraktkostnad

Både frakttjenestenivået og kostnaden påvirker avgifter, skatter og gebyrer, og er derfor påkrevd. Zonos kan beregne frakt, eller du kan sende dette til oss.

Beregn frakt

For å la Zonos beregne fraktkostnader, bruk shipmentRatingCalculateWorkflow. Fraktalternativene som returneres i den beregnede fraktresponsen vil korrelere med serviceLevels du har tildelt fraktprofiler i Dashboard.

Feilsøking: Hvis du forventer et serviceLevel i responsen, men det ikke vises, vennligst sørg for at serviceLevel er aktivert og støttes av method du valgte.

Legg til cartonizeWorkflow (som ikke har noen inndata) hvis du vil at Zonos skal sortere produktene dine i kartonger før fraktkostnaden beregnes (brukes for dimensjonsvekt.

Send fraktkostnader

Hvis du kjenner serviceLevel og amount for en forsendelse, kan du sende disse i shipmentRatingCreateWorkflow delen av forespørselen. Vi vil bruke disse verdiene til å beregne eventuelle tilknyttede fraktgebyrer og returnere dem i responsen.

Be om et landed cost via API 

Når du har de nødvendige inndataene, send GraphQL-mutasjonen til API-endepunktet ved å bruke ditt valgte klientbibliotek eller verktøy. Her er noen eksempler på hvordan du kan strukturere mutasjonen.

Bruk denne forespørselen når du lar Zonos beregne fraktkostnaden som en del av Landed Cost forespørselen. Vi vil da beregne avgifter og skatter på frakt hvis de vurderes av destinasjonslandet.

Mutasjon

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
mutation CalculateLandedCostWithShipping(
  $parties: [PartyCreateWorkflowInput!]!
  $items: [ItemCreateWorkflowInput!]!
  $landedCostConfig: LandedCostWorkflowInput!
) {
  partyCreateWorkflow(input: $parties) {
    type
    id
    organization
  }

  itemCreateWorkflow(input: $items) {
    id
    amount
  }

  cartonizeWorkflow {
    id
    type
    items {
      item {
        id
      }
    }
  }

  shipmentRatingCalculateWorkflow {
    id
    amount
  }

  landedCostCalculateWorkflow(input: $landedCostConfig) {
    id
    duties {
      amount
      currency
    }
    taxes {
      amount
      currency
    }
    fees {
      amount
      currency
    }
  }
}

Variabler

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
{
  "parties": [
    {
      "location": {
        "administrativeArea": "Utah",
        "administrativeAreaCode": "UT",
        "countryCode": "US",
        "line1": "345 N 2450 E",
        "line2": "#151",
        "locality": "St George",
        "postalCode": "84790"
      },
      "type": "ORIGIN"
    },
    {
      "location": {
        "administrativeArea": "BC",
        "administrativeAreaCode": "BC",
        "countryCode": "CA",
        "line1": "27 Sussex Dr.",
        "locality": "Victoria",
        "postalCode": "V8T 2V9"
      },
      "person": {
        "email": "test@gmail.com",
        "firstName": "firstName",
        "lastName": "lastName",
        "phone": "5022303021",
        "companyName": "goProTest",
        "metadata": { "key": "key", "value": "value" }
      },
      "type": "DESTINATION"
    },
    {
      "type": "PAYOR",
      "location": {
        "administrativeArea": "ON",
        "administrativeAreaCode": "ON",
        "countryCode": "CA",
        "latitude": 1.2,
        "line1": "asdf",
        "line2": "asdf",
        "locality": "locality",
        "longitude": 3423.2,
        "postalCode": "M4C 1A1"
      },
      "person": {
        "email": "test@gmail.com",
        "firstName": "firstName",
        "lastName": "lastName",
        "phone": "5022303021",
        "companyName": "goProTest",
        "metadata": { "key": "key", "value": "value" }
      }
    }
  ],
  "items": [
    {
      "amount": 69,
      "currencyCode": "USD",
      "countryOfOrigin": "US",
      "quantity": 1,
      "productId": "productId",
      "hsCode": "1006.30",
      "description": "description",
      "measurements": [
        { "type": "WIDTH", "value": 2, "unitOfMeasure": "CENTIMETER" },
        { "type": "WEIGHT", "value": 2, "unitOfMeasure": "POUND" }
      ]
    },
    {
      "amount": 62,
      "currencyCode": "CAD",
      "countryOfOrigin": "US",
      "hsCode": "1006.30",
      "quantity": 1,
      "productId": "productId2",
      "description": "description2",
      "measurements": [
        { "type": "WIDTH", "value": 2, "unitOfMeasure": "CENTIMETER" },
        { "type": "WEIGHT", "value": 2, "unitOfMeasure": "POUND" }
      ]
    }
  ],
  "landedCostConfig": {
    "endUse": "FOR_RESALE",
    "method": "DAP",
    "tariffRate": "ZONOS_PREFERRED"
  }
}

Svar

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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
{
  "data": {
    "partyCreateWorkflow": [
      {
        "type": "ORIGIN",
        "id": "party_749959ae-b9ff-4de4-b4ac-59cc990c53ba",
        "organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
      },
      {
        "type": "DESTINATION",
        "id": "party_cd7ff245-76b6-464f-a7bf-151ebe1f8833",
        "organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
      },
      {
        "type": "PAYOR",
        "id": "party_00e63a9e-9735-44d9-b129-3b3e76c5df25",
        "organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
      }
    ],
    "itemCreateWorkflow": [
      {
        "id": "item_eb27f071-de8b-4578-9db9-ae69aaf9be3e",
        "amount": 69
      },
      {
        "id": "item_fffa8ba8-cc8d-4e13-bed6-55044a71c115",
        "amount": 62
      }
    ],
    "cartonizeWorkflow": [
      {
        "id": "carton_b34b29c1-ce27-464b-b91b-df8e4a696312",
        "type": "PACKAGE",
        "items": [
          {
            "item": {
              "id": "item_eb27f071-de8b-4578-9db9-ae69aaf9be3e"
            }
          },
          {
            "item": {
              "id": "item_fffa8ba8-cc8d-4e13-bed6-55044a71c115"
            }
          }
        ]
      }
    ],
    "shipmentRatingCalculateWorkflow": [
      {
        "id": "shipment_rating_96787309-9510-43cc-b4fa-c341ff80f4cc",
        "amount": 173.2
      },
      {
        "id": "shipment_rating_b0ccb109-7794-4c7c-b5cc-e2cfbbc5c8ac",
        "amount": 190.1
      }
    ],
    "landedCostCalculateWorkflow": [
      {
        "id": "landed_cost_74d3ce11-bff2-4326-9e6f-368e03ac88b4",
        "duties": [
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "taxes": [
          {
            "amount": 3.45,
            "currency": "USD"
          },
          {
            "amount": 3.1,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "fees": [
          {
            "amount": 0.13,
            "currency": "USD"
          },
          {
            "amount": 1.44,
            "currency": "USD"
          }
        ]
      },
      {
        "id": "landed_cost_7bbfd354-028c-457f-8c8e-c81bb8fa09a0",
        "duties": [
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "taxes": [
          {
            "amount": 3.45,
            "currency": "USD"
          },
          {
            "amount": 3.1,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "fees": [
          {
            "amount": 0.13,
            "currency": "USD"
          },
          {
            "amount": 1.44,
            "currency": "USD"
          }
        ]
      }
    ]
  }
}

Be om en landed cost i Dashboard 

Du kan også beregne landed costs direkte i Zonos Dashboard uten å bruke API-en. Dette er nyttig for å teste beregninger, trene teamet ditt, eller få raske tilbud for kundehenvendelser.

Dashboard bruker de samme API-endepunktene som beskrevet ovenfor, så resultatene vil samsvare med det du ville fått fra direkte API-anrop. Dette gjør det til en flott måte å validere API-integrasjonen din eller utforske hvordan forskjellige innganger påvirker beregningene.

Bruke Dashboard-kalkulatoren

Med landed cost-kalkulatoren i Dashboard kan du få tilbud med beregnede fraktpriser, lage tilbud med kjente fraktkostnader, eller behandle flere tilbud i bulk.

Bruk denne flyten når du vet frakttjenestenivået og kostnaden for forsendelsen din.

  1. Gå til Dashboard → Orders → Quotes
  2. Klikk Nytt tilbud
  3. Valgfritt — Endre plasseringen av din avsendingsadresse
  4. Velg et Destinasjonsland fra nedtrekksmenyen
  5. Skriv inn fraktbeløpet
    • Tjenestenivået er valgfritt; å legge det til lar oss beregne gjeldende fraktgebyrer
  6. Legg til vareinformasjonen for forsendelsen
    • Når du skriver inn en beskrivelse, klassifiserer vi automatisk classify produktet og genererer en HS-kode
    • Du kan overskrive den genererte HS-koden om nødvendig
    • For flere varer, klikk Lagre og legg til en annen. Ellers, klikk Lagre
  7. Valgfritt — Klikk Flere alternativer for å endre:
    • Salgstype til For videresalg
    • Leveringsmodus til Leveringsgebyrer betales ikke
  8. Klikk Få tilbud
    • For å gjøre endringer, klikk Rediger skjema og endre eventuelle detaljer
    • Klikk Få tilbud igjen for å oppdatere

Et landed cost-tilbud vil vises til høyre, inkludert produkt-, frakt- og importkostnader. Utvid tilbudet for å se detaljerte oppdelinger av varer, frakt, avgifter, skatter og gebyrer. Alle tilbud lagres på tilbudssiden for fremtidig referanse.

Rediger eksisterende tilbud: Klikk Tilbud igjen øverst til høyre for å endre et eksisterende tilbud i stedet for å starte fra bunnen av.

Fordeler med å bruke Dashboard

  • Ingen koding nødvendig — Generer tilbud gjennom et brukervennlig grensesnitt
  • Teamtrening — Hjelp ikke-tekniske teammedlemmer med å forstå landed cost-komponenter
  • API-validering — Bekreft at API-integrasjonen din gir forventede resultater
  • Kundesupport — Generer raskt tilbud for kundehenvendelser
  • Bulkbehandling — Håndter flere beregninger effektivt (kommer snart)

Dashboard-tilbud inkluderer de samme detaljerte oppdelingene som er tilgjengelige gjennom API-en, noe som gjør det til et utmerket supplement til din automatiserte integrasjon.

Var denne siden nyttig?

Bestill en demo

Spørsmål?

Få støtte
© 2025 Zonoszonos.com
På denne siden:
  • Beregn en landed cost
  • Forbered forespørselen
  • Be om et landed cost via API
  • Be om en landed cost i Dashboard