Passer au contenu principal

Guide de configuration avancée des intégrations comptables

Guide avancé de l’intégration comptable de Clava avec QuickBooks Online et Xero

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 (JournalEntry)

Écriture manuelle (ManualJournal)

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

Track Departments doit être activé dans les préférences de QBO

Une catégorie de suivi doit être configurée sur la connexion

Types de comptes

AccountType et AccountSubType (tous deux pris en charge)

AccountType uniquement (sous-types non pris en charge)

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

  1. Dans Paramètres → Intégrations → Comptabilité (Settings → Integrations → Accounting), activez l’interrupteur QuickBooks.

  2. Cliquez sur Connecter QuickBooks. Vous êtes redirigé vers la page d’autorisation OAuth d’Intuit.

  3. Connectez-vous et autorisez la connexion.

  4. 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).

  5. Cliquez sur Enregistrer.

Connecter Xero

  1. Dans Paramètres → Intégrations → Comptabilité, activez l’interrupteur Xero.

  2. Cliquez sur Connecter Xero. Vous êtes redirigé vers la page d’autorisation OAuth de Xero.

  3. Connectez-vous, sélectionnez votre organisation Xero et autorisez la connexion.

  4. 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.

  5. 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

Bank

Comptes de trésorerie, comptes courants, comptes d’épargne

Other Current Asset

Actifs à court terme ne relevant pas des autres catégories

Fixed Asset

Immobilisations corporelles à long terme

Other Asset

Actifs à long terme ne relevant pas des autres catégories

Credit Card

Comptes de carte de crédit

Equity

Capitaux propres, résultats non distribués

Income

Produits de l’activité principale

Other Income

Produits des activités secondaires

Expense

Charges d’exploitation

Other Expense

Charges hors exploitation

Cost of Goods Sold

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 :

  • UndepositedFunds

  • OpeningBalanceEquity

  • PayrollLiabilities

  • TaxPayable

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

Other Current Liability

Taxes à payer à court terme

Long Term Liability

Taxes à payer à long terme

Expense (sous-type TaxesPaid uniquement)

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

CURRENT

Actifs circulants

CURRLIAB

Dettes à court terme

DEPRECIATN

Amortissements

DIRECTCOSTS

Coûts directs

EQUITY

Comptes de capitaux propres

EXPENSE

Charges d’exploitation

FIXED

Immobilisations

INVENTORY

Stocks

LIABILITY

Dettes générales

NONCURRENT

Actifs non courants

OTHERINCOME

Autres produits

OVERHEADS

Frais généraux

PREPAYMENT

Charges constatées d’avance

REVENUE

Produits

SALES

Ventes

TERMLIAB

Dettes à terme

PAYGLIABILITY

Retenues à la source à payer (PAYG)

SUPERANNUATIONEXPENSE

Charges de retraite (superannuation)

SUPERANNUATIONLIABILITY

Dettes de retraite (superannuation)

WAGESEXPENSE

Charges salariales

WAGESPAYABLELIABILITY

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

LIABILITY

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 : AccountType et AccountSubType sont tous deux renseignés (p. ex. 4001 / Income / Discounts/Refunds).

  • Xero : seuls Code et AccountType sont renseignés ; AccountSubType est 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

Income / Other Income (QBO) ou REVENUE / SALES / OTHERINCOME (Xero)

Taux de taxe → compte de passif

Other Current Liability / Long Term Liability (QBO) ou LIABILITY (Xero)

Compte de dépôt / bancaire

Bank (QBO) ou CURRENT (Xero – BANK est exclu ; utilisez un compte d’actif circulant)


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

  1. Cliquez sur Synchroniser maintenant sur une carte de connexion.

  2. Sélectionnez la période de synchronisation (jour, semaine ou mois).

  3. 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.

  4. 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éussie ou É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.

Avez-vous trouvé la réponse à votre question ?