Zonos beregner den totale landed cost 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 beregnet. I noen tilfeller kan du bruke vår landed cost uten garanti, noe som betyr at du selv er ansvarlig for eventuelle forskjeller mellom vår beregning og de faktiske kostnadene.
En API for beregning av landed cost 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 landed cost basert på forsendelsesdestinasjon, varene i handlekurven og forsendelsesinformasjon.
Hver arbeidsflyt 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 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 beskrevet alle felt som kreves for å beregne en garantert landed cost. Kontroller at denne informasjonen er inkludert før du lager forespørselen.
Nødvendige innganger for garanterte beregninger
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.
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 postens definisjon av en postforsendelse. 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 varens 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 varenøkkelpreferanse. 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å kartongen hvis Zonos beregner forsendelseskostnaden.
shipmentRatingCreateWorkflowInput
Denne arbeidsflyten brukes når du allerede kjenner forsendelsesservicen 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 forsendelseskostnaden. Se hele skjemaet i vår GraphQL API referanse. Nødvendige felt er:
amount: Forsendelseskostnaden.
currencyCode: Valutakoden for forsendelseskostnaden.
serviceLevelCode: Koden som angir servicenivået for forsendelsen som brukes i forsendelsesvurderingen.
landedCostWorkFlowInput
landedCostWorkFlowInput bestemmer preferanser for landed cost-beregningen. 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 remitteringsordning gjelder, remitteres de via en skatte-ID).
Hvis du bruker vår landed cost-garanti, 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 landed cost 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 landed cost-garanti, bør denne alltid være ZONOS_PREFERRED.
Legg til beregnet forsendelse: Hvis du ønsker at Zonos skal beregne forsendelseskostnaden for deg, bytt shipmentRatingCreateWorkflow med shipmentRatingCalculateWorkflow. Legg til cartonizeWorkflow hvis du ønsker at Zonos skal sortere varene dine i kartong før du finner forsendelseskostnaden (brukt for dimensjonell vekt).
HS-kode og forsendelsesalternativer
GraphQL gir deg fleksibilitet til å tilpasse forespørselen til din preferanse. Det finnes et par alternativer for hvordan du inkluderer HS-koder og forsendelseskostnader i forespørselen.
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 et mer nøyaktig landed cost-tilbud. 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 et landed cost-tilbud. 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 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 landed cost-beregningen 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 tillitsscoring, vil standard HS-koden tildelt butikken din bli brukt.
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 forsendelseskostnader, bruk shipmentRatingCalculateWorkflow. Forsendelsesalternativene som returneres i det beregnede forsendelsessvaret vil korrelere med serviceLevels du har tildelt til forsendelsesprofiler 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 forsendelseskostnaden (brukt for dimensjonell vekt.
Send forsendelseskostnader
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ørgebyrer og returnere disse i svaret.
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 forsendelseskostnaden som en del av Landed Cost-forespørselen. Vi vil deretter beregne toll og avgifter på forsendelse hvis de vurderes av destinasjonslandet.
Etter at du har beregnet en landed cost 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.
Du kan også beregne landed cost 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 landed cost-kalkulatoren i Dashboard kan du få tilbud med beregnede forsendelsespriser, opprett tilbud med kjente forsendelseskostnader, eller behandle flere tilbud i bulk.
Bruk denne flyten når du kjenner servicenivået og kostnaden for forsendelsen din.
Valgfritt — Endre plasseringen av adresse for avgang
Velg et destinasjonsland fra rullegardinmenyen
Skriv inn forsendelsesbeløpet
Servicenivået er valgfritt; å legge det til lar oss beregne gjeldende transportørgebyrer
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
Valgfritt — Klikk Flere alternativer for å endre:
Salgstype til For videresalg
Leveringsmodus til Levering, tollavgifter ikke betalt
Klikk Få tilbud
For å gjøre endringer, klikk Rediger form og endre eventuelle detaljer
Klikk Få tilbud igjen for å oppdatere
Et landed cost-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å landed cost-komponentene
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
Beregn landed cost - GraphQL
Beregn en landed cost
Beregn toll, avgifter og gebyrer med GraphQL.GraphQL
Zonos beregner den totale landed cost 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 beregnet. I noen tilfeller kan du bruke vår landed cost 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 landed cost 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 landed cost basert på forsendelsesdestinasjon, varene i handlekurven og forsendelsesinformasjon.
Hver arbeidsflyt 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 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 beskrevet alle felt som kreves for å beregne en garantert landed cost. Kontroller at denne informasjonen er inkludert før du lager forespørselen.
Nødvendige innganger for garanterte beregninger
partyCreateWorkflowInputpartyCreateWorkflowInputidentifiserer de involverte partene og deres steder. Se hele skjemaet i vår GraphQL API referanse. Nødvendige felt er:locationadministrativeAreaCode: 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.personemail: E-postadressen til personen.firstName: Fornavn på personen.lastName: Etternavn på personen.phone: Telefonnummeret til personen.typeDESTINATION:location- ogperson-informasjon for forsendelsesdestinasjon.ORIGIN:location-informasjonen for forsendelsesopprinnelsen. Personen som er knyttet til forsendelsesopprinnelsen, er ikke påkrevd.itemCreateWorkflowInputitemCreateWorkflowInputlister 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 postens definisjon av en postforsendelse. Hvis varensquantityer 1, er dette den totale kostnaden for varen. Hvis varensquantityer >1, vil API-et multiplisereamountmed varensquantityfor å få totalen for linjevaren. Ikke legg den totale prisen på alle enheter av varen iamount.currencyCode: Valutakoden for varebeløpet.quantity: Antall av varen. API-et vil multiplisere varensamountmed varensquantityfor å få totalen for linjevaren.countryOfOrigin: Landet hvor varen ble produsert.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.cartonsCreateWorkflowInputcartonsCreateWorkflowInputkrever 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å kartongen hvis Zonos beregner forsendelseskostnaden.shipmentRatingCreateWorkflowInputDenne arbeidsflyten brukes når du allerede kjenner forsendelsesservicen 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.shipmentRatingCreateWorkflowInputkommuniserer forsendelseskostnaden. Se hele skjemaet i vår GraphQL API referanse. Nødvendige felt er:amount: Forsendelseskostnaden.currencyCode: Valutakoden for forsendelseskostnaden.serviceLevelCode: Koden som angir servicenivået for forsendelsen som brukes i forsendelsesvurderingen.landedCostWorkFlowInputlandedCostWorkFlowInputbestemmer preferanser for landed cost-beregningen. 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 remitteringsordning gjelder, remitteres de via en skatte-ID).DDP_PREFERRED, som gir et DDP-tilbud når det er mulig og et DAP-tilbud hvis et DDP-tilbud ikke er tillatt. Bruk avDAPi stedet kan resultere i at landed cost 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 landed cost-garanti, bør denne alltid væreZONOS_PREFERRED.HS-kode og forsendelsesalternativer
GraphQL gir deg fleksibilitet til å tilpasse forespørselen til din preferanse. Det finnes et par alternativer for hvordan du inkluderer HS-koder og forsendelseskostnader 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.
Zonos anbefaler sterkt å bruke produktspesifikke HS-koder da det fører til et mer nøyaktig landed cost-tilbud. Hvis du kjenner dine HS-koder, send
hsCodefor hveritemunderitemCreateWorkflow.Hvis du sender en HS-kode, vil Zonos validere den på farten når du henter et landed cost-tilbud. 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.
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 landed cost-beregningen basert på følgendeitemCreateWorkflowproduktdetaljfelt:description,category, ogmaterial. Hvis produktdetaljfeltene dine ikke er detaljerte nok til å generere en klassifisering basert på Classify's tillitsscoring, vil standard HS-koden tildelt butikken din bli brukt.Forsendelseskostnad
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.
For å få Zonos til å beregne forsendelseskostnader, bruk
shipmentRatingCalculateWorkflow. Forsendelsesalternativene som returneres i det beregnede forsendelsessvaret vil korrelere medserviceLevelsdu har tildelt til forsendelsesprofiler i Dashboard.Legg til
cartonizeWorkflow(som ikke har noen innganger) hvis du ønsker at Zonos skal sortere varene dine i kartong før du finner forsendelseskostnaden (brukt for dimensjonell vekt.Hvis du kjenner
serviceLevelogamountfor en forsendelse, kan du sende disse ishipmentRatingCreateWorkflow-delen av forespørselen. Vi vil bruke disse verdiene til å beregne eventuelle tilknyttede transportørgebyrer og returnere disse i svaret.Be om en landed cost 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 forsendelseskostnaden som en del av Landed Cost-forespørselen. Vi vil deretter beregne toll og avgifter på forsendelse hvis de vurderes av destinasjonslandet.
mutation CalculateLandedCost($parties: [PartyCreateWorkflowInput!]!$items: [ItemCreateWorkflowInput!]!$landedCostConfig: LandedCostWorkFlowInput!) {partyCreateWorkflow(input: $parties) {typeidorganization}itemCreateWorkflow(input: $items) {idamountproductId}cartonizeWorkflow {idtypeitems {item {id}}}shipmentRatingCalculateWorkflow {idamount}landedCostCalculateWorkflow(input: $landedCostConfig) {idduties {amountcurrencynote}taxes {amountcurrencynote}fees {amountcurrencynote}}}Neste trinn: Opprett en ordre
Etter at du har beregnet en landed cost og mottatt
landedCostIdfra API-svaret, bør du opprette en ordre for å fullføre transaksjonen i Zonos-systemet. BrukorderCreatemutasjonen og sende innlandedCostIdfra tilbudet ditt. Lær mer om opprettelse av ordrer.Be om en landed cost i Dashboard
Du kan også beregne landed cost 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 landed cost-kalkulatoren i Dashboard kan du få tilbud med beregnede forsendelsespriser, opprett tilbud med kjente forsendelseskostnader, eller behandle flere tilbud i bulk.
Bruk denne flyten når du kjenner servicenivået og kostnaden for forsendelsen din.
Et landed cost-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
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.
ItemCreateWorkflowInput LandedCostWorkFlowInput PartyCreateWorkflowInput ShipmentRatingCreateWorkflowInput
cartonizeWorkflow itemCreateWorkflow landedCostCalculateWorkflow partyCreateWorkflow shipmentRatingCalculateWorkflow shipmentRatingCreateWorkflow
Var denne siden nyttig?