09. Integraciones
Integraciones Externas Identificadas
1. Google Cloud Pub/Sub
- Objetivo: Mensajería asíncrona, orquestación de eventos de facturación o notificación.
- Tecnología:
spring-cloud-gcp-starter-pubsub(4.5.1). - Componentes:
PubSubController,PubSubRestController,ChannelAdapter. - Configuración:
pub-sub-consumer.json.
Tópicos y Suscripciones Identificadas:
| Tópico / Suscripción (Prefijo) | Uso / Propósito | Tipo (Interna/Externa) |
|---|---|---|
facturacion-inicio | Tópico principal para el inicio del flujo de facturación. | Interna |
facturacion.enlace.* | Flujo asíncrono para facturación por enlace (solicitado, en proceso, procesado, completado, fallido). | Interna |
facturacion.cierre.* | Orquestación de procesos de cierre e integraciones (ADIVAL, SIDEFF, SICOFA, SVD, AS400). | Interna |
facturacion.en.linea.* | Flujo de mensajería para facturación en línea desde portal. | Interna |
facturacion.nomina.* | Orquestación del procesamiento de nómina (carga y timbrado masivo de archivos TXT/XML). | Interna |
Nota: Se catalogan como Internas porque, aunque Google Cloud Pub/Sub es un servicio administrado en la nube (externo), estos tópicos y suscripciones se utilizan exclusivamente para la orquestación asíncrona de los componentes dentro de la arquitectura del proyecto Alpura Facturación.
2. Base de Datos
- Objetivo: Almacenamiento de transacciones y estados.
- Tecnología: PostgreSQL / H2 (Vía JDBC).
Conexiones a Base de Datos Configuradas:
| Entorno / Identificador | URL JDBC | Tipo (Interna/Externa) | Credenciales |
|---|---|---|---|
| Primaria (Prod/Stage) | jdbc:postgresql://172.21.192.3:5432/alpura_facturacion_pre_prod | Interna | (Gestionadas vía Secrets) |
| Secundaria (Dev/QA) | jdbc:postgresql://104.154.147.131:5432/omnicanal | Interna | (Gestionadas vía Secrets) |
| Base H2 (Memoria) | jdbc:h2:mem:facturacion_db | Interna | (En Memoria) |
Nota de Seguridad: Las credenciales de conexión no se documentan aquí; se inyectan en tiempo de ejecución a través del servicio de secretos de la infraestructura.
3. Servicios REST de Terceros o Internos
- Objetivo: Integraciones HTTP síncronas.
- Tecnología:
Apache HttpClient5,RestTemplate. - Configuración:
RestTemplateConfigpara timeouts.
URLs de Consumo Identificadas:
| Servicio / Proceso | URL / Dominio Base (Ejemplo ambiente dev/uat) | Tipo |
|---|---|---|
| SSO / Keycloak (Alpura) | https://sso-dev.alpura.com/...https://hub-uat-login.alpura.com/... | Interno |
| APIM Alpura (Catálogos, Notificaciones, Docs, Reportes, Enlaces) | https://apw-uat.alpura.com:8243/... | Interno |
| Oracle Integration Cloud (OIC) (Cancelación, Sideff, SVD, Sicofa, Adival, AP, AR, Addendas) | https://oic-ash-dev-idhnamyewasy-ia.integration.us-ashburn-1.ocp.oraclecloud.com/... | Externo |
| Pegaso Tecnología (Timbrado) | https://gwcloudqa.pegasotecnologia.mx/... | Externo |
| Click Factura (Timbrado / Cancelación) | https://www.clickfactura.co/...https://timbrado-soa-click-factura-... | Externo |
| SAT (Valida CFDI) | https://consultaqr.facturaelectronica.sat.gob.mx/... | Externo |
4. SFTP / SSH (JSch)
- Objetivo: Descarga, carga o integración de archivos planos (especialmente nómina).
- Tecnología: JSch (0.1.55).
- Conexión Identificada: El sistema realiza conexiones SFTP apuntando al host
129.80.18.67. - Tipo de Conexión: Externa (IP Pública). Se utiliza para el procesamiento (lectura de directorios, carga y descarga de archivos XML/TXT).