La integración con Microsoft Dynamics 365 Business Central mantiene a tus clientes de Pabau sincronizados con los registros de clientes en Business Central. Cuando creas o editas un cliente en Pabau, el cambio se envía automáticamente a Business Central —como creación o actualización de cliente— casi en tiempo real, para que tu equipo de finanzas vea siempre los mismos datos del cliente que tú.
Este es un conector dentro de la herramienta Data Sync de Pabau. Si eres nuevo en Data Sync, lee primero Cómo funciona Data Sync en Pabau para conocer los conceptos generales (desencadenantes, mapeo, el registro de entregas y los reintentos). Esta guía cubre todo lo específico de Business Central.
Nota: El conector sincroniza el objeto cliente. Envía los clientes de Pabau a Business Central; no sincroniza facturas, citas, productos ni transacciones financieras. Necesitas acceso de administrador en Pabau para configurarlo.
Qué hace el conector
- Crea un cliente en Business Central cuando se crea un cliente en Pabau.
- Actualiza el cliente correspondiente cuando se edita un cliente en Pabau.
- Opcionalmente bloquea el cliente en Business Central cuando se elimina un cliente en Pabau (se recomienda bloquear en lugar de eliminar, y está desactivado por defecto).
- Opcionalmente crea nuevos clientes de Pabau a partir de clientes de Business Central (desactivado por defecto; es mejor dejarlo así para bases de clientes grandes).
Antes de empezar: lo que necesitas de tu equipo de IT
Business Central autentica a Pabau mediante un registro de aplicación de Microsoft Entra ID (una conexión "servicio a servicio" o S2S). Tu administrador de Business Central debe proporcionar:
- ID de directorio (tenant): el directorio de Entra ID de tu tenant de Business Central.
- ID de aplicación (cliente): el registro de aplicación de Entra ID al que se le ha concedido acceso a la API de Business Central.
- Secreto de cliente: el secreto de ese registro de aplicación.
- ID de empresa: el GUID de la empresa en Business Central (desde el endpoint de empresas).
- El nombre del entorno (por ejemplo, Production, o el nombre de un entorno de pruebas).
Tu equipo de IT también debe conceder al registro de aplicación permiso para leer y escribir clientes a través de la API de Business Central, y otorgar el consentimiento de administrador en Entra ID. Si tu tenant publica su propio servicio web de clientes personalizado (páginas OData personalizadas) en lugar de la API estándar, también necesitarás el nombre de la empresa y el nombre de la página de clientes usados para acceder a ese servicio.
Consejo: Pídele a tu proveedor de Business Central el "paquete de incorporación de la integración". Contiene exactamente los valores anteriores. Guarda el secreto de cliente de forma segura; solo lo pegas en Pabau una vez y se almacena cifrado.
Paso 1: Configuración de la conexión
En Data Hub > Data Sync, selecciona Añadir conector, elige Microsoft Dynamics 365 Business Central y selecciona Configurar. En la pestaña Configuración, completa los campos que te proporcionó tu equipo de IT.
Los ajustes que verás:
- Entorno: el nombre del entorno de Business Central, normalmente production o el nombre de un entorno de pruebas.
- ID de empresa: el GUID de la empresa en Business Central.
- Tipo de API: Standard API v2.0 para la mayoría de los tenants, o Páginas OData personalizadas para tenants que publican su propio servicio web de clientes.
- Nombre de empresa (OData) y Nombre de la página de clientes (OData): solo se requieren para páginas OData personalizadas, por ejemplo
Company('IBSSI')yCustomerAPI. - Número de cliente: Automático permite que Business Central asigne el número de cliente; Generar a partir del id de Pabau construye el número a partir del id del cliente en Pabau (necesario en tenants cuyo usuario de integración no pueda ejecutar la serie de numeración).
- Prefijo del número de cliente: el prefijo para los números generados (hasta 10 caracteres), por ejemplo
ZPAB. - Al eliminar un cliente: Bloquear el cliente (recomendado) o Eliminar el registro (solo si tus permisos de Business Central permiten la eliminación).
- Crear en la primera actualización: cuando está activado, editar un cliente que nunca se ha sincronizado crea el cliente en Business Central en lugar de omitirlo.
- Crear nuevos clientes a partir de clientes de Business Central: cuando está activado, los clientes de Business Central que no coincidan con ningún cliente existente se crean como nuevos clientes de Pabau (máximo 25 por sondeo). Déjalo desactivado para bases de clientes grandes.
- URL base de la API: una anulación opcional para nubes soberanas o proxies; déjalo en blanco en caso contrario.
Introduce las tres credenciales (ID de tenant, ID de cliente, secreto de cliente) en la sección Credenciales y, a continuación, selecciona Probar conexión. Pabau almacena las credenciales cifradas y confirma que se han guardado.
Paso 2: Desencadenantes
En la pestaña Desencadenantes, elige qué eventos de Pabau se envían a Business Central. Para este conector, los eventos de cliente se corresponden así:
client.create→ Crear o actualizar clienteclient.update→ Crear o actualizar clienteclient.delete→ Bloquear cliente al eliminar
Nota: client.delete está desactivado por defecto. Actívalo solo si quieres que un cliente eliminado en Pabau bloquee el cliente correspondiente en Business Central, y solo si tus permisos de Business Central permiten la operación de bloqueo.
Paso 3: Mapeo de campos
En la pestaña Mapeo, despliega Clientes para ver cómo se corresponden los campos de cliente de Pabau con los campos de cliente de Business Central. Los nombres de campo se establecen por defecto según la API estándar; si tu tenant usa páginas OData personalizadas, redirige cada campo de destino al nombre de campo de tu página personalizada usando los menús desplegables.
El mapeo predeterminado es:
- Nombre completo (nombre + apellidos) → Nombre (obligatorio)
- ID de cliente → Número de cliente (se usa cuando está activado "Generar a partir del id de Pabau")
- Móvil → Número de teléfono
- Calle de correspondencia → Dirección
- Ciudad de correspondencia → Ciudad
- Provincia de correspondencia → Provincia
- Código postal de correspondencia → Código postal
- Correo electrónico → Correo electrónico (opcional; ver la nota más abajo)
Importante: Desactiva un campo si tu tenant de Business Central rechaza las escrituras en él. Business Central aplica una actualización como una única solicitud, así que si se rechaza un campo mapeado, toda la actualización falla, incluidos los campos que habrían estado bien. Si un campo concreto (por ejemplo, Correo electrónico) es rechazado de forma constante por la validación de tu tenant, desactívalo en el mapeo hasta que tu equipo de IT lo resuelva del lado de Business Central.
Paso 4: Vincular registros existentes (recomendado antes de la puesta en marcha)
Si ya tienes clientes en Business Central y clientes en Pabau para las mismas personas, ejecuta Vincular registros existentes antes de confiar en la sincronización. Esto empareja los registros que ya existen en ambos lados y los vincula, de modo que las futuras ediciones actualicen el registro correcto en lugar de crear duplicados. Solo escribe vínculos: nunca crea ni modifica registros en ninguno de los dos lados, y siempre se ejecuta primero como una simulación para que puedas revisar un informe completo antes de vincular nada.
Tú eliges cómo se emparejan los registros: mediante una referencia almacenada (como el ID personalizado del cliente o el campo de referencia de cliente) y, opcionalmente, mediante una dirección de correo electrónico única como alternativa. La simulación genera un informe CSV descargable que muestra cuántos registros coincidieron, cuántos fueron ambiguos (dejados sin vincular a propósito) y cuántos no coincidieron. Cuando estés conforme, confirma la ejecución para escribir los vínculos.
Importante: Si Crear en la primera actualización está activado mientras tus registros aún no están vinculados, editar un cliente no vinculado creará un cliente duplicado en Business Central. Considera desactivarlo en Configuración hasta que se haya completado la vinculación, y luego vuelve a activarlo.
Paso 5: Pruébalo de principio a fin
En la pestaña Mapeo, selecciona Enviar evento de prueba, elige client.create o client.update, y selecciona Enviar prueba. Pabau selecciona un cliente real, lo envía a través del flujo en vivo y registra el resultado en el log marcado como prueba. Abre los Registros para confirmar que se realizó correctamente, y luego comprueba que el cliente aparece (o se actualiza) en Business Central.
Solución de problemas: cómo leer los fallos en el registro de entregas
Abre Registros en el conector para ver todas las entregas. Selecciona cualquier fila fallida para ver la solicitud exacta que envió Pabau, la respuesta que devolvió Business Central y el ID de correlación.
Los resultados más comunes, y lo que significan:
Rechazado (HTTP 400)
Business Central rechazó los datos. El mensaje de respuesta te indica exactamente por qué, por ejemplo, "The email address … is not valid." Este es un fallo permanente (Pabau no lo reintentará) porque volver a enviar los mismos datos fallaría de nuevo. Corrige los datos en Pabau, o pide a tu equipo de IT que flexibilice la validación en Business Central, y luego vuelve a enviarlo con Sincronizar datos más recientes. Si un campo entero es siempre rechazado, desactívalo en el mapeo (consulta la nota sobre el mapeo más arriba).
Fallo de autenticación (HTTP 401 / 403)
Business Central no aceptó las credenciales de Pabau, o el registro de aplicación no tiene permiso para leer/escribir clientes. Pide a tu equipo de IT que confirme que el registro de aplicación tiene acceso a la API de Business Central, que se ha otorgado el consentimiento de administrador en Entra ID y que los conjuntos de permisos no excluyen las páginas de la API de clientes. Vuelve a introducir las credenciales en la pestaña Configuración si se han rotado.
Límite de frecuencia superado (HTTP 429)
Business Central le pidió a Pabau que redujera la velocidad. Esto es temporal: Pabau espera y reintenta automáticamente. No se necesita ninguna acción a menos que persista.
Error del servidor (HTTP 5xx)
Un problema del lado de Business Central. Temporal: Pabau reintenta automáticamente con un intervalo creciente hasta un máximo de 8 intentos.
Error de red
Pabau no pudo comunicarse con Business Central en absoluto (un tiempo de espera agotado o un problema de conexión). Temporal: Pabau reintenta automáticamente.
No implementado
Un estado poco frecuente y temporal que solo se ve brevemente durante una actualización de la plataforma Pabau, cuando el entorno de ejecución del conector no ha terminado de implementarse. Se soluciona por sí solo en el siguiente intento o en el siguiente barrido automático; si ves que persiste, vuelve a enviar la entrega con Sincronizar datos más recientes o ponte en contacto con soporte.
Nota: Después de que Pabau intente un fallo temporal 8 veces sin éxito, se detiene y marca la entrega como fallida. Siempre puedes reenviarla manualmente desde el detalle de la entrega una vez que se haya solucionado el problema subyacente.
Reenviar una entrega fallida
Desde el panel de detalle de una entrega fallida, elige una de estas opciones:
- Repetir la carga útil original: vuelve a enviar exactamente lo que se envió antes. Úsala cuando los datos eran correctos y el problema estaba del lado de Business Central (por ejemplo, un permiso que ya se ha concedido).
- Sincronizar datos más recientes: reconstruye la solicitud con los valores actuales del cliente y la envía. Úsala cuando hayas corregido los datos del cliente en Pabau después del fallo.
Consejo: Cuando abras un ticket de soporte sobre una sincronización con Business Central, incluye el ID de correlación del detalle de la entrega. Business Central también devuelve su propio ID de correlación dentro del mensaje de error; compartir ambos permite que tu equipo de IT y Pabau rastreen la misma solicitud desde cada lado.
Artículos relacionados
- Cómo funciona Data Sync en Pabau