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á permitir que los clientes ingresen su credentialToken desde Zonos Dashboard en su plataforma. A partir de ahí, podrá realizar solicitudes a Zonos en su nombre.
Crear un envío
Para recuperar una label, debe crear un shipment al 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 del landedCost 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 las etiquetas se crean correctamente, devolveremos las etiquetas como labelImage, que es una BASE64_ENCODED_IMAGE, o como una url desde la que se puede obtener la etiqueta.
Utilice este flujo de trabajo cuando cree un envío para un pedido existente y no necesite modificar los detalles de artículos o partes. Admite números de seguimiento opcionales, centros de fulfillment, selección de nivel de servicio y seguro de valor declarado.
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 documentFilingOpciones de variables:
- Con centro de fulfillment: Agregue
"fulfillmentCenter": "fulfillment_center_12345"para especificar la ubicación de origen - Con seguimiento personalizado: Establezca
"generateLabel": falsey agregue"trackingNumbers": ["tracking_1", "tracking_2"] - Con nivel de servicio: Agregue
"serviceLevel": "dhl.express_example"para seleccionar un servicio de transportista específico - Con seguro de valor declarado: Agregue
"isDeclaredValue": truepara habilitar la cobertura de valor declarado - Con servicios especiales: Consulte la guía de servicios especiales para baterías, hielo seco, mercancías peligrosas y opciones de firma.
Valor declarado
Establezca "isDeclaredValue": true para habilitar la cobertura de valor declarado para todos los artículos de su envío. Zonos reclama automáticamente el valor total de todos los artículos enviados en el pedido; los comerciantes no pueden modificar este monto. 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 gestiona automáticamente la implementación específica del transportista cuando habilita el valor declarado, incluidos los parámetros apropiados en nuestras llamadas a la API a estos transportistas, por lo que no necesita gestionar distintos requisitos de transportistas.
Limitaciones de UPS: UPS solo cubre valores entre 100 y 50.000 USD y procesa el valor declarado a nivel de cartón. Para envíos de varios 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.
Servicios especiales
Utilice specialServices en un cartón para indicar requisitos de manipulación especial para baterías, hielo seco, mercancías peligrosas o requisitos de firma. Consulte la guía de servicios especiales para obtener detalles y ejemplos completos.
ShipStation UPS Unlock: No se admiten envíos multipieza. Cuando un pedido se envía en varias cajas, el campo de referencia se duplica, lo que provoca que la coincidencia del número de pedido falle en el backend. Los comerciantes que necesiten envíos multipieza deben crear la etiqueta en Zonos Dashboard en su lugar. Los envíos de una sola caja no se ven afectados.
Anular un envío
En caso de que un cliente desee anular un shipment, puede usar la siguiente mutación que anulará todas las labels vinculadas al shipment.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223" status: VOIDED note: "Voiding shipment" } ) { id status }}
Crear envíos desde su plataforma
Ofrezca a sus clientes la posibilidad 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 utiliza la API de Zonos y solo necesita crear envíos para pedidos existentes, consulte nuestra guía de creación de envíos.
Si es una plataforma de envío que admite a clientes de Zonos que envían internacionalmente, integrarse con Zonos para la creación de envíos debería ser una consideración prioritaria. Esto le permitirá ofrecer la experiencia más fluida para sus comerciantes y sus clientes, aprovechando las funciones existentes de su plataforma mientras Zonos gestiona la creación del envío, la etiqueta y la documentación aduanera de respaldo.
Las ventajas de usar Zonos para crear envíos incluyen:
Esta guía le guiará por los pasos para implementar una integración completa de extremo a extremo que le permitirá solicitar envíos a Zonos desde su plataforma.