Labelafdruk mogelijk maken
Volg de onderstaande stappen zodat uw klanten labels van Zonos via uw platform kunnen ophalen.
API-gegevens toestaan
De Zonos API is toegankelijk via een credentialToken. Uw platform moet klanten de mogelijkheid geven om hun credentialToken vanaf het Zonos Dashboard in uw platform in te voeren. Vanaf hier kunt u namens hen verzoeken doen aan Zonos.
Verzendingen aanmaken
Om een label op te halen, moet u een shipment aanmaken waaraan het label zal worden gekoppeld. Zonos beheert dit proces met een workflow die shipments en labels in hetzelfde verzoek aanmaakt. Wanneer u deze mutatie uitvoert, hoeft u geen serviceLevel door te geven, omdat wij het serviceLevel gebruiken dat is afgeleid van de landedCost die aan de order is gekoppeld. Voor de orderId kunt u de Zonos order-ID gebruiken of de accountOrderNumber die waarschijnlijk al in uw systeem aanwezig is.
Wanneer een verzending en labels succesvol zijn aangemaakt, retourneren we labels als een labelImage, wat een BASE64_ENCODED_IMAGE is, of als een url waarvanuit het label kan worden opgehaald.
Gebruik deze workflow wanneer u een verzending aanmaakt voor een bestaande bestelling en geen wijzigingen hoeft aan te brengen aan item- of partijgegevens. Het ondersteunt optionele volgnummers, fulfilmentcentra, selectie van serviceniveau en verzekerde waarde.
Mutatie
mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {
shipmentCreateWorkflow(input: $input) {
id
status
trackingDetails {
number
}
serviceLevel {
id
name
carrier {
id
name
}
}
shipmentCartons {
id
carton {
id
width
length
height
weight
items {
item {
id
amount
description
}
}
}
label {
url
trackingNumber
id
documentFiling
}
}
}
}
Basisvariabelen
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789abc"
}
}
Met Fulfillment Center
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789def",
"fulfillmentCenter": "fulfillment_center_12345"
}
}
Met Aangepaste Tracking
{
"input": {
"generateLabel": false,
"orderId": "order_12345678-1234-1234-1234-123456789ghi",
"trackingNumbers": ["tracking_example_1", "tracking_example_2"]
}
}
Met Serviceniveau
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789jkl",
"serviceLevel": "dhl.express_example"
}
}
Met verklaarde waarde verzekering
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789mno",
"isDeclaredValue": true
}
}
Verklaarde waarde
Stel "isDeclaredValue": true in om dekking voor de verklaarde waarde voor alle artikelen in uw zending in te schakelen. Zonos claimt automatisch de volledige waarde van alle artikelen die in de bestelling zijn ingediend; handelaren kunnen dit bedrag niet wijzigen. Dit stelt de maximale aansprakelijkheid in 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 behandelt automatisch de vervoerdersspecifieke implementatie wanneer u de verklaarde waarde inschakelt, inclusief de juiste parameters in onze API-aanroepen naar deze vervoerders, zodat u geen verschillende vereisten van vervoerders hoeft te beheren.
UPS-beperkingen: UPS dekt alleen waarden tussen 100-50.000 USD en verwerkt de verklaarde waarde op het niveau van de doos. Voor zendingen met meerdere dozen moeten handelaren de zending splitsen om dekking per doos aan te geven. UPS genereert ook een extra verzekeringsformulier dat met de labels moet worden afgedrukt.
FedEx en DHL: Verwerken de verklaarde waarde op het niveau van de zending zonder aanvullende beperkingen.
Annuleer een zending
In het geval dat een klant een zending wil annuleren, kunt u de volgende mutatie gebruiken die alle labels die aan de zending zijn gekoppeld, annuleert.
Verzoek
mutation {
shipmentStatusUpdate(
input: {
shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"
status: VOIDED
note: "Voiding shipment"
}
) {
id
status
}
}
Verpakkingszendingen vanuit uw platform aanmaken
Geef klanten de mogelijkheid om Zonos-zendingen en labels vanuit uw platform aan te maken.
Deze gids is ontworpen voor ontwikkelaars van verzendplatforms die de Zonos-verzendingcreatie-mogelijkheden willen integreren in hun platform voor hun klanten. Als u al de Zonos API gebruikt en slechts zendingen voor bestaande bestellingen hoeft aan te maken, bekijk dan onze handleiding voor zendingcreatie.
Als u een verzendplatform bent dat Zonos-klanten ondersteunt die internationaal verzenden, zou integratie met Zonos voor verzendingcreatie een belangrijke overweging moeten zijn. Dit stelt u in staat om uw handelaren en hun klanten de meest naadloze ervaring te bieden door gebruik te maken van de bestaande functies van uw platform, terwijl Zonos het aanmaken van de verzending, het label en de ondersteunende douanedocumentatie beheert.
Voordelen van het gebruik van Zonos om zendingen aan te maken zijn:
Deze gids leidt u stap voor stap door de implementatie van een volledige end-to-end integratie die het mogelijk maakt om Zonos aan te roepen voor zendingen vanaf uw platform.