Skip to main content
Esta guía detalla los requisitos y pasos necesarios para conectar tu instancia de Dynamics 365 Business Central con Payana a través de la API REST de Business Central. La integración requiere configurar una identidad de aplicación en Microsoft Entra ID (Azure AD) y registrarla dentro de Business Central para otorgarle los permisos adecuados.

​
Opciones de Configuración

Existen dos formas de configurar la integración:

​
Opción A: Configuración por Payana

Si prefieres que el equipo de Payana realice la configuración, necesitamos los siguientes accesos temporales:
1. Microsoft Entra ID (Azure)
  • Usuario con el rol Application Developer (para el registro de la aplicación y creación de secretos).
2. Dynamics 365 Business Central
  • Usuario con el rol SUPER o D365 BUS FULL ACCESS en el entorno Sandbox (y eventualmente en Producción para el despliegue final).
  • Acceso a la página Aplicaciones de Microsoft Entra dentro de Business Central.
  • Nombre del entorno de Business Central (ej. production, sandbox).
  • Nombre o ID de la empresa (Company) con la que se operará.
  • Tenant ID del directorio de Microsoft Entra ID.

​
Opción B: Configuración por el Cliente

Si tu equipo realizará la configuración, sigue los pasos a continuación.

​
Paso 1: Registro de la Aplicación en Microsoft Entra ID

La integración necesita una identidad de aplicación para autenticarse de forma segura sin intervención de un usuario.
1

Crear el registro de aplicación

Accede al Portal de Azure y ve a App Registrations > New registration.
  • Nombre: Integracion_Payana
  • Tipo de cuenta: Accounts in this organizational directory only (Single tenant)
2

Copiar los identificadores

Una vez creada la aplicación, en la página Overview, copia y guarda:
  • Application (client) ID
  • Directory (tenant) ID
3

Crear el secreto de cliente

Ve a Certificates & secrets > New client secret.
  • Descripción: Payana Integration
  • Expiración: Selecciona el período más largo disponible (máximo 2 años).
Copia el Valor del secreto inmediatamente. Microsoft lo ocultará permanentemente tras salir de la pantalla.
4

Configurar permisos de API

Ve a API permissions > Add a permission > Microsoft APIs y selecciona Dynamics 365 Business Central.En Application permissions, selecciona:
  • API.ReadWrite.All — Acceso a APIs y servicios web
  • Automation.ReadWrite.All — Acceso a las APIs de automatización
Usa Application permissions (no Delegated permissions), ya que la integración opera sin sesión de usuario.
Haz clic en “Grant admin consent for [Nombre del Inquilino]” para otorgar el consentimiento de administrador.

​
Paso 2: Registro de la Aplicación en Business Central

Este paso vincula la identidad de Azure con Business Central y define los permisos que tendrá la integración dentro del ERP.
1

Acceder a la configuración de aplicaciones Entra

En Business Central, haz clic en el ícono de búsqueda (🔍) y escribe “Microsoft Entra Applications” (o “Aplicaciones de Microsoft Entra” en español).Abre la página correspondiente.
2

Crear la aplicación

Haz clic en New (Nuevo) para abrir la ficha de aplicación.
3

Ingresar el Client ID

En el campo Client ID, ingresa el Application (client) ID obtenido en el Paso 1.
4

Completar la descripción y activar

  • Description: Integración Payana
  • State: Enabled
5

Asignar conjuntos de permisos

En la sección User Permission Sets, asigna los permisos necesarios para que la integración acceda a los datos requeridos.Consulta la sección Permisos Requeridos más abajo para la lista recomendada.
No asignes el permiso SUPER. Sigue el principio de mínimo privilegio y asigna únicamente los permisos que la integración necesita.

​
Paso 3: Publicar el Web Service

Por defecto, la API REST de Business Central no expone el detalle de saldos pendientes por factura ni los pagos aplicados a cada una. Para habilitar esta información hay que publicar un Web Service adicional desde la propia interfaz de Business Central — no requiere desarrollo.
1

Abrir la página Web Services

En Business Central, hacé clic en el ícono de búsqueda (🔍) y escribí “Web Services”. Abrí la página correspondiente.
2

Buscar o crear la línea de Vendor Ledger Entries

Muchas instancias de Business Central ya traen esta línea publicada por defecto (Object Type Query, caption “Vendor Ledger Entries”). Revisá si ya existe antes de crear una nueva.Si no existe, hacé clic en Nuevo y completá:
  • Object Type: Query
  • Object ID: usá el buscador (ícono de lupa) y escribí “Vendor Ledger” o “Ledg.” para encontrarla — no ingreses el número directamente, puede variar según la versión de Business Central.
  • Service Name: VendorLedgerEntries.
Es importante que el Service Name quede exactamente como VendorLedgerEntries — Payana consulta ese endpoint con ese nombre fijo. Si Business Central lo trunca o lo modifica al guardar, corregilo manualmente antes de publicar.
3

Publicar

Tildá la casilla Published. Business Central va a generar automáticamente la URL en la columna OData V4 URL.
4

Repetir para el detalle de pagos por factura

Repetí los mismos pasos para publicar una segunda línea:
  • Object Type: Page
  • Object ID: buscá por nombre “Detailed Vendor Ledg” o “Ledg.” (caption: “Detailed Vendor Ledger Entries”).
  • Service Name: DetailedVendorLedgerEntries.
  • Tildá Published y guardá.
Es importante que el Service Name quede exactamente como DetailedVendorLedgerEntries — Payana consulta ese endpoint con ese nombre fijo. Si Business Central lo trunca o lo modifica al guardar, corregilo manualmente antes de publicar.
5

Verificar permisos

El usuario o aplicación que consuma estas URLs necesita permiso de lectura sobre las tablas “Vendor Ledger Entry” y “Detailed Vendor Ledg. Entry”. Agregá ese permiso en el mismo permission set que le asignaste a la aplicación en el Paso 2.
Estos dos Web Services usan la misma autenticación que ya configuraste en el Paso 1 (mismo client_id, client_secret y token) — no hace falta crear una identidad ni un flujo de autenticación distinto.

​
Permisos Requeridos

Asigna los siguientes Permission Sets a la aplicación registrada en Business Central:
Si tu instancia utiliza conjuntos de permisos personalizados, trabaja con tu administrador de Business Central para verificar que cubren los endpoints de la API REST que Payana necesita consumir, además de lectura sobre “Vendor Ledger Entry” y “Detailed Vendor Ledg. Entry” (necesarios para los Web Services del Paso 3).

​
Entidades de API Utilizadas

La integración accede a los siguientes recursos de la Business Central API v2.0 (/api/v2.0):

​
Credenciales de Conexión

Una vez finalizada la configuración, comparte los siguientes parámetros con el equipo técnico de Payana a través de un canal seguro:
El company_id se puede obtener desde Business Central en Configuración de Empresa o a través del endpoint GET https://api.businesscentral.dynamics.com/v2.0/{tenantId}/{environmentName}/api/v2.0/companies.
El client_secret es un valor sensible. Compártelo únicamente a través de canales seguros.

​
Lista de Verificación Final

Antes de contactar al equipo de onboarding, verifica que tienes todo listo:
  • Has registrado la aplicación en Microsoft Entra ID con los permisos API.ReadWrite.All y Automation.ReadWrite.All (Paso 1).
  • Has creado y copiado el secreto de cliente antes de salir de la pantalla (Paso 1).
  • Has registrado la aplicación en Business Central con el Client ID correcto y el estado en Enabled (Paso 2).
  • Has asignado los conjuntos de permisos necesarios a la aplicación (Paso 2).
  • Has publicado los Web Services de Vendor Ledger Entries y Detailed Vendor Ledg. Entries (Paso 3) y confirmado el Service Name final de cada uno.
  • Tienes las 5 credenciales necesarias: client_id, client_secret, tenant_id, environment_name y company_id.