Movimientos

Ver un movimiento

Devuelve un movimiento con sus líneas, el stock físico que dejó cada una, sus vínculos y quién lo registró.

GET/api/v1/stock-movements/get

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

movementIduuidrequerido

Respuesta

200 con este JSON.

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
fromopciónrequeridoadmite null
Valores: apt blocked
toopciónrequeridoadmite null
Valores: apt blocked
reversesobjetorequeridoadmite null
Campos (2)
- iduuidrequerido
- numbertextorequerido
reversedByobjetorequeridoadmite null
Campos (2)
- iduuidrequerido
- numbertextorequerido
countobjetorequeridoadmite null
Campos (2)
- iduuidrequerido
- numbertextorequerido
registeredByobjetorequerido
Campos (2)
- idtextorequerido
- namecualquierarequerido
registeredAtfecha y horarequerido
lineslista de objetorequerido
Campos de cada elemento (8)
- itemobjetorequerido
  Campos (7)
  - iduuidrequerido
  - codetextorequerido
  - nametextorequerido
  - statusopciónrequerido
    Valores: active inactive
  - unitCodetextorequerido
  - unitNametextorequerido
  - allowsDecimalssí o norequerido
- quantitynúmerorequerido
- physicalAfternúmerorequerido
- aptAfternúmerorequerido
- blockedAfternúmerorequerido
- releasedcualquierarequerido
- unitCostcualquiera
- amountcualquiera

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/get?movementId=3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90" \
  -b sesion.txt \
  -H "X-Expected-Company: $ERP_EMPRESA"

const respuesta = await fetch(`${process.env.ERP_URL}/api/v1/stock-movements/get?movementId=3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90`, {
  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();

{
  "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"
  },
  "from": "apt",
  "to": "apt",
  "reverses": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "number": "texto"
  },
  "reversedBy": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "number": "texto"
  },
  "count": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "number": "texto"
  },
  "registeredBy": {
    "id": "texto",
    "name": null
  },
  "registeredAt": "2026-10-23T14:30:00.000Z",
  "lines": [
    {
      "item": {
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "code": "texto",
        "name": "texto",
        "status": "active",
        "unitCode": "texto",
        "unitName": "texto",
        "allowsDecimals": false
      },
      "quantity": 100,
      "physicalAfter": 100,
      "aptAfter": 100,
      "blockedAfter": 100,
      "released": null,
      "unitCost": null,
      "amount": null
    }
  ]
}