VerifikaDocs
ReferenciaIngresos

Corregir un ingreso declarado

Solo funciona sobre ingresos DECLARED. Nunca toca status ni origin.

PATCH
/incomes/{id}

Autorización

apiKey incomes.write
AutorizaciónBearer <token>

La llave del negocio, creada en el panel: Integraciones → API pública. Formato vk_live_… (o vk_test_… fuera de producción).

Va en: header

Permiso: incomes.write

Parámetros de la ruta

id*string

Parámetros de consulta

companyId?string

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

Cuerpo de la petición

application/json

Tipos de TypeScript

Usa el tipo request body en TypeScript.

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/incomes/string" \  -H "Content-Type: application/json" \  -d '{    "customerName": "Juan P."  }'
{  "object": "income",  "id": "cmtnoxo4s00066kw1mgbyuzdd",  "amount": 45000,  "currency": "COP",  "status": "DECLARED",  "origin": "DECLARED",  "occurredAt": "2026-09-04T15:00:00.000Z",  "createdAt": "2026-09-04T15:02:11.104Z",  "verifiedAt": null,  "reference": "TX-9912",  "customerName": "Juan P.",  "bankLabel": "Nequi",  "accountLabel": null,  "duplicateOfId": null,  "branch": {    "id": "cmt7xbfrj0002q3w1iq4ysatr",    "name": "Principal"  },  "confirmedBy": {    "id": null,    "name": "ERP del contador",    "phone": null  },  "attachments": [],  "bankChannels": []}

Listar ingresos GET

Lista los pagos del negocio, del más reciente al más antiguo, paginada por cursor. Acepta los mismos filtros que el panel: si el reporte que descarga el dueño y lo que lee tu integración salieran de filtros distintos, dirían cosas distintas del mismo mes.

Registrar un egreso POST

Queda con source: "API", para que en el libro se distinga lo que escribió un sistema de lo que escribió una persona.