Notificaciones

En esta página encontrarás una explicación de las notificaciones asíncronas enviadas por Koncili.

---

Koncili envía notificaciones automáticas mediante solicitudes HTTP POST a la URL de callback registrada previamente por el integrador. Todas las notificaciones siguen rigurosamente el siguiente formato JSON:

Importante

El endpoint de notificación debe ser público para permitir la recepción de los mensajes.

{
  "notificationType": "TIPO_EVENTO",
  "timestamp": "ISO8601",
  "payload": {
    // Datos específicos del evento
  }
}

Tipos de notificación

A continuación se listan todos los tipos de notificación que Koncili puede enviar; la respuesta esperada para todos es:

HTTP/1.1 200 OK
Content-Type: application/json

{"status": "success"}

1. Prueba de la URL de notificación

{
  "notificationType": "TEST_NOTIFICATION",
  "timestamp": "2025-06-13T15:00:00Z",
  "payload": null
}

2. Cuenta creada

Se dispara cuando se activa una nueva cuenta:

{
  "notificationType": "ACCOUNT_CREATED",
  "timestamp": "2025-06-13T15:00:00Z",
  "payload": {
    "accountId": 1234,
    "status": "ACTIVE"
  }
}

3. Conciliación finalizada

Se envía cuando concluye un proceso de conciliación:

Información

Aquí hay dos escenarios posibles de notificación: conciliación finalizada con éxito y con error.

{
  "notificationType": "RECONCILIATION_COMPLETED",
  "timestamp": "2025-06-13T15:00:00Z",
  "payload": {
    "accountId": 1234,
    "reconciliationId": 4321,
    "resolvedEndDate": "2025-06-13T16:00:00Z",
    "situation": "CONCILIED"
  }
}

{
  "notificationType": "RECONCILIATION_COMPLETED",
  "timestamp": "2025-06-13T15:00:00Z",
  "payload": {
    "accountId": 1234,
    "reconciliationId": 4321,
    "resolvedEndDate": null,
    "situation": "ERROR"
  }
}

4. Bloqueo temporal

Se dispara cuando la API se bloquea temporalmente:

{
  "notificationType": "BLOCKED_TEMPORARY",
  "timestamp": "2025-06-13T15:00:00Z",
  "payload": {
    "integratorName": "INTEGRATOR NAME",
    "durationMinutes": 60
  }
}

5. Bloqueo permanente

Se envía en casos de intentos recurrentes después de un bloqueo temporal:

{
  "notificationType": "BLOCKED_PERMANENT",
  "timestamp": "2025-06-13T15:00:00Z",
  "payload": {
    "integratorName": "INTEGRATOR NAME",
  }
}

6. Desbloqueo

Notificación de liberación del acceso:

{
  "notificationType": "UNLOCKED",
  "timestamp": "2025-06-13T15:00:00Z",
  "payload": {
    "integratorName": "INTEGRATOR NAME",
  }
}