Open Office Hours Temporada 1: Sesión 3 - Conexiones: D365 OData Cloud
Para conectar tu sistema Microsoft Dynamics 365 a Rapidi necesitas una conexión OData. Tanto si integras Business Central como D365 Finance o D365 Sales, el proceso sigue siempre el mismo patrón. Cuando conozcas estos pasos, podrás configurar cualquier conexión de D365 en unos cinco minutos.
En este artículo te explicamos cómo configurar una conexión OData Cloud; además, encontrarás la grabación de la sesión 3 de Open Office Hours - Conexión OData Cloud.
En nuestra serie Open Office Hours, sesiones de formación en directo de 30 minutos que organizamos de enero a abril, tratamos todo, desde la configuración básica hasta la configuración avanzada.
Cómo configurar conexiones OData de Dynamics 365 en Rapidi: Business Central, Finance & Sales
La configuración de conexiones OData entre Microsoft Dynamics 365 y Rapidi sigue un patrón de tres pasos:
- registrar una aplicación en Azure,
- configurar la aplicación en tu ERP,
- y después crear la conexión en Rapidi.
Esta guía te acompaña en cada paso con los ajustes concretos que necesitas.
Mira la grabación de nuestra tercera sesión: Conexiones - Dynamics 365 ODATA Cloud
Diapositivas de la presentación
Antes de empezar
Necesitarás acceso a tres sistemas:
-
Primero, el portal de Azure, con permisos para registrar aplicaciones.
-
Segundo, tu instancia de Microsoft Dynamics 365 (Business Central, Finance o Sales) con acceso de administrador.
-
Tercero, tu cuenta de servicio de Rapidi.
El proceso de conexión tiene tres fases principales: el registro de la aplicación en Azure, la configuración del ERP y la configuración de la conexión en Rapidi. Cada sistema pasa las credenciales al siguiente.
Paso 1: registra tu aplicación en Azure
1 Crea el registro de la aplicación
Abre el portal de Azure y ve a App Registrations. Haz clic en "New registration" y ponle a tu aplicación un nombre descriptivo (por ejemplo, "Rapidi-Production" o "Rapidi-Test-2026").
Añade una URL de redirección. Es obligatoria para las conexiones de Business Central. Usa la URL de redirección que se indica en tu documentación de Rapidi.
2 Define los permisos de API
Tu aplicación necesita permisos para acceder a los datos de D365. Ve a API Permissions y haz clic en "Add a permission".
Busca tu sistema de destino (por ejemplo, Business Central o Dynamics 365 Finance). Necesitas dos tipos de permisos:
Delegated permissions: selecciona todos los permisos disponibles en esta categoría.
Application permissions: vuelve a hacer clic en "Add a permission", selecciona tu sistema, elige "Application permissions" y selecciona las opciones disponibles.
Después de añadir ambos, haz clic en "Grant admin consent" para que los permisos aparezcan como "Granted" (marca de verificación verde).
3 Crea un secreto de cliente
Ve a "Certificates & secrets" y haz clic en "New client secret". Ponle un nombre y elige un periodo de caducidad.
Copia el valor del secreto de inmediato. Es tu contraseña para la conexión de Rapidi. Solo podrás verlo una vez.
Antes de salir de Azure, anota estos valores de la página Overview de tu aplicación:
| Campo de Azure | Campo de Rapidi |
|---|---|
| Application (client) ID | User ID |
| Directory (tenant) ID | Domain |
| Client secret value | Password |
Paso 2: configura tu ERP
Para Dynamics 365 Business Central
En Business Central, busca "Microsoft Entra" y ábrelo. Haz clic en "New" para crear una nueva entrada de aplicación.
Pega tu Application ID de Azure en el campo Application ID. Ponle un nombre que coincida con el registro de tu aplicación en Azure. Activa la aplicación.
Añade conjuntos de permisos. Como mínimo, necesitas:
permisos de automatización y permisos de administrador. Según tu configuración, puede que necesites conjuntos de permisos adicionales para funcionalidades específicas.
Haz clic en "Grant consent" y acepta la solicitud de permisos.
Para Dynamics 365 Finance
El proceso es similar. Registra tu aplicación de Azure en Dynamics 365 Finance, añade el Application ID y asigna los roles de seguridad necesarios.
Para Dynamics 365 Sales
En Dynamics 365 Sales, registra la aplicación de Azure y asigna los roles de seguridad adecuados para acceder a los datos que necesitas.
Paso 3: crea la conexión en Rapidi
Inicia sesión en tu servicio de Rapidi y crea una nueva conexión. Selecciona el tipo de conexión según tu ERP:
| Sistema | Tipo de conexión |
|---|---|
| Business Central | BC Nav OData |
| D365 Finance | Finance OData |
| D365 Sales | D365 Sales OData |
Los campos de la conexión, uno a uno
Server/Instance URL: la obtienes de los servicios web de tu ERP. En Business Central, ve a Web Services, busca una página como Customer Card y copia la URL de OData.
Company: el nombre de la empresa en tu instancia del ERP.
User ID: tu Application (client) ID de Azure.
Password: el valor del secreto de cliente que copiaste de Azure.
Domain: tu ID de inquilino (tenant ID) de Azure.
Resource: la URL base de tu ERP (la URL hasta el dominio, incluido).
Metadata URL: tu URL de OData hasta "/ODataV4", seguida de "/$metadata".
Selecciona "Use SSL" y elige el método de autenticación adecuado.
Haz clic en "Test" para verificar la conexión. Si todo va bien, verás un mensaje de confirmación.
Haz un Redesign para cargar los metadatos
Después de la prueba, haz clic en "Redesign" para leer las tablas y los campos disponibles en tu ERP. Así se cargan los metadatos y Rapidi sabe a qué datos puedes acceder.
Las conexiones OData muestran el número de registros y tablas disponibles, no los nombres concretos de las tablas. Para verificar el acceso, consulta la lista de Web Services de tu ERP. Todo lo que esté publicado allí estará disponible a través de la conexión.
Gestión de tu conexión
Cuando caducan los secretos
Cuando tu secreto de cliente caduca, Rapidi envía notificaciones de error. Para solucionarlo:
Ve a Azure, abre el registro de tu aplicación y crea un nuevo secreto de cliente. Copia el nuevo valor. En Rapidi, edita tu conexión y actualiza solo el campo de la contraseña con el nuevo valor del secreto. Guarda y prueba la conexión.
Añadir nuevas tablas o campos
Si añades nuevas páginas o campos en tu ERP, no aparecerán automáticamente en Rapidi. Después de publicar nuevas páginas en Web Services (en Business Central) o de hacer visibles los campos en tu ERP, ve a tu conexión de Rapidi y haz clic en "Redesign" para actualizar los metadatos.
Si un campo no aparece después del Redesign, comprueba que esté publicado en la página, en la interfaz de tu ERP. Los campos que solo existen en el backend deben exponerse en el frontend para que Rapidi pueda leerlos.
Reutilizar aplicaciones para varias conexiones
Puedes usar el mismo registro de aplicación de Azure para varias conexiones. Crea una aplicación en Azure y usa esas mismas credenciales al configurar en Rapidi conexiones con distintas instancias del ERP. Así ahorras tiempo y reduces el número de aplicaciones que tienes que gestionar.
Páginas OData frente a páginas API
En Business Central, Microsoft está pasando de las páginas OData a las páginas API. Ambas funcionan con Rapidi. El proceso de configuración de la conexión es idéntico para los dos tipos. Puedes leer datos, escribir datos y realizar todas las operaciones estándar, tanto si te conectas a páginas OData como a páginas API.
Solución de problemas habituales
Falla la prueba de conexión: comprueba que has concedido el consentimiento de administrador en Azure. Verifica que el Application ID coincide en Azure y en tu ERP. Confirma que el secreto de cliente no ha caducado.
Faltan tablas: en Business Central, revisa Web Services para confirmar que la página está publicada. Después de publicarla, haz un Redesign de la conexión en Rapidi.
Faltan campos: los campos deben estar visibles en la interfaz de tu ERP. Añade el campo al diseño de la página y después haz un Redesign en Rapidi.
Errores de permisos: revisa los conjuntos de permisos asignados a tu aplicación en el ERP. Asegúrate de que incluyen los permisos de automatización y de administrador.
Preguntas frecuentes
¿Qué pasa cuando caduca mi secreto de cliente de Azure?
Recibirás notificaciones de error de Rapidi. Crea un nuevo secreto en Azure, copia su valor y actualiza el campo de la contraseña en tu conexión de Rapidi. Haz una prueba para confirmar que se ha solucionado.
¿Por qué no veo ciertas tablas o campos después de conectar?
Las tablas y los campos deben estar publicados en los Web Services de tu ERP para que aparezcan en Rapidi. Publica los elementos que faltan y después haz un Redesign de tu conexión para actualizar los metadatos.
¿Puedo usar la misma aplicación de Azure para varias conexiones de D365?
Sí. Crea un registro de aplicación en Azure y reutiliza esas credenciales para varias conexiones en Rapidi.
¿Hay alguna diferencia entre las páginas OData y las páginas API para las conexiones de Rapidi?
No hay ninguna diferencia funcional en la configuración de la conexión. Ambos tipos de página funcionan igual con Rapidi.
Próximos pasos
Con tu conexión OData de D365 configurada, ya puedes crear transferencias para mover datos entre tus sistemas. La conexión se encarga de la autenticación y del acceso a los datos, mientras que las transferencias definen qué datos se mueven y cuándo.
Inscríbete en la sesión de la próxima semana: Conexiones: Salesforce & HubSpot
Si necesitas conectar Salesforce o HubSpot, estos sistemas usan autorización OAuth en lugar del registro de una aplicación en Azure, pero el proceso general en Rapidi sigue un patrón similar.
¿Te perdiste las sesiones anteriores? Encuentra las grabaciones de
Consulta la Wiki de Rapidi para ver la documentación detallada, o abre un caso de soporte si tienes algún problema.
Open Office Hours
Cada semana, nuestros especialistas en integración imparten una sesión de formación gratuita de 30 minutos sobre un tema concreto de MyRapidi.