VerifikaDocs
ReferenciaConciliación bancaria

Volver a cruzar

Vuelve a cruzar el extracto contra el libro (útil después de registrar pagos que faltaban). Lo resuelto a mano se respeta.

POST
/bank-statements/{id}/rematch

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

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

curl -X POST "https://example.com/bank-statements/cmuh8q2r70044x8w1b6n3m1kd/rematch"
{  "object": "bankStatement",  "id": "cmuh8q2r70044x8w1b6n3m1kd",  "status": "processed",  "fileName": "extracto-bancolombia-septiembre.pdf",  "format": "PDF",  "kind": "ACCOUNT",  "bank": {    "key": "bancolombia",    "name": "Bancolombia"  },  "accountLast4": "8300",  "accountType": "AHORROS",  "paymentAccount": {    "id": "cmt7xbfs10005q3w1u8k2c9va",    "provider": "BANCOLOMBIA",    "alias": "Ahorros principal",    "last4": "8300"  },  "currency": "COP",  "periodStart": "2026-09-01",  "periodEnd": "2026-09-30",  "pages": 3,  "verdict": "VERIFIED",  "balances": {    "opening": 1250000,    "closing": 3184520.37  },  "totals": {    "credits": 4872300,    "debits": 2937779.63,    "lineCount": 64  },  "bankSummary": {    "opening": 1250000,    "closing": 3184520.37,    "credits": 4872300,    "debits": 2937779.63,    "gmf": 11751.12,    "yields": 412.5,    "interest": null,    "fees": 14280  },  "difference": {    "closingBalance": 0,    "credits": 0,    "debits": 0  },  "checks": [    {      "key": "balance",      "label": "Saldo final",      "status": "PASS",      "expected": 3184520.37,      "actual": 3184520.37,      "detail": "El saldo inicial más los movimientos da el saldo final del banco."    }  ],  "warnings": [],  "hasOriginal": true,  "matchedAt": "2026-10-12T21:03:11.000Z",  "createdAt": "2026-10-12T21:03:02.000Z",  "progress": {    "total": 64,    "resolved": 51,    "pending": 13,    "percentResolved": 80  },  "groups": {    "matched": {      "count": 38,      "amount": 4104300    },    "registered": {      "count": 0,      "amount": 0    },    "bankFees": {      "count": 13,      "amount": 26443.62    },    "ignored": {      "count": 0,      "amount": 0    },    "missingIncomes": {      "count": 6,      "amount": 768000    },    "missingExpenses": {      "count": 7,      "amount": 1843200    },    "onlyInVerifika": {      "count": 2,      "amount": 95000    }  },  "onlyInVerifika": {    "object": "list",    "data": [      {        "incomeId": "cmufa1b2c0009x8w1q4w5e6rt",        "amount": 45000,        "occurredAt": "2026-09-18T15:02:00.000Z",        "day": "2026-09-18",        "customerName": "Juan Pérez",        "status": "VERIFIED",        "origin": "WHATSAPP",        "reference": "M1A2B3C4",        "bankLabel": "Nequi",        "accountLabel": "Ahorros *8300",        "seenByBank": true      }    ],    "hasMore": true  },  "deductions": {    "fee": 0,    "feeTax": 0,    "withholding": 0  },  "bankFeeCategories": [    "GMF",    "CUOTA_MANEJO",    "RENDIMIENTOS"  ]}

Listar extractos GET

Los extractos leídos, del más reciente al más viejo, con su `progress`. Los que se están leyendo no salen aquí: consúltalos por id.

Descargar el reporte GET

El mismo «Descargar reporte» del panel: Excel (Resumen · Movimientos · Solo en Verifika), PDF o CSV. Responde el archivo binario con `Content-Disposition: attachment`.