Entregas

Listar remitos

Lista los remitos de la empresa activa con búsqueda por número o cliente y filtros de estado, reversión, facturación, forma de entrega, depósito, cliente, pedido y fechas. Por defecto trae todos menos los descartados.

GET/api/v1/deliveries/list

Permiso: deliveries.view
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
statuslista de opciónadmite null
Valores: draft issued discarded
reversallista de opciónadmite null
Valores: partial total
invoicingopciónadmite null
Valores: pending
deliveryMethodlista de opciónadmite null
Valores: transport own-fleet customer-pickup
cotlista de opciónadmite null
Valores: pending rejected
warehouseIduuidadmite null
customerIduuidadmite null
salesOrderIduuidadmite null
dateFromfechaadmite null
dateTofechaadmite null
sortopción
Valores: number date customerPor defecto: date
directionopción
Valores: asc descPor defecto: desc
circuitopción
Valores: all fiscal xPor defecto: all
pageentero
Por defecto: 1mínimo 1
pageSizeentero
Por defecto: 50mínimo 1, máximo 100

Respuesta

200 con este JSON.

deliverieslista de objetorequerido
Campos de cada elemento (16)
- iduuidrequerido
- deliveryNoteIduuidrequerido
- numbertextorequerido
- internalNumberenterorequerido
- legalNumberenterorequeridoadmite null
- statusopciónrequerido
  Valores: draft issued discarded
- deliveryStatusopciónrequerido
  Valores: open closed annulled
- reversalopciónrequerido
  Valores: none partial total
- documentDatefecharequerido
- customerobjetorequerido
  Campos (4)
  - iduuidrequerido
  - codeenterorequerido
  - legalNametextorequerido
  - taxIdtextorequerido
- deliveryMethodopciónrequerido
  Valores: transport own-fleet customer-pickup
- destinationobjetorequerido
  Campos (7)
  - kindopciónrequerido
    Valores: recipient fiscal-address pickup
  - recipientIduuidrequeridoadmite null
  - nametextorequerido
  - addresstextorequerido
  - citytextorequerido
  - receiverNamecualquierarequerido
  - carrierTaxIdcualquierarequerido
- warehouseobjetorequerido
  Campos (3)
  - iduuidrequerido
  - codetextorequerido
  - nametextorequerido
- pendingInvoicesí o norequerido
- cotStatusopciónrequerido
  Valores: not-required pending granted rejected
- circuitopciónrequerido
  Valores: fiscal x
totalenterorequerido
mínimo 0

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.view`.
`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" \
  -b sesion.txt \
  -H "X-Expected-Company: $ERP_EMPRESA"

const respuesta = await fetch(`${process.env.ERP_URL}/api/v1/deliveries/list`, {
  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();

{
  "deliveries": [
    {
      "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "deliveryNoteId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "number": "texto",
      "internalNumber": 1,
      "legalNumber": 1,
      "status": "draft",
      "deliveryStatus": "open",
      "reversal": "none",
      "documentDate": "2026-10-23",
      "customer": {
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "code": 1,
        "legalName": "texto",
        "taxId": "texto"
      },
      "deliveryMethod": "transport",
      "destination": {
        "kind": "recipient",
        "recipientId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "name": "texto",
        "address": "texto",
        "city": "texto",
        "receiverName": null,
        "carrierTaxId": null
      },
      "warehouse": {
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "code": "texto",
        "name": "texto"
      },
      "pendingInvoice": false,
      "cotStatus": "not-required",
      "circuit": "fiscal"
    }
  ],
  "total": 1
}