Crear envíos mediante la API
Después de calcular un Landed Cost y crear un pedido, puede enviar números de seguimiento y otros detalles del envío a Zonos a través de la API.
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 documentFiling } } }}Opciones 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
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,01 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 (UPS Control Log) que debe imprimirse con las etiquetas para valores declarados superiores a 999 USD.
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.
Anular un envío
Para cancelar una etiqueta creada, use la siguiente mutación para anular el envío. Las etiquetas asociadas también se anularán automáticamente. Tenga en cuenta que una vez anulado un envío, no se puede actualizar ni restaurar.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_12345678-1234-1234-1234-123456789stu" status: VOIDED note: "Voiding shipment" } ) { id status }}
Crear un envío para pedidos existentes
Cree envíos y etiquetas con la API de Zonos después de calcular landed costs y crear pedidos.
GraphQL
Esta guía está diseñada para usuarios ya integrados con la API de Zonos que necesitan crear envíos para pedidos existentes en su sistema. Si es una plataforma de envío y desea ofrecer la creación de envíos de Zonos a sus clientes, consulte nuestra guía de la API de envíos.
Si está integrado con la API de Zonos y tiene aprobación para enviar fuera de Dashboard, use la mutación
shipmentCreateWorkflowpara crear envíos y proporcionar información de seguimiento. Estas mutaciones también le permiten informar a Zonos sobre envíos nacionales a centros de cross-docking.Nota: Si utiliza una aplicación de aranceles e impuestos con una plataforma que sincroniza automáticamente los números de seguimiento con Zonos, o si envía directamente a través de Dashboard, estas mutaciones no son necesarias.