Cobros de clientes

Ingresos cobrados, anticipos e imputaciones a ventas.

Recurso JSONreceipts

Modelo y significado

Este recurso representa dinero recibido de clientes, no remitos ni recepción documental. purpose distingue invoice, unbilled y advance. Cada imputación apunta a sales-invoices por invoiceId. No usar targetType/targetId de pagos de compra en este circuito.

El agregado de operaciones informa allocated y unallocated, calculados. Un cobro sin imputación no reduce automáticamente el saldo de una factura.

Consulta del recurso

HTTP

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

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

Ejemplo estructurado

JSON

{
  "id": "80000000-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",
  "date": "2026-10-01",
  "amount": "20000.00",
  "currency": "ARS",
  "method": "card",
  "concept": "Cobro de venta",
  "category": "Óptica",
  "purpose": "invoice",
  "allocations": [
    {
      "invoiceId": "70000000-0000-4000-8000-000000000001",
      "amount": "20000.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`	Opcional	UUID de customers; identifica la cuenta del cliente.
`date`	`string`	Obligatorio	Fecha civil del movimiento, YYYY-MM-DD. Patrón: ^\d{4}-\d{2}-\d{2}$
`method`	`"cash" \| "transfer" \| "mercado_pago" \| "card" \| "check" \| "automatic_debit" \| "other"`	Obligatorio	Medio de pago: cash, transfer, mercado_pago, card, check, automatic_debit u other.
`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.
`reference`	`string`	Opcional	Referencia bancaria o comercial. Máx. 1000 caracteres.
`purpose`	`"invoice" \| "unbilled" \| "advance"`	Obligatorio	invoice: aplicado a factura; unbilled: ingreso sin factura; advance: anticipo.
`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.