Conector REST de Business Central
Documentación de la API
Sección titulada «Documentación de la API»La API OData v2.0 estándar de Business Central documenta las entidades y las opciones $filter/$orderby que utiliza este conector.
Cómo funciona la autenticación
Sección titulada «Cómo funciona la autenticación»La conexión se autentica como aplicación mediante credenciales de cliente (S2S) de Entra ID (Azure AD): el ID de cliente y el secreto de un registro de aplicación se intercambian por un token de acceso en https://login.microsoftonline.com/<tenant id>/oauth2/v2.0/token, con el ámbito https://api.businesscentral.dynamics.com/.default. No hay inicio de sesión interactivo. El registro de aplicación necesita permisos de API concedidos a Business Central (API.ReadWrite.All o un ámbito más limitado que emita su administrador).
Cada solicitud se limita a un entorno (por ejemplo, Production o un entorno de pruebas) y a una empresa dentro de él; ambos se establecen en la conexión y no se eligen en cada solicitud.
Configuración
Sección titulada «Configuración»| Campo | Tipo | Descripción |
|---|---|---|
| Nombre | Texto | Nombre para mostrar de esta conexión. |
| ID de cliente | Texto | El ID de aplicación (cliente) del registro de aplicación de Entra. |
| Secreto de cliente | Texto | El secreto de cliente del registro de aplicación. Se almacena cifrado. |
| ID de inquilino | Texto | El ID de su inquilino de Azure AD. |
| Entorno | Texto | El nombre del entorno de Business Central, por ejemplo Production. |
| Empresa | Texto | El ID de la empresa de Business Central sobre la que esta conexión lee y contabiliza. |
Entidades disponibles para importar
Sección titulada «Entidades disponibles para importar»El paso Import Business Central Entity abarca seis entidades: accounts, generalLedgerEntries, customers, vendors, items, journals. Cada extracción admite filtros del lado del servidor por entidad. Consulte Import Business Central Entity (paso) para ver la referencia completa de campos.
generalLedgerEntries es de solo lectura y solo contiene movimientos contabilizados: es la entidad que debe extraer para un balance de comprobación o el detalle del libro mayor, ya que nunca incluye una línea que todavía esté en un lote de diario sin contabilizar.
Contabilización de líneas del diario general
Sección titulada «Contabilización de líneas del diario general»El paso Business Central Post crea líneas dentro de un lote de diario existente y contabiliza ese lote a través de la canalización de escritura de ERP compartida de PlaidCloud; verifica que el lote contenga solo las líneas de esta solicitud antes de contabilizar y confirma la contabilización con generalLedgerEntries (no con el propio lote de diario). Consulte Business Central: Post General Journal Lines para ver la referencia de campos y Conectarse a Business Central para el tutorial completo de contabilización.
Limitaciones conocidas
Sección titulada «Limitaciones conocidas»| Limitación | Qué significa |
|---|---|
| Un solo tipo de documento de escritura | Solo se admite la contabilización de líneas del diario general. El flujo de documentos en borrador (facturas de venta y de compra, de Borrador a Contabilizado) no se admite, porque la acción de contabilización de ese flujo no está especificada en la documentación publicada de Microsoft. |
| Solo contabiliza en un lote existente | Este conector nunca crea un lote de diario en Business Central; créelo allí primero. |
| Contabilizaciones simultáneas en el mismo lote | La protección de idempotencia se limita por número de documento, no por lote de diario; no se garantiza que dos números de documento distintos que se contabilicen al mismo tiempo en el mismo lote se serialicen. |
Temas relacionados
Sección titulada «Temas relacionados»- Conectarse a Business Central (guía) — paso a paso: crear la conexión, probarla, importar una entidad y contabilizar un diario.
- Import Business Central Entity (paso)
- Business Central: Post General Journal Lines
- Revisar el historial de contabilizaciones de ERP