Beregn en landed cost

partyCreateWorkflowInput identificerer de involverede parter og deres lokationer. Se det fulde skema i vores GraphQL API reference. Påkrævede felter er:

• location
  • administrativeAreaCode: Stats- eller provinskoden i to bogstaver. Kun påkrævet for CA og BR.
  • countryCode: Landets ISO-kode i to bogstaver.
  • line1: Første linje i adressen.
  • postalCode: Postnummeret eller zip-koden for adressen.
• person
  • email: Personens e-mailadresse.
  • firstName: Personens fornavn.
  • lastName: Personens efternavn.
  • phone: Personens telefonnummer.
• type
  • DESTINATION: location- og person-oplysningerne for forsendelsesdestinationen.
  • ORIGIN: location-oplysningerne for forsendelsesoprindelsen. Den person, der er knyttet til forsendelsesoprindelsen, er ikke påkrævet.

itemCreateWorkflowInput 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 varens quantity er 1, er dette varens samlede pris. Hvis varens quantity er >1, ganger API'et varens amount med varens quantity for at få totalen for linjeposten. Læg ikke den samlede pris for alle enheder af varen i amount.
• currencyCode: Valutakoden for varebeløbet.
• quantity: Antallet af varen. API'et ganger varens amount med varens quantity for 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.

cartonsCreateWorkflowInput 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.

Dette 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.

landedCostWorkFlowInput 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 af DAP i stedet kan resultere i, at landed costs ikke længere er garanterede, da dette typisk resulterer i told og skat betalt ved levering.
• 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ære ZONOS_PREFERRED.

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.

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 serviceLevel i svaret, men det ikke vises, skal du sikre, at serviceLevel er aktiveret og understøttes af den method, 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.