Envíos

Listar envíos

GET /v1/shipping-orders

Devuelve los envíos de la 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: <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": "Depósito Centro",
        "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`	La referencia propia, si se mandó al crear el envío
`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 del 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 informan cuánto hay pero no permiten recorrerlo. Tampoco garantiza un orden estable entre llamadas. Para obtener la lista completa, escribir a soporte.

total es la cantidad total de envíos y pages en cuántas páginas entrarían.

Seguir un envío desde otro sistema

Con el trackingNumber se arma el link de seguimiento para mandarle al destinatario:

https://tracking.fleeto.com.ar?trackingNumber=FL7Q2XM4

Es una página pública: se abre sin usuario ni contraseña.

Listar envíos

Respuesta

Los campos que conviene mirar

Cuántos devuelve

Seguir un envío desde otro sistema

En esta página