Movimientos de stock

Aperturas, ajustes, devoluciones y consumos registrados manualmente.

Recurso JSONstock-movements

Modelo y significado

quantity es positiva; direction determina el signo: in suma y out resta. kind distingue opening, adjustment, return y consumption. La fecha de un movimiento realizado o remito recibido no puede ser futura.

Los ingresos por remito no se duplican en stock-movements. Para exportar un libro de movimientos propio, generar entradas desde líneas de remitos received y agregar los movimientos manuales con su identidad separada.

Consulta del recurso

HTTP

GET https://finanzas.neavision.com.ar/api/v1/agent/stock-movements
Authorization: Bearer <token-de-integracion>

Requiere stock-movements:read. Respuesta de lista: { data: [...], page: { total, nextCursor } }. El detalle se consulta con /stock-movements/{id}. Ver paginación y filtros.

Ejemplo estructurado

JSON

{
  "id": "90000000-0000-4000-8000-000000000001",
  "version": 1,
  "createdAt": "2026-10-01T12:00:00Z",
  "updatedAt": "2026-10-01T12:00:00Z",
  "voidedAt": null,
  "productId": "30000000-0000-4000-8000-000000000001",
  "date": "2026-10-01",
  "quantity": "1",
  "unit": "unidad",
  "direction": "out",
  "kind": "consumption",
  "reason": "Salida registrada para venta"
}

Diccionario de campos

Obligatorio / Opcional: campos del registro de negocio; dentro de una lista u objeto, se aplica cuando ese contenedor está presente. Servidor: identidad y auditoría. Respuesta: campos agregados o administrados por el servidor; no enviarlos como una edición ordinaria. La presencia de los calculados depende del endpoint.

Campo	Tipo / valores	Condición	Significado y restricciones
`externalId`	`string`	Opcional	Identidad opcional del sistema de origen. Única por recurso entre registros activos. Máx. 500 caracteres.
`notes`	`string`	Opcional	Observaciones registradas. Máx. 10000 caracteres.
`documentIds`	`array`	Opcional	UUID de los respaldos. No contiene imágenes ni archivos. Máx. 100 elementos.
`productId`	`uuid`	Obligatorio	UUID de products.
`date`	`string`	Obligatorio	Fecha civil del movimiento, YYYY-MM-DD. Patrón: ^\d{4}-\d{2}-\d{2}$
`quantity`	`string`	Obligatorio	Cantidad decimal exacta. En entradas de líneas/movimientos es positiva, hasta 4 decimales. Patrón: ^(0\|[1-9]\d{0,9})(\.\d{1,4})?$
`unit`	`string`	Obligatorio	Unidad textual exacta. No hay conversiones automáticas. Máx. 1000 caracteres.
`direction`	`"in" \| "out"`	Obligatorio	in suma stock; out resta stock.
`kind`	`"opening" \| "adjustment" \| "return" \| "consumption"`	Obligatorio	Clasificación del registro; los valores permitidos dependen del recurso.
`reason`	`string`	Obligatorio	Motivo del movimiento. Máx. 1000 caracteres.
`id`	`uuid`	Servidor	Identificador UUID estable del registro. No usar el número de comprobante como ID.
`version`	`integer`	Servidor	Versión entera para detectar cambios sobre este registro. Mín. 1.
`createdAt`	`date-time`	Servidor	Momento de creación, ISO 8601 con zona.
`updatedAt`	`date-time`	Servidor	Última modificación del registro; no implica que un saldo derivado se haya mantenido igual.
`voidedAt`	`date-time`	Servidor	Momento de anulación; null o ausente indica registro activo.