Créditos de venta
Créditos que reducen las obligaciones de clientes.
Recurso JSON
sales-creditsModelo y significado
Las imputaciones apuntan a sales-invoices. El número de crédito es único entre activos sin distinguir mayúsculas. Reduce balance, pero no aumenta el dinero cobrado paid.
Consulta del recurso
HTTP
GET https://finanzas.neavision.com.ar/api/v1/agent/sales-credits
Authorization: Bearer <token-de-integracion>Requiere sales-credits:read. Respuesta de lista: { data: [...], page: { total, nextCursor } }. El detalle se consulta con /sales-credits/{id}. Ver paginación y filtros.
Ejemplo estructurado
JSON
{
"id": "b0000000-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": "NC-00001",
"date": "2026-10-01",
"amount": "5000.00",
"currency": "ARS",
"concept": "Crédito de venta",
"allocations": [
{
"invoiceId": "70000000-0000-4000-8000-000000000001",
"amount": "5000.00"
}
]
}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. |
date | string | Obligatorio | Fecha civil del movimiento, YYYY-MM-DD. Patrón: ^\d{4}-\d{2}-\d{2}$ |
concept | string | Obligatorio | Descripción comercial del movimiento. Máx. 1000 caracteres. |
allocations | array | Obligatorio | Imputaciones embebidas. No confundir importe del movimiento con importe aplicado. Máx. 500 elementos. |
allocations[].invoiceId | uuid | Obligatorio | UUID de la factura asociada; el recurso destino depende del circuito. |
allocations[].installmentId | string | Opcional | ID textual de cuota dentro de la factura, opcional. Máx. 1000 caracteres. |
allocations[].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. |