Créditos de proveedores
Créditos aplicables a facturas de compra o gastos.
Recurso JSON
creditsModelo y significado
Reducen la obligación mediante allocations, con la misma estructura de destino que los pagos. No son un egreso de caja. No hay número fiscal obligatorio ni desglose impositivo en este recurso.
Consulta del recurso
HTTP
GET https://finanzas.neavision.com.ar/api/v1/agent/credits
Authorization: Bearer <token-de-integracion>Requiere credits:read. Respuesta de lista: { data: [...], page: { total, nextCursor } }. El detalle se consulta con /credits/{id}. Ver paginación y filtros.
Ejemplo estructurado
JSON
{
"id": "a0000000-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",
"date": "2026-10-01",
"amount": "10000.00",
"currency": "ARS",
"concept": "Crédito del proveedor",
"allocations": [
{
"targetType": "invoice",
"targetId": "20000000-0000-4000-8000-000000000001",
"amount": "10000.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. |
supplierId | uuid | Obligatorio | UUID de suppliers; distingue la cuenta del proveedor. |
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[].targetType | "invoice" | "expense" | Obligatorio | invoice apunta a invoices; expense apunta a expenses. |
allocations[].targetId | uuid | Obligatorio | UUID de la obligación destino. |
allocations[].amount | string | Obligatorio | Importe original positivo, string decimal con hasta 2 decimales. Patrón: ^(0|[1-9]\d{0,12})(\.\d{1,2})?$ |
allocations[].installmentId | string | Opcional | ID textual de cuota dentro de la factura, opcional. Máx. 100 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. |