Passer au contenu principal

Guide d’utilisation des intégrations comptables (avancé)

Guide d’utilisation des intégrations comptables

Vue d’ensemble

Clava - Fittr s’intègre à deux plateformes comptables : QuickBooks Online (QBO) et Xero. Les deux intégrations comptabilisent automatiquement le chiffre d’affaires des ventes sous forme d’écritures comptables dans votre plan comptable, mais elles diffèrent par la structure des écritures, le fonctionnement du suivi par salle et le traitement 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

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 de QuickBooks (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.


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, Clava - 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 »

Clava - 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 ?