Cuando una organización cambia de proveedor Peppol, los registros SMP deben transferirse. Durante el cambio, el Participant ID sigue registrado, de modo que los remitentes pueden seguir enviando. El PSB ofrece dos escenarios de migración a través de la API.

Sin clave de migración si no hay registro de recepción: si la party no tiene un registro de recepción Peppol activo vía eConnect (ningún claim SMP de recepción), no hay nada que migrar y prepareToMigrate no hace falta. Registra la recepción directamente en el nuevo proveedor. Solo envío con un claim SMP aún en eConnect no es lo mismo que "sin registro de recepción": el claim sigue ocupado y la clave de migración sigue siendo necesaria para liberarlo.

Si una party pasa de eConnect a otro proveedor Peppol Access Point, prepara la migración a través del endpoint prepareToMigrate:

GET /api/v1/peppol/{partyId}/prepareToMigrate

Este endpoint hace dos cosas:

1. Marca la party en el SMP de eConnect como "en migración"
2. Registra una clave de migración en el SML de Peppol

La API devuelve la clave de migración en la respuesta. Entrega esta clave al nuevo proveedor, que la necesita para asumir el registro en su SMP.

{
  "migrationKey": "abc123-def456-ghi789"
}

Al completarse, el Service Group del SMP de eConnect se retira, en su caso con una redirección temporal para evitar una interrupción.

Si una party llega a eConnect desde otro proveedor Peppol Access Point, necesitas la clave de migración que el proveedor actual ha generado. Añade esta clave a la configuración de la party mediante:

PUT /api/v1/peppol/config/party/{partyId}

Con el objeto migration en el cuerpo de la petición:

{
  "migration": {
    "key": "la-clave-de-migracion-del-proveedor-actual"
  }
}

El PSB completa la migración automáticamente: se asume el registro SMP y se actualiza el SML. A partir de ese momento, todos los mensajes Peppol de esta party pasan por el Access Point de eConnect.

Si la clave de migración no es válida o ha caducado, la migración falla y la API devuelve un mensaje de error. En ese caso, solicita una nueva clave al proveedor actual.

Ruta no-API (clientes de la plataforma): empieza en la plataforma en Mi entorno → Cancelar cuenta → Migrar. Una solicitud de soporte suelta no es la ruta del cliente. Sin acceso al portal, soporte inicia el formulario de baja. Tras el formulario, la clearance financiera y el tratamiento por superadmin support, recibes el código de migración en un correo seguro de TechSupport, no en un ticket ni en un correo de anuncio. Entrégalo solo al nuevo proveedor. Dos condiciones: (a) el cliente da a eConnect una instrucción escrita/legal, y (b) el cliente no tiene obligaciones financieras pendientes con eConnect. Los pasos siguientes describen el procedimiento equivalente vía API.

Intermediario/en bloque sin rol de Administrador: un intermediario que solo tiene una autorización (sin rol de Administrador) sobre organizaciones de clientes normalmente no puede iniciar por sí mismo una baja/migración de autoservicio para esas organizaciones. Para un cambio en bloque de varias organizaciones/entornos de clientes, esto se gestiona a través de soporte (una clave de migración por identificador Peppol) — no revocando las claves de conexión. Revocar las claves de conexión solo rompe el enlace de la API y no es una baja del registro SMP.

Número de claves en solicitudes en bloque: el número de claves de migración únicas puede ser menor que el número de organizaciones en la solicitud — solo las organizaciones con un registro de recepción activo reciben una clave. Varios correos con las mismas claves únicas conforman juntos una entrega completa una vez que todos los identificadores Peppol a migrar están cubiertos.

1. La party decide cambiar a otro proveedor
2. Llama a GET /api/v1/peppol/{partyId}/prepareToMigrate
3. Entrega la clave de migración al nuevo proveedor
4. El nuevo proveedor asume el registro SMP con la clave
5. El registro en eConnect se limpia automáticamente

1. La party decide cambiar a eConnect
2. El proveedor actual genera una clave de migración
3. Llama a PUT /api/v1/peppol/config/party/{partyId} con la clave de migración
4. El PSB asume el registro SMP y actualiza el SML
5. A continuación, configura las capabilities y los hooks deseados

Durante la transferencia la party sigue registrada en la red, de modo que los remitentes pueden seguir enviando. Las facturas se recogen en el Access Point antiguo y en el nuevo, para que el flujo no se detenga. Qué punto recibe un mensaje depende del momento de la actualización SML (DNS). Una migración estándar suele tardar varios días laborables. eConnect la acompaña sin coste.

Tras una migración exitosa a eConnect, el SML actualiza los registros DNS. No des por hecho que cada consulta apunte ya al Access Point de eConnect en el mismo momento. Después de la migración, configura siempre las capabilities y establece los hooks necesarios.

No olvides configurar también los permisos de usuario y, opcionalmente, un businessCard a través de la Enrollment API si aún no se ha hecho.

¿Necesitas ayuda con una migración? Contacta con TechSupport para orientación durante el proceso de migración.

• Red Peppol a través de la API: SMP y capabilities
• Registro Peppol a través de la API (Enrollment)
• Resumen: la Procurement Service Bus (PSB)
• ¿Qué es Peppol y cómo funciona la red?
• Peppol internacional
• Registrarse en Peppol (plataforma)
• Facturación electrónica con eConnect