Dit artikel behandelt hoe je veelvoorkomende problemen en foutmeldingen met Xero in Pabau kunt oplossen.
Inhoudsopgave:
2. Gegevensvelden worden niet correct gekoppeld van Pabau naar Xero
3. Xero-rekeningcodes worden niet weergegeven in Pabau
3.1 Hoe je servicespecifieke rekeningcodes toevoegt aan Pabau
4. Synchronisatiestatus van factuur wordt niet bijgewerkt in Pabau
5. Synchronisatiefouten opsporen
6. Integratiefouten
Xero niet kunnen vinden in Pabau
Stap 1: Ga naar de App Marketplace
Begin met inloggen op je Pabau-account met je inloggegevens. Ga vervolgens naar de Setup-pagina; je vindt de App Marketplace onder het gedeelte Integraties.
Stap 2: Ga naar Xero
Op de App Marketplace-pagina kun je Xero vinden. Als je Xero al hebt geïntegreerd in je Pabau-account, kun je dit ook terugvinden onder het tabblad "Verbonden apps".
OPMERKING: Om te zien hoe je Xero kunt integreren met je Pabau-account, raadpleeg dit artikel.
Gegevensvelden worden niet correct gekoppeld van Pabau naar Xero
Stap 1: Controleer de standaard factuurstatus
Op de Xero-integratiepagina, onder het tabblad Facturen, kun je kiezen hoe je wilt dat facturen worden gesynchroniseerd naar Xero. Dit stel je in bij de Standaard factuurstatus. Zorg ervoor dat je de juiste status hebt geselecteerd.
-
Concept - facturen die in Pabau worden aangemaakt, worden gesynchroniseerd naar Xero en behouden dezelfde structuur en gegevens als bij de eerste synchronisatie. Bijvoorbeeld: als je in Pabau een factuur maakt met specifieke regelitems, klantgegevens en betalingsvoorwaarden, verschijnt deze factuur in Xero met al deze gegevens intact. Wijzigingen die je na de synchronisatie in Pabau aanbrengt, worden alleen automatisch in Xero weerspiegeld als je de factuur handmatig bijwerkt in Xero.
-
In afwachting van goedkeuring - de facturen worden gesynchroniseerd naar Xero, maar het proces wordt pas afgerond zodra je ze handmatig goedkeurt in Xero. Met deze status kun je de facturen in Xero controleren voordat ze officieel worden geregistreerd. Zodra je de facturen in Xero goedkeurt, worden ze verwerkt en geregistreerd in je boekhoudsysteem.
- In afwachting van betaling (aanbevolen) - eventuele wijzigingen die in Pabau aan de facturen worden aangebracht, worden direct weerspiegeld in Xero. Als je bijvoorbeeld de gegevens van een factuur in Pabau bijwerkt, zoals het toevoegen van een nieuw regelitem of het wijzigen van de betalingsvoorwaarden, worden deze wijzigingen in realtime gesynchroniseerd naar Xero.
OPMERKING: We raden aan om de status in te stellen op "In afwachting van betaling".
Stap 2: Controleer Xero
Om te controleren of alles correct is gesynchroniseerd in Xero, log je in op je Xero-account met je inloggegevens. Onder het tabblad Business, linksboven op de pagina, vind je het tabblad "Facturen". Alle factuurstatussen worden bovenaan de pagina weergegeven.
Xero-rekeningcodes worden niet weergegeven in Pabau
Stap 1: Log in op Xero
Begin met inloggen op je Xero-account. Onder het tabblad Accounting, linksboven op de pagina, vind je de optie Rekeningschema (Chart of Accounts).
Stap 2: Rekeningcode inschakelen
Zodra je op de pagina Rekeningschema bent, zie je een lijst met codes die je kunt integreren in je Pabau-account. Deze codes helpen elke transactie te categoriseren.
Zodra je de gewenste code hebt gevonden, klik je op de naam en verschijnt er een pop-upvenster waarin je de optie "Betalingen naar deze rekening inschakelen" moet aanvinken. Klik op de knop Opslaan om de actie te voltooien.
Stap 3: Controleer de code in Pabau
Nadat je de code in Xero hebt ingeschakeld, log je in op Pabau om te controleren of alles correct wordt weergegeven. Ga naar de Xero-integratiepagina om verder te gaan. Onder het tabblad Facturen vind je de regelitems voor de standaard Xero-rekeningcode. Alle codes die in Xero zijn ingeschakeld, verschijnen in het dropdownmenu, waar je kunt selecteren welke code je als standaard wilt instellen.
Hoe je servicespecifieke rekeningcodes toevoegt aan Pabau
Als je bepaalde services wilt koppelen aan verschillende codes, kun je dit doen door naar het tabblad Services op de Xero-integratiepagina te gaan en de beschikbare codes te selecteren die verschijnen in het dropdownmenu helemaal rechts van de servicenaam.
OPMERKING: Als je geen code toewijst aan een service, krijgt deze de standaard rekeningcode die je hebt ingesteld op het tabblad Facturen.
Hoe je kunt controleren of een factuur is gesynchroniseerd met Xero in Pabau
Stap 1: Ga naar Money
Zodra je bent ingelogd op Pabau, vouw je het tabblad Money uit in het linker zijmenu en klik je op Facturen om te beginnen.
Alle facturen worden weergegeven op de Facturen-pagina, en de kolom Sync Xero wordt automatisch toegevoegd zodra je bent geïntegreerd met Xero.
Het icoon in de kolom Sync Xero geeft de status van de factuur aan.
- Grijs icoon- Synchronisatie is bezig
- Rood icoon- De factuur is niet gesynchroniseerd
- Blauw icoon- Factuur is succesvol gesynchroniseerd
Stap 2: Ga naar de klantkaart
Om een klantkaart te bekijken, kun je ofwel op de klantnaam klikken vanuit de facturen op de facturenpagina, of naar de zoekbalk bovenaan de pagina gaan en minstens drie letters van de naam van de klant typen. Pabau filtert de resultaten terwijl je typt.
Stap 3: Ga naar het tabblad Financials
Nadat je de klant hebt geselecteerd, vind je het tabblad "Financials" in de klantkaart. Dit tabblad bevat een overzicht van alle betalingen die door de klant zijn gedaan. Klik op het factuurnummer om alle factuurgegevens te bekijken.
Je ziet het Sync Xero-icoon linksboven in de factuur. Als je erover hovert, wordt de synchronisatiestatus weergegeven.
Stap 4: Controleer de synchronisatiestatus
Onder het tabblad Betalingen, controleer of de optie "Betalingen synchroniseren met XERO" is ingeschakeld. Als alle instellingen correct zijn en facturen nog steeds niet synchroniseren, escaleer deze gevallen dan naar klantenondersteuning voor verder onderzoek.
OPMERKING: Nadat de factuur is aangemaakt, kan het 3-5 minuten duren voordat de update is voltooid en de factuur op het Xero-platform verschijnt.
Synchronisatiefouten opsporen
Wanneer een synchronisatie niet tot stand komt of niet wordt voltooid richting je Xero-organisatie, verschijnt het rode icoon en wordt er een bericht weergegeven wanneer je erover hovert.
Als je hovert over het icoon dat niet automatisch is gesynchroniseerd, kun je erop klikken om het in te plannen voor handmatige synchronisatie.
Je kunt ook alle synchronisatiefouten terugvinden op de Xero-integratiepagina in Pabau, onder het tabblad Sync Errors. Deze pagina toont alle facturen die niet automatisch zijn gesynchroniseerd en welke foutmeldingen je hebt ontvangen.
Als er een poging was om de factuur te synchroniseren en dit om een of andere reden is mislukt, zijn dit de meest voorkomende oorzaken en foutmeldingen die we tot nu toe zijn tegengekomen:
XEROINV-01
Dit betekent dat de factuur die je probeerde te synchroniseren niet kan worden gevonden in Pabau; de mogelijke oorzaak is dat een medewerker deze in de tussentijd uit het systeem heeft verwijderd.
XEROINV-02
Dit betekent dat het contact dat aan de factuur is gekoppeld niet kan worden gevonden in Pabau; de mogelijke oorzaak is dat een medewerker dit in de tussentijd uit het systeem heeft verwijderd.
XEROIN-03
We konden de aangevraagde factuur-GUID niet koppelen aan een factuur van je Xero-organisatie. Een mogelijke oorzaak is dat de factuur in Xero is verwijderd/gearchiveerd.
XEROINV-04
Dit betekent dat de gegevens niet correct waren opgemaakt voor je Xero-organisatie; meld deze gevallen aan klantenondersteuning voor onderzoek.
XEROINV-05
Dit betekent dat je bedrijf betalingen heeft ingeschakeld om te synchroniseren met Xero, maar dat er geen betalingen waren gekoppeld aan de gevraagde factuur voor synchronisatie. De factuur wordt gesynchroniseerd zonder betalingsinformatie.
XEROIN-06
Dit betekent dat er een fout is opgetreden bij het synchroniseren van de bijgevoegde betalingsinformatie voor de factuur naar je Xero-organisatie; meld deze gevallen aan klantenondersteuning voor onderzoek.
XEROINV-07
Dit betekent dat de factuur is bewerkt/bijgewerkt op het Xero-platform terwijl deze oorspronkelijk vanuit Pabau was gegenereerd; dit soort gevallen wordt niet verwerkt door de API, aangezien dit wordt beschouwd als ongeoorloofde wijzigingen die niet het normale updateproces van Pabau naar je Xero-organisatie volgen.
XEROINV-08
Dit betekent dat de factuur is gegenereerd met de status "Geautoriseerd"; dit is de definitieve vorm van de factuur op het Xero-platform, en deze komt niet in aanmerking voor updates vanuit externe API's en/of systemen.
XEROINV-09
Dit betekent dat de standaard rekeningcode 200 is verwijderd/gearchiveerd uit je Xero-organisatie; om correct te kunnen synchroniseren, selecteer je een geldige betaalrekening in je Xero-integratiedashboard.
XEROINV-10
Deze fout geeft aan dat de factuur-ID niet kon worden gekoppeld op je Xero-platform. De mogelijke oorzaak hiervan is dat de factuur niet meer beschikbaar is op je Xero-platform.
Voor dit soort problemen kun je een e-mail sturen naar support, en zullen we handmatig een nieuwe invoeging van deze facturen activeren om te worden gesynchroniseerd op je Xero-platform.
XEROINV-11
Deze foutcode geeft aan dat er een fout is opgetreden bij het verwerken van betalingen voor deze factuur; bekijk je betalingsinstellingen op het Xero-integratiedashboard in Pabau en zorg ervoor dat je alle juiste rekeningcodes hebt ingesteld met geldige rekeningen die betalingen kunnen accepteren.
Integratiefouten
Als je problemen ondervindt bij het verbinden van Xero met Pabau, vind je hieronder de meest voorkomende foutmeldingen en hoe je deze kunt oplossen.
Foutcode: 500
Bericht: unauthorized_client: Unknown client or client not enabled
Deze fout betekent dat de Client ID die je in Pabau hebt ingevoerd onjuist is, of dat de client niet is ingeschakeld in je Xero-app.
Hoe je dit oplost:
-
Log in op je Xero-account en ga naar My Apps.
-
Zoek de app die je hebt aangemaakt volgens de handleiding voor het instellen van de Xero-integratie.
-
Klik op de app en ga naar het tabblad "Configuration".
-
Kopieer de Client ID.
-
Ga in Pabau naar Setup > App Marketplace > Verbonden apps > Xero.
-
Klik op de knop Configure.
-
Plak de Client ID in het formulier en klik op Generate Sync Link om verder te gaan.
Foutcode: 400
Bericht: The requested URL returned error: 400
Deze fout verschijnt meestal wanneer de Client Secret Key onjuist is of ontbreekt.
Hoe je dit oplost:
-
Open de detailpagina van je Xero-app zoals hierboven beschreven.
-
Als je de originele secret key niet hebt bewaard, kun je de oude verwijderen of negeren.
-
Klik op Generate another secret om een nieuwe sleutel te maken.
-
Kopieer en bewaar de nieuwe sleutel meteen veilig, aangezien je deze niet nogmaals kunt bekijken.
-
Ga in Pabau naar Setup > App Marketplace > Verbonden apps > Xero.
-
Klik op de knop Configure.
-
Plak de nieuwe Client Secret Key in het formulier en klik op Generate Sync Link.
Foutcode: 500
Bericht: unauthorized_client : Invalid redirect_uri
Deze fout betekent dat de OAuth 2.0 redirect-URI niet correct is ingesteld in je Xero-app.
Hoe je dit oplost:
-
Ga naar de detailpagina van je Xero-app.
-
Zoek het veld OAuth 2.0 redirect-URI.
-
Zorg ervoor dat de juiste URL zonder typfouten is ingevoerd.
Als je Pabau-URL app.pabau.com is, gebruik dan deze URI:https://app.pabau.com/index.php?p=xero_integration
Als je account een ander domein gebruikt, vervang dit dan dienovereenkomstig. Bijvoorbeeld, als je URL clinic.pabau.me is, gebruik dan:https://clinic.pabau.me/index.php?p=xero_integration
-
Klik op Save om de applicatiegegevens bij te werken.
-
Probeer het integratieproces in Pabau opnieuw.
Als je een waarschuwingsbericht bij je icoon tegenkomt dat niet in onze lijst staat, meld dit dan aan onze klantenondersteuning.
Voor meer handleidingen, raadpleeg de gerelateerde artikelen hieronder, selecteer extra handleidingen, of gebruik de zoekbalk bovenaan de pagina. Deze handleidingen helpen je om het meeste uit je Pabau-account te halen.
Daarnaast raden we je aan, om je Pabau-account volledig te benutten en te begrijpen, de aanvullende handleidingen en bronnen te verkennen die worden aangeboden op de Pabau Academy. Deze biedt uitgebreide videotutorials en lessen, voor een complete leerervaring die je kan uitrusten met de essentiële vaardigheden om succesvol te zijn met Pabau.