Ver envíos y tracking

Conoce los recursos de API para listar y buscar envíos, y ver sus detalles.

Los endpoints de búsqueda y obtención de envíos y tracking utilizan rate limiting 🟡Bajo Ver más sobre límites de requests

Listar envíos

get

https://api.zipnova.com.ar/v2https://api.zipnova.cl/v2https://api.zipnova.com.mx/v2

/shipments

Obtiene un listado paginado de envíos ordenados por fecha de creación descendente. Por defecto retorna los envíos de los últimos 30 días. Cada página contiene hasta 20 resultados.

Autorizaciones

basicAuthbearerAuth

AuthorizationstringRequerido

Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña

Parámetros de consulta

account_idintegerOpcional

Filtrar por ID de cuenta. Solo pueden consultar cuentas a las que tienen acceso.

Example: 7

carrier_idintegerOpcional

Filtrar por ID de transportista

Example: 3

external_idstringOpcional

Filtrar por ID externo del envío (búsqueda exacta)

Example: ORDER-9821

service_typestringOpcional

Filtrar por código de tipo de servicio (e.g. standard_delivery, pickup_point)

Example: standard_delivery

statusstringOpcional

Filtrar por código de estado (e.g. new, shipped, delivered, cancelled)

Example: delivered

order_idstringOpcional

Filtrar por ID de pedido del canal de venta (e.g. número de orden de MercadoLibre o Shopify)

Example: 2000009876543210

parent_shipment_idintegerOpcional

Filtrar envíos relacionados (devoluciones o reenvíos) a partir del ID del envío padre

Example: 1040

origin_idintegerOpcional

Filtrar por ID del origen en el catálogo de direcciones (address id)

Example: 12

fromstring · dateOpcional

Fecha de inicio del rango de creación (YYYY-MM-DD). Por defecto: 30 días atrás.

Example: 2024-08-01

tostring · dateOpcional

Fecha de fin del rango de creación (YYYY-MM-DD, inclusive)

Example: 2024-08-31

Respuestas

200

Lista paginada de envíos

application/json

get

/shipments

HTTPcURLJavaScriptPython

GET /v2/shipments HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Accept: */*

200

Lista paginada de envíos

{
  "data": [
    {
      "id": 1042,
      "external_id": "ORDER-9821",
      "delivery_id": "R-00012345",
      "created_at": "2024-08-15T10:30:00+0000",
      "account_id": 7,
      "parent_shipment_id": 1040,
      "carrier_id": 3,
      "service_type": "standard",
      "status": "delivered",
      "status_name": "Entregado",
      "tracking": "https://app.zipnova.com/tracking/1042",
      "tracking_external": "https://carrier.com/track?id=ABC123",
      "destination": {
        "name": "Juan Pérez",
        "city": "Buenos Aires",
        "state": "Buenos Aires",
        "zipcode": "1043"
      },
      "origin": {
        "id": 12,
        "name": "Depósito Central",
        "city": "Córdoba",
        "state": "Córdoba",
        "zipcode": "5000"
      },
      "declared_value": 1500,
      "price": 320.5,
      "price_incl_tax": 387.8,
      "total_weight": 1200,
      "total_volume": 8000,
      "total_packages": 2
    }
  ],
  "links": {
    "first": "https://api.zipnova.com/v2/shipments?page=1",
    "last": "https://api.zipnova.com/v2/shipments?page=5",
    "prev": null,
    "next": "https://api.zipnova.com/v2/shipments?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 5,
    "per_page": 20,
    "to": 20,
    "total": 98
  }
}

Obtener envío

get

https://api.zipnova.com.ar/v2https://api.zipnova.cl/v2https://api.zipnova.com.mx/v2

/shipments/{shipment}

Obtiene el detalle completo de un envío específico, incluyendo paquetes, ítems, destino, origen, tiempos de entrega y envíos relacionados.

Autorizaciones

basicAuthbearerAuth

AuthorizationstringRequerido

Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña

Parámetros de ruta

shipmentintegerRequerido

ID del envío

Example: 1042

Respuestas

200

Detalle del envío

application/json

idintegerOpcional

ID único del envío

Example: 1042

external_idstring · nullableOpcional

Identificador externo del envío (e.g. número de orden del cliente)

Example: ORDER-9821

delivery_idstring · nullableOpcional

Número de remito asignado por el transportista

Example: R-00012345

carrier_tracking_idstring · nullableOpcional

Identificador de seguimiento público del transportista

Example: TRACKING-ABC123

carrier_tracking_id_altstring · nullableOpcional

Identificador de seguimiento alternativo del transportista

Example: TRACKING-XYZ456

created_atstring · date-timeOpcional

Fecha y hora de creación del envío (ISO 8601)

Example: 2024-08-15T10:30:00+00:00

account_idintegerOpcional

ID de la cuenta propietaria del envío

Example: 7

parent_shipment_idinteger · nullableOpcional

ID del envío padre. Presente cuando este envío es una devolución o reenvío

Example: 1040

logistic_typestringOpcional

Tipo de logística del envío (e.g. crossdock, carrier_dropoff, xd_dropoff, self_service)

Example: crossdock

service_typestringOpcional

Código del tipo de servicio (e.g. standard, express, pickup_point)

Example: standard

statusstringOpcional

Código de estado actual del envío (e.g. new, in_transit, delivered)

Example: in_transit

status_namestringOpcional

Nombre legible del estado actual

Example: En camino

trackingstring · nullableOpcional

URL de seguimiento público del envío en la plataforma

Example: https://app.zipnova.com/tracking/1042

tracking_externalstring · nullableOpcional

URL de seguimiento en el sitio web del transportista

Example: https://carrier.com/track?id=ABC123

return_instructionsstring · nullableOpcional

URL con instrucciones de devolución. Solo presente en envíos de tipo reverse logistics

Example: https://app.zipnova.com/return/abc123xyz

declared_valuenumber · floatOpcional

Valor declarado del contenido del envío en la moneda local

Example: 1500

pricenumber · floatOpcional

Costo del envío sin impuestos

Example: 320.5

price_incl_taxnumber · floatOpcional

Costo del envío con impuestos incluidos

Example: 387.8

total_weightintegerOpcional

Peso total del envío en gramos

Example: 1200

total_volumeintegerOpcional

Volumen total del envío en centímetros cúbicos (cm³)

Example: 8000

tagsstring[]Opcional

Etiquetas asociadas al envío

sourcestring · nullableOpcional

Fuente u origen de creación del envío (e.g. nombre del canal o integración)

Example: shopify

403

Sin acceso a este envío

404

Envío no encontrado

get

/shipments/{shipment}

HTTPcURLJavaScriptPython

GET /v2/shipments/{shipment} HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Accept: */*

{
  "id": 1042,
  "external_id": "ORDER-9821",
  "delivery_id": "R-00012345",
  "carrier_tracking_id": "TRACKING-ABC123",
  "carrier_tracking_id_alt": "TRACKING-XYZ456",
  "created_at": "2024-08-15T10:30:00+00:00",
  "delivery_time": {
    "estimated_delivery": "2024-08-18T23:59:59+00:00",
    "dropoff_deadline_at": "2024-08-16T15:00:00+00:00",
    "times": {
      "preparation": "P2D",
      "crossdocking": "P1D",
      "carrier": "P5D",
      "total": "P8D"
    }
  },
  "account_id": 7,
  "parent_shipment_id": 1040,
  "logistic_type": "crossdock",
  "service_type": "standard",
  "carrier": {
    "id": 3,
    "name": "Andreani",
    "logo": "https://cdn.zipnova.com/carriers/andreani.png"
  },
  "status": "in_transit",
  "status_name": "En camino",
  "tracking": "https://app.zipnova.com/tracking/1042",
  "tracking_external": "https://carrier.com/track?id=ABC123",
  "return_instructions": "https://app.zipnova.com/return/abc123xyz",
  "destination": {
    "name": "Juan Pérez",
    "document": "20-12345678-5",
    "street": "Av. Corrientes",
    "street_number": "1234",
    "street_extras": "Piso 3, Dto B",
    "city": "Buenos Aires",
    "state": "Buenos Aires",
    "zipcode": "C1043",
    "phone": "[phone]",
    "email": "[email protected]",
    "pickup_point": {
      "id": 55,
      "name": "Sucursal Palermo",
      "geolocation": {
        "lat": -34.5907,
        "lng": -58.4239
      }
    }
  },
  "origin": {
    "id": 12,
    "name": "Depósito Central",
    "document": "30-71234567-0",
    "street": "Av. San Martín",
    "street_number": "500",
    "street_extras": null,
    "city": "Córdoba",
    "state": "Córdoba",
    "zipcode": "X5000",
    "phone": "[phone]",
    "email": "[email protected]",
    "is_dropshipping": false,
    "supplier": {
      "name": "Proveedor XYZ"
    }
  },
  "declared_value": 1500,
  "price": 320.5,
  "price_incl_tax": 387.8,
  "total_weight": 1200,
  "total_volume": 8000,
  "packages": [
    {
      "id": 2001,
      "label_code": "LP-00099",
      "sku_id": null,
      "weight": 1200,
      "height": 200,
      "width": 300,
      "length": 400,
      "volume": 24000,
      "description_1": "Ropa deportiva",
      "description_2": null,
      "description_3": null,
      "classification": {
        "id": 1,
        "name": "General"
      },
      "tax_class_code": "IVA21",
      "label_elements": [
        {
          "id": "zipnova_label_code",
          "type": "barcode",
          "format": "code128a",
          "value": "LP-00099"
        }
      ],
      "container": {
        "id": 5,
        "description": "Caja chica",
        "outer_width": 320,
        "outer_height": 220,
        "outer_length": 420,
        "inner_width": 310,
        "inner_length": 410,
        "inner_height": 210,
        "max_weight": 5000,
        "empty_weight": 200
      },
      "items": [
        {
          "id": 3001,
          "sku": {
            "sku": "SKU-001",
            "sku_id": 88,
            "internal_sku": "INT-001",
            "name": "Remera Azul Talle M",
            "barcode": "7791234567890"
          },
          "description": "Remera Azul Talle M",
          "tax_class_code": "IVA21",
          "must_keep_vertical": false,
          "weight": 300,
          "width": 100,
          "length": 150,
          "height": 20,
          "pos_x": 0,
          "pos_y": 0,
          "pos_z": 0
        }
      ]
    }
  ],
  "tags": [],
  "related_shipments": [
    {
      "type": "child",
      "relationship": "return",
      "shipment_id": 1043
    }
  ],
  "source": "shopify",
  "marketplace": {
    "code": "meli",
    "name": "MercadoLibre"
  },
  "order": {
    "id": 500,
    "channel": "meli",
    "channel_created_at": "2024-08-14T08:00:00+00:00",
    "channel_relations": [
      {
        "type": "order",
        "id": "2000009876543210"
      }
    ]
  },
  "fulfillment_order": {
    "id": 200,
    "status_id": 3,
    "external_id": "FO-88991",
    "items": [
      {
        "sku_id": 88,
        "qty": 2,
        "lot_numbers": [
          "text"
        ],
        "serial_numbers": [
          "text"
        ]
      }
    ]
  }
}

Puntos de entrega disponibles

get

https://api.zipnova.com.ar/v2https://api.zipnova.cl/v2https://api.zipnova.com.mx/v2

/shipments/{shipment}/dropoff_locations

Obtiene los puntos de entrega (dropoff) disponibles para un envío con logística carrier_dropoff o xd_dropoff. Se puede filtrar por código postal o por ciudad y provincia/estado. Sin filtros, retorna las sucursales más cercanas al origen del envío.

Autorizaciones

basicAuthbearerAuth

AuthorizationstringRequerido

Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña

Parámetros de ruta

shipmentintegerRequerido

ID del envío

Example: 1042

Parámetros de consulta

zipcodestringOpcional

Código postal para buscar sucursales cercanas. No usar junto con city/state

Example: 1043

citystringOpcional

Ciudad para buscar sucursales. Usar junto con state

Example: Buenos Aires

statestringOpcional

Provincia o estado para buscar sucursales. Usar junto con city

Example: Buenos Aires

Respuestas

200

Lista de puntos de entrega disponibles

application/json

400

El envío no tiene logística de tipo carrier_dropoff o xd_dropoff

403

Sin acceso a este envío

404

Envío no encontrado

get

/shipments/{shipment}/dropoff_locations

HTTPcURLJavaScriptPython

GET /v2/shipments/{shipment}/dropoff_locations HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Accept: */*

{
  "data": [
    {
      "id": 55,
      "name": "Sucursal Palermo",
      "address": "Av. Santa Fe 3000",
      "city": "Buenos Aires",
      "state": "Buenos Aires",
      "zipcode": "1425",
      "lat": -34.5907,
      "lng": -58.4239
    }
  ]
}

Historial de estados

get

https://api.zipnova.com.ar/v2https://api.zipnova.cl/v2https://api.zipnova.com.mx/v2

/shipments/{shipment}/tracking

Obtiene el historial completo de cambios de estado de un envío, ordenado por defecto del más reciente al más antiguo.

Autorizaciones

basicAuthbearerAuth

AuthorizationstringRequerido

Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña

Parámetros de ruta

shipmentintegerRequerido

ID del envío

Example: 1042

Parámetros de consulta

sortstring · enumOpcional

Orden de los eventos. newest: del más reciente al más antiguo. oldest: cronológico

Default: newestExample: newestValores posibles:

Respuestas

200

Historial de estados del envío

application/json

403

Sin acceso a este envío

404

Envío no encontrado

get

/shipments/{shipment}/tracking

HTTPcURLJavaScriptPython

GET /v2/shipments/{shipment}/tracking HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Accept: */*

{
  "data": [
    {
      "occurred_at": "2024-08-16T14:22:00+0000",
      "created_at": "2024-08-16T14:22:00+0000",
      "status": {
        "code": "in_transit",
        "name": "En camino",
        "visible_name": "En camino a tu domicilio",
        "substatus": null
      }
    }
  ]
}