Vue d’ensemble
Clava s’intègre à deux plateformes comptables : QuickBooks Online (QBO) et Xero. Les deux intégrations regroupent les ventes par catégorie de chiffre d’affaires sur la période de synchronisation choisie, puis synchronisent ce récapitulatif avec QuickBooks Online ou Xero sous forme d’écriture comptable dans votre plan comptable.
L’intégration ne synchronise pas les transactions de vente individuelles.
Les plateformes diffèrent par la structure des écritures comptables, le fonctionnement du suivi par salle, le traitement des types de comptes et celui des taxes.
Ce guide couvre la configuration, le paramétrage et le fonctionnement de la synchronisation pour les deux plateformes.
Les plateformes prises en charge en un coup d’œil
Fonctionnalité | QuickBooks Online | Xero |
Type d’écriture comptable | Écriture comptable ( | Écriture manuelle ( |
Annulation / suppression | Suppression définitive | Annulée (Xero ne permet pas de véritable suppression) |
Mécanisme de suivi par salle | Départements (nécessite QBO Plus ou Advanced) | Catégories de suivi + options de suivi |
Condition du suivi par salle |
| Une catégorie de suivi doit être configurée sur la connexion |
Types de comptes |
|
|
Correspondance des taux de taxe | Obligatoire pour la synchronisation automatique ; avertissements affichés lors d’une synchronisation manuelle | Facultative |
Comptabilisation des lignes de taxe | Lignes de crédit explicites sur des comptes de passif | Lignes de crédit explicites sur des comptes de passif (si une correspondance est définie) |
Premiers pas
Connecter QuickBooks Online
Dans Paramètres → Intégrations → Comptabilité (Settings → Integrations → Accounting), activez l’interrupteur QuickBooks.
Cliquez sur Connecter QuickBooks. Vous êtes redirigé vers la page d’autorisation OAuth d’Intuit.
Connectez-vous et autorisez la connexion.
Une fois redirigé, une fenêtre Configurer la connexion QuickBooks s’ouvre. Donnez un nom à la connexion, sélectionnez les salles qu’elle couvre et choisissez un mode de correspondance (voir Modes de correspondance ci-dessous).
Cliquez sur Enregistrer.
Connecter Xero
Dans Paramètres → Intégrations → Comptabilité, activez l’interrupteur Xero.
Cliquez sur Connecter Xero. Vous êtes redirigé vers la page d’autorisation OAuth de Xero.
Connectez-vous, sélectionnez votre organisation Xero et autorisez la connexion.
Une fois redirigé, la fenêtre Configurer la connexion Xero s’ouvre. En plus du nom, des salles et du mode de correspondance, vous verrez un sélecteur Catégorie de suivi – voir Suivi par salle : Xero pour plus de détails.
Cliquez sur Enregistrer.
Connexions multiples : vous pouvez créer plusieurs connexions par plateforme (par exemple, des organisations QBO distinctes pour différentes marques). Chaque connexion est configurée et synchronisée indépendamment.
Configuration de la connexion
Après la configuration initiale, vous pouvez rouvrir la fenêtre de configuration à tout moment avec l’icône Modifier (crayon) de la carte de connexion.
Salles
Sélectionnez les salles de votre établissement couvertes par cette connexion. Une salle ne peut appartenir qu’à une seule connexion par plateforme à la fois.
Mode de correspondance
Chaque connexion fonctionne selon l’un des deux modes suivants :
Mode | Description |
Plan comptable unique | Un même ensemble de correspondances catégorie de chiffre d’affaires → compte s’applique à toutes les salles de la connexion. Une écriture comptable est générée par synchronisation. |
Plan comptable par salle | Chaque salle dispose de son propre ensemble de correspondances. Une écriture comptable est générée par salle et par synchronisation. |
Ces modes s’excluent mutuellement. Passer de l’un à l’autre ne migre pas automatiquement les correspondances existantes.
Valeur par défaut pour les connexions nouvelles et existantes : « Plan comptable unique ».
Choisir un mode : utilisez « Plan comptable unique » si toutes les salles partagent le même plan comptable. Utilisez « Plan comptable par salle » si chaque salle tient une comptabilité séparée.
Correspondances des catégories de chiffre d’affaires
Les catégories de chiffre d’affaires sont la classification utilisée par Clava (Fittr) pour les différents types de ventes (pack, carte, abonnement, entrée à l’unité, carte cadeau, remboursements, etc.). Chaque catégorie doit être associée à un compte précis de votre plan comptable avant qu’une synchronisation puisse être lancée.
Ouvrir la fenêtre de correspondance
Cliquez sur Correspondances sur une carte de connexion pour ouvrir la fenêtre de correspondance. Elle charge votre plan comptable directement depuis QuickBooks ou Xero.
Mode « Plan comptable unique »
Toutes les catégories apparaissent dans une seule liste. Sélectionnez un compte pour chaque catégorie. Le Compte bancaire (le compte de dépôt, c’est-à-dire le compte d’actif qui reçoit le débit de contrepartie) se définit également ici et est commun à toutes les salles.
Enregistrez une fois terminé.
Mode « Plan comptable par salle »
Un sélecteur de salle apparaît en haut de la fenêtre. Choisissez une salle pour afficher et modifier ses correspondances. Vous pouvez passer d’une salle à l’autre : les modifications non enregistrées de chaque salle sont conservées comme brouillons jusqu’à l’enregistrement.
Le Compte bancaire est commun à toutes les salles de la connexion (défini une fois, il s’applique à toutes).
Lorsque vous enregistrez, toutes les salles ayant des modifications non enregistrées sont enregistrées en une seule opération.
Condition préalable à la synchronisation : en mode « Plan comptable par salle », chaque salle de la connexion doit avoir au moins une correspondance avant qu’un aperçu ou une synchronisation puisse être lancé. La synchronisation ne s’exécute pas si une salle n’a aucune correspondance.
Types et sous-types de comptes
Lorsque vous associez des catégories de chiffre d’affaires, des taux de taxe ou des comptes de dépôt, les menus déroulants affichent les comptes de votre plan comptable tels qu’ils sont chargés directement depuis votre plateforme comptable.
Chaque compte s’affiche avec son type de compte et (pour QuickBooks Online) son sous-type de compte pour vous aider à identifier le bon compte.
Clava applique un filtrage pour que seuls les comptes adaptés à la comptabilisation d’écritures soient proposés dans chaque contexte. Les différents menus déroulants utilisent différentes vues filtrées de votre plan comptable.
QuickBooks Online
Les comptes QuickBooks Online comportent un type de compte et un sous-type de compte, tous deux affichés dans les menus déroulants de correspondance.
Types de comptes disponibles pour la correspondance des catégories de chiffre d’affaires et du compte de dépôt (11 types – les types liés à des comptes auxiliaires sont exclus) :
Type de compte | Usage courant |
| Comptes de trésorerie, comptes courants, comptes d’épargne |
| Actifs à court terme ne relevant pas des autres catégories |
| Immobilisations corporelles à long terme |
| Actifs à long terme ne relevant pas des autres catégories |
| Comptes de carte de crédit |
| Capitaux propres, résultats non distribués |
| Produits de l’activité principale |
| Produits des activités secondaires |
| Charges d’exploitation |
| Charges hors exploitation |
| Coûts directs de production des marchandises vendues |
Types exclus : Accounts Receivable et Accounts Payable sont exclus, car ils nécessitent une référence client ou fournisseur (EntityRef) sur chaque ligne d’écriture, ce qui n’est pas disponible dans la synchronisation agrégée du chiffre d’affaires de Fittr. Long Term Liability et Other Current Liability sont exclus de la correspondance générale, car ils sont réservés à la correspondance des taxes à payer (voir ci-dessous).
Sous-types exclus : les sous-types suivants sont également filtrés de la liste générale des comptes :
UndepositedFundsOpeningBalanceEquityPayrollLiabilitiesTaxPayable
Les sous-types de comptes sont pris en charge et affichés à côté du type de compte dans les menus déroulants. Ils sont définis par QuickBooks Online et varient selon le type de compte (par exemple, Cash on hand ou Savings sous Bank, ou Office Equipment sous Fixed Asset).
Types de comptes disponibles pour la correspondance des taux de taxe (3 types, via un endpoint distinct) :
Type de compte | Usage courant |
| Taxes à payer à court terme |
| Taxes à payer à long terme |
| Comptes de charges fiscales |
Xero
Les comptes Xero comportent uniquement un type de compte. Xero ne prend pas en charge les sous-types de comptes : ce champ apparaît toujours vide dans les menus déroulants de correspondance.
Types de comptes disponibles pour la correspondance des catégories de chiffre d’affaires et du compte de dépôt (tous les types actifs sauf BANK) :
Type de compte | Usage courant |
| Actifs circulants |
| Dettes à court terme |
| Amortissements |
| Coûts directs |
| Comptes de capitaux propres |
| Charges d’exploitation |
| Immobilisations |
| Stocks |
| Dettes générales |
| Actifs non courants |
| Autres produits |
| Frais généraux |
| Charges constatées d’avance |
| Produits |
| Ventes |
| Dettes à terme |
| Retenues à la source à payer (PAYG) |
| Charges de retraite (superannuation) |
| Dettes de retraite (superannuation) |
| Charges salariales |
| Salaires à payer |
Remarque : les comptes de type BANK sont exclus de la requête sur le plan comptable et n’apparaissent pas dans les menus déroulants des catégories de chiffre d’affaires ni du compte de dépôt pour les connexions Xero.
Types de comptes disponibles pour la correspondance des taux de taxe (1 type, via un endpoint distinct) :
Type de compte | Usage courant |
| Comptes de taxes à payer |
Affichage des comptes dans les menus déroulants de correspondance
Dans toutes les fenêtres de correspondance (catégories de chiffre d’affaires, taux de taxe et compte de dépôt), chaque compte s’affiche au format :
[Code] / [AccountType] / [AccountSubType]
QuickBooks Online :
AccountTypeetAccountSubTypesont tous deux renseignés (p. ex.4001 / Income / Discounts/Refunds).Xero : seuls
CodeetAccountTypesont renseignés ;AccountSubTypeest vide (p. ex.200 / REVENUE).
Correspondances de types de comptes recommandées
Pour des états financiers corrects, nous recommandons les correspondances suivantes :
Correspondance | Type de compte recommandé |
Catégorie de chiffre d’affaires → compte de produits |
|
Taux de taxe → compte de passif |
|
Compte de dépôt / bancaire |
|
Correspondances des taux de taxe
QuickBooks et Xero : la correspondance des taux de taxe est obligatoire pour les synchronisations automatiques programmées et vivement recommandée pour les synchronisations manuelles.
Fonctionnement des lignes de taxe
Lorsque des correspondances de taux de taxe sont définies, l’écriture comptable utilise le chiffre d’affaires net (HT) pour chaque ligne de crédit des comptes de produits et ajoute des lignes de crédit explicites pour chaque taux de taxe associé, comptabilisées sur le compte de passif configuré. Le débit total (compte de dépôt) est toujours égal au montant brut d’origine, quel que soit le nombre de taux associés.
Exemple d’écriture comptable (avec correspondance des taxes) :
CR Sales — Pass $100.00 (CA net)
CR Sales — Pack $50.00 (CA net)
CR Tax Payable 10% $15.00 (ligne explicite de taxe à payer)
DR Undeposited Funds $165.00 (montant brut d’origine — inchangé)
Lorsqu’un taux de taxe n’a aucune correspondance, le montant de la taxe reste inclus dans la ligne de chiffre d’affaires brut de la catégorie. Un avertissement s’affiche dans l’aperçu et dans la confirmation de synchronisation. Aucune ligne n’est perdue ; l’écriture comptable est toujours équilibrée.
Configurer les correspondances des taux de taxe
Cliquez sur le bouton Taux de taxe d’une carte de connexion pour ouvrir la fenêtre de correspondance des taxes.
Chaque taux de taxe de la plateforme est listé avec son pourcentage. Sélectionnez un compte de passif de votre plan comptable pour chaque taux.
Plan comptable unique : un seul ensemble de correspondances pour toutes les salles.
Plan comptable par salle : les correspondances sont chargées pour chaque salle. Les correspondances de toutes les salles sont chargées dès l’ouverture de la fenêtre. Passez d’une salle à l’autre avec le sélecteur.
QuickBooks : validation des taxes pour la synchronisation automatique
La synchronisation automatique programmée vérifie que tous les taux de taxe ont une correspondance avant de s’exécuter. Si un taux n’en a pas, la synchronisation automatique ignore entièrement la connexion pour cette exécution. Les synchronisations manuelles ne sont pas bloquées : elles s’exécutent avec un avertissement de taxe sans correspondance.
Suivi par salle
Le suivi par salle permet à une connexion en mode Plan comptable unique de comptabiliser le chiffre d’affaires ventilé par salle dans une seule écriture comptable. Les lignes de chiffre d’affaires et de taxe de chaque salle portent une étiquette de suivi afin que votre plateforme comptable puisse produire des rapports par salle.
Le mode « Plan comptable par salle » n’utilise pas le suivi par salle. Il génère à la place des écritures comptables distinctes pour chaque salle.
QuickBooks : départements
Dans QuickBooks, le suivi par salle utilise les départements.
Conditions :
Abonnement QuickBooks Online Plus ou Advanced.
« Track departments » doit être activé dans QBO → Settings → Account and Settings → Advanced → Categories.
Associer les salles à des départements :
Cliquez sur le bouton Salles d’une carte de connexion pour ouvrir la fenêtre de correspondance des salles.
Pour chaque salle, choisissez l’une des deux options :
Option | Description |
Créer un département | Fittr crée un nouveau département dans QuickBooks pour cette salle lors de l’enregistrement de la correspondance. |
Associer à un élément existant | Sélectionnez un département QuickBooks existant à associer à cette salle. |
Après l’enregistrement, Fittr synchronise immédiatement les correspondances avec QuickBooks. Chaque ligne affiche un statut de synchronisation (En attente, Synchronisé ou Erreur). Le suivi par salle ne peut pas être utilisé tant que toutes les correspondances des salles n’affichent pas Synchronisé.
Xero : catégories de suivi
Dans Xero, le suivi par salle utilise les catégories de suivi et les options de suivi.
Conditions :
Une catégorie de suivi doit exister dans Xero et être définie sur la connexion (non archivée).
Configurer la catégorie de suivi :
Dans la fenêtre Modifier la connexion, sélectionnez la catégorie de suivi Xero à utiliser pour la ventilation par salle. Ce menu déroulant charge les catégories de suivi de votre organisation Xero. Les catégories archivées sont exclues.
Associer les salles à des options de suivi :
Cliquez sur le bouton Salles d’une carte de connexion. La fenêtre liste vos salles ainsi que les options de suivi disponibles dans la catégorie sélectionnée.
Option | Description |
Créer une option de suivi | Fittr crée une nouvelle option de suivi dans Xero pour cette salle. |
Associer à un élément existant | Sélectionnez une option de suivi existante à associer à cette salle. |
Comme pour QuickBooks, toutes les lignes doivent atteindre le statut Synchronisé pour que le suivi par salle soit actif.
Remarque sur Xero : Xero ne permet pas de supprimer une option de suivi une fois créée. Si vous sélectionnez « Créer », l’option reste dans Xero même si vous supprimez ensuite la correspondance de la salle.
Synchronisation
Synchronisation manuelle
Cliquez sur Synchroniser maintenant sur une carte de connexion.
Sélectionnez la période de synchronisation (jour, semaine ou mois).
Si la connexion utilise QuickBooks, un statut de validation des taxes s’affiche. Un avertissement apparaît si des taux de taxe n’ont pas de correspondance.
Cliquez sur Aperçu du rapport pour générer un aperçu de l’écriture comptable sans rien comptabiliser.
Aperçu de l’écriture comptable
L’aperçu affiche l’ensemble des lignes qui seront comptabilisées :
Lignes de crédit – une par catégorie de chiffre d’affaires associée (montant net s’il y a des lignes de taxe ; brut sinon).
Lignes de crédit de taxe – une par taux de taxe associé, sur le compte de passif configuré.
Ligne(s) de débit – une par salle (ou un total unique pour les synchronisations d’une seule salle), sur le compte de dépôt. Toujours égale à la somme de toutes les lignes de crédit.
Si des taux de taxe n’ont pas de correspondance, un bandeau d’avertissement indique le montant total de taxe non associé et les taux concernés. L’aperçu peut tout de même être confirmé.
Si une écriture comptable existe déjà pour la même connexion et la même période, un avertissement de doublon s’affiche. Vous pouvez tout de même continuer ; une nouvelle écriture sera comptabilisée en plus de l’existante.
Cliquez sur Envoyer vers QuickBooks ou Xero pour y comptabiliser l’écriture.
Synchronisation en mode « Plan comptable par salle »
En mode « Plan comptable par salle », la synchronisation crée une écriture comptable par salle. L’écriture de chaque salle :
inclut uniquement les données de chiffre d’affaires de cette salle ;
utilise les correspondances des catégories de chiffre d’affaires configurées pour cette salle ;
utilise les correspondances des taux de taxe configurées pour cette salle ;
ne mélange pas les données d’autres salles.
Si une salle n’a aucun chiffre d’affaires sur la période sélectionnée, elle est ignorée sans message (aucune écriture vide n’est créée).
Si les correspondances d’une salle sont incomplètes, la synchronisation est bloquée pour cette salle et une erreur indique les correspondances manquantes. Les autres salles sont tout de même traitées.
Synchronisation automatique
La synchronisation automatique s’exécute selon un calendrier que vous configurez pour chaque connexion. Fréquences prises en charge :
Fréquence | Exécution | Période comptabilisée |
Quotidienne | Chaque jour | Veille |
Hebdomadaire | Chaque lundi | Du lundi au dimanche précédents |
Mensuelle | Le 1er de chaque mois | Mois civil précédent |
La synchronisation automatique nécessite que :
le statut de la connexion soit
Connectée;le compte de dépôt soit configuré ;
les correspondances requises soient définies pour toutes les salles actives ;
QuickBooks uniquement : tous les taux de taxe aient une correspondance. Si ce n’est pas le cas, la synchronisation automatique ignore la connexion pour cette exécution.
Vous pouvez définir une date de début de synchronisation automatique facultative sur la connexion ; les synchronisations sont ignorées jusqu’à cette date.
Journaux de synchronisation
Chaque carte de connexion affiche l’historique des tentatives de synchronisation dans une liste dépliable. Chaque entrée du journal indique :
la période synchronisée ;
le statut (
RéussieouÉchec) ;le nombre de lignes comptabilisées ;
le détail des lignes de taxe (taux, montants, comptes de passif) ;
les avertissements pour les taux de taxe sans correspondance.
Depuis une entrée du journal de synchronisation, vous pouvez supprimer l’écriture comptable directement dans QuickBooks ou Xero.
QuickBooks : l’écriture comptable est définitivement supprimée de QBO.
Xero : l’écriture manuelle est annulée (statut
VOIDED). Xero ne permet pas de véritable suppression des écritures manuelles comptabilisées.
Dépannage
Erreur « Toutes les salles doivent avoir au moins une correspondance »
Vous êtes en mode « Plan comptable par salle » et une ou plusieurs salles de la connexion n’ont aucune correspondance de catégorie de chiffre d’affaires. Ouvrez Correspondances, passez d’une salle à l’autre et attribuez au moins une correspondance de compte à chacune.
Avertissement de validation des taxes dans la fenêtre de synchronisation (QuickBooks)
Un ou plusieurs taux de taxe de la plateforme n’ont pas de compte de passif associé. Ouvrez Taux de taxe et attribuez un compte de passif à chaque taux listé. Tant que ce n’est pas fait, la synchronisation automatique programmée ne s’exécutera pas pour cette connexion.
La correspondance d’une salle affiche le statut « Erreur »
Fittr n’a pas pu créer ou vérifier le département (QuickBooks) ou l’option de suivi (Xero) chez la plateforme. Vérifiez que :
votre jeton OAuth est toujours valide (essayez de déconnecter puis de reconnecter l’intégration) ;
pour QuickBooks : votre abonnement prend en charge les départements (Plus ou Advanced requis) ;
pour Xero : la catégorie de suivi n’est pas archivée.
Réessayez d’enregistrer la correspondance de la salle une fois le problème résolu. La synchronisation est bloquée tant que toutes les correspondances des salles n’ont pas atteint le statut Synchronisé.
Avertissement d’écriture comptable en double
Une écriture comptable a déjà été comptabilisée pour cette connexion et cette période. Si l’écriture précédente était incorrecte, supprimez-la d’abord depuis les journaux de synchronisation, puis relancez la synchronisation.
Xero : « Cannot delete journal entry »
Xero ne permet pas de supprimer les écritures manuelles comptabilisées. L’intégration annule donc l’écriture à la place. Les écritures annulées restent visibles dans Xero mais sont exclues des rapports. Il s’agit d’une limite de la plateforme Xero.
