DOCS

Beregn landekostnad - GraphQL

Landed Cost•
HjemFor logistikkselskaper Landed Cost Beregn landekostnad - GraphQL

Beregn en landekostnad

Beregn toll, avgifter og gebyrer med GraphQL.

GraphQL

Zonos beregner totalkostnaden for internasjonale forsendelser – inkludert toll, avgifter og eventuelle tilleggsgebyrer som pålegges av tollmyndighetene, meglere eller transportør. I de fleste tilfeller garanterer vi disse beregningene ved å betale den endelige regningen selv og belaste deg nøyaktig det vi beregnete. I noen tilfeller kan du bruke vår landekostnad uten garanti, noe som betyr at du selv er ansvarlig for eventuelle forskjeller mellom vår beregning og de faktiske kostnadene.

Forbered forespørselen 

En API for beregning av landekostnad krever flere innganger, som vi har organisert i arbeidsflyter. Når du er ferdig, vil du kunne lage en enkelt forespørsel som returnerer en landekostnad basert på forsendelsesdestinasjon, varene i handlekurven og forsendelsesinformasjon.

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

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

Nedenfor har vi beskrevet alle felt som kreves for å beregne en garantert landekostnad. Kontroller at denne informasjonen er inkludert før du lager forespørselen.

partyCreateWorkflowInput

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

  • location
    • administrativeAreaCode: Koden for stat eller provins, i to bokstaver. Kun nødvendig for CA og BR.
    • countryCode: To-bokstavs ISO-kode for landet.
    • line1: Første linje av adressen.
    • postalCode: Postnummeret eller zipkoden for adressen.
  • person
    • email: E-postadressen til personen.
    • firstName: Fornavn på personen.
    • lastName: Etternavn på personen.
    • phone: Telefonnummeret til personen.
  • type
    • DESTINATION: location- og person-informasjon for forsendelsesdestinasjon.
    • ORIGIN: location-informasjonen for forsendelsesopprinnelsen. Personen som er knyttet til forsendelsesopprinnelsen, er ikke påkrevd.
itemCreateWorkflowInput

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

  • amount: Verdien av en enkelt enhet av produktet som sendes, før multiplikasjon med antall. Merk at dette avviker fra postaldefinisjon av en postallvare. Hvis varens quantity er 1, er dette den totale kostnaden for varen. Hvis varens quantity er >1, vil API-et multiplisere amount med varens quantity for å få totalen for linjevaren. Ikke legg den totale prisen på alle enheter av varen i amount.
  • currencyCode: Valutakoden for varebeløpet.
  • quantity: Antall av varen. API-et vil multiplisere vareens amount med varens quantity for å få totalen for linjevaren.
  • countryOfOrigin: Landet hvor varen ble produsert.
  • En av følgende (avhengig av hva som er satt som din nøkkelnøkkelprefersanse. Din varenøkkel knytter informasjon lagret i Catalog til varen i handlekurven og brukes under etikettopprettelse.)
    • productId: Varens produkt-ID.
    • sku: Varens SKU.

measurements (WEIGHT, LENGTH, WIDTH, HEIGHT) kreves bare hvis du vil kartongisere varene dine når du får en forsendelsesvurdering.

cartonsCreateWorkflowInput

cartonsCreateWorkflowInput krever bare selve inngangen. Se hele skjemaet i vår GraphQL API referanse for å se alle verdier som kan sendes. Det er viktig å overføre dimensjonene og vekten på kartonnnen hvis Zonos beregner forsendeleskostnaden.

shipmentRatingCreateWorkflowInput

Denne arbeidsflyten brukes når du allerede kjenner forsendelses servicen og kostnaden; hvis du ønsker at Zonos skal beregne disse kostnadene for tjenestene du har aktivert, bytt ut denne arbeidsflyten og bruk i stedet shipmentRatingCalculateWorkflow.

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

  • amount: Forsendeleskostnaden.
  • currencyCode: Valutakoden for forsendeleskostnaden.
  • serviceLevelCode: Koden som angir servicenivået for forsendelsen som brukes i forsendelses vurderingen.
landedCostWorkFlowInput

landedCostWorkFlowInput bestemmer preferanser for beregningen av landekostnad. Se hele skjemaet i vår GraphQL API referanse. Nødvendige felt er:

  • calculationMethod: Angir din preferanse for hvordan du planlegger å sende: DDP (forhåndsbetalte tollsatser og avgifter) eller DAP (enten betales tollsatser og avgifter ved levering, eller hvis en tilbakebetalingsplan gjelder, remitteres de via en skatte-ID).
    • Hvis du bruker vår garantierte landekostnad, bør denne verdien alltid være DDP_PREFERRED, som gir et DDP-tilbud når det er mulig og et DAP-tilbud hvis et DDP-tilbud ikke er tillatt. Bruk av DAP i stedet kan resultere i at landekosten ikke lenger er garantert, da dette vanligvis resulterer i tollsatser og avgifter betalt ved levering.
  • endUse: Angir om varene selges til en annen bedrift (FOR_RESALE) eller for sluttbruk med en forbruker (NOT_FOR_RESALE).
  • tariffRate: Angir metoden Zonos skal bruke for å beregne tollsatsene for dette tilbudet, i tilfelle det finnes en rekke tollsatser som kunne bli brukt. *Når du bruker vår garantierte landekostnad, bør denne alltid være ZONOS_PREFERRED.

Legg til beregnet forsendelse: Hvis du ønsker at Zonos skal beregne forsendeleskostnaden for deg, bytt shipmentRatingCreateWorkflow med shipmentRatingCalculateWorkflow. Legg til cartonizeWorkflow hvis du ønsker at Zonos skal sortere varene dine i kartong før du finner forsendeleskostnaden (brukt for dimensjonell vekt).

GraphQL gir deg fleksibilitet til å tilpasse forespørselen til din preferanse. Det finnes et par alternativer for hvordan du inkluderer HS-koder og forsendelskostnader i forespørselen.

HS-koder 

HS-koder påvirker tollsatser og er derfor nødvendige. Du kan sende HS-koden for hver vare eller la Classify generere dem.

Sende HS-koder for hver vare

Zonos anbefaler sterkt å bruke produktspesifikke HS-koder da det fører til en mer nøyaktig prisberegning for landekostnad. Hvis du kjenner dine HS-koder, send hsCode for hver item under itemCreateWorkflow.

Hvis du sender en HS-kode, vil Zonos validere den på farten når du henter en landekostnadsberegning. Hvis HS-koden du oppgav er ugyldig (dvs. at den ikke eksisterer), vil Zonos omklassifisere varen din på farten og bruke den nye, gyldige HS-koden i stedet for den du oppgav.

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

Generer HS-koder med Classify

Hvis du ikke sender Zonos en hsCode, skal vi først sjekke Zonos Catalog for å se om du har en HS-kode lagret for varen din. Hvis du ikke har det, vil vi ringe Classify for å generere en klassifisering for å drive landekostnadsberegningen basert på følgende itemCreateWorkflow produktdetalj felt: description, category, og material. Hvis produktdetalj feltene dine ikke er detaljerte nok til å generere en klassifisering basert på Classify's tillits scoring, vil standard HS-koden tildelt butikken din bli brukt.

Forsendelses kostnad 

Både servicenivået for forsendelse og kostnaden påvirker tollsatsene, avgiftene og gebyrene og er derfor nødvendig. Zonos kan beregne forsendelse eller du kan sende dette til oss.

Beregn forsendelse

For å få Zonos til å beregne forsendelskostnader, bruk shipmentRatingCalculateWorkflow. Forsendelses alternativene som returneres i det beregnede forsendelses svaret vil korrelere med serviceLevels du har tildelt til forsendelsprofiler i Dashboard.

Feilsøking: Hvis du forventer en serviceLevel i svaret men det ikke vises, må du kontrollere at serviceLevel er aktivert og støttes av method du valgte.

Legg til cartonizeWorkflow (som ikke har noen innganger) hvis du ønsker at Zonos skal sortere varene dine i kartong før du finner forsendelskostnaden (brukt for dimensjonell vekt.

Send forsendelskostnader

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 transportør gebyrer og returnere disse i svaret.

Be om landekostnad via API 

Når du har nødvendig inngangdata, send GraphQL-mutasjonen til API-sluttpunktet med 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 forsendeleskostnaden som en del av Landed Cost forespørselen. Vi vil deretter beregne toll og avgifter på forsendelse hvis de vurderes av destinasjonslandet.

1mutation CalculateLandedCost(
2$parties: [PartyCreateWorkflowInput!]!
3$items: [ItemCreateWorkflowInput!]!
4$landedCostConfig: LandedCostWorkFlowInput!
5) {
6 partyCreateWorkflow(input: $parties) {
7 type
8 id
9 organization
10 }
11 itemCreateWorkflow(input: $items) {
12 id
13 amount
14 productId
15 }
16 cartonizeWorkflow {
17 id
18 type
19 items {
20 item {
21 id
22 }
23 }
24 }
25 shipmentRatingCalculateWorkflow {
26 id
27 amount
28 }
29 landedCostCalculateWorkflow(input: $landedCostConfig) {
30 id
31 duties {
32 amount
33 currency
34 note
35 }
36 taxes {
37 amount
38 currency
39 note
40 }
41 fees {
42 amount
43 currency
44 note
45 }
46 }
47}

Neste trinn: Opprett en ordre

Etter at du har beregnet en landekostnad og mottatt landedCostId fra API-svaret, bør du opprette en ordre for å fullføre transaksjonen i Zonos-systemet. Bruk orderCreate mutasjonen og sende inn landedCostId fra tilbudet ditt. Lær mer om opprettelse av ordrer.

Be om landekostnad i Dashboard 

Du kan også beregne landekosten direkte i Zonos Dashboard uten å bruke API-en. Dette er nyttig for å teste beregninger, trene teamet ditt eller få rask tilbud for kundeforespørsler.

Dashboard bruker de samme API-sluttpunktene beskrevet ovenfor, så resultatene vil samsvare med det du ville få fra direkte API-kall. Dette gjør det til en fin måte å validere API-integrasjonen eller utforske hvordan ulike innganger påvirker beregningene.

Bruk Dashboard-kalkulatoren

Med landekostnadskalkulatoren i Dashboard kan du få tilbud med beregnede forsendelsespriser, opprett tilbud med kjente forsendelskostnader, eller behandle flere tilbud i bulk.

Bruk denne flyten når du kjenner servicenivået og kostnaden for forsendelsen din.

  1. Gå til Dashboard → Ordrer → Tilbud
  2. Klikk Nytt tilbud
  3. Valgfritt — Endre plasseringen av adresse for avgang
  4. Velg et destinasjonsland fra rullegardinmenyen
  5. Skriv inn forsendelses beløpet
    • Servicenivået er valgfritt; å legge det til lar oss beregne gjeldende transportør gebyrer
  6. Legg til varedetaljene for forsendelsen
    • Når du skriver inn en beskrivelse, klassifiserer vi automatisk produktet og genererer en HS-kode
    • Du kan overskrive den genererte HS-koden om nødvendig
    • For flere varer, klikk Lagre og legg til ny. Ellers klikk Lagre
  7. Valgfritt — Klikk Flere alternativer for å endre:
    • Salgstype til For videresalg
    • Leveringsmodus til Leverans tollavgifter ikke betalt
  8. Klikk Få tilbud
    • For å gjøre endringer, klikk Rediger form og endre eventuelle detaljer
    • Klikk Få tilbud igjen for å oppdatere

Et landekostaday tilbud vises til høyre, inkludert produkt, forsendelse og importkostnader. Utvid tilbudet for å se detaljerte oppdelinger av varer, forsendelse, toll, avgifter og gebyrer. Alle tilbud lagres på tilbudssiden for fremtidig referanse.

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

Fordeler med å bruke Dashboard

  • Ingen koding påkrevd — Generer tilbud gjennom et brukervennlig grensesnitt
  • Teamtrening — Hjelp ikke-tekniske teammedlemmer med å forstå landekostnads komponenter
  • API-validering — Verifiser at API-integrasjonen produserer forventede resultater
  • Kundeservice — Generer raskt tilbud for kundeforespørsler
  • Bulk-behandling — Håndter flere beregninger effektivt (kommer snart)

Dashboard tilbud inneholder de samme detaljerte oppdelinger som er tilgjengelig gjennom API-en, noe som gjør det til et utmerket komplement til den automatiserte integrasjonen.

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

ItemCreateWorkflowInput LandedCostWorkFlowInput PartyCreateWorkflowInput ShipmentRatingCreateWorkflowInput

MUTATIONS

cartonizeWorkflow itemCreateWorkflow landedCostCalculateWorkflow partyCreateWorkflow shipmentRatingCalculateWorkflow shipmentRatingCreateWorkflow

Bestill en demo

Var denne siden nyttig?

Få støtte·Juridiske dokumenter·© 2026 Zonos
På denne siden:
  • Beregn en landekostnad
  • Forbered forespørselen
  • Be om landekostnad via API
  • Be om landekostnad i Dashboard