NeavisiónDocs
Contratos JSON

Créditos de proveedores

Créditos aplicables a facturas de compra o gastos.

Recurso JSONcredits

Modelo 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.

CampoTipo / valoresCondiciónSignificado y restricciones
externalIdstringOpcionalIdentidad opcional del sistema de origen. Única por recurso entre registros activos. Máx. 500 caracteres.
notesstringOpcionalObservaciones registradas. Máx. 10000 caracteres.
amountstringObligatorioImporte original positivo, string decimal con hasta 2 decimales. Patrón: ^(0|[1-9]\d{0,12})(\.\d{1,2})?$
currency"ARS" | "USD"ObligatorioMoneda original: ARS o USD. No sumar monedas distintas.
documentIdsarrayOpcionalUUID de los respaldos. No contiene imágenes ni archivos. Máx. 100 elementos.
supplierIduuidObligatorioUUID de suppliers; distingue la cuenta del proveedor.
datestringObligatorioFecha civil del movimiento, YYYY-MM-DD. Patrón: ^\d{4}-\d{2}-\d{2}$
conceptstringObligatorioDescripción comercial del movimiento. Máx. 1000 caracteres.
allocationsarrayObligatorioImputaciones embebidas. No confundir importe del movimiento con importe aplicado. Máx. 500 elementos.
allocations[].targetType"invoice" | "expense"Obligatorioinvoice apunta a invoices; expense apunta a expenses.
allocations[].targetIduuidObligatorioUUID de la obligación destino.
allocations[].amountstringObligatorioImporte original positivo, string decimal con hasta 2 decimales. Patrón: ^(0|[1-9]\d{0,12})(\.\d{1,2})?$
allocations[].installmentIdstringOpcionalID textual de cuota dentro de la factura, opcional. Máx. 100 caracteres.
iduuidServidorIdentificador UUID estable del registro. No usar el número de comprobante como ID.
versionintegerServidorVersión entera para detectar cambios sobre este registro. Mín. 1.
createdAtdate-timeServidorMomento de creación, ISO 8601 con zona.
updatedAtdate-timeServidorÚltima modificación del registro; no implica que un saldo derivado se haya mantenido igual.
voidedAtdate-timeServidorMomento de anulación; null o ausente indica registro activo.

Buscar documentación