DOCS

Crear un envío

Landed Cost•
InicioPara proveedores de logística Landed Cost Crear un envío

Crear un envío para pedidos existentes

Crea envíos y etiquetas con la API de Zonos después de calcular los costos de entrega y crear pedidos.

GraphQL

Esta guía está diseñada para usuarios que ya están integrados con la API de Zonos y necesitan crear envíos para pedidos existentes en su sistema. Si eres una plataforma de envío y deseas ofrecer la creación de envíos de Zonos a tus clientes, consulta nuestra guía de API de Envío.

Si estás integrado con la API de Zonos y aprobado para enviar fuera del Dashboard, utiliza la mutación shipmentCreateWorkflow para crear envíos y proporcionar información de seguimiento. Estas mutaciones también te permiten informar a Zonos sobre envíos nacionales a instalaciones de cross-docking.

Nota: Si estás utilizando una aplicación de Derechos e Impuestos con una plataforma que sincroniza automáticamente los números de seguimiento con Zonos, o si estás enviando directamente a través del Dashboard, estas mutaciones no son necesarias.

Crear envíos a través de la API 

Después de calcular un Landed Cost y crear un pedido, puedes enviar números de seguimiento y otros detalles del envío a Zonos a través de la API.

Utiliza este flujo de trabajo cuando estés creando un envío para un pedido existente y no necesites modificar los detalles del artículo o de la parte. Soporta números de seguimiento opcionales, centros de cumplimiento, selección de nivel de servicio y seguro de valor declarado.

Mutación

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
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

1
2
3
4
5
6
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789abc"
  }
}

Con Centro de Cumplimiento

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789def",
    "fulfillmentCenter": "fulfillment_center_12345"
  }
}

Con Seguimiento Personalizado

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": false,
    "orderId": "order_12345678-1234-1234-1234-123456789ghi",
    "trackingNumbers": ["tracking_example_1", "tracking_example_2"]
  }
}

Con Nivel de Servicio

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789jkl",
    "serviceLevel": "dhl.express_example"
  }
}

Con seguro de valor declarado

1
2
3
4
5
6
7
{
  "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 

Para cancelar una etiqueta creada, utiliza la siguiente mutación para anular el envío. Cualquier etiqueta asociada también será anulada automáticamente. Ten en cuenta que una vez que un envío es anulado, no se puede actualizar ni restaurar.

Mutación

1
2
3
4
5
6
7
8
9
10
11
12
mutation {
  shipmentStatusUpdate(
    input: {
      shipment: "shipment_12345678-1234-1234-1234-123456789stu"
      status: VOIDED
      note: "Voiding shipment"
    }
  ) {
    id
    status
  }
}

¿Fue útil esta página?

Reservar una demostración

¿Preguntas?

Obtener soporte
© 2025 Zonoszonos.com
En esta página:
  • Crear un envío para pedidos existentes
  • Crear envíos a través de la API
  • Anular un envío