DOCS
Landed Cost•
StartpaginaVoor logistieke dienstverleners Landed Cost Zending aanmaken

Zending aanmaken voor bestaande orders

Maak zendingen en labels met de Zonos API na landed cost-berekening en ordercreatie.

GraphQL

Deze handleiding is bedoeld voor gebruikers die al zijn geïntegreerd met de Zonos API en zendingen willen aanmaken voor bestaande orders in hun systeem. Ben je een verzendplatform en wil je in plaats daarvan het aanmaken van Zonos-zendingen aan je klanten aanbieden, raadpleeg dan onze Shipment API-handleiding.

Als je bent geïntegreerd met de Zonos API en goedgekeurd bent om buiten Dashboard te verzenden, gebruik dan de shipmentCreateWorkflow-mutation om zendingen aan te maken en trackinginformatie te verstrekken. Met deze mutations kun je Zonos ook informeren over binnenlandse zendingen naar cross-docking faciliteiten.

Opmerking: Als je een Duty and Tax-app gebruikt met een platform dat trackingnummers automatisch synchroniseert met Zonos, of als je rechtstreeks via Dashboard verzendt, zijn deze mutations niet vereist.

Zendingen aanmaken via API 

Na het berekenen van een Landed Cost en het aanmaken van een order kun je trackingnummers en andere zendingsgegevens via de API naar Zonos verzenden.

Gebruik deze workflow wanneer je een zending aanmaakt voor een bestaande order en de gegevens van items of partijen niet hoeft te wijzigen. Deze ondersteunt optionele trackingnummers, fulfillment centers, het selecteren van een servicelevel en verzekering met aangegeven waarde.

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
29 }
30 }
31 }
32 label {
33 url
34 trackingNumber
35 id
36 documentFiling
37 }
38 }
39 }
40}

Variabele opties:

  • Met fulfillment center: Voeg "fulfillmentCenter": "fulfillment_center_12345" toe om de herkomstlocatie op te geven
  • Met aangepaste tracking: Stel "generateLabel": false in en voeg "trackingNumbers": ["tracking_1", "tracking_2"] toe
  • Met servicelevel: Voeg "serviceLevel": "dhl.express_example" toe om een specifieke vervoerdersservice te selecteren
  • Met verzekering voor aangegeven waarde: Voeg "isDeclaredValue": true toe om dekking voor aangegeven waarde in te schakelen

Aangegeven waarde

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

UPS-beperkingen: UPS dekt alleen waarden tussen 100,01 en 50.000 USD en verwerkt aangegeven waarde op cartonniveau. Bij zendingen met meerdere cartons moeten merchants de zending splitsen om per carton dekking toe te wijzen. UPS genereert ook een extra verzekeringsformulier (UPS Control Log) dat samen met de labels moet worden afgedrukt voor aangegeven waarden boven 999 USD.

FedEx en DHL: Verwerken aangegeven waarde op zendingniveau, zonder verdere beperkingen.

Speciale diensten

Gebruik specialServices op een carton om speciale behandelingsvereisten aan te geven voor batterijen, droogijs, gevaarlijke goederen of handtekeningvereisten. Zie de handleiding voor speciale diensten voor volledige details en voorbeelden.

Een zending annuleren 

Gebruik de volgende mutation om een aangemaakt label te annuleren en zo de zending te annuleren. Bijbehorende labels worden hierbij automatisch ook geannuleerd. Houd er rekening mee dat een zending die eenmaal is geannuleerd, niet meer kan worden bijgewerkt of hersteld.

1mutation {
2 shipmentStatusUpdate(
3 input: {
4 shipment: "shipment_12345678-1234-1234-1234-123456789stu"
5 status: VOIDED
6 note: "Voiding shipment"
7 }
8 ) {
9 id
10 status
11 }
12}
GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput

MUTATIONS

cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate

Was deze pagina nuttig?

Krijg ondersteuning·Juridische documenten·© 2026 Zonos
Op deze pagina:
  • Zending aanmaken voor bestaande orders
  • Zendingen aanmaken via API
  • Een zending annuleren