Este artículo explica cómo resolver problemas y errores comunes con Xero en Pabau.
Tabla de contenidos:
2. Los campos de datos no se asignan correctamente de Pabau a Xero
3. Los códigos de cuenta de Xero no aparecen en Pabau
3.1 Cómo incorporar códigos de cuenta específicos por servicio en Pabau
4. El estado de sincronización de la factura no se actualiza en Pabau
5. Detectar errores de sincronización
6. Errores de integración
No se encuentra Xero en Pabau
Paso 1: Ve a App Marketplace
Comienza iniciando sesión en tu cuenta de Pabau con tus credenciales de acceso. Luego, ve a la página de Configuración; encontrarás App Marketplace en la sección Integraciones.
Paso 2: Ve a Xero
En la página de App Marketplace, podrás localizar Xero. Si ya has integrado Xero en tu cuenta de Pabau, también podrás identificarlo en la pestaña "Aplicaciones conectadas".
NOTA: Para saber cómo integrar Xero en tu cuenta de Pabau, consulta este artículo.
Los campos de datos no se asignan correctamente de Pabau a Xero
Paso 1: Comprueba el estado de factura predeterminado
En la página de integración de Xero, en la pestaña Facturas, puedes seleccionar cómo quieres que las facturas se sincronicen con Xero. Esto se configura en el Estado de facturas predeterminado. Asegúrate de haber seleccionado el estado correcto.
-
Borrador - las facturas creadas en Pabau se sincronizarán con Xero y mantendrán la misma estructura y detalles que tenían al sincronizarse inicialmente. Por ejemplo, si generas una factura en Pabau con líneas de detalle específicas, datos del cliente y condiciones de pago, al sincronizarse con Xero, aparecerá con todos esos detalles intactos. Cualquier cambio realizado en la factura en Pabau después de la sincronización solo se reflejará automáticamente en Xero si actualizas manualmente la factura en Xero.
-
Pendiente de aprobación - las facturas se sincronizarán con Xero, pero el proceso solo se finalizará cuando las apruebes manualmente en Xero. Este estado te permite revisar las facturas en Xero antes de que se registren oficialmente. Una vez que apruebes las facturas en Xero, se procesarán y registrarán en tu sistema contable.
- Pendiente de pago (recomendado) - cualquier cambio realizado en las facturas en Pabau se reflejará inmediatamente en Xero. Por ejemplo, si actualizas los detalles de una factura en Pabau, como añadir una nueva línea de detalle o cambiar las condiciones de pago, estos cambios se sincronizarán con Xero en tiempo real.
NOTA: Recomendamos configurarlo en el estado "Pendiente de pago".
Paso 2: Comprueba Xero
Para verificar que todo se haya sincronizado correctamente en Xero, inicia sesión en tu cuenta de Xero con tus credenciales de acceso. En la pestaña Business, situada en la parte superior izquierda de la página, encontrarás la pestaña "Facturas". Todos los estados de las facturas se mostrarán en la parte superior de la página.
Los códigos de cuenta de Xero no aparecen en Pabau
Paso 1: Inicia sesión en Xero
Comienza iniciando sesión en tu cuenta de Xero. En la pestaña Contabilidad, en la parte superior izquierda de la página, encontrarás la opción Plan de cuentas.
Paso 2: Habilita el código de cuenta
Una vez en la página del Plan de cuentas, puedes ver una lista de códigos para integrar en tu cuenta de Pabau. Estos códigos ayudan a categorizar cada transacción.
Después de localizar el código que necesitas, haz clic en el nombre y aparecerá una ventana emergente donde debes marcar la opción "Enable Payments to this Account". Haz clic en el botón Guardar para finalizar la acción.
Paso 3: Comprueba el código en Pabau
Después de habilitar el código en Xero, inicia sesión en Pabau para asegurarte de que todo se refleje correctamente. Ve a la página de integración de Xero para continuar. En la pestaña de facturas, encontrarás Default Xero account code line items. Cualquier código habilitado en Xero aparecerá en el menú desplegable, donde puedes seleccionar qué código quieres establecer como predeterminado.
Cómo incorporar códigos de cuenta específicos por servicio en Pabau
Si quieres asignar algunos servicios específicos con diferentes códigos, puedes hacerlo yendo a la pestaña Servicios en la página de integración de Xero y seleccionando los códigos disponibles que aparecen en el menú desplegable a la derecha del nombre del servicio.
NOTA: Si no asignas un código a un servicio, tendrá el código de cuenta predeterminado que hayas configurado en la pestaña Facturas.
Cómo comprobar si una factura se ha sincronizado con Xero en Pabau
Paso 1: Ve a Money
Una vez que hayas iniciado sesión en Pabau, expande la pestaña Money en el menú lateral izquierdo y haz clic en Facturas para comenzar.
Todas las facturas se mostrarán en la página de Facturas, y la columna Sync Xero se añadirá automáticamente tras la integración con Xero.
El icono de la columna Sync Xero indica el estado de la factura.
- Icono gris- la sincronización está en curso
- Icono rojo- la factura no está sincronizada
- Icono azul- la factura se ha sincronizado correctamente
Paso 2: Ve a la ficha del cliente
Para ver la ficha de un cliente, puedes hacer clic en el nombre del cliente desde las facturas listadas en la página de facturas, o ir a la barra de búsqueda en la parte superior de la página y escribir al menos tres letras del nombre del cliente. Pabau filtrará los resultados a medida que escribas.
Paso 3: Cambia a la pestaña Financials
Después de seleccionar el cliente, encontrarás la pestaña "Financials" en la ficha del cliente. Esta pestaña contiene un registro de todos los pagos realizados por el cliente. Haz clic en el número de factura para mostrar todos los detalles de la factura.
Puedes ver el icono de Sync Xero en la esquina superior izquierda de la factura. Si pasas el cursor sobre él, mostrará su estado de sincronización.
Paso 4: Verifica el estado de sincronización
En la pestaña Pagos, asegúrate de que la opción "Sync payments to XERO" esté habilitada. Si toda la configuración es correcta y las facturas no se sincronizan, escala estos casos a soporte al cliente para una investigación más detallada.
NOTA: Después de generar la factura, puede tardar entre 3 y 5 minutos en completarse la actualización y en que la factura aparezca en la plataforma de Xero.
Detectar errores de sincronización
Cada vez que una sincronización no logre establecerse o completarse hacia tu organización de Xero, aparecerá el icono rojo y se mostrará un mensaje al pasar el cursor sobre él.
Si pasas el cursor sobre el icono que no se sincronizó automáticamente, puedes hacer clic para programarlo para sincronización manual.
También puedes identificar todos los errores de sincronización en la página de integración de Xero en Pabau, en la pestaña Sync Errors. Esta página muestra todas las facturas que no se han sincronizado automáticamente y qué errores has recibido.
Si hubo un intento de sincronizar la factura y por alguna razón falló, estas son las razones y errores más comunes que hemos identificado hasta ahora:
XEROINV-01
Significa que la factura que intentaste sincronizar no se encuentra en Pabau; la causa probable es que un miembro del equipo la haya eliminado del sistema mientras tanto.
XEROINV-02
Significa que el contacto asignado a la factura no se encuentra en Pabau; la causa probable es que un miembro del equipo lo haya eliminado del sistema mientras tanto.
XEROIN-03
No pudimos hacer coincidir el GUID de la factura solicitada con una factura de tu organización de Xero. Una causa probable es que la factura en Xero pueda haberse eliminado o archivado.
XEROINV-04
Significa que los datos estaban malformados para tu organización de Xero; por favor, informa de estos casos a soporte al cliente para su investigación.
XEROINV-05
Significa que tu empresa tiene los pagos habilitados para sincronizarse con Xero, pero no había pagos adjuntos a la factura solicitada para sincronizar. La factura se sincronizará sin información de pago.
XEROIN-06
Significa que hubo un error al intentar sincronizar la información de pago adjunta a la factura con tu organización de Xero; por favor, informa de estos casos a soporte al cliente para su investigación.
XEROINV-07
Significa que la factura fue editada/actualizada en la plataforma de Xero cuando inicialmente se generó desde Pabau; estos casos no serán procesados por la API, ya que se consideran actualizaciones no permitidas que no siguen el proceso habitual de actualización de Pabau hacia tu organización de Xero.
XEROINV-08
Significa que la factura se generó con el estado "Authorized"; esta es la forma final de la factura en la plataforma de Xero, y no son elegibles para recibir ningún tipo de actualización desde APIs y/o sistemas externos.
XEROINV-09
Significa que el código de cuenta predeterminado 200 se eliminó o archivó de tu organización de Xero; para continuar con la sincronización correcta, selecciona una cuenta de pago válida en tu panel de integración de Xero.
XEROINV-10
Este error indica que el ID de la factura no pudo coincidir en tu plataforma de Xero. La causa probable es que la factura ya no esté disponible en tu plataforma de Xero.
Para este tipo de problemas, envía un correo a soporte y activaremos manualmente una nueva inserción de esas facturas para que se sincronicen en tu plataforma de Xero.
XEROINV-11
Este código de error muestra que hubo un error al procesar los pagos de esta factura; por favor, revisa la configuración de pagos en el panel de integración de Xero en Pabau y asegúrate de tener todos los códigos de cuenta correctos configurados con cuentas válidas que puedan aceptar pagos.
Errores de integración
Si tienes problemas para conectar Xero con Pabau, a continuación se enumeran los mensajes de error más comunes y cómo resolverlos.
Código de error: 500
Mensaje: unauthorized_client: Unknown client or client not enabled
Este error significa que el Client ID que introdujiste en Pabau es incorrecto o que el cliente no ha sido habilitado en tu aplicación de Xero.
Cómo solucionarlo:
-
Inicia sesión en tu cuenta de Xero y ve a My Apps.
-
Busca la aplicación que creaste siguiendo la guía de configuración de la integración con Xero.
-
Haz clic en la aplicación y cambia a la pestaña "Configuration".
-
Copia el Client ID.
-
En Pabau, ve a Configuración > App Marketplace > Aplicaciones conectadas > Xero.
-
Haz clic en el botón Configure.
-
Pega el Client ID en el formulario y haz clic en Generate Sync Link para continuar.
Código de error: 400
Mensaje: The requested URL returned error: 400
Este error suele aparecer cuando la Client Secret Key es incorrecta o falta.
Cómo solucionarlo:
-
Abre la página de detalles de tu aplicación de Xero como se describió anteriormente.
-
Si no guardaste la clave secreta original, puedes eliminar la antigua o ignorarla.
-
Haz clic en Generate another secret para crear una nueva clave.
-
Copia y guarda de forma segura la nueva clave de inmediato, ya que no podrás volver a verla.
-
En Pabau, ve a Configuración > App Marketplace > Aplicaciones conectadas > Xero.
-
Haz clic en el botón Configure.
-
Pega la nueva Client Secret Key en el formulario y haz clic en Generate Sync Link.
Código de error: 500
Mensaje: unauthorized_client : Invalid redirect_uri
Este error significa que el redirect URI de OAuth 2.0 no se ha configurado correctamente en tu aplicación de Xero.
Cómo solucionarlo:
-
Ve a la página de detalles de tu aplicación de Xero.
-
Busca el campo OAuth 2.0 redirect URI.
-
Asegúrate de que la URL correcta esté introducida sin errores.
Si tu URL de Pabau es app.pabau.com, usa este URI:https://app.pabau.com/index.php?p=xero_integration
Si tu cuenta usa un dominio diferente, reemplázalo según corresponda. Por ejemplo, si tu URL es clinic.pabau.me, usa:https://clinic.pabau.me/index.php?p=xero_integration
-
Haz clic en Guardar para actualizar los detalles de la aplicación.
-
Vuelve a intentar el proceso de integración en Pabau.
Si encuentras un mensaje de advertencia junto a tu icono que no aparece en nuestra lista, infórmalo a nuestro equipo de soporte al cliente.
Para más guías, consulta los artículos relacionados a continuación, selecciona guías adicionales o utiliza la barra de búsqueda en la parte superior de la página. Estas guías te ayudarán a sacar el máximo partido a tu cuenta de Pabau.
Además, para ayudarte a aprovechar y comprender plenamente tu cuenta de Pabau, te recomendamos explorar guías y recursos adicionales disponibles en la Pabau Academy. Ofrece tutoriales en vídeo detallados y lecciones, brindando una experiencia de aprendizaje integral que puede dotarte de las habilidades esenciales para lograr el éxito con Pabau.