Movimientos

Listar movimientos de stock

Lista los movimientos, del más nuevo al más viejo, con búsqueda por número, artículo o detalle y filtros de tipo, depósito, artículo, estado y fechas.

GET/api/v1/stock-movements/list

Permiso: stock-movements.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
typeopciónadmite null
Valores: entry exit opening_balance condition_change count_adjustment reversal
warehouseIduuidadmite null
itemIduuidadmite null
statusopciónadmite null
Valores: registered reverted
dateFromfechaadmite null
dateTofechaadmite null
pageentero
Por defecto: 1mínimo 1
pageSizeentero
Por defecto: 50mínimo 1, máximo 100

Respuesta

200 con este JSON.

movementslista de objetorequerido
Campos de cada elemento (11)
- iduuidrequerido
- numbertextorequerido
- typeopciónrequerido
  Valores: entry exit opening_balance condition_change count_adjustment reversal
- reasoncualquierarequerido
- notescualquierarequerido
- datefecharequerido
- statusopciónrequerido
  Valores: registered reverted
- warehouseobjetorequerido
  Campos (4)
  - iduuidrequerido
  - codetextorequerido
  - nametextorequerido
  - statusopciónrequerido
    Valores: active inactive
- lineCountenterorequerido
  mínimo 1
- sourceobjetorequeridoadmite null
  Campos (5)
  - kindopciónrequerido
    Valores: delivery-note delivery-note-reversal goods-receipt goods-receipt-reversal
  - iduuidrequerido
  - numbertextorequerido
  - deliveryIduuid
  - goodsReceiptIduuid
- itemLineobjeto
  Campos (4)
  - quantitynúmerorequerido
  - physicalAfternúmerorequerido
  - fromopciónrequeridoadmite null
    Valores: apt blocked
  - toopciónrequeridoadmite null
    Valores: apt blocked
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 `stock-movements.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/stock-movements/list" \
  -b sesion.txt \
  -H "X-Expected-Company: $ERP_EMPRESA"

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

{
  "movements": [
    {
      "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "number": "texto",
      "type": "entry",
      "reason": null,
      "notes": null,
      "date": "2026-10-23",
      "status": "registered",
      "warehouse": {
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "code": "texto",
        "name": "texto",
        "status": "active"
      },
      "lineCount": 1,
      "source": {
        "kind": "delivery-note",
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "number": "texto",
        "deliveryId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "goodsReceiptId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90"
      },
      "itemLine": {
        "quantity": 100,
        "physicalAfter": 100,
        "from": "apt",
        "to": "apt"
      }
    }
  ],
  "total": 1
}