VerifikaDocs
ReferenciaCuentas por cobrar

Historial de un cliente

Todos los movimientos de un cliente, paginados por cursor, recientes primero. balanceAfter es el saldo justo después de cada uno: el estado de cuenta se lee de arriba abajo sin que la columna mienta.

Permiso: receivables.read.

GET
/receivables/{id}/entries

Autorización

apiKey receivables.read
AutorizaciónBearer <token>

La llave del negocio, creada en el panel: Integraciones → API pública. vk_live_… es una llave real; vk_test_…, una llave de modo prueba (verificaciones simuladas, nada toca el libro real). Ver la guía «Modo de prueba».

Va en: header

Permiso: receivables.read

Parámetros de la ruta

id*string

Id del cliente (la cuenta por cobrar).

Parámetros de consulta

companyId?string

Sobre qué negocio actúa la petición. Obligatorio solo si la llave entra a varios negocios; con uno solo, se deduce.

limit?integer

Filas por página.

Rango1 <= value <= 100
Por defecto50
startingAfter?string

Cursor: el nextCursor de la página anterior.

type?string

Tipos a incluir, separados por coma: CHARGE, PAYMENT, WRITE_OFF. Sin el parámetro, todos.

includeVoided?boolean

Incluir los anulados. Por defecto sí; false deja solo lo que cuenta para el saldo.

Por defectotrue

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/receivables/string/entries"
{  "object": "list",  "data": [    {      "object": "receivableEntry",      "id": "cmu4h7r2t0014bnw1y2e6kd9v",      "accountId": "cmu4a2k9x000b7qw1h3r5tz8e",      "type": "PAYMENT",      "amount": 80000,      "currency": "COP",      "balanceAfter": 170000,      "note": "Abono en efectivo, caja 2",      "occurredAt": "2026-09-26T21:05:33.000Z",      "createdAt": "2026-09-26T21:05:33.118Z",      "source": "API",      "createdBy": null,      "voided": false,      "voidedAt": null,      "voidedBy": null    },    {      "object": "receivableEntry",      "id": "cmu4a2kb4000d7qw1c5x8fj3n",      "accountId": "cmu4a2k9x000b7qw1h3r5tz8e",      "type": "PAYMENT",      "amount": 50000,      "currency": "COP",      "balanceAfter": 250000,      "note": "Abono inicial",      "occurredAt": "2026-09-22T14:12:08.431Z",      "createdAt": "2026-09-22T14:12:08.432Z",      "source": "API",      "createdBy": null,      "voided": false,      "voidedAt": null,      "voidedBy": null    }  ],  "hasMore": true,  "nextCursor": "cmu4a2kb4000d7qw1c5x8fj3n"}

Resumen del cuaderno GET

Cuánto le deben al negocio, cuántos clientes deben, cuánto está vencido, lo fiado y lo abonado en un periodo, el reparto por etapa y los cinco que más deben. Sumado en la base: es la misma cifra que muestra el panel. Acepta los mismos filtros que `GET /v1/receivables` (el orden y la paginación no aplican). Los `*InRange` usan el periodo que dice `range` — por defecto, el mes en curso en Bogotá. Permiso: `receivables.read`.

Listar clientes que deben GET

El cuaderno de fiados, un cliente por fila con su saldo, paginado por cursor. Por defecto, quien más debe primero. Acepta **los mismos filtros** que el tablero y el Excel del panel: si lo que lee tu integración y lo que ve la dueña salieran de filtros distintos, dirían cosas distintas del mismo cuaderno. Para totales usa `GET /v1/receivables/summary`, no sumes páginas. Permiso: `receivables.read`.