Entregas

Listar pedidos para entregar (backorders)

Lista los pedidos confirmados con algo pendiente de entrega, en orden de confirmación, con el destino del cliente, las unidades pendientes y cuántas posiciones cubre el stock disponible de un depósito, asignado primero a los pedidos más viejos.

GET/api/v1/deliveries/list-deliverable-orders

Permiso: deliveries.prepare
Empresa: Opera sobre la empresa activa
Tipo: Lectura: no cambia nada
Respuesta: JSON

Encabezados

Cookietextorequerido
La cookie de sesión del usuario de la integración (__Secure-erp.session_token). Cuando esté la clave API, va en Authorization: Bearer. Ver Autenticación.
X-Expected-Companyuuidrequerido
La empresa sobre la que operás. Si no coincide con la de la credencial, responde 409. Ver Empresa activa.

Parámetros de la consulta

searchtextoadmite null
hasta 100 caracteres
customerIduuidadmite null
warehouseIduuidadmite null
confirmedFromfechaadmite null
confirmedTofechaadmite null

Respuesta

200 con este JSON.

orderslista de objetorequerido
Campos de cada elemento (10)
- salesOrderobjetorequerido
  Campos (3)
  - iduuidrequerido
  - numbertextorequerido
  - confirmedAtfecharequerido
- customerobjetorequerido
  Campos (3)
  - iduuidrequerido
  - codeenterorequerido
  - legalNametextorequerido
- destinationobjetorequerido
  Campos (3)
  - recipientIduuidrequeridoadmite null
  - nametextorequerido
  - citytextorequerido
- partiallyDeliveredsí o norequerido
- pendingQuantitynúmerorequerido
- deliveredPercententerorequerido
  mínimo 0, máximo 100
- positionsenterorequerido
  mínimo 0
- coveredPositionsenterorequerido
  mínimo 0
- coveredPercententerorequerido
  mínimo 0, máximo 100
- coverageopciónrequerido
  Valores: complete partial none
warehouseobjetorequerido
Campos (3)
- iduuidrequerido
- codetextorequerido
- nametextorequerido
warehouseslista de objetorequerido
Campos de cada elemento (4)
- iduuidrequerido
- codetextorequerido
- nametextorequerido
- isGeneralsí o norequerido

Errores

Un rechazo responde application/problem+json con un code estable. Los más comunes en esta operación:

`401`	Falta la credencial o venció.
`403`	La credencial no tiene el permiso `deliveries.prepare`.
`409`	La empresa activa no es la de `X-Expected-Company`.
`422`	Datos inválidos o una regla de negocio rota, con el detalle por campo.
`503`	Sistema ocupado: reintentá después de `Retry-After` segundos.

La lista completa está en Errores.

curl
TypeScript

curl "$ERP_URL/api/v1/deliveries/list-deliverable-orders" \
  -b sesion.txt \
  -H "X-Expected-Company: $ERP_EMPRESA"

const respuesta = await fetch(`${process.env.ERP_URL}/api/v1/deliveries/list-deliverable-orders`, {
  headers: {
    Cookie: process.env.ERP_SESION!,
    "X-Expected-Company": process.env.ERP_EMPRESA!,
  },
});
if (!respuesta.ok) throw new Error((await respuesta.json()).title);
const datos = await respuesta.json();

{
  "orders": [
    {
      "salesOrder": {
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "number": "texto",
        "confirmedAt": "2026-10-23"
      },
      "customer": {
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "code": 1,
        "legalName": "texto"
      },
      "destination": {
        "recipientId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "name": "texto",
        "city": "texto"
      },
      "partiallyDelivered": false,
      "pendingQuantity": 100,
      "deliveredPercent": 1,
      "positions": 1,
      "coveredPositions": 1,
      "coveredPercent": 1,
      "coverage": "complete"
    }
  ],
  "warehouse": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "code": "texto",
    "name": "texto"
  },
  "warehouses": [
    {
      "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "code": "texto",
      "name": "texto",
      "isGeneral": false
    }
  ]
}