Facturas de venta

Comprobantes de venta a clientes y sus cuotas.

Recurso JSONsales-invoices

Modelo y significado

La identidad activa es tipo y número sin distinguir mayúsculas; no se divide por cliente. Este recurso conserva cabecera financiera y cuotas, pero no tiene lines, productos vendidos, precio unitario, impuestos ni CAE estructurado.

Los campos derivados son paid (cobros aplicados), credited (créditos aplicados), balance, overdue, status y schedule. status admite pending/partial/paid; para vencidos, el filtro overdue consulta el importe overdue. Registrar una venta no genera por sí solo una salida de stock.

Consulta del recurso

HTTP

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

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

Ejemplo estructurado

JSON

{
  "id": "70000000-0000-4000-8000-000000000001",
  "version": 1,
  "createdAt": "2026-10-01T12:00:00Z",
  "updatedAt": "2026-10-01T12:00:00Z",
  "voidedAt": null,
  "customerId": "60000000-0000-4000-8000-000000000001",
  "number": "00002-00000010",
  "invoiceType": "B",
  "issueDate": "2026-10-01",
  "amount": "50000.00",
  "currency": "ARS",
  "concept": "Venta de anteojos",
  "category": "Óptica"
}

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.
`amount`	`string`	Obligatorio	Importe original positivo, string decimal con hasta 2 decimales. Patrón: ^(0\|[1-9]\d{0,12})(\.\d{1,2})?$
`currency`	`"ARS" \| "USD"`	Obligatorio	Moneda original: ARS o USD. No sumar monedas distintas.
`documentIds`	`array`	Opcional	UUID de los respaldos. No contiene imágenes ni archivos. Máx. 100 elementos.
`customerId`	`uuid`	Obligatorio	UUID de customers; identifica la cuenta del cliente.
`number`	`string`	Obligatorio	Número de comprobante conservado como texto, con sus ceros y formato. Máx. 1000 caracteres.
`invoiceType`	`string`	Opcional	Tipo de factura conservado como texto. No es un catálogo cerrado. Máx. 1000 caracteres.
`issueDate`	`string`	Obligatorio	Fecha civil de emisión, YYYY-MM-DD. Patrón: ^\d{4}-\d{2}-\d{2}$
`dueDate`	`string`	Opcional	Vencimiento comercial; no sustituye los vencimientos de cuotas. Patrón: ^\d{4}-\d{2}-\d{2}$
`concept`	`string`	Obligatorio	Descripción comercial del movimiento. Máx. 1000 caracteres.
`category`	`string`	Obligatorio	Rubro como texto libre, sin tabla de categorías. Máx. 1000 caracteres.
`installments`	`array`	Opcional	Cuotas. Sus importes suman exactamente el total del comprobante. Máx. 360 elementos.
`installments[].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.
`installments[].dueDate`	`string`	Obligatorio	Vencimiento comercial; no sustituye los vencimientos de cuotas. Patrón: ^\d{4}-\d{2}-\d{2}$
`installments[].amount`	`string`	Obligatorio	Importe original positivo, string decimal con hasta 2 decimales. Patrón: ^(0\|[1-9]\d{0,12})(\.\d{1,2})?$
`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.
`paid`	`string`	Respuesta	Importe aplicado calculado; consultar la definición del recurso.
`credited`	`string`	Respuesta	Crédito de venta aplicado, calculado.
`balance`	`string`	Respuesta	Saldo calculado del comprobante.
`overdue`	`string`	Respuesta	Saldo vencido calculado de ventas.
`status`	`"pending" \| "partial" \| "paid"`	Respuesta	Estado registrado o calculado, según el recurso y endpoint.
`schedule`	`array`	Respuesta	Cuotas de venta enriquecidas con paid y balance.
`schedule[].id`	`string`	Opcional	Identificador textual estable dentro de la lista de líneas, cuotas o anticipos; no es un UUID global.
`schedule[].dueDate`	`date`	Respuesta	Vencimiento comercial; no sustituye los vencimientos de cuotas.
`schedule[].amount`	`string`	Respuesta	Importe original positivo, string decimal con hasta 2 decimales.
`schedule[].paid`	`string`	Respuesta	Importe aplicado calculado; consultar la definición del recurso.
`schedule[].balance`	`string`	Respuesta	Saldo calculado del comprobante.