Labelprinten inschakelen
Volg de onderstaande stappen om uw klanten in staat te stellen Zonos labels vanuit uw platform op te halen.
Sta API-referenties toe
De Zonos API is toegankelijk via een credentialToken. Uw platform moet klanten de mogelijkheid bieden om hun credentialToken van het Zonos Dashboard in uw platform in te voeren. Vanaf hier kunt u namens hen verzoeken indienen bij Zonos.
Creëer een zending
Om een label op te halen, moet u een shipment creëren waarmee het label zal worden geassocieerd. Zonos beheert dit proces met een workflow die shipments en labels in hetzelfde verzoek creëert. Bij het uitvoeren van deze mutatie hoeft u geen serviceLevel door te geven, aangezien wij het serviceLevel gebruiken dat is gekoppeld aan de landedCost die aan de order is verbonden. Voor de orderId kunt u de Zonos order-ID of het accountOrderNumber gebruiken dat waarschijnlijk al in uw systeem staat.
Wanneer een zending en labels succesvol zijn aangemaakt, retourneren wij 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 voor een bestaande bestelling aanmaakt en geen wijzigingen aan item- of partijgegevens hoeft aan te brengen. Het ondersteunt optionele trackingnummers, fulfilmentcentra, selectie van serviceniveaus en verzekering voor opgegeven 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
}
}
Creëer zendingen vanuit uw platform
Geef klanten de mogelijkheid om Zonos zendingen en labels vanuit uw platform te creëren.
Deze gids is ontworpen voor ontwikkelaars van verzendplatforms die de mogelijkheden voor het creëren van Zonos zendingen in hun platform voor hun klanten willen integreren. Als u al gebruikmaakt van de Zonos API en alleen zendingen voor bestaande bestellingen wilt creëren, zie dan onze gids voor het creëren van zendingen.
Als u een verzendplatform bent dat Zonos klanten ondersteunt die internationaal verzenden, moet integratie met Zonos voor het creëren van zendingen een topprioriteit zijn. Dit stelt u in staat om de meest naadloze ervaring voor uw handelaren en hun klanten te bieden door gebruik te maken van de bestaande functies van uw platform, terwijl Zonos het beheer van de creatie van de zending, het label en de ondersteunende douanedocumentatie op zich neemt.
Voordelen van het gebruik van Zonos voor het creëren van zendingen zijn onder andere:
Deze gids leidt u door de stappen om een complete end-to-end integratie te implementeren die u in staat stelt om Zonos voor zendingen vanuit uw platform aan te roepen.