Manual de Integración con El Corte Inglés (Ágora) en Connect Manager#
1. Introducción#
Este manual describe paso a paso cómo configurar la integración entre El Corte Inglés y Ágora a través de Connect Manager. El objetivo es dejar operativo el envío/recepción de pedidos en el entorno de El Corte Inglés, pasando primero por un entorno de pruebas (PRE) y finalizando en el entorno real de producción (PRO).
El proceso implica la coordinación de tres partes: el distribuidor, El Corte Inglés y (en la fase final) los informáticos de El Corte Inglés, que son quienes activan la integración en su propio terminal.
2. Solicitud de precredenciales#
Se debe enviar un correo a extensibilidadpuntodeventaECI@elcorteingles.es indicando a quién se le va a realizar la integración, y solicitando los datos necesarios en el entorno de Pre (pruebas):
Matrícula
Referencia interna del producto a enviar
Nota: El Corte Inglés distingue entre Pre (entorno de pruebas) y Pro (entorno real/producción). En esta primera solicitud siempre se piden los datos de Pre.
3. Datos recibidos de El Corte Inglés#
El Corte Inglés responde con los datos de matrícula y referencia interna del producto, diferenciados por entorno:
Entorno PRE (pruebas)
Matrícula:
00000000Referencia interna del producto:
000000
Entorno PRO (producción)
Matrícula:
00000000Referencia interna del producto:
00000000(IVA 21%)00000000(IVA 10%)
Estos datos de PRO se guardan de referencia, pero no se utilizan hasta que El Corte Inglés confirme las pruebas (ver punto 8).
4. Credenciales de acceso#
En un correo aparte, El Corte Inglés envía las credenciales de acceso a la integración:
Client ID:
00000000000Client Secret:
0000000000000
⚠️ Estas credenciales dan acceso directo a la plataforma. Deben tratarse como información confidencial y no compartirse fuera del equipo de configuración.
5. Endpoints del entorno de pruebas (PRE)#
Para realizar las pruebas se deben usar siempre estos endpoints:
URL API:
https://api-manager-nft.pre.elcorteingles.es/URL AUTH:
https://identity-services.nft.elcorteingles.es/oauth2/token
6. Configuración de la acción personalizada (botón) en Ágora#
Dentro de la integración se genera una URL propia de la integración.
Esa URL se coloca en Ágora, dentro de una Acción personalizada, para crear un botón.
⚠️ Importante: No se debe configurar en el servicio de Ágora el envío de documentos.
7. Pruebas#
Con el botón ya creado, se genera un ticket de prueba.
Se cierra la operación utilizando la acción personalizada (el botón) creada en el paso anterior.
8. Aviso a El Corte Inglés y confirmación#
Una vez realizadas las pruebas, se envía un correo a El Corte Inglés indicando que las pruebas se han completado, quedando a la espera de su confirmación.
Cuando El Corte Inglés confirme el resultado de las pruebas (OK), facilitará los datos definitivos de producción.
9. Paso a producción#
Tras la confirmación de El Corte Inglés, se deben sustituir todos los datos de PRE por los de PRO:
Matrícula (PRE → PRO)
Referencia interna del producto (PRE → PRO)
Client ID / Client Secret (nuevos, de producción)
URL API y URL AUTH del entorno PRO
Actualizar/regenerar la URL de la acción personalizada en Ágora si corresponde al nuevo entorno
10. Configuración final por parte de El Corte Inglés#
Con los datos de producción ya sustituidos, el proceso pasa a manos del equipo informático de El Corte Inglés, que desde su terminal debe:
Configurar la integración 55.
Seleccionar el local correspondiente a la integración.
11. Verificación final#
Comprobar que la integración aparece activa.
Confirmar que los pedidos de prueba/producción se reciben correctamente en Ágora.
Verificar que el botón de la acción personalizada funciona correctamente y no está configurado el envío de documentos.