Cuando una organización cambia de proveedor Peppol, los registros SMP deben transferirse. El protocolo de migración de Peppol garantiza que esto ocurra sin tiempo de inactividad: los remitentes pueden seguir enviando durante la migración. El PSB ofrece dos escenarios de migración a través de la API.

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"
}

Después de la migración, la party se elimina automáticamente del SMP de eConnect.

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): los clientes que no usan la API inician la migración a través del formulario de baja/finalización en support.econnect.eu — no mediante una solicitud a soporte. Tras enviarlo, reciben un código de migración que entregan al nuevo proveedor. Se aplican dos condiciones a la transferencia: (a) el cliente da a eConnect una autorización escrita/legal para ello, 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

El protocolo de migración de Peppol está diseñado para cero tiempo de inactividad. Durante la transferencia, la party sigue registrada en la red. Los remitentes que envían una factura en ese momento alcanzan a la party a través del Access Point antiguo o del nuevo, según el momento de la propagación del SML. No se pierde ningún mensaje.

Tras una migración exitosa a eConnect, la party es accesible de inmediato, pero la propagación SMP a través de la red Peppol puede tardar unos minutos. 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