1. A quoi sert la synchronisation comptable?
Cette fonctionnalité permet de synchroniser les écritures comptables des factures de vente et des factures d'achat et d'éviter ainsi le double encodage.
Les factures clients: Depuis Vertuoza vers le logiciel comptable
Les factures fournisseurs: Depuis Vertuoza vers le logiciel comptable
👉 Résultat : Vous gagnez du temps et réduisez les risques d’erreur de saisie.
Et c’est inclus dans votre abonnement, sans coût supplémentaire.
👉👉👉 Voici tous les logiciels compatibles
2. Comment configurer une synchronisation comptable ?
2.1 Connexion entre les deux logiciels
- Vous pouvez aller dans Vertuoza dans vos Paramètres < Intégration < Synchro comptable
- Vous sélectionnez votre logiciel comptable et cliquez sur "Connecter"
Il existe 📡 Deux types d’intégration :
Logiciels en ligne avec connexion directe
Cliquez sur votre logiciel comptable
remplissez les champs de connexion
✨ Astuce:
Cliquez sur "Comment se connecter" pour avoir de l'aide
Logiciels qui nécessitent un agent local installé sur le serveur/ordinateur :
BOB50
Sage 100
Winbooks
⚠️⚠️ Rapprochez vous de votre comptable et/de votre informaticien ⚠️⚠️
Pour permettre l’échange des données, un petit connecteur doit être installé sur votre serveur/ordinateur où le logiciel comptable est installé.
L’opération prend quelques minutes et doit être faite avec la personne en accès admin
Si besoin, prenez contact avec Vertuoza et nous vous accompagnerons lors d’un rendez-vous afin que tout soit configuré correctement et en toute sécurité.
2.2. Paramétrage comptable
Une fois la connexion établie, vous pouvez rentrer les informations comptables nécessaires dans la page de connexion. Ces informations sont récupérables depuis votre logiciel comptable:
Codes TVA : Pour chaque TVA utilisée dans vos factures, vous devez ajouter le code TVA correspondant. Ce code provient de votre logiciel comptable.
Comptes généraux: Ajouter les comptes généraux utilisés dans votre logiciel comptable.
Liaison des comptes généraux aux types de composants: Il existe plusieurs liaisons possibles
par types de composants : C'est le minimum obligatoire.
par composant
par ligne de facture
Journaux comptables
Plan analytique:
L'utilisation de plan analytique dans votre logiciel de comptabilité permet, par exemple, de répartir les achats et les ventes par chantier.
Si vous activez l'utilisation des plans analytiques, Vertuoza va créer les chantiers comme analytique dans votre logiciel comptable.
Vous pourrez donc analyser vos factures par chantier.
Attention: si vous avez déjà des analytiques créés dans votre logiciel comptable pour des chantiers de Vertuoza, il est obligatoire d'indiquer l'identifiant de cet analytique dans le champ "identifiant comptable" de votre chantier (voir Gestion > Chantier).
Attention: si vous avez déjà des clients ou des fournisseurs créés dans votre logiciel comptable et si ceux-ci sont aussi dans Vertuoza, il est obligatoire d'indiquer leur identifiant dans la champ "identifiant comptable" dans votre ficher contact/entreprise.ID contact/entreprise:
Pour éviter des doublons de contact (client, fournisseur) entre les deux logiciels et lier correctement les écritures comptables à ceux-ci
3. Questions fréquentes
Où trouver l'agent local à installer pour les logiciels comptables concernés ?
Lors de la configuration de la synchronisation comptable chez notre partenaire CHIFT, le téléchargement de l'exécutable vous sera automatiquement proposé à la fin de votre configuration dans le cas où il faut installer un exécutable.
La documentation se trouve ici: >>ici<<.
Où trouver les codes TVA ?
Pour Winbooks Classic et Bob50, les codes TVA se trouvent assez facilement dans le logiciel comptable.
Pour Odoo, il faut aller dans la fiche d’une TVA que l’on souhaite utiliser et regarder dans l’URL de la page. Dans l’URL il y a “?id=” suivi d’un chiffre et c’est ce chiffre qu'il faut mettre dans Vertuoza comme code TVA.
Pour les autres logiciels, veuillez contacter le support après avoir fait votre liaison de compte de votre logiciel comptable.
Quelle est la différence entre synchronisation comptable et synchronisation des paiements ?
La synchronisation comptable permet de synchroniser les informations sur les factures clients et fournisseurs entre Vertuoza et le logiciel de comptabilité de votre entreprise.
La synchronisation des paiements est liée aux logiciels de relevé bancaire. Cette fonctionnalité dans Vertuoza permet de récupérer les extraits de compte sous forme de paiements. On peut ainsi assigner un paiement à une facture dans Vertuoza et donc changer le statut de paiement d’une facture.
Que faire en cas d'erreur ?
Vous trouverez ci-dessous tous les codes d'erreur de l'API Chift avec des descriptions simplifiées et des solutions pratiques:
Error Code | Description simplifiée | Résolution |
ERROR_CHIFT_AUTHENTICATION_ERROR | Vos identifiants Chift sont incorrects ou expirés | Vérifiez votre connexion à Chift ou l’installation de votre agent local. |
ERROR_CONNECTOR_AUTHENTICATION | Le mot de passe ou identifiant du logiciel comptable est incorrect | Reconnectez-vous au logiciel comptable avec les bons identifiants |
ERROR_CONNECTOR_CONFIGURATION | L’agent local n'est pas correctement configuré | Vérifiez ou réinstallez l’agent local lié à votre logiciel comptable. |
ERROR_CONFIGURATION_SYNC | La synchronisation n'est pas bien paramétrée | Activez et configurez correctement la synchronisation. |
ERROR_NO_ACTIVE_CONNECTION | Aucune connexion active n'existe pour cette API | Activez et configurez correctement la synchronisation. |
ERROR_CONFIGURATION_CONNECTION | Problème dans la configuration de la connexion | Vérifiez ou recommencez la connexion à votre logiciel comptable via Chift. |
ERROR_DATA_VALIDATION | Les données envoyées ne sont pas valides | Contactez le support pour identifier le problème |
ERROR_API_RESOURCE_NOT_FOUND | Erreur technique | Veuillez réessayer et contactez le support si le problème persiste. |
ERROR_WEBHOOK_NOT_SUPPORTED | Erreur technique | Contactez le support pour identifier le problème |
ERROR_UNKNOWN | Erreur inconnue | Veuillez réessayer et contactez le support si le problème persiste. |
ERROR_INVALID_BODY | Un champ dans votre requête est invalide | Vérifiez que tous les champs de votre facture sont correctement complétés. |
ERROR_INVALID_QUERY_PARAMETER | Erreur technique | Veuillez réessayer et contactez le support si le problème persiste. |
ERROR_INVALID_PATH_PARAMETER | Erreur technique | Veuillez réessayer et contactez le support si le problème persiste. |
ERROR_INVALID_RESPONSE | Erreur technique | Veuillez réessayer et contactez le support si le problème persiste. |
ERROR_RESOURCE_NOT_SUPPORTED | Erreur technique | Veuillez réessayer et contactez le support si le problème persiste. |
ERROR_TECHNICAL_MAPPING | Erreur technique | Veuillez réessayer et contactez le support si le problème persiste. |
ERROR_INTEGRATION_INVALID | Erreur technique | Veuillez réessayer et contactez le support si le problème persiste. |
ERROR_CONNECTION_INFO_EMPTY | Erreur technique | Veuillez réessayer et contactez le support si le problème persiste. |
ERROR_CONFIGURATION_LOCALAGENT | Impossible de se connecter à l'agent local | Vérifiez ou réinstallez l’agent local lié à votre logiciel comptable. |
ERROR_GATEWAY_TIMEOUT | Le logiciel ne répond pas | Veuillez réessayer et contactez le support si le problème persiste. |
ERROR_BACKEND_FORBIDDEN | Erreur technique | Veuillez réessayer et contactez le support si le problème persiste. |
REQUEST_ALREADY_PROCESSED | Cette requête a déjà été traitée avec succès | Ne renvoyez pas la même requête |
REQUEST_IN_PROCESS | Cette requête est en cours de traitement | Attendez la fin du traitement avant de réessayer |
ERROR_RATE_LIMIT | Vous avez fait trop de requêtes trop rapidement | Attendez quelques minutes avant de réessayer |
ERROR_BACKEND_NOT_FOUND | Erreur technique | Veuillez réessayer et contactez le support si le problème persiste. |
ERROR_UNEXPECTED | Erreur inattendue liée aux données | Veuillez réessayer et contactez le support si le problème persiste. |
ERROR_INTERNAL_ERROR | Erreur technique interne | Veuillez réessayer et contactez le support si le problème persiste. |
ERROR_CONNECTOR_MISSING_EXTENSION | Une extension du logiciel est manquante | Installez ou mettez à jour l'extension requise |
ERROR_INVALID_VAT_FORMAT | Le numéro de TVA n'est pas au bon format | Utilisez le format sans espaces ni points et au bon format (ex: BE0784930037) |
ERROR_INVALID_LANGUAGE_FORMAT | Le code langue n'est pas valide | Veuillez contacter le support pour résoudre ce problème. |
ERROR_INVALID_CURRENCY_FORMAT | Le code devise n'est pas valide | Veuillez contacter le support pour résoudre ce problème. |
ERROR_INVALID_COUNTRY_FORMAT | Le code pays n'est pas valide | Veuillez contacter le support pour résoudre ce problème. |
ERROR_INVALID_FINANCIAL_PERIOD_FORMAT | La période comptable n'est pas au bon format | Vérifiez le format de votre période comptable dans vos par |
ERROR_BOOKS_FROZEN | La comptabilité est verrouillée/gelée | Déverrouillez la comptabilité dans le logiciel |
ERROR_NO_INVOICE_LINE | La facture doit contenir au moins une ligne | Ajoutez au moins un article/ligne à la facture |
ERROR_ZERO_INVOICE | Le montant de la facture ne peut pas être zéro | Créez une facture avec un montant supérieur à zéro |
ERROR_ZERO_LINE | Une ligne de la facture a un montant de zéro | Supprimez ou modifiez les lignes avec montant zéro |
ERROR_NO_OPERATION_LINE | L'opération doit contenir au moins une ligne | Ajoutez au moins une ligne à l'opération |
ERROR_INVALID_OPERATION_LINE_TYPE | Une ligne client/fournisseur doit avoir un partner_id | Ajoutez le partner_id pour les lignes client/fournisseur |
ERROR_OPERATION_NOT_BALANCED | Les montants débits et crédits ne sont pas équilibrés | Assurez-vous que la somme des lignes = 0 |
ERROR_NOT_ENOUGH_MATCHING_ENTRIES | Il faut minimum 2 écritures pour un lettrage | Sélectionnez au moins 2 écritures à lettrer |
ERROR_ANALYTIC_ACCOUNTING_NOT_ACTIVE | La comptabilité analytique n'est pas activée | Activez la comptabilité analytique dans le logiciel |
ERROR_ANALYTIC_ACCOUNTING_PLAN_NOT_CONFIGURED | Aucun plan analytique par défaut n'est configuré | Configurez un plan analytique par défaut |
ERROR_ANALYTIC_ACCOUNT_ALREADY_EXISTS | Ce compte analytique existe déjà | Utilisez un autre code de compte analytique |
ERROR_ANALYTIC_ACCOUNT_NOT_FOUND | Le compte analytique n'existe pas | Créez d'abord le compte analytique dans le logiciel |
ERROR_ANALYTIC_PLAN_NOT_FOUND | Le plan analytique n'existe pas | Créez d'abord le plan analytique dans le logiciel |
ERROR_INVALID_ANALYTIC_DISTRIBUTION | La répartition analytique est incorrecte | Vérifiez que chaque plan totalise 100% et n'apparaît qu'une fois |
ERROR_INVALID_ANALYTIC_DISTRIBUTION_ACCOUNTS | Chaque plan analytique doit avoir au moins un compte | Ajoutez au moins un compte analytique par plan |
ERROR_INVALID_ANALYTIC_DISTRIBUTION_ACCOUNTS_PERCENTAGE | Les comptes analytiques doivent totaliser 100% | Ajustez les pourcentages pour qu'ils totalisent 100% |
ERROR_INVOICE_AMOUNTS_DO_NOT_MATCH | Les montants de la facture sont incohérents | Recalculez les montants de la facture |
ERROR_LINE_AMOUNTS_DO_NOT_MATCH | Les montants d'une ligne sont incohérents | Vérifiez le montant de TVA et le taux de TVA |
ERROR_TAX_RATE_NOT_CORRESPONDING | Le taux de TVA ne correspond pas au code TVA | Utilisez un code TVA avec le bon taux ou modifiez le mapping |
ERROR_MULTIPLE_GL_ACCOUNTS | Les écritures ont des comptes créditeurs/débiteurs différents | Utilisez le même compte créditeur/débiteur pour toutes les écritures |
ERROR_MULTIPLE_PARTNER_ACCOUNTS | Une écriture ne peut avoir qu'un seul compte tiers | Utilisez un seul compte tiers par écriture |
ERROR_ACCOUNT_NUMBER_NOT_CONFIGURED | Ce compte n'est pas configuré pour les écritures | Configurez le compte dans le logiciel comptable |
ERROR_ENTRY_HAS_INVALID_STATUS | L'écriture n'a pas le bon statut pour être lettrée | Changez le statut de l'écriture |
ERROR_ENTRY_HAS_NO_ACCOUNT_RECEIVABLE_PAYABLE | L'écriture n'a pas de compte client/fournisseur | Ajoutez un compte client/fournisseur à l'écriture |
ERROR_ENTRY_NOT_LINKED_TO_PARTNER | L'écriture n'est pas liée au tiers indiqué | Vérifiez que l'écriture est bien liée au bon tiers |
ERROR_ENTRY_ALREADY_RECONCILED | L'écriture est déjà lettrée | Délettrz d'abord l'écriture si nécessaire |
ERROR_ENTRY_ALREADY_PARTIALLY_MATCHED | L'écriture est déjà partiellement lettrée | Délettrez l'écriture ou complétez le lettrage existant |
ERROR_JOURNAL_NOT_GOOD_SCOPE | Le journal ne peut pas être utilisé pour ce type | Utilisez un journal vente pour les factures de vente, etc. |
ERROR_JOURNAL_NOT_CONFIGURED | Le journal n'est pas configuré | Configurez le journal dans le logiciel comptable |
ERROR_TAX_CODE_NOT_GOOD_SCOPE | Ce code TVA ne peut pas être utilisé ici | Utilisez un code TVA vente pour les ventes, achat pour les achats |
ERROR_MULTIPLE_JOURNALS | Plusieurs journaux correspondent | Précisez quel journal utiliser dans votre requête |
ERROR_JOURNAL_NOT_FOUND_FOR_SCOPE | Aucun journal n'a été trouvé pour ce type | Créez un journal adapté ou précisez-le dans la requête |
ERROR_INVOICE_NUMBER_ALREADY_USED | Ce numéro de facture existe déjà | Utilisez un autre numéro de facture |
ERROR_INVOICE_ALREADY_EXISTS | Cette facture existe déjà | Ne créez pas de doublon, modifiez l'existante si besoin |
ERROR_ENTRY_NUMBER_ALREADY_USED | Ce numéro d'écriture existe déjà | Utilisez un autre numéro d'écriture |
ERROR_PDF_NOT_APPLICABLE_TO_DRAFT_INVOICE | Impossible d'ajouter un PDF à un brouillon | Créez d'abord la facture définitive avant d'ajouter le PDF |
ERROR_TAX_CODE_NOT_FOUND | Le code TVA n'existe pas | Créez le code TVA dans le logiciel ou modifiez le mapping |
ERROR_TAX_CODE_NOT_CONFIGURED | Le code TVA n'est pas correctement configuré | Ajoutez un compte de TVA au code TVA dans le logiciel |
ERROR_ACCOUNT_NUMBER_NOT_FOUND | Le compte général n'existe pas | Créez le compte dans le plan comptable |
ERROR_OPERATION_NOT_FOUND | L'opération n'existe pas | Vérifiez l'ID de l'opération |
ERROR_OPERATION_NUMBER_ALREADY_USED | Ce numéro d'opération existe déjà | Utilisez un autre numéro d'opération |
ERROR_WRONG_ACCOUNT_TYPE | Le type de compte est incorrect pour cette ligne | Utilisez un compte du bon type (charge, produit, etc.) |
ERROR_BOOKYEAR_NOT_FOUND | Aucun exercice comptable pour cette date | Créez l'exercice comptable incluant cette date |
ERROR_PERIOD_CLOSED | La période comptable est clôturée | Rouvrez la période ou utilisez une autre date |
ERROR_JOURNAL_LOCKED | Le journal est verrouillé | Déverrouillez le journal dans le logiciel |
ERROR_INVALID_FIELD_FORMAT_BANK_ACCOUNT | Le numéro de compte bancaire/IBAN est invalide | Vérifiez le format du numéro de compte |
ERROR_INVALID_FIELD_FORMAT_ANALYTIC_ACCOUNT | Le code du compte analytique n'est pas valide | Respectez le format du logiciel comptable |
ERROR_INVALID_FIELD_FORMAT_ANALYTIC_PLAN | Le format du plan analytique n'est pas valide | Respectez le format du logiciel comptable |
ERROR_INVALID_FIELD_FORMAT_JOURNAL_ID | Le format de l'ID journal n'est pas valide | Respectez le format du logiciel comptable |
ERROR_INVALID_FIELD_FORMAT_TAX_CODE | Le format du code TVA n'est pas valide | Respectez le format du logiciel comptable |
ERROR_INVALID_FIELD_FORMAT_ENTRIES | Le format des IDs d'écritures n'est pas valide | Respectez le format du logiciel comptable |
ERROR_JOURNAL_ALREADY_OPEN | Le journal est déjà ouvert | Fermez d'abord le journal avant de créer l'écriture |
ERROR_INVALID_FIELD_FORMAT_ID | Le format de l'ID n'est pas valide | Respectez le format du logiciel comptable |
ERROR_INVALID_FIELD_FORMAT_PARTNER_ID | Le format de l'ID tiers n'est pas valide | Respectez le format du logiciel comptable |
ERROR_INVALID_FIELD_FORMAT_COMPANY_ID | Le format de l'ID société n'est pas valide | Respectez le format du logiciel comptable |
ERROR_MISSING_FIRST_NAME | Le prénom est obligatoire pour une personne physique | Ajoutez le prénom du client/fournisseur |
ERROR_MISSING_LAST_NAME | Le nom est obligatoire pour une personne physique | Ajoutez le nom du client/fournisseur |
ERROR_PARTNER_ALREADY_EXISTS | Ce client/fournisseur existe déjà | Utilisez un autre code ou modifiez l'existant |
ERROR_JOURNAL_NOT_FOUND | Le journal n'existe pas | Créez le journal dans le logiciel ou vérifiez son ID |
ERROR_PARTNER_NOT_FOUND | Le client/fournisseur n'existe pas | Créez d'abord le client/fournisseur dans le logiciel |
ERROR_ENTRY_NOT_FOUND | L'écriture n'existe pas | Vérifiez l'ID de l'écriture |
ERROR_DUPLICATE_ENTRIES | Les écritures contiennent des doublons | Supprimez les écritures en double |
ERROR_INVOICE_NOT_FOUND | La facture n'existe pas | Vérifiez l'ID de la facture |
ERROR_MISCELLANEOUS_OPERATION_NOT_FOUND | L'opération diverse n'existe pas | Vérifiez l'ID de l'opération diverse |
ERROR_LANGUAGE_NOT_FOUND | La langue n'existe pas ou n'est pas active | Activez la langue dans le logiciel ou utilisez-en une autre |
ERROR_CURRENCY_NOT_FOUND | La devise n'existe pas ou n'est pas active | Activez la devise dans le logiciel ou utilisez-en une autre |
ERROR_NEGATIVE_INVOICE | Une facture ne peut pas être négative | Utilisez une note de crédit au lieu d'une facture négative |
ERROR_ACCOUNT_NUMBER_NOT_ACTIVE | Le compte utilisé n'est pas actif | Activez le compte dans le plan comptable |
ERROR_PARTNER_NOT_ACTIVE | Le client/fournisseur n'est pas actif | Activez le client/fournisseur dans le logiciel |
ERROR_ACCOUNT_NUMBER_NOT_GOOD_SCOPE | Ce compte ne peut pas être utilisé dans ce contexte | Utilisez un compte approprié au type d'opération |
ERROR_INVALID_INVOICE_DATE | La période de cette date est verrouillée | Utilisez une date dans une période ouverte |
ERROR_WRONG_ENTRY_TYPE | Vous ne pouvez créer que des écritures vente/achat | Utilisez un journal de vente ou d'achat |
ERROR_MAX_DIFFERENCE_MONTHS | Vous pouvez récupérer maximum 3 mois de données | Réduisez la période entre date_from et date_to |
ERROR_ATTACHMENT_ALREADY_EXISTS | Une pièce jointe existe déjà pour cette facture | Supprimez d'abord l'ancienne pièce jointe |
ERROR_INVALID_BASE64_STRING | Le document PDF n'est pas valide | Vérifiez l'encodage base64 de votre PDF |
ERROR_INVALID_DUE_DATE | La date d'échéance doit être après la date de facture | Corrigez la date d'échéance |
ERROR_CHARGE_PRODUCT_ACCOUNT_MISSING | Au moins un compte charge/produit est requis | Ajoutez un compte de charge ou produit |
ERROR_COLLECTIVE_ACCOUNT_MISSING | Un compte collectif client/fournisseur est requis | Ajoutez le compte collectif |
ERROR_PARTNER_ACCOUNT_MISSING | Un compte tiers est requis dans partner_id | Ajoutez le compte tiers |
ERROR_ANALYTIC_ACCOUNT_ARCHIVED | Le compte analytique est archivé | Désarchivez le compte ou utilisez-en un autre |
ERROR_INVALID_FIELD_FORMAT_INVOICE_NUMBER | Le numéro de facture est trop long ou invalide | Raccourcissez ou corrigez le numéro de facture |
ERROR_INVALID_FIELD_FORMAT_OPERATION_NUMBER | Le numéro d'opération est trop long ou invalide | Raccourcissez ou corrigez le numéro d'opération |
ERROR_INVALID_FIELD_FORMAT_NUMBER | Le numéro est trop long ou invalide | Raccourcissez ou corrigez le numéro |
ERROR_ANALYTIC_ACCOUNT_NUMBER_PLAN_NOT_ACTIVE | Ce compte ne peut pas utiliser ce plan analytique | Configurez le compte pour ce plan analytique |
ERROR_LEDGER_ACCOUNT_ALREADY_EXISTS | Ce compte général existe déjà | Utilisez un autre numéro de compte |
ERROR_NUMBER_ALREADY_USED | Ce numéro est déjà utilisé | Utilisez un numéro différent |
ERROR_COUNTERPART_ACCOUNT_NUMBER_NOT_GOOD_SCOPE | Le compte de contrepartie ne peut pas être utilisé ici | Utilisez un compte de contrepartie approprié |
ERROR_COUNTERPART_ACCOUNT_NOT_FOUND | Le compte de contrepartie n'existe pas | Créez le compte de contrepartie |
ERROR_COLLECTIVE_ACCOUNT_NOT_CONFIGURED | Le compte collectif n'est pas configuré | Configurez le compte collectif client/fournisseur |
ERROR_JOURNAL_ALREADY_EXISTS | Ce journal existe déjà | Utilisez un autre code de journal |
ERROR_COUNTERPART_ACCOUNT_ALREADY_USED | Ce compte de contrepartie est déjà lié à un journal | Utilisez un autre compte de contrepartie |
ERROR_COUNTERPART_ACCOUNT_NOT_ALLOWED | Un compte de contrepartie n'est autorisé que pour les journaux banque/caisse | Retirez le compte de contrepartie ou changez le type de journal |
ERROR_MISSING_COUNTERPART_ACCOUNT | Un compte de contrepartie est obligatoire pour les journaux banque/caisse | Ajoutez un compte de contrepartie |
ERROR_PERIOD_BLOCKED | La période est bloquée à cause d'une révision | Attendez la fin de la révision |
ERROR_PDF_MUST_BE_UNIQUE | Ce PDF existe déjà dans le logiciel | La facture existe déjà, ne créez pas de doublon |
ERROR_ENTRY_ITEMS | Vous devez avoir au moins 2 lignes d'écriture | Ajoutez au moins 2 lignes à votre écriture |
ERROR_BANK_ACCOUNT_NUMBER_ALREADY_EXISTS | Ce numéro de compte bancaire existe déjà | Utilisez un autre numéro de compte |