Productos

Catálogo de productos, unidades y códigos por proveedor.

Recurso JSONproducts

Modelo y significado

La clave de relación es id; sku identifica el catálogo comercial. La unidad debe coincidir exactamente con remitos y movimientos. No se guardan costos, precios de venta, depósitos, lotes ni variantes ópticas estructuradas.

GET /products devuelve el catálogo. El saldo quantity, la recepción acumulada received y hasOpening se consultan en GET /operations, dentro de products; no son atributos persistidos del producto.

Consulta del recurso

HTTP

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

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

Ejemplo estructurado

JSON

{
  "id": "30000000-0000-4000-8000-000000000001",
  "version": 1,
  "createdAt": "2026-10-01T12:00:00Z",
  "updatedAt": "2026-10-01T12:00:00Z",
  "voidedAt": null,
  "sku": "ARM-001",
  "name": "Armazón modelo ejemplo",
  "unit": "unidad",
  "supplierCodes": [
    {
      "supplierId": "10000000-0000-4000-8000-000000000001",
      "code": "ARM-001"
    }
  ]
}

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.
`sku`	`string`	Obligatorio	Código de producto. Único sin distinguir mayúsculas entre productos activos. Máx. 1000 caracteres.
`name`	`string`	Obligatorio	Nombre visible. Máx. 1000 caracteres.
`unit`	`string`	Obligatorio	Unidad textual exacta. No hay conversiones automáticas. Máx. 1000 caracteres.
`supplierCodes`	`array`	Opcional	Equivalencias de código por proveedor. Máx. 100 elementos.
`supplierCodes[].supplierId`	`uuid`	Obligatorio	UUID de suppliers; distingue la cuenta del proveedor.
`supplierCodes[].code`	`string`	Obligatorio	Código del proveedor. 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.