Forbered anmodningen
Beregning af en landed cost API kræver flere input, som vi har organiseret i workflows. Når de er fuldført, kan du foretage en enkelt anmodning for at returnere en landed cost baseret på forsendelsesdestinationen, varerne i kurven og forsendelsesdetaljerne.
Hvert workflow har sine egne påkrævede input. GraphQL giver dig mulighed for at sende flere data end nødvendigt, men kun visse felter er påkrævede for at returnere en landed cost. Disse er tydeligt markeret i vores API-reference for at se alle mulige felter.
Bemærk, at nogle felter er betinget påkrævede, hvis du vil have, at din beregning skal være garanteret.
Nedenfor har vi skitseret alle felter, der kræves for at beregne en garanteret landed cost. Sørg for, at disse oplysninger er inkluderet, før du foretager din anmodning.
Påkrævede input til garanterede beregninger
partyCreateWorkflowInputpartyCreateWorkflowInput identificerer de involverede parter og deres lokationer. Se det fulde skema i vores GraphQL API reference. Påkrævede felter er:
locationadministrativeAreaCode: Stats- eller provinskoden i to bogstaver. Kun påkrævet for CA og BR.countryCode: Landets tocifrede ISO-kode.line1: Første linje i adressen.postalCode: Postnummeret eller zip-koden for adressen.
personemail: Personens e-mailadresse.firstName: Personens fornavn.lastName: Personens efternavn.phone: Personens telefonnummer.
typeDESTINATION:location- ogperson-oplysningerne for forsendelsesdestinationen.ORIGIN:location-oplysningerne for forsendelsesoprindelsen. Denperson, der er knyttet til forsendelsesoprindelsen, er ikke påkrævet.
itemCreateWorkflowInputitemCreateWorkflowInput viser varerne i kurven. Der findes mange valgfrie felter (se alle muligheder i vores API-reference), men felterne nedenfor er påkrævede.
amount: Værdien af en enkelt enhed af det produkt, der sendes, før den ganges med antal. Bemærk, at dette adskiller sig fra postdefinitionen af en postvare. Hvis varensquantityer 1, er dette varens samlede pris. Hvis varensquantityer >1, ganger API'et varensamountmed varensquantityfor at få totalen for linjeposten. Læg ikke den samlede pris for alle enheder af varen iamount.currencyCode: Valutakoden for varebeløbet.quantity: Antallet af varen. API'et ganger varensamountmed varensquantityfor at få totalen for linjeposten.countryOfOrigin: Landet, hvor varen blev fremstillet.- Et af følgende (alt efter hvad der er indstillet som din item key preference. Din item key forbinder oplysninger gemt i Catalog med varen i kurven og bruges ved oprettelse af label.)
productId: Varens produkt-ID.sku: Varens SKU.
measurements (WEIGHT, LENGTH, WIDTH, HEIGHT) er kun påkrævet, hvis du vil cartonize dine varer, når du får en shipment rating.
cartonsCreateWorkflowInputcartonsCreateWorkflowInput kræver kun selve inputtet. Se det fulde skema i vores GraphQL API reference for at se alle værdier, der kan sendes. Det er vigtigt at sende kartonens dimensioner og vægt, hvis Zonos beregner fragtomkostningen.
shipmentRatingCreateWorkflowInputDette workflow bruges, når du allerede kender fragtservicen og -omkostningen; hvis du vil have Zonos til at beregne disse omkostninger for tjenester, du har aktiveret, skal du erstatte dette workflow og bruge shipmentRatingCalculateWorkflow i stedet.
shipmentRatingCreateWorkflowInput kommunikerer fragtomkostningen. Se det fulde skema i vores GraphQL API reference. Påkrævede felter er:
amount: Fragtomkostningen.currencyCode: Valutakoden for fragtomkostningen.serviceLevelCode: Koden, der angiver det fragtserviceniveau, der bruges i shipment rating.
landedCostWorkFlowInputlandedCostWorkFlowInput angiver præferencer for landed cost-beregningen. Se det fulde skema i vores GraphQL API reference. Påkrævede felter er:
calculationMethod: Angiver din præference for, hvordan du planlægger at sende: DDP (forudbetalt told og skat) eller DAP (enten betales told og skat ved levering, eller hvis en remittanceordning gælder, remitteres de via et skatte-ID).- Hvis du bruger vores landed cost-garanti, skal denne værdi altid være
DDP_PREFERRED, som giver et DDP-tilbud, når det er muligt, og et DAP-tilbud, når et DDP-tilbud ikke er tilladt. Brug afDAPi stedet kan resultere i, at landed costs ikke længere er garanterede, da dette typisk resulterer i told og skat betalt ved levering.
- Hvis du bruger vores landed cost-garanti, skal denne værdi altid være
endUse: Angiver, om varerne sælges til en anden virksomhed (FOR_RESALE) eller til slutbrug hos en forbruger (NOT_FOR_RESALE).tariffRate: Angiver den metode, Zonos skal bruge til at beregne toldsatserne for dette tilbud, hvis der er et interval af toldsatser, der kan anvendes. *Når du bruger vores landed cost-garanti, skal dette altid væreZONOS_PREFERRED.
Tilføj beregnet fragt: Hvis du vil have Zonos til at beregne fragtomkostningen for dig, skal du erstatte
shipmentRatingCreateWorkflowmedshipmentRatingCalculateWorkflow. TilføjcartonizeWorkflow, hvis du vil have Zonos til at sortere dine varer i kartoner, før fragtomkostningen findes (bruges til dimensional weight).
HS-kode og fragtmuligheder
GraphQL giver dig fleksibiliteten til at tilpasse anmodningen efter din præference. Der er et par muligheder for, hvordan du inkluderer HS-koder og fragtomkostninger i anmodningen.
HS-koder
HS-koder påvirker toldsatser og er derfor påkrævet. Du kan sende HS-koden for hver vare eller lade Classify generere dem.
Zonos anbefaler stærkt at bruge produktspecifikke HS-koder, da det giver et mere præcist landed cost-tilbud. Hvis du kender dine HS-koder, skal du sende hsCode for hver item under itemCreateWorkflow.
Hvis du sender en HS-kode, validerer Zonos den on the fly, når der anmodes om et landed cost-tilbud. Hvis den HS-kode, du angav, er ugyldig (dvs. den findes ikke), vil Zonos genklassificere din vare on the fly og bruge den nye, gyldige HS-kode i stedet for den, du angav.
Hvis du har brug for hjælp til at generere HS-koder til dine produkter, læs om Zonos Classify og hvordan du anmoder om en klassificering.
Hvis du ikke sender Zonos en hsCode, tjekker vi først Zonos Catalog for at se, om du har en HS-kode gemt for din vare. Hvis ikke, kalder vi Classify for at generere en klassificering, der driver din landed cost-beregning baseret på følgende produktdetaljefelter i itemCreateWorkflow: description, category og material. Hvis dine produktdetaljefelter ikke er detaljerede nok til at generere en klassificering baseret på Classifys confidence scoring, bruges standard HS-koden, der er tildelt din butik.
Fragtomkostning
Både fragtserviceniveauet og dets omkostning påvirker told, skat og gebyrer og er derfor påkrævet. Zonos kan beregne fragt, eller du kan sende det til os.
For at få Zonos til at beregne fragtomkostninger skal du bruge shipmentRatingCalculateWorkflow. Fragtmulighederne returneret i svaret på beregnet fragt korrelerer med de serviceLevels, du har tildelt fragtprofiler i Dashboard.
Fejlfinding: Hvis du forventer et
serviceLeveli svaret, men det ikke vises, skal du sikre, atserviceLeveler aktiveret og understøttes af denmethod, du valgte.
Tilføj cartonizeWorkflow (som ikke har input), hvis du vil have Zonos til at sortere dine varer i kartoner, før fragtomkostningen findes (bruges til dimensional weight).
Hvis du kender serviceLevel og amount for en forsendelse, kan du sende dem i shipmentRatingCreateWorkflow-delen af anmodningen. Vi bruger disse værdier til at beregne eventuelle tilknyttede carrier-gebyrer og returnerer dem i svaret.
Anmod om en landed cost via API
Når du har de påkrævede inputdata, skal du sende GraphQL-mutationen til API-endpointet ved hjælp af dit valgte klientbibliotek eller værktøj. Her er nogle eksempler på, hvordan du kan strukturere mutationen.
Brug denne anmodning, når du får Zonos til at beregne fragtomkostningen som en del af Landed Cost-anmodningen. Vi beregner derefter told og skat på fragt, hvis de vurderes af destinationslandet.
mutation CalculateLandedCost($parties: [PartyCreateWorkflowInput!]!$items: [ItemCreateWorkflowInput!]!$landedCostConfig: LandedCostWorkFlowInput!) { partyCreateWorkflow(input: $parties) { type id organization } itemCreateWorkflow(input: $items) { id amount productId } cartonizeWorkflow { id type items { item { id } } } shipmentRatingCalculateWorkflow { id amount } landedCostCalculateWorkflow(input: $landedCostConfig) { id duties { amount currency note } taxes { amount currency note } fees { amount currency note } }}Næste trin: Opret en ordre
Når du har beregnet en landed cost og modtaget landedCostId fra API-svaret, skal du oprette en ordre for at finalisere transaktionen i Zonos-systemet. Brug orderCreate-mutationen og send landedCostId fra dit tilbud. Læs mere om oprettelse af ordrer.
Anmod om en landed cost i Dashboard
Du kan også beregne landed costs direkte i Zonos Dashboard uden at bruge API'et. Det er nyttigt til at teste beregninger, træne dit team eller få hurtige tilbud til kundehenvendelser.
Dashboard bruger de samme API-endpoints som beskrevet ovenfor, så resultaterne matcher det, du ville få fra direkte API-kald. Det gør det til en god måde at validere din API-integration på eller udforske, hvordan forskellige input påvirker beregningerne.
Brug af Dashboard-beregneren
Med landed cost-beregneren i Dashboard kan du få tilbud med beregnede fragttakster, oprette tilbud med kendte fragtomkostninger eller behandle flere tilbud i bulk.
Brug dette flow, når du kender fragtserviceniveauet og -omkostningen for din forsendelse.
- Gå til Dashboard → Orders → Quotes
- Klik New quote
- Valgfrit — Rediger lokationen for din afsendelsesadresse
- Vælg et Destination country i dropdown-menuen
- Angiv fragtbeløbet
- Serviceniveauet er valgfrit; at tilføje det giver os mulighed for at beregne gældende carrier-gebyrer
- Tilføj varedetaljerne for forsendelsen
- Når du angiver en beskrivelse, klassificerer vi automatisk produktet og genererer en HS-kode
- Du kan overskrive den genererede HS-kode, hvis det er nødvendigt
- For flere varer skal du klikke Save and add another. Ellers skal du klikke Save
- Valgfrit — Klik More options for at ændre:
- Sale type til For resale
- Delivery mode til Delivery duties unpaid
- Klik Get quote
- For at foretage ændringer skal du klikke Edit form og ændre detaljer
- Klik Get quote igen for at opdatere
Et landed cost-tilbud vises til højre, inklusive produkt-, fragt- og importomkostninger. Udvid tilbuddet for at se detaljerede opdelinger af varer, fragt, told, skat og gebyrer. Alle tilbud gemmes på tilbudssiden til fremtidig reference.
Rediger eksisterende tilbud: Klik Quote again øverst til højre for at ændre et eksisterende tilbud i stedet for at starte forfra.
Fordele ved at bruge Dashboard
- Ingen kodning påkrævet — Generer tilbud via en brugervenlig grænseflade
- Teamtræning — Hjælp ikke-tekniske teammedlemmer med at forstå landed cost-komponenter
- API-validering — Verificer, at din API-integration giver forventede resultater
- Kundesupport — Generer hurtigt tilbud til kundehenvendelser
- Bulkbehandling — Håndter flere beregninger effektivt (kommer snart)
Dashboard-tilbud inkluderer de samme detaljerede opdelinger, der er tilgængelige via API'et, hvilket gør det til et fremragende supplement til din automatiserede integration.
Beregn en landed cost
Beregn told, skat og gebyrer med GraphQL.GraphQL
Zonos beregner den samlede landed cost for internationale forsendelser — inklusive told, skat og eventuelle yderligere gebyrer opkrævet af told, mæglere eller carriers. I de fleste tilfælde garanterer vi disse beregninger ved selv at betale den endelige regning og opkræve dig præcis det, vi beregnede. I nogle tilfælde kan du bruge vores landed cost uden garanti, hvilket betyder, at du påtager dig ansvaret for enhver forskel mellem vores beregning og de faktiske opkrævninger.