Landed cost berekenen

De partyCreateWorkflowInput identificeert de betrokken partijen en hun locaties. Bekijk het volledige schema in onze GraphQL API referentie. Verplichte velden zijn:

• location
  • administrativeAreaCode: De staat- of provinciecode, in twee letters. Alleen vereist voor CA en BR.
  • countryCode: De tweeletterige ISO-code van het land.
  • line1: De eerste regel van het adres.
  • postalCode: De postcode van het adres.
• person
  • email: Het e-mailadres van de persoon.
  • firstName: De voornaam van de persoon.
  • lastName: De achternaam van de persoon.
  • phone: Het telefoonnummer van de persoon.
• type
  • DESTINATION: De location- en person-informatie voor de verzendbestemming.
  • ORIGIN: De location-informatie voor de verzendoorsprong. De person die aan de verzendoorsprong is gekoppeld, is niet vereist.

De itemCreateWorkflowInput vermeldt de artikelen in de winkelwagen. Er zijn veel optionele velden (zie alle mogelijkheden in onze API-referentie), maar de onderstaande velden zijn verplicht.

• amount: De waarde van één eenheid van het product dat wordt verzonden, vóór vermenigvuldiging met de hoeveelheid. Let op: dit wijkt af van de postale definitie van een postzending. Als de quantity van het artikel 1 is, is dit de totale kostprijs van het artikel. Als de quantity van het artikel groter is dan 1, vermenigvuldigt de API de amount van het artikel met de quantity om het totaal voor de regel te bepalen. Zet niet de totale prijs van alle eenheden van het artikel in amount.
• currencyCode: De valutacode voor het artikelbedrag.
• quantity: De hoeveelheid van het artikel. De API vermenigvuldigt de amount van het artikel met de quantity om het totaal voor de regel te bepalen.
• countryOfOrigin: Het land waar het artikel is vervaardigd.
• Een van de volgende (afhankelijk van uw itemsleutelvoorkeur. Uw itemsleutel koppelt informatie die is opgeslagen in Catalog aan het artikel in de winkelwagen en wordt gebruikt bij het aanmaken van labels.)
  • productId: De product-ID van het artikel.
  • sku: De SKU van het artikel.

De measurements (WEIGHT, LENGTH, WIDTH, HEIGHT) zijn alleen vereist als u uw artikelen wilt cartoniseren bij het ophalen van een shipment rating.

De cartonsCreateWorkflowInput vereist alleen de invoer zelf. Bekijk het volledige schema in onze GraphQL API referentie om alle waarden te zien die kunnen worden doorgegeven. Het is belangrijk om de afmetingen en het gewicht van het karton door te geven als Zonos de verzendkosten berekent.

Deze workflow wordt gebruikt wanneer u de verzendservice en -kosten al kent; als u wilt dat Zonos deze kosten berekent voor services die u hebt ingeschakeld, vervangt u deze workflow door de shipmentRatingCalculateWorkflow.

De shipmentRatingCreateWorkflowInput communiceert de verzendkosten. Bekijk het volledige schema in onze GraphQL API referentie. Verplichte velden zijn:

• amount: De verzendkosten.
• currencyCode: De valutacode van de verzendkosten.
• serviceLevelCode: De code die het servicelevel aangeeft dat in de shipment rating wordt gebruikt.

De landedCostWorkFlowInput bepaalt de voorkeuren voor de landed cost-berekening. Bekijk het volledige schema in onze GraphQL API referentie. Verplichte velden zijn:

• calculationMethod: Geeft uw voorkeur aan voor de manier van verzenden: DDP (vooruitbetaalde invoerrechten en belastingen) of DAP (invoerrechten en belastingen worden bij levering betaald, of — als een remittance-regeling van toepassing is — via een belasting-ID afgedragen).
  • Als u onze landed cost guarantee gebruikt, moet deze waarde altijd DDP_PREFERRED zijn. Dat levert waar mogelijk een DDP-offerte op, en een DAP-offerte wanneer een DDP-offerte niet is toegestaan. Het gebruik van DAP kan er in plaats daarvan voor zorgen dat landed costs niet langer gegarandeerd zijn, omdat dit doorgaans betekent dat invoerrechten en belastingen bij levering worden betaald.
• endUse: Geeft aan of de goederen worden verkocht aan een ander bedrijf (FOR_RESALE) of bedoeld zijn voor eindgebruik door een consument (NOT_FOR_RESALE).
• tariffRate: Geeft de methode aan die Zonos moet gebruiken om de tariefpercentages voor deze offerte te berekenen, in het geval er een bandbreedte van tariefpercentages van toepassing kan zijn. *Bij gebruik van onze landed cost guarantee moet dit altijd ZONOS_PREFERRED zijn.

Zonos raadt sterk aan productspecifieke HS-codes te gebruiken, omdat dit leidt tot een nauwkeurigere landed cost-offerte. Als u uw HS-codes kent, geeft u de hsCode voor elk item door tijdens de itemCreateWorkflow.

Als u een HS-code doorgeeft, valideert Zonos deze meteen bij het opvragen van een landed cost-offerte. Als de door u opgegeven HS-code ongeldig is (dat wil zeggen niet bestaat), zal Zonos uw artikel opnieuw classificeren en de nieuwe, geldige HS-code gebruiken in plaats van de door u opgegeven code.

Als u hulp nodig heeft bij het genereren van HS-codes voor uw producten, lees dan meer over Zonos Classify en hoe u een classificatie aanvraagt.

Als u Zonos geen hsCode doorgeeft, controleren we eerst Zonos Catalog om te zien of u een HS-code voor uw artikel heeft opgeslagen. Zo niet, dan roepen we Classify aan om een classificatie te genereren voor uw landed cost-berekening, op basis van de volgende productdetailvelden van itemCreateWorkflow: description, category en material. Als uw productdetailvelden niet gedetailleerd genoeg zijn om op basis van Classify's confidence scoring een classificatie te genereren, wordt de standaard HS-code van uw account gebruikt.

Om Zonos de verzendkosten te laten berekenen, gebruikt u de shipmentRatingCalculateWorkflow. De verzendopties in het antwoord van de berekende verzending komen overeen met de serviceLevels die u in Dashboard aan verzendprofielen heeft toegewezen.

Problemen oplossen: Als u een serviceLevel in het antwoord verwacht maar deze niet verschijnt, controleer dan of de serviceLevel is ingeschakeld en wordt ondersteund door de method die u heeft geselecteerd.

Voeg de cartonizeWorkflow toe (die geen invoer heeft) als u wilt dat Zonos uw artikelen sorteert in kartons voordat de verzendkosten worden bepaald (gebruikt voor dimensioneel gewicht).

Als u de serviceLevel en amount voor een zending kent, kunt u deze doorgeven in het shipmentRatingCreateWorkflow-gedeelte van het verzoek. Wij gebruiken deze waarden om eventuele bijbehorende vervoerderskosten te berekenen en die in het antwoord terug te geven.