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
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.
Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña
Filtrar por ID de cuenta. Solo pueden consultar cuentas a las que tienen acceso.
7Filtrar por ID de transportista
3Filtrar por ID externo del envío (búsqueda exacta)
ORDER-9821Filtrar por código de tipo de servicio (e.g. standard_delivery, pickup_point)
standard_deliveryFiltrar por código de estado (e.g. new, shipped, delivered, cancelled)
deliveredFiltrar por ID de pedido del canal de venta (e.g. número de orden de MercadoLibre o Shopify)
2000009876543210Filtrar envíos relacionados (devoluciones o reenvíos) a partir del ID del envío padre
1040Filtrar por ID del origen en el catálogo de direcciones (address id)
12Fecha de inicio del rango de creación (YYYY-MM-DD). Por defecto: 30 días atrás.
2024-08-01Fecha de fin del rango de creación (YYYY-MM-DD, inclusive)
2024-08-31Lista paginada de envíos
GET /v2/shipments HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Accept: */*
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",
"substatus_code": "ok",
"substatus_name": "Ok",
"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,
"rescue": {
"requested_at": "2024-08-16T09:41:03+00:00"
}
}
],
"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
}
}Obtiene el detalle completo de un envío específico, incluyendo paquetes, ítems, destino, origen, tiempos de entrega y envíos relacionados.
Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña
ID del envío
1042Detalle del envío
ID único del envío
1042Identificador externo del envío (e.g. número de orden del cliente)
ORDER-9821Número de remito asignado por el transportista
R-00012345Identificador de seguimiento público del transportista
TRACKING-ABC123Identificador de seguimiento alternativo del transportista
TRACKING-XYZ456Fecha y hora de creación del envío (ISO 8601)
2024-08-15T10:30:00+00:00Fecha y hora en que el envío alcanzó su estado actual (ISO 8601)
2024-08-16T14:30:00+00:00Fecha y hora de entrega al destinatario (ISO 8601). Presente solo si fue entregado
2024-08-18T14:30:00+00:00ID de la cuenta propietaria del envío
7ID del envío padre. Presente cuando este envío es una devolución o reenvío
1040Tipo de logística del envío (e.g. crossdock, carrier_dropoff, xd_dropoff, self_service)
crossdockCódigo del tipo de servicio (e.g. standard, express, pickup_point)
standardCódigo de estado actual del envío (e.g. new, in_transit, delivered)
in_transitNombre legible del estado actual
En caminoCódigo del subestado actual del envío, si aplica
okNombre legible del subestado actual, si aplica
OkURL de seguimiento público del envío en la plataforma
https://app.zipnova.com/tracking/1042URL de seguimiento en el sitio web del transportista
https://carrier.com/track?id=ABC123URL con instrucciones de devolución. Solo presente en envíos de tipo reverse logistics
https://app.zipnova.com/return/abc123xyzValor declarado del contenido del envío en la moneda local
1500Costo del envío sin impuestos
320.5Costo del envío con impuestos incluidos
387.8Peso total del envío en gramos
1200Volumen total del envío en centímetros cúbicos (cm³)
8000Etiquetas asociadas al envío
Fuente u origen de creación del envío (e.g. nombre del canal o integración)
shopifySin acceso a este envío
Envío no encontrado
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",
"last_status_at": "2024-08-16T14:30:00+00:00",
"delivered_at": "2024-08-18T14: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",
"substatus_code": "ok",
"substatus_name": "Ok",
"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": "+5491112345678",
"email": "juan@example.com",
"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": "+5493512345678",
"email": "deposito@empresa.com",
"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": 20,
"width": 30,
"length": 40,
"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": 32,
"outer_height": 22,
"outer_length": 42,
"inner_width": 31,
"inner_length": 41,
"inner_height": 21,
"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": 10,
"length": 15,
"height": 2,
"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"
]
}
]
},
"rescue": {
"requested_at": "2024-08-16T09:41:03+00:00"
}
}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.
Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña
ID del envío
1042Código postal para buscar sucursales cercanas. No usar junto con city/state
1043Ciudad para buscar sucursales. Usar junto con state
Buenos AiresProvincia o estado para buscar sucursales. Usar junto con city
Buenos AiresLista de puntos de entrega disponibles
El envío no tiene logística de tipo carrier_dropoff o xd_dropoff
Sin acceso a este envío
Envío no encontrado
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
}
]
}Obtiene el historial completo de cambios de estado de un envío, ordenado por defecto del más reciente al más antiguo.
Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña
ID del envío
1042Orden de los eventos. newest: del más reciente al más antiguo. oldest: cronológico
newestExample: newestValores posibles: Historial de estados del envío
Fecha y hora efectiva del cambio de estado (ISO 8601)
2024-08-16T14:22:00-03:00Fecha y hora de registración del cambio de estado (ISO 8601)
2024-08-16T14:25:31-03:00Sin acceso a este envío
Envío no encontrado
GET /v2/shipments/{shipment}/tracking HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Accept: */*
[
{
"occurred_at": "2024-08-16T14:22:00-03:00",
"created_at": "2024-08-16T14:25:31-03:00",
"status": {
"code": "delivered",
"name": "Entregado",
"visible_name": "Entregado",
"substatus": "Ok",
"substatus_code": "ok"
}
}
]Última actualización