Landed Cost•

StartpaginaVoor logistieke dienstverleners Landed Cost Verzendintegratie voor platforms

Zendingen aanmaken vanuit uw platform

Geef klanten de mogelijkheid om Zonos-zendingen en -labels vanuit uw platform aan te maken.

Deze handleiding is bedoeld voor ontwikkelaars van verzendplatforms die de mogelijkheden van Zonos voor het aanmaken van zendingen in hun platform willen integreren voor hun klanten. Gebruikt u de Zonos API al en wilt u alleen zendingen aanmaken voor bestaande bestellingen, raadpleeg dan onze handleiding voor het aanmaken van een zending.

Als u een verzendplatform bent dat Zonos-klanten ondersteunt bij internationaal verzenden, moet integratie met Zonos voor het aanmaken van zendingen een topprioriteit zijn. Hierdoor kunt u uw handelaars en hun klanten de meest naadloze ervaring bieden door gebruik te maken van de bestaande functies van uw platform, terwijl Zonos het aanmaken van de zending, het label en de bijbehorende douanedocumentatie beheert.

Voordelen van het gebruik van Zonos voor het aanmaken van zendingen zijn onder meer:

Facturering van invoerrechten en belastingen door derden - Wij zorgen ervoor dat uw of het rekeningnummer van de vervoerder van uw handelaar wordt gebruikt voor de verzendkosten, terwijl de facturen voor invoerrechten en belastingen naar Zonos gaan.
Flexibiliteit - In plaats van ontwikkelwerk te verrichten om ervoor te zorgen dat u compliant labels met uw platform kunt genereren, integreert u met onze API en laat u de voortdurend veranderende grensoverschrijdende compliance aan ons over.
Nauwkeurige douanedocumentatie - Wanneer u Zonos gebruikt om labels te genereren, zorgen wij ervoor dat de juiste gegevens aan de vervoerder worden doorgegeven, zodat het pakket snel door de douane komt.

Deze handleiding begeleidt u door de stappen om een volledige end-to-end-integratie te implementeren waarmee u Zonos vanuit uw platform kunt aanroepen voor zendingen.

Labels afdrukken inschakelen

Volg de onderstaande stappen zodat uw klanten Zonos-labels vanuit uw platform kunnen ophalen.

API-inloggegevens toestaan

Een zending aanmaken

Om een label op te halen, moet u een shipment aanmaken waarmee het label wordt geassocieerd. Zonos beheert dit proces met een workflow die in één verzoek zowel shipments als labels aanmaakt. Bij het uitvoeren van deze mutatie hoeft u geen serviceLevel door te geven, omdat wij de serviceLevel gebruiken die is vastgelegd in de landedCost die aan de order is gekoppeld. Voor de orderId kunt u de Zonos-bestelling-ID of het accountOrderNumber gebruiken, dat waarschijnlijk al in uw systeem aanwezig is.

Wanneer een zending en labels succesvol zijn aangemaakt, retourneren wij de labels als een labelImage, wat een BASE64_ENCODED_IMAGE is, of als een url waar het label kan worden opgehaald.

Gebruik deze workflow wanneer u een zending aanmaakt voor een bestaande bestelling en geen artikel- of partijgegevens hoeft te wijzigen. Deze ondersteunt optionele trackingnummers, fulfilmentcentra, selectie van serviceniveau en verzekering voor aangegeven waarde.

Shopify-handelaars

Shopify geeft een nulwaarde door voor person in de partij van herkomst. Als gevolg hiervan werkt orderId alleen niet voor Shopify-handelaars — gebruik in plaats daarvan het tabblad Geavanceerde zending aanmaken en geef volledige partijgegevens op, inclusief person.

1mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {

2 shipmentCreateWorkflow(input: $input) {

3 id

4 status

5 trackingDetails {

6 number

7 }

8 serviceLevel {

9 id

10 name

11 carrier {

12 id

13 name

14 }

15 }

16 shipmentCartons {

17 id

18 carton {

19 id

20 width

21 length

22 height

23 weight

24 items

25 item

26 id

27 amount

28 description

32 label

33 url

34 trackingNumber

35 id

36 documentFiling

Variabele opties:

Met fulfilmentcentrum: Voeg "fulfillmentCenter": "fulfillment_center_12345" toe om de locatie van herkomst op te geven
Met aangepaste tracking: Stel "generateLabel": false in en voeg "trackingNumbers": ["tracking_1", "tracking_2"] toe
Met serviceniveau: Voeg "serviceLevel": "dhl.express_example" toe om een specifieke vervoerderservice te selecteren
Met verzekering voor aangegeven waarde: Voeg "isDeclaredValue": true toe om dekking voor aangegeven waarde in te schakelen
Met speciale diensten: Raadpleeg de handleiding voor speciale diensten voor batterijen, droogijs, gevaarlijke stoffen en handtekeningopties.

Aangegeven waarde

Stel "isDeclaredValue": true in om dekking voor aangegeven waarde in te schakelen voor alle artikelen in uw zending. Zonos claimt automatisch de volledige waarde van alle artikelen die in de bestelling zijn opgegeven; handelaars kunnen dit bedrag niet wijzigen. Dit bepaalt de maximale aansprakelijkheid die de vervoerder accepteert in geval van verlies, schade of diefstal tijdens het transport. Deze functie wordt alleen ondersteund voor UPS-, FedEx- en DHL-zendingen. Zonos verwerkt automatisch de vervoerderspecifieke implementatie wanneer u de aangegeven waarde inschakelt, inclusief de juiste parameters in onze API-aanroepen naar deze vervoerders, zodat u geen verschillende vervoerdervereisten hoeft te beheren.

UPS-beperkingen: UPS dekt alleen waarden tussen 100 en 50.000 USD en verwerkt de aangegeven waarde op doosniveau. Bij zendingen met meerdere dozen moeten handelaars de zending opsplitsen om de dekking per doos aan te geven. UPS genereert ook een extra verzekeringsformulier dat samen met de labels moet worden afgedrukt.

FedEx en DHL: Verwerken de aangegeven waarde op zendingsniveau, zonder extra beperkingen.

Speciale diensten

Gebruik specialServices op een doos om speciale hanteringsvereisten aan te geven voor batterijen, droogijs, gevaarlijke stoffen of handtekeningvereisten. Raadpleeg de handleiding voor speciale diensten voor volledige details en voorbeelden.

ShipStation UPS Unlock: Zendingen met meerdere dozen worden niet ondersteund. Wanneer een bestelling in meerdere dozen wordt verzonden, wordt het referentieveld gedupliceerd, waardoor het matchen van bestelnummers op de backend mislukt. Handelaars die zendingen met meerdere dozen nodig hebben, moeten het label in plaats daarvan aanmaken in het Zonos Dashboard. Zendingen met één doos worden hierdoor niet beïnvloed.

Een zending annuleren

GraphQL API ReferenceTypes, inputs, and operations used in this guide

INPUTS

CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput

MUTATIONS

cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate

Boek een demo

Zendingen aanmaken vanuit uw platform

Labels afdrukken inschakelen

API-inloggegevens toestaan

Een zending aanmaken

Een zending annuleren

Was deze pagina nuttig?