Remitos

Recepción física y vinculación con líneas facturadas.

Recurso JSONdelivery-notes

Modelo y significado

draft no suma stock. received suma las cantidades físicas una sola vez, aunque no haya factura vinculada. La identidad activa es proveedor y número sin distinguir mayúsculas.

lines[].matches permite varias facturas por línea de remito y varios remitos por línea de factura. La suma de matches de una línea no puede superar su cantidad recibida; sí puede superar lo facturado, generando excess. Conservar los IDs de línea al integrar.

Consulta del recurso

HTTP

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

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

Ejemplo estructurado

JSON

{
  "id": "40000000-0000-4000-8000-000000000001",
  "version": 1,
  "createdAt": "2026-10-01T12:00:00Z",
  "updatedAt": "2026-10-01T12:00:00Z",
  "voidedAt": null,
  "supplierId": "10000000-0000-4000-8000-000000000001",
  "number": "R-000042",
  "date": "2026-10-01",
  "status": "received",
  "lines": [
    {
      "id": "remito-linea-1",
      "productId": "30000000-0000-4000-8000-000000000001",
      "description": "Armazón modelo ejemplo",
      "quantity": "6",
      "unit": "unidad",
      "supplierCode": "ARM-001",
      "matches": [
        {
          "invoiceId": "20000000-0000-4000-8000-000000000001",
          "lineId": "linea-1",
          "quantity": "6"
        }
      ]
    }
  ]
}

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.
`supplierId`	`uuid`	Obligatorio	UUID de suppliers; distingue la cuenta del proveedor.
`number`	`string`	Obligatorio	Número de comprobante conservado como texto, con sus ceros y formato. Máx. 1000 caracteres.
`date`	`string`	Obligatorio	Fecha civil del movimiento, YYYY-MM-DD. Patrón: ^\d{4}-\d{2}-\d{2}$
`status`	`"draft" \| "received"`	Obligatorio	Estado registrado o calculado, según el recurso y endpoint.
`orderReferences`	`array`	Opcional	Referencias documentadas de pedidos; no son claves foráneas. Máx. 100 elementos.
`lines`	`array`	Obligatorio	Detalle embebido; no existe una tabla independiente de líneas. Máx. 500 elementos.
`lines[].id`	`string`	Obligatorio	Identificador textual estable dentro de la lista de líneas, cuotas o anticipos; no es un UUID global. Máx. 1000 caracteres.
`lines[].productId`	`uuid`	Obligatorio	UUID de products.
`lines[].description`	`string`	Obligatorio	Descripción registrada. Máx. 1000 caracteres.
`lines[].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})?$
`lines[].unit`	`string`	Obligatorio	Unidad textual exacta. No hay conversiones automáticas. Máx. 1000 caracteres.
`lines[].orderReference`	`string`	Opcional	Referencia textual del pedido. Máx. 1000 caracteres.
`lines[].supplierCode`	`string`	Opcional	Código de proveedor opcional. Coincidencia exacta cuando ambas líneas lo informan. Máx. 1000 caracteres.
`lines[].matches`	`array`	Obligatorio	Asignaciones de una línea de remito a líneas de facturas de compra. Máx. 500 elementos.
`lines[].matches[].invoiceId`	`uuid`	Obligatorio	UUID de la factura asociada; el recurso destino depende del circuito.
`lines[].matches[].lineId`	`string`	Obligatorio	ID textual de la línea destino, local a la factura. Máx. 1000 caracteres.
`lines[].matches[].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})?$
`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.