Envíos
Listá tus envíos con su destinatario, su origen y su seguimiento.
Listar envíos
GET /v1/shipping-ordersDevuelve envíos de tu cuenta con el destinatario y el origen ya incluidos — no hace falta un segundo request para resolverlos.
curl https://api.fleeto.com.ar/v1/shipping-orders \
-H "x-api-key: TU_API_KEY"Respuesta
{
"data": [
{
"id": "clx8f2h9k0001",
"shippingOrderNumber": "SO-000124",
"externalReference": "PEDIDO-8891",
"status": "OUT_FOR_DELIVERY",
"service": "NEXT_DAY",
"shippingWeight": 1200,
"trackingNumber": "FL7Q2XM4",
"sender": {
"name": "Mi depósito",
"email": "deposito@mitienda.com",
"phoneNumber": "+5493511234567",
"address": {
"street": "Av. Colón",
"doorNumber": "1200",
"floor": null,
"zipCode": "5000",
"locality": "Alberdi",
"city": "Córdoba",
"province": "Córdoba",
"country": "AR"
}
},
"receiver": {
"name": "Ana Gómez",
"email": "ana@example.com",
"phoneNumber": "+5493517654321",
"address": {
"street": "Rondeau",
"doorNumber": "455",
"floor": "3B",
"zipCode": "5000",
"locality": "Nueva Córdoba",
"city": "Córdoba",
"province": "Córdoba",
"country": "AR"
}
},
"createdAt": "2026-08-14T13:02:41.000Z",
"updatedAt": "2026-08-15T09:18:05.000Z"
}
],
"pages": 4,
"total": 37
}Los campos que conviene mirar
| Campo | Qué trae |
|---|---|
shippingOrderNumber | El número con el que se identifica el envío en el panel |
externalReference | Tu propia referencia, si la mandaste al crearlo |
trackingNumber | El código de seguimiento. null mientras el envío no salió |
status | En qué punto del recorrido está |
service | SAME_DAY, NEXT_DAY o STANDARD |
shippingWeight | El peso, en gramos |
status usa los mismos estados que ves en el panel, en su forma interna:
PENDING, LABEL_CREATED, READY_FOR_PICKUP, HANDLING, OUT_FOR_DELIVERY,
DELIVERY_ATTEMPTED, DELIVERY_RESCHEDULED, DELIVERED, DELIVERY_FAILED y
CANCELLED. Qué significa cada uno está en Envíos.
El peso viene en gramos
Como todas las magnitudes de la API: los pesos en gramos y las medidas en
milímetros, siempre enteros. Un envío de 1,2 kg llega como 1200.
Cuántos devuelve
Por ahora, los primeros 10
El endpoint devuelve una sola página de 10 envíos y todavía no acepta
parámetros para pedir las siguientes, así que pages y total te dicen
cuánto hay pero no podés recorrerlo. Tampoco garantiza un orden estable entre
llamadas. Si necesitás la lista completa, escribinos.
total es cuántos envíos tenés en total y pages en cuántas páginas entrarían.
Seguí un envío desde tu sistema
Con el trackingNumber armás el link de seguimiento que le pasás a tu cliente:
https://tracking.fleeto.com.ar?trackingNumber=FL7Q2XM4Es una página pública: tu cliente la abre sin usuario ni contraseña.