Pagos a proveedores

Egresos, pagos programados e imputaciones a compras o gastos.

Recurso JSONpayments

Modelo y significado

amount es el total del pago; allocations indica cuánto se aplica a cada factura o gasto y, opcionalmente, a una cuota. Las referencias sin factura registrada se conservan en invoiceReferences. No inventar facturas ni enlazar por similitud de fecha o importe.

completed representa un pago realizado; scheduled, uno programado. Los pagos scheduled reservan importes en candidatos de órdenes y proyecciones; no reducen paid/balance de la factura de compra como un pago completed. documentedAdvance informa el anticipo restante documentado. El medio check no dispone de una tabla separada de cheques.

Consulta del recurso

HTTP

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

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

Ejemplo estructurado

JSON

{
  "id": "50000000-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": "40000.00",
  "currency": "ARS",
  "method": "transfer",
  "status": "completed",
  "allocations": [
    {
      "targetType": "invoice",
      "targetId": "20000000-0000-4000-8000-000000000001",
      "amount": "40000.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
`paymentOrderId`	`uuid`	Respuesta	Orden que originó el pago; relación administrada por el servidor.
`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`	Opcional	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}$
`method`	`"cash" \| "transfer" \| "mercado_pago" \| "card" \| "check" \| "automatic_debit" \| "other"`	Obligatorio	Medio de pago: cash, transfer, mercado_pago, card, check, automatic_debit u other.
`status`	`"completed" \| "scheduled"`	Obligatorio	Estado registrado o calculado, según el recurso y endpoint.
`executionDate`	`string`	Opcional	Fecha de ejecución de un pago programado, cuando corresponde. Patrón: ^\d{4}-\d{2}-\d{2}$
`reference`	`string`	Opcional	Referencia bancaria o comercial. Máx. 1000 caracteres.
`concept`	`string`	Opcional	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.
`invoiceReferences`	`array`	Opcional	Aplicaciones documentadas a facturas cuyo original aún no se registró; no reemplazan una relación por UUID. Máx. 500 elementos.
`invoiceReferences[].number`	`string`	Obligatorio	Número de comprobante conservado como texto, con sus ceros y formato. Máx. 1000 caracteres.
`invoiceReferences[].amount`	`string`	Obligatorio	Importe original positivo, string decimal con hasta 2 decimales. Patrón: ^(0\|[1-9]\d{0,12})(\.\d{1,2})?$
`invoiceReferences[].issueDate`	`string`	Opcional	Fecha civil de emisión, YYYY-MM-DD. Patrón: ^\d{4}-\d{2}-\d{2}$
`invoiceReferences[].dueDate`	`string`	Opcional	Vencimiento comercial; no sustituye los vencimientos de cuotas. Patrón: ^\d{4}-\d{2}-\d{2}$
`documentedAdvance`	`string`	Opcional	Anticipo documentado todavía no aplicado. 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.
`hasReceipt`	`boolean`	Respuesta	Indicador derivado de respaldo; no prueba por sí solo pago o recepción.
`hasInvoice`	`boolean`	Respuesta	Indicador derivado de factura respaldada.
`amountInSelection`	`string`	Respuesta	Porción del pago que corresponde a los filtros. amount conserva el importe original.
`categories`	`array`	Respuesta	Rubros de las aplicaciones, calculados.