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. 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: 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; 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.

Listar egresos GET

Gastos del negocio, paginados por cursor. Requiere el módulo de egresos en el plan además del permiso expenses.read.