Bereken de logistieke kosten

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

• location
  • administrativeAreaCode: De staats- 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 of zipcode 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 bij de verzendoorsprong hoort, 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 poststuk. Als de quantity van het artikel 1 is, is dit de totale kostprijs van het artikel. Als de quantity groter is dan 1, vermenigvuldigt de API de amount met de quantity om het totaal voor de regel te krijgen. Zet niet de totale prijs van alle eenheden in amount.
• currencyCode: De valutacode voor het artikelbedrag.
• quantity: De hoeveelheid van het artikel. De API vermenigvuldigt de amount met de quantity om het totaal voor de regel te krijgen.
• countryOfOrigin: Het land waar het artikel is vervaardigd.
• Een van de volgende (welke is ingesteld als uw itemsleutelvoorkeur. Uw itemsleutel koppelt informatie uit Catalog aan het artikel in de winkelwagen en wordt gebruikt bij het maken 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 kartoniseren bij het ophalen van een verzendtarief.

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 de doos 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 verzendserviceniveau aangeeft dat in de verzendbeoordeling 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 hoe u wilt verzenden: DDP (vooruitbetaalde invoerrechten en belastingen) of DAP (invoerrechten en belastingen worden bij levering betaald, of via een remittance-regeling met een belasting-ID).
  • Als u onze landed cost-garantie gebruikt, moet deze waarde altijd DDP_PREFERRED zijn, wat waar mogelijk een DDP-offerte geeft en een DAP-offerte wanneer DDP niet is toegestaan. Het gebruik van DAP kan ertoe leiden 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 aan een ander bedrijf worden verkocht (FOR_RESALE) of voor eindgebruik door een consument (NOT_FOR_RESALE).
• tariffRate: Geeft de methode aan die Zonos moet gebruiken om de tarieven voor deze offerte te berekenen wanneer er een reeks tarieven van toepassing kan zijn. *Bij gebruik van onze landed cost-garantie moet dit altijd ZONOS_PREFERRED zijn.

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

Als u een HS-code doorgeeft, valideert Zonos deze onmiddellijk bij het ophalen van een landed cost-offerte. Als de 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 meer over Zonos Classify en hoe u een classificatie aanvraagt.

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

Om Zonos de verzendkosten te laten berekenen, gebruikt u de shipmentRatingCalculateWorkflow. De verzendopties in de berekende verzendrespons komen overeen met de serviceLevels die u aan verzendprofielen in Dashboard hebt toegewezen.

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

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