Habilitar la impresión de etiquetas
Siga los pasos a continuación para permitir que sus clientes recuperen etiquetas de Zonos desde su plataforma.
Permitir credenciales de API
La API de Zonos es accesible mediante un credentialToken. Su plataforma deberá dar a los clientes la capacidad de ingresar su credentialToken desde el Tablero de Zonos en su plataforma. Desde aquí, podrá hacer solicitudes a Zonos en su nombre.
Crear un envío
Para recuperar una label, se requiere crear un shipment con el que se asociará la label. Zonos gestiona este proceso con un flujo de trabajo que crea shipments y labels en la misma solicitud. Al realizar esta mutación, no necesita pasar un serviceLevel ya que utilizaremos el serviceLevel utilizado del landedCost que está vinculado al order. Para el orderId, puede usar el ID de pedido de Zonos o el accountOrderNumber que probablemente ya esté en su sistema.
Cuando un envío y etiquetas se crean con éxito, devolveremos etiquetas como una labelImage que es una BASE64_ENCODED_IMAGE, o como una url desde donde se puede obtener la etiqueta.
Utilice este flujo de trabajo cuando esté creando un envío para un pedido existente y no necesite modificar los detalles del artículo o de la parte. Admite números de seguimiento opcionales, centros de cumplimiento, selección de nivel de servicio y seguro de valor declarado.
Mutación
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
}
}
}
}
Variables Básicas
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789abc"
}
}
Con Centro de Cumplimiento
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789def",
"fulfillmentCenter": "fulfillment_center_12345"
}
}
Con Seguimiento Personalizado
{
"input": {
"generateLabel": false,
"orderId": "order_12345678-1234-1234-1234-123456789ghi",
"trackingNumbers": ["tracking_example_1", "tracking_example_2"]
}
}
Con Nivel de Servicio
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789jkl",
"serviceLevel": "dhl.express_example"
}
}
Con seguro de valor declarado
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789mno",
"isDeclaredValue": true
}
}
Valor declarado
Establezca "isDeclaredValue": true para habilitar la cobertura de valor declarado para todos los artículos en su envío. Zonos reclama automáticamente el valor total de todos los artículos enviados en el pedido; los comerciantes no pueden modificar esta cantidad. Esto establece la responsabilidad máxima que el transportista aceptará en caso de pérdida, daño o robo durante el tránsito. Esta función solo es compatible con envíos de UPS, FedEx y DHL. Zonos maneja automáticamente la implementación específica del transportista cuando habilita el valor declarado, incluyendo los parámetros apropiados en nuestras llamadas API a estos transportistas, por lo que no necesita gestionar diferentes requisitos de transportistas.
Limitaciones de UPS: UPS solo cubre valores entre 100-50,000 USD y procesa el valor declarado a nivel de cartón. Para envíos de múltiples cartones, los comerciantes deben dividir el envío para designar la cobertura por cartón. UPS también genera un formulario de seguro adicional que debe imprimirse con las etiquetas.
FedEx y DHL: Procesan el valor declarado a nivel de envío sin restricciones adicionales.
Anular un envío
En el caso de que un cliente desee anular un envío, puede utilizar la siguiente mutación que anulará todas las etiquetas vinculadas al envío.
Solicitud
mutation {
shipmentStatusUpdate(
input: {
shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"
status: VOIDED
note: "Voiding shipment"
}
) {
id
status
}
}
Cree envíos desde su plataforma
Brinde a los clientes la capacidad de crear envíos y etiquetas de Zonos desde su plataforma.
Esta guía está diseñada para desarrolladores de plataformas de envío que desean integrar las capacidades de creación de envíos de Zonos en su plataforma para sus clientes. Si ya está utilizando la API de Zonos y solo necesita crear envíos para pedidos existentes, consulte nuestra guía de creación de envíos.
Si usted es una plataforma de envío que apoya a los clientes de Zonos que envían internacionalmente, integrar con Zonos para la creación de envíos debería ser una consideración principal. Esto le permitirá ofrecer la experiencia más fluida para sus comerciantes y sus clientes aprovechando las características existentes de su plataforma mientras deja que Zonos gestione la creación del envío, la etiqueta y la documentación aduanera de apoyo.
Las ventajas de usar Zonos para crear envíos incluyen:
Esta guía lo guiará a través de los pasos para implementar una integración completa de extremo a extremo que le permitirá llamar a Zonos para envíos desde su plataforma.