Encender una interconexión

Una interconexión describe en un solo sitio todo lo necesario para hablar con una contraparte:

• por dónde entra su tráfico (la entrada) y a quién se le entrega (la salida);
• cómo se codifica y qué campos se traducen;
• qué tubería corre;
• sus políticas de stand-in, cola y totales.

Es una plantilla versionada que se exporta y se importa. Esta guía la lleva de borrador a activa.

1. Administrador

   1. 1. Importar o construirEntra como borrador
   2. 2. Revisar el flujoPasos, campos y nodo de salida
   3. 3. SimularRequisito para pedir la activación
   4. 4. CertificarContra el banco simulado; informe con evidencia
   5. 5. Solicitar la publicación

2. Otra persona

   1. 6. AprobarSolo aquí se llama al switch

Antes de empezar

• Necesitas el rol de administrador de la consola, y que la credencial del switch tenga el alcance de cambiar interconexiones.
• Ten a mano lo que pactaste con la contraparte: su especificación, el enmarcado, quién marca a quién, si exige inicio de sesión y la política de stand-in. Lo resume la ruta del integrador.
• El nodo de salida tiene que existir. Si la contraparte marca hacia nosotros (nodo servidor), su alta se hace hoy por la API del switch: la consola todavía no da de alta nodos servidor.

1. Importar o construir la plantilla

1. Abre Operación › Interconexiones.
2. Elige una de dos:
   • Importar: sube el archivo de plantilla que te mandó la contraparte, o pégalo.
   • Asistente: construye la misma plantilla paso a paso, sin escribir el archivo a mano. La pestaña Plantilla YAML muestra lo que se enviará: se lee, no se escribe.
3. Guarda. El switch la recibe como borrador, con una versión nueva. El tráfico no cambia.

Si el switch la rechaza, el mensaje señala la ruta del campo que sobra o que falta. Un campo desconocido se rechaza en vez de ignorarse, para que un código de nodo mal escrito no se pierda en silencio.

El cifrado de la plantilla es declarativo

La plantilla viaja por correo; no es lugar para rutas de certificados ni claves. Quien abre de verdad el puerto con cifrado es la configuración del switch, y si no puede cargar su certificado, el puerto no se abre.

2. Revisar el flujo dibujado

1. Abre la ficha de la interconexión y ve a la pestaña Flujo.
2. Comprueba los pasos que corren, en su orden real de ejecución.
3. Revisa el mapeo de campos: qué se escribe o se lee en cada campo, incluidos los privados.
4. Comprueba a qué nodo sale.

3. Simular

1. En la misma pestaña Flujo, simula con un tipo de mensaje y unos campos de prueba.
2. Lee el resultado: cada paso queda marcado como ejecutado o saltado, con el motivo que dio el switch, y se ve a qué nodo se entregaría y si aplicaría stand-in.
3. Simula al menos una compra, un reverso y un cierre.

Simular no mueve nada. Y es obligatorio: sin simular esa versión, no se puede pedir su activación.

4. Certificar

1. Ve a la pestaña Certificación.
2. Elige el objetivo:
   • Simulador: el switch levanta una contraparte simulada dentro de sí mismo. Sirve para ensayar el guion.
   • Nodo: el host real de la contraparte. Solo cuando ella esté lista y lo haya acordado.
3. Corre la batería. Solo puede haber una corrida a la vez por interconexión.
4. Lee el informe caso por caso:
   • Aprobado o fallido: se ejecutó de verdad.
   • Omitido: no se pudo ejecutar, siempre con su causa. Un omitido no es un fallido. Si la limitación es nuestra, el informe lo dice así.
5. Descarga el informe en PDF para el expediente de la contraparte.

El peor error posible

Certificar contra el simulador creyendo que era el banco. Antes de entregar un informe, comprueba el objetivo de la corrida.

5. Solicitar la publicación

1. Ve a la pestaña Publicación.
2. Solicita activar la versión simulada. Escribe una nota: qué cambia y por qué.
3. Avisa a quien aprueba. Mientras tanto, la solicitud queda pendiente y el tráfico sigue igual.

6. La aprobación

La hace otra persona: Aprobar una publicación. Cuando aprueba, la consola llama al switch y la versión queda activa; la anterior deja de estarlo.

Si algo sale mal

Mensaje o síntoma	Qué hacer
«No me deja activar»	Falta simular esa versión, o eres quien la va a aprobar. Las dos cosas son a propósito
«Importé y no cambió nada»	Correcto: importar crea un borrador. Cambiar el tráfico es el paso 6
Ya existe una solicitud pendiente	Solo puede haber una por interconexión. Resuelve o retira la anterior
La certificación sale con omitidos	Lee la causa de cada uno; la contraparte decide si le vale
El switch lo rechazó al aprobar	La credencial de la consola no tiene el alcance de cambiar interconexiones. La solicitud sigue pendiente

Qué sigue

• Publicación a cuatro ojos
• Cómo rutea Aurora