VerifikaDocs
ReferenciaConciliación bancaria

Ignorar una fila

«No va en el libro»: un traslado entre cuentas propias, por ejemplo.

POST
/bank-statements/{id}/lines/{lineId}/ignore

Autorización

apiKey reconciliation.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: reconciliation.write

Parámetros de la ruta

id*string
lineId*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.

Parámetros de cabecera

Idempotency-Key?string

Llave única de la operación. Un reintento con la misma llave y el mismo cuerpo devuelve la respuesta original en vez de volver a ejecutar. Ver la guía de idempotencia.

Longitudlength <= 255

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/bank-statements/cmuh8q2r70044x8w1b6n3m1kd/lines/cmuh8q2s90045x8w1z5c4v2ep/ignore"
{  "object": "bankStatementLineAction",  "action": "ignore",  "outcome": "APPLIED",  "line": {    "object": "bankStatementLine",    "id": "cmuh8q2s90045x8w1z5c4v2ep",    "statementId": "cmuh8q2r70044x8w1b6n3m1kd",    "seq": 17,    "page": 1,    "date": "2026-09-12",    "time": null,    "postDate": null,    "description": "TRANSFERENCIA DESDE NEQUI",    "reference": "00812345",    "amount": 120000,    "direction": "in",    "balance": 2410500,    "fee": null,    "feeTax": null,    "withholding": null,    "bankFeeCategory": null,    "status": "IGNORED",    "matchMethod": null,    "matchScore": null,    "resolvedAt": "2026-10-12T21:10:44.000Z",    "inheritedDate": false,    "rawText": "2026/09/12 TRANSFERENCIA DESDE NEQUI 00812345 120,000.00 2,410,500.00",    "income": null,    "expense": null  },  "statement": {    "id": "cmuh8q2r70044x8w1b6n3m1kd",    "progress": {      "total": 64,      "resolved": 52,      "pending": 12,      "percentResolved": 81    },    "groups": {      "matched": {        "count": 38,        "amount": 4104300      },      "registered": {        "count": 1,        "amount": 120000      },      "bankFees": {        "count": 13,        "amount": 26443.62      },      "ignored": {        "count": 0,        "amount": 0      },      "missingIncomes": {        "count": 5,        "amount": 648000      },      "missingExpenses": {        "count": 7,        "amount": 1843200      },      "onlyInVerifika": {        "count": 2,        "amount": 95000      }    }  }}

Registrar una fila en el libro POST

Registra la fila: una **entrada** nace como ingreso `PENDING` con `origin: BANK` («lo vio el banco»); una **salida**, como gasto (pide además `expenses.write`; `categoryId` opcional). Repetirla contesta `ALREADY_DONE` sin crear nada.

Deshacer una fila POST

Deshace lo resuelto y la vuelve a cruzar. **No borra** lo que se registró en el libro: casi siempre la fila vuelve a quedar `MATCHED` con ese mismo movimiento.