Integraciones

Aquí se documenta cada sistema externo o capa de exposición con tres ejes: qué es (ficha), qué APIs o contratos están descritos en el handbook, y qué flujo conviene seguir para entender el recorrido completo.

Complementa Arquitectura (monorepo y core) y enlaza con API Reference y Producto · Flujos e integraciones cuando el tema cruza capas.

Mapa interactivo

Cada tarjeta agrupa la ficha de integración, las APIs o contratos documentados y los flujos donde tiene sentido leerlos en orden. Los datos salen de src/data/integracionesHub.ts (menú dinámico).

Orquestador de emisión

Dispatch (`/api/integrations/...`), contrato StandardRiskItem, adaptadores (Phoenix, AMA, …), reintentos e historial de emisiones. Punto central entre el core y los proveedores externos.

Guía del orquestador →

APIs y contratos

• Superficies REST (dispatch, post-sales)

Flujos y secuencias

• Integraciones en el código
• Risk item (contrato)

Plataforma común

Cómo está montada la capa de integraciones en el monorepo y los contratos hacia proveedores externos (complementa la guía del orquestador).

Integraciones (código) →

APIs y contratos

• Superficies REST (mapa HTTP)

Flujos y secuencias

• Risk item (contrato operativo)

Phoenix

Emisión y catálogos hacia la plataforma Phoenix por línea de negocio (viaje, salud, hogar, etc.).

Ficha Phoenix →

APIs y contratos

• Contrato StandardRiskItem (orquestador)
• Shield · rutas (integrations)

Flujos y secuencias

• Dispatch y diagrama de emisión

AMA

Adaptador de emisión hacia AMA con mapeo de beneficiarios y payloads propios.

Ficha AMA →

APIs y contratos

• Orquestador (mismo contrato)

Flujos y secuencias

• Flujos e integración (producto)

Pagos (Silice / Reef)

Tokenización Silice, widget Reef en el monorepo, payment widget por iframe (repo aparte) y cierre vía processPayment.

Ficha Silice y Reef →

APIs y contratos

• Superficies REST (payments / processPayment)

Flujos y secuencias

• Flujo de pagos (producto)
• Suscripciones y cobros

Desarrollo (monorepo)

• Payment widget (iframe, postMessage)
• Código monorepo: reefWidget, components/pay

Shield (API REST)

API HTTP estable para partners: autenticación por namespace, risk items, reclamos, catálogo.

Qué es Shield →

APIs y contratos

• Shield · introducción
• Autenticación y tokens
• Inventario de rutas
• Namespaces y consumidores

Flujos y secuencias

• Flujos y ejemplos curl

Postventa (titular)

OTP, JWT post-sales y rutas acotadas para el portal del titular; emisión post-cambio con orquestador.

Resumen postventa →

APIs y contratos

• API Post-sales (referencia)

Flujos y secuencias

• Diagrama OTP (SVG)
• Flujos e integraciones

Fenicio (experimental)

POC de solo lectura contra la API de Fenicio (orders y stocks) vía rutas Shield. Dev-only, aún no persiste en el modelo del core.

Ficha Fenicio →

APIs y contratos

• Shield · inventario de rutas

Ficheros Carrefour (MAPFRE)

Exportación de la cartera Carrefour a MAPFRE como ficheros (EIAC, RIC, SSAA/OPEN_SYSTEMS, MIC, pagos) generados por orden y despachados por SFTP.

Pipeline y despacho →

Flujos y secuencias

• Familias de ficheros y slugs

Canal Vidanta

Landing y experiencia del canal; sincronización con integraciones tras cambios.

Qué es el canal Vidanta →

APIs y contratos

• Post-sales (si aplica al flujo)

Flujos y secuencias

• Flujo landing (producto)

Desarrollo (monorepo)

• Guía técnica del landing (Next.js)

Alertas y Supabase

Discord en tiempo real, correos por skill y Edge Functions con cron (pg_cron) para reportes.

Alertas y operación →

APIs y contratos

• Workflows y skills (contexto)

Flujos y secuencias

• Notificaciones, skills y Edge

Relación con otras áreas

• Producto: Flujos e integraciones
• API Reference: Introducción
• Guías de desarrollo (landings, tRPC, componentes): Guías de Desarrollo

La navegación principal es el mapa de tarjetas (datos en src/data/integracionesHub.ts). El lateral resume Orquestador, fichas por proveedor y enlaces a API Reference; el detalle por capa sigue enlazado desde cada tarjeta.