Beräkna en landed cost

partyCreateWorkflowInput identifierar de involverade parterna och deras platser. Se hela schemat i vår GraphQL API-referens. Obligatoriska fält är:

• location
  • administrativeAreaCode: Delstats- eller provinskoden, med två bokstäver. Krävs endast för CA och BR.
  • countryCode: Landets tvåbokstavs-ISO-kod.
  • line1: Adressens första rad.
  • postalCode: Adressens postnummer.
• person
  • email: Personens e-postadress.
  • firstName: Personens förnamn.
  • lastName: Personens efternamn.
  • phone: Personens telefonnummer.
• type
  • DESTINATION: location- och person-information för fraktdestinationen.
  • ORIGIN: location-information för fraktursprunget. person kopplad till fraktursprunget krävs inte.

itemCreateWorkflowInput listar artiklarna i varukorgen. Det finns många valfria fält (se alla möjligheter i vår API-referens), men fälten nedan är obligatoriska.

• amount: Värdet av en enskild enhet av produkten som skickas, innan multiplikation med kvantitet. Observera att detta skiljer sig från den postala definitionen av en postförsändelse. Om artikelns quantity är 1 är detta den totala kostnaden för artikeln. Om artikelns quantity är >1 multiplicerar API:et artikelns amount med artikelns quantity för att få totalen för radartikeln. Lägg inte in totalpriset för alla enheter av artikeln i amount.
• currencyCode: Valutakoden för artikelbeloppet.
• quantity: Kvantiteten av artikeln. API:et multiplicerar artikelns amount med artikelns quantity för att få totalen för radartikeln.
• countryOfOrigin: Landet där artikeln tillverkades.
• Ett av följande (beroende på vad som är inställt som er artikelnyckelpreferens. Er artikelnyckel kopplar information lagrad i Catalog till artikeln i varukorgen och används vid skapande av etiketter.)
  • productId: Artikelns produkt-ID.
  • sku: Artikelns SKU.

measurements (WEIGHT, LENGTH, WIDTH, HEIGHT) krävs endast om ni vill kartongisera era artiklar när ni hämtar en fraktvärdering.

cartonsCreateWorkflowInput kräver endast själva indatan. Se hela schemat i vår GraphQL API-referens för alla värden som kan skickas. Det är viktigt att skicka kartongens mått och vikt om Zonos beräknar fraktkostnaden.

Detta arbetsflöde används när ni redan känner till frakttjänsten och kostnaden; om ni vill att Zonos ska beräkna dessa kostnader för tjänster ni har aktiverat, byt ut detta arbetsflöde och använd shipmentRatingCalculateWorkflow i stället.

shipmentRatingCreateWorkflowInput kommunicerar fraktkostnaden. Se hela schemat i vår GraphQL API-referens. Obligatoriska fält är:

• amount: Fraktkostnaden.
• currencyCode: Valutakoden för fraktkostnaden.
• serviceLevelCode: Koden som anger den fraktservicenivå som används i fraktvärderingen.

landedCostWorkFlowInput styr preferenser för landed cost-beräkningen. Se hela schemat i vår GraphQL API-referens. Obligatoriska fält är:

• calculationMethod: Anger er preferens för hur ni planerar att skicka: DDP (förbetalda tullar och skatter) eller DAP (antingen betalas tullar och skatter vid leverans, eller om en remitteringsordning gäller, remitteras de via ett skatte-ID).
  • Om ni använder vår landed cost-garanti ska detta värde alltid vara DDP_PREFERRED, vilket ger en DDP-offert när det är möjligt och en DAP-offert om en DDP-offert inte är tillåten. Att använda DAP i stället kan leda till att landed costs inte längre garanteras, eftersom detta vanligtvis innebär att tullar och skatter betalas vid leverans.
• endUse: Anger om varorna säljs till ett annat företag (FOR_RESALE) eller för slutlig användning hos en konsument (NOT_FOR_RESALE).
• tariffRate: Anger den metod som Zonos ska använda för att beräkna tullsatserna för denna offert, om det finns ett intervall av tullsatser som kan tillämpas. *När ni använder vår landed cost-garanti ska detta alltid vara ZONOS_PREFERRED.

Zonos rekommenderar starkt att använda produktspecifika HS-koder eftersom det leder till en mer korrekt landed cost-offert. Om ni känner till era HS-koder, skicka hsCode för varje item under itemCreateWorkflow.

Om ni skickar en HS-kod validerar Zonos den i realtid när ni hämtar en landed cost-offert. Om den HS-kod ni angav är ogiltig (det vill säga den finns inte) kommer Zonos att omklassificera er artikel i realtid och använda den nya, giltiga HS-koden i stället för den ni angav.

Om ni behöver hjälp att generera HS-koder för era produkter, lär er mer om Zonos Classify och hur ni begär en klassificering.

Om ni inte skickar en hsCode till Zonos kontrollerar vi först Zonos Catalog för att se om ni har en HS-kod lagrad för er artikel. Om ni inte har det anropar vi Classify för att generera en klassificering som driver er landed cost-beräkning baserat på följande produktinformationsfält i itemCreateWorkflow: description, category och material. Om era produktinformationsfält inte är tillräckligt detaljerade för att generera en klassificering baserat på Classifys konfidenspoäng används den standard-HS-kod som tilldelats er butik.

För att låta Zonos beräkna fraktkostnader, använd shipmentRatingCalculateWorkflow. Fraktalternativen som returneras i det beräknade fraktsvaret korrelerar med de serviceLevels ni har tilldelat fraktprofiler i Dashboard.

Felsökning: Om ni förväntar er en serviceLevel i svaret men den inte visas, se till att serviceLevel är aktiverad och stöds av den method ni valde.

Lägg till cartonizeWorkflow (som inte har några indata) om ni vill att Zonos ska sortera era artiklar i kartonger innan fraktkostnaden hittas (används för dimensionell vikt.

Om ni känner till serviceLevel och amount för en sändning kan ni skicka dem i shipmentRatingCreateWorkflow-delen av begäran. Vi använder dessa värden för att beräkna eventuella tillhörande transportörsavgifter och returnerar dem i svaret.