Schakel het afdrukken van etiketten in
Volg de onderstaande stappen zodat uw klanten kunnen ophalen Zonos labels vanaf uw platform.
API-referenties toestaan
De Zonos API is bereikbaar via een credentialToken. Uw platform moet klanten de mogelijkheid bieden om hun credentialTokenvan de Zonos Dashboard in uw platform. Vanaf hier kunt u verzoeken indienen Zonos namens hen.
Maak een zending aan
Voor het ophalen van een label, bent u verplicht een shipmentdat de labelzal worden geassocieerd. Zonos beheert dit proces met een workflow die creëert shipmentsEn labelsin hetzelfde verzoek. Bij het uitvoeren van deze mutatie hoeft u geen a serviceLevelzoals we zullen gebruiken serviceLevelgebruikt van de landedCostdat is gebonden aan de order. Voor de orderId, kunt u gebruik maken van de Zonos bestellings-ID of de accountOrderNumberdat zal waarschijnlijk al in uw systeem aanwezig zijn.
Wanneer een zending en labels met succes zijn aangemaakt, retourneren we labels als een labelImage dat is een BASE64_ENCODED_IMAGE, of als een urlwaar het label vandaan kan worden gehaald.
Gebruik deze workflow wanneer u een verzending voor een bestaande bestelling maakt en de artikel- of feestdetails niet hoeft te wijzigen. Het ondersteunt optionele trackingnummers, fulfilmentcentra, serviceniveauselectie en aangegeven waardeverzekering.
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 documentFilingVariabele opties:
- Met Fulfilment Center: Toevoegen
"fulfillmentCenter": "fulfillment_center_12345"om de herkomstlocatie op te geven - Met aangepaste tracking: Ingesteld
"generateLabel": falseen toevoegen"trackingNumbers": ["tracking_1", "tracking_2"]- Met serviceniveau: Toevoegen"serviceLevel": "dhl.express_example"om een specifieke vervoerderservice te selecteren - Met Aangegeven Waarde Verzekering: Toevoegen
"isDeclaredValue": trueom dekking van de aangegeven waarde mogelijk te maken - Met speciale services: Zie de gids voor speciale services voor batterijen, droogijs, gevaarlijke goederen en handtekeningopties.
Opgegeven waarde
Instellen "isDeclaredValue": true om dekking van de 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 ingediend; handelaars kunnen dit bedrag niet wijzigen. Dit bepaalt de maximale aansprakelijkheid die de vervoerder aanvaardt 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. Voor zendingen die uit meerdere dozen bestaan, moeten verkopers de zending opsplitsen om de dekking per doos aan te geven. UPS genereert ook een aanvullend verzekeringsformulier dat met de labels moet worden afgedrukt.
FedEx en DHL: Verwerk de aangegeven waarde op zendingsniveau zonder aanvullende beperkingen.
Speciale diensten
Gebruik specialServices op een doos om speciale hanteringsvereisten voor batterijen, droogijs, gevaarlijke goederen of handtekeningvereisten aan te geven. Zie de gids voor speciale services voor volledige details en voorbeelden.
ShipStation UPS ontgrendelen: verzendingen uit meerdere delen worden niet ondersteund. Wanneer een bestelling in meerdere dozen wordt verzonden, wordt het referentieveld gedupliceerd, waardoor het matchen van het bestelnummer in de backend mislukt. Verkopers die zendingen uit meerdere stukken nodig hebben, moeten het label aanmaken in de Zonos Dashboardin plaats van. Zendingen in één doos blijven onaangetast.
Een zending annuleren
In het geval dat een klant een shipment, kunt u de volgende mutatie gebruiken die alles ongeldig maakt labelsgebonden aan de shipment.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223" status: VOIDED note: "Voiding shipment" } ) { id status }}
Maak zendingen vanaf uw platform
Geef klanten de mogelijkheid om te creëren Zonos zendingen en labels vanaf uw platform.Deze handleiding is bedoeld voor ontwikkelaars van verzendplatforms die willen integreren Zonos mogelijkheden voor het maken van verzendingen in hun platform voor hun klanten. Als u al gebruik maakt van de Zonos API en hoeft u in plaats daarvan alleen verzendingen voor bestaande bestellingen aan te maken, zie onze handleiding voor het maken van verzendingen.
Als u een verzendplatform bent dat dit ondersteunt Zonos klanten die internationaal verzenden, integreren met Zonos voor het maken van zendingen moet een topoverweging zijn. Hierdoor kunt u uw verkopers en hun klanten de meest naadloze ervaring bieden door gebruik te maken van de bestaande functies van uw platform en tegelijkertijd Zonos beheer het aanmaken van de zending, het etiket en de ondersteunende douanedocumentatie.
Voordelen van het gebruik Zonos om zendingen aan te maken zijn onder meer:
Deze gids leidt u door de stappen om een volledige end-to-end-integratie te implementeren waarmee u kunt bellen Zonos voor zendingen vanaf uw platform.