Event-Hub

El servicio Event-Hub está diseñado para notificar en tiempo real todos los movimientos de tipo débito y crédito que ocurran en las cuentas propias de una empresa. Este servicio está pensado para empresas que gestionan cuentas en el banco y desean estar informadas de manera inmediata sobre las transacciones realizadas en sus cuentas.

Características principales

1. Notificaciones de movimientos: El servicio envía notificaciones automáticas sobre:
   • Movimientos de débito.
   • Movimientos de crédito.
2. Capa de seguridad: Event-Hub protege la integridad de los datos mediante el uso de una API Key que autentica todas las solicitudes.
3. Con dos (2) reintentos: Las notificaciones incluyen un mecanismo de hasta dos reintentos en caso de recibir respuestas con código 500 o por timeout. Es decir, se envía la notificación original más dos intentos adicionales. Es responsabilidad del cliente asegurarse de que su sistema pueda recibir y procesar las notificaciones correctamente.

Recomendaciones de integración

1. Validación flexible del body del request:
   • Se recomienda no implementar validaciones demasiado estrictas en los datos recibidos en las notificaciones.
   • En caso de detectar un cambio inesperado en los datos del body, se recomienda reportarlo a soporte en lugar de rechazar las notificaciones. Esto evitará la pérdida de información valiosa.
2. Validación de unicidad del ID de operación:
   • Es importante validar que el ID de operación incluido en cada notificación sea único.
   • Esto permite evitar errores relacionados con duplicados de notificaciones y asegura la consistencia de los registros procesados.
3. Conciliación de movimientos:
   • Es altamente recomendable integrarse con la API de consulta de movimientos del banco.
   • Esto permite verificar y conciliar las transacciones notificadas, asegurando que todas las operaciones hayan sido correctamente registradas.

Beneficios

• Notificaciones en tiempo real: Mantiene a las empresas informadas de los movimientos en sus cuentas al instante.
• Seguridad robusta: Garantiza que solo las aplicaciones autorizadas puedan acceder al servicio.
• Simplificación de operaciones: Ayuda a automatizar la supervisión de las cuentas sin necesidad de verificaciones manuales constantes.
• Prevención de errores: La integración con la API de consulta de movimientos proporciona una herramienta adicional para garantizar la integridad de la información recibida.

Event-Hub es una solución ágil y segura que permite a las empresas optimizar la gestión de sus cuentas bancarias y responder de manera oportuna a cualquier transacción registrada. En los próximos apartados, se detallarán las especificaciones técnicas y los pasos necesarios para la integración con este servicio.

Datos necesarios para recibir notificaciones

Para recibir las notificaciones de dicho servicio es necesario que nos informen los siguientes datos:

• URL que recibirá la notificación. Esta debe tener el endpoint detallado en la documentación aqui expuesta
• Formato de notificación: json.
• ApiKey necesaria para autenticarse al endpoint disponibilizado:
  • Deben aceptar un header con el nombre x-api-key.
  • El valor lo determinan ustedes para cada ambiente (QA y PROD).
  • Debe ser enviado a nuestro equipo de ciberseguridad a la casilla de correo: [email protected]
  • Informar que ya se enviaron las credenciales a ciberseguridad a [email protected]
    Los datos a informar son:
    • Asunto
    • Remitente
    • Fecha y hora de envío.

Visualización de códigos de movimiento

Para tener el detalle de todos los códigos de movimiento informados por el Event-Hub, pueden consultar:

• Códigos de Movimiento - Caja de Ahorro
• Códigos de Movimiento - Cuenta Corriente

Estructura de respuesta JSON

El servicio ofrecerá la siguiente estructura tras cada movimiento detectado de las cuentas informadas.

{
  "account": {
    "number": "825213",
    "type_account": "CC",
    "currency": "ARS"
  },
  "addinfo": {
    "operation_description": "370",
    "operation_id": "20210511124728105235",
    "operation_date": "11-05-2021 12:47:28",
    "cuil_origin": "30517016185",
    "name_origin": "FGSS DA EMPRESA AB JS",
    "amount": "40500.00",
    "reversal": false,
    "business_date": "11-05-2021",
    "completed_date": "11-05-2021"
  },
  "add_data_api": {
    "request_id": "",
    "timestamp": ""
  }
}