Cómo migrar de OData a páginas API en Dynamics 365 Business Central
Probablemente ya hayas oído el anuncio de que Microsoft está retirando de forma gradual la posibilidad de exponer páginas de interfaz de usuario (UI) como endpoints OData (y SOAP). En su lugar, tendrás que usar páginas API. Esta retirada forma parte de una estrategia de modernización plurianual para estandarizar las integraciones en torno a las páginas API y las consultas API, diseñadas específicamente para el acceso programático.Migrar de OData a páginas API en Dynamics 365 Business Central implica identificar los endpoints OData, crear las páginas API correspondientes y transferir tus datos garantizando los permisos adecuados y la coherencia de los datos. Este proceso permite un acceso a los datos más rápido, más seguro y modernizado.
Puede parecer algo pronto, pero cuanto antes te prepares, mejor posicionado estarás cuando llegue el momento del cambio.
Resumen
Esta guía explica cómo pasar de los endpoints OData de páginas UI a las páginas API y las consultas API en Microsoft Dynamics 365 Business Central.Conocerás el calendario de estos cambios, por qué Microsoft los introduce, en qué se diferencian las páginas API de OData y de las consultas API, y los pasos para migrar tus integraciones.
Usa esta guía para que tus integraciones sigan funcionando y se mantengan seguras y actualizadas.
Índice
- Fechas clave y cambios de la migración
- Por qué Microsoft se aleja de OData
- OData frente a páginas API: ¿qué cambia?
- Páginas API frente a consultas API: ¿cuál deberías usar?
- Cómo migrar de OData a páginas API: paso a paso
- Preguntas frecuentes
Fechas clave y cambios de la migración
- 2025 (v26, Wave 1): Aparecen advertencias si usas OData con páginas UI.
- 2026 (v28–v29): Microsoft añade nuevas funciones de API y más advertencias.
- 2027 (v30, Wave 1): OData con páginas UI deja de funcionar. Solo funcionarán las páginas API y las consultas API.
Fuente: Microsoft: funciones obsoletas en Business Central
Por qué Microsoft se aleja de OData
- Las páginas API son para integraciones. Las páginas UI son para personas.
- Las páginas API procesan los datos más rápido y funcionan mejor con filtros y grandes volúmenes de datos.
- Las páginas API ofrecen un mejor control sobre quién puede acceder a qué.
- Las páginas API usan números de versión, así que es menos probable que las actualizaciones rompan tus integraciones.
OData frente a páginas API: ¿qué cambia?
| Característica | OData (página UI) | Página API |
|---|---|---|
| Qué hace | Expone una página UI como endpoint | Diseñada para integraciones |
| Velocidad | Más lenta con muchos datos | Más rápida, gestiona más registros |
| Control de versiones | Ninguno | Sí (v2.0, v3.0, etc.) |
| Estabilidad | Cambia si cambia la UI | Más estable, basada en un contrato |
| Seguridad | Basada en la página | Basada en el contrato de datos |
| Soporte | En vías de desaparición | Soporte completo |
Páginas API frente a consultas API: ¿cuál deberías usar?
Las páginas API y las consultas API te dan acceso a los datos de Business Central, pero tienen usos distintos:
- Páginas API: Úsalas para trabajar con registros de una tabla (como clientes o pedidos de venta). Puedes leer, crear, actualizar y eliminar registros si tienes permiso.
- Consultas API: Úsalas cuando necesites extraer datos de más de una tabla o necesites un informe personalizado. Las consultas API pueden unir, filtrar y agrupar datos, pero son de solo lectura. Son adecuadas para informes personalizados o datos resumidos.
En resumen: usa las páginas API para las tareas habituales con datos. Usa las consultas API para informes personalizados o cuando necesites combinar datos de distintas fuentes.
Cómo migrar de OData a páginas API: paso a paso
- Cambia los endpoints OData antiguos, como
/ODataV4/Page/CustomerCard, por endpoints de páginas API, como/api/v2.0/customers,/vendorso/salesOrders. - Actualiza los mapeos de tu integración y vuelve a cargar los metadatos.
- Usa campos como
systemModifiedAtolastModifiedDateTimepara sincronizar solo los datos modificados. - Prueba tus integraciones en un entorno seguro. Las páginas API suelen funcionar entre un 30 y un 50 % más rápido.
- Si necesitas campos personalizados, crea páginas API personalizadas con extensiones AL.
Descubre más en este artículo sobre cómo leer las páginas API de Microsoft Dynamics 365 Business Central e integrarte con ellas.
💡 ¡Consejo profesional! Hacer el cambio pronto mantiene tus integraciones en funcionamiento y facilita el mantenimiento.
Como siempre, si necesitas ayuda para pasar tu integración de OData a páginas API, ponte en contacto con el equipo de soporte de Rapidi para que te ayude.
Actualizado en febrero de 2026
Preguntas frecuentes
¿Cuándo dejan de funcionar los endpoints OData?
Los endpoints OData de páginas UI dejan de funcionar en la versión 30 (2027 Wave 1).
¿Por qué usar páginas API en lugar de OData?
Las páginas API son más rápidas, más seguras y es menos probable que dejen de funcionar.
¿Tengo que reescribir todas las integraciones?
Si tu integración usa páginas UI a través de OData, tienes que pasarte a páginas API o consultas API antes de 2027.