Ce guide fournit des étapes complètes pour diagnostiquer et résoudre les problèmes courants de synchronisation entre Karbon et Xero. Que vous rencontriez des difficultés avec la correspondance des personnes-ressources ou la synchronisation des factures, ces instructions vous aideront à identifier la cause, comprendre les actions nécessaires et garantir que vos données financières circulent de manière fluide et précise entre les deux plateformes.
Index
Synchronisation des personnes-ressources Xero
Comprendre les problèmes de correspondance courants
Légères différences de nom (même courriel) : Xero affiche « Jean Nadeau » et Karbon « Jonathan Nadeau », mais le courriel est identique. Ce sont probablement la même personne. Confirmer la correspondance.
Adresses courriel différentes (même nom) : le nom est identique, mais les courriels diffèrent. Cela peut être un courriel mis à jour ou deux personnes-ressources distinctes. Vérifiez attentivement. Si c’est une mise à jour d’adresse, confirmer la correspondance. Sinon, créer une nouvelle personne-ressource.
Fautes de frappe : les erreurs d’orthographe peuvent causer des correspondances partielles. Si c’est bien la même personne-ressource, corrigez cette erreur dans Karbon ou Xero avant de confirmer la correspondance.
Accéder aux problèmes de correspondance
Allez dans Paramètres > Applications connectées.
Trouvez l’intégration Xero et cliquez sur Gérer.
Cliquez sur Résoudre les problèmes de correspondance.
Examiner et résoudre les correspondances partielles
L’écran Correspondances partielles affiche les personnes-ressources Xero et les correspondances possibles dans Karbon. Deux choix pour chaque personne-ressource :
Confirmer la correspondance : à choisir si la personne-ressource Xero et Karbon représentent le même client.
Conséquence : Les personnes-ressources se lient, et les données Xero (nom, email de facturation, téléphone principal, adresse de facturation) mettent à jour la personne-ressource Karbon.
Créer une nouvelle personne-ressource : si la personne-ressource Xero est différente de celle de Karbon qui a été suggérée.
Conséquence : Une nouvelle personne-ressource Karbon est créée avec les données de Xero et se synchronise bidirectionnellement.
Gérer les personnes-ressources exclues par le filtrage ContactType
Lors de la configuration de la synchronisation Xero, certaines personnes-ressources Xero peuvent être exclues si leur ContactType ne correspond pas au filtre choisi (ex. « Clients uniquement »).
Impact sur la résolution des correspondances :
Ces personnes-ressources exclues n’apparaissent pas automatiquement dans la liste synchronisée.
Karbon affiche alors une bannière sur la fiche de la personne-ressource :
« Une personne-ressource Xero correspondant a été trouvé mais est exclue par vos paramètres de synchronisation. »Vous pouvez confirmer manuellement la correspondance via la bannière, ce qui force l’import et la synchronisation.
Résolution des exclusions :
Utilisez Associer et synchroniser cette personne-ressource depuis la bannière, ou :
Ajustez le filtre ContactType dans les paramètres de synchronisation Xero pour inclure plus de personnes-ressources (ex. passer de « Clients uniquement » à « Toutes les personnes-ressources »).
Synchronisation des factures Xero
Trouver les factures qui ne se synchronisent pas
Si une facture échoue à se synchroniser, Karbon affiche des indicateurs clairs pour identifier et résoudre le problème.
Indicateurs visuels :
Point rouge : à côté de Facturation et Paramètres dans le menu principal.
Bannières d’erreur :
Dans l’écran Configuration de la facturation
Dans Applications connectées → Xero Grand Livre général
La bannière inclut un lien Voir les erreurs avec la liste complète des factures en échec.
Tableau des erreurs Xero Blue
Cliquez sur Afficher les erreurs pour ouvrir le tableau des erreurs Xero, qui répertorie toutes les factures qui n'ont pas pu être synchronisées. Chaque ligne comprend :
Type : (ex. Facture)
ID : numéro de facture Karbon
Origine : toujours « Karbon »
Client : client lié à la facture
Raison : message expliquant l’échec
Montant : total de la facture
Statut : « Échec de la synchronisation »
Réessayer les factures en échec
Dans le tableau des erreurs Xero, après avoir corrigé l'erreur :
Après correction, cliquez sur Réessayer la synchronisation.
Cliquez sur Actualiser les résultats pour mettre à jour la liste.
Statuts de synchronisation :
Le statut de la synchronisation se trouve dans les onglets « En attente de paiement » et « Payé » de l'écran Facturation des factures.
Synchronisé
Échec
-
Résolution des différentes erreurs
Code d’erreur : client introuvable
Description : La personne-ressource Karbon n’est pas synchronisé avec une personne-ressource Xero.
Comment corriger :
Code d’erreur : numéro de facture en double
Description : le numéro de facture Karbon existe déjà dans Xero, et Xero exige des numéros de facture uniques.
Comment corriger :
Option 1 :
Supprimez la facture dans Karbon.
Créez une nouvelle facture dans Karbon pour la synchroniser.
Option 2 :
Créez une nouvelle facture correspondante directement dans Xero.
Notez : la facture ne sera pas synchronisée avec Karbon.
Code d'erreur : Taux de taxe manquant
Description : le taux de taxe utilisé sur la facture Karbon n’est pas mise en correspondance à un taux de taxe Xero.
Comment corriger :
Examinez vos mises en correspondance de taux de taxe dans la configuration de la synchronisation des factures.
Assurez-vous que tous les taux de taxe Karbon ont des taux de taxe Xero correspondants.
Complétez toutes les mises en correspondance manquantes.
Retournez au tableau des erreurs Xero et cliquez sur Réessayer la synchronisation.
Code d’erreur : compte par défaut manquant
Description : le compte de revenus ou de dépenses par défaut défini dans Karbon a été supprimé ou n’est pas disponible dans Xero.
Comment corriger :
Option 1 :
Allez dans les paramètres de synchronisation des factures dans Karbon.
Mettez à jour la mise en correspondance du compte par défaut avec un code de compte Xero valide.
Enregistrez les modifications.
Retournez au tableau des erreurs Xero et cliquez sur Réessayer la synchronisation.
Option 2 :
Allez dans le plan comptable de Xero.
Désarchivez le compte mis en correspondance.
Retournez au tableau des erreurs Xero et cliquez sur Réessayer la synchronisation.