xtraCHEF : Obtenir de l’aide pour les erreurs d’extraction QuickBooks

Dernière mise à jour : 7 juill. 2026, 12 h 57

Si vous recevez un message d’erreur lors de l’extraction des factures de xtraCHEF vers Quickbooks, découvrez comment corriger cette erreur.

Dans cet article :

 

Déterminer si une extraction a réussi

Pour déterminer si une extraction a été importée avec succès dans QuickBooks, consultez le Moniteur d’extraction. Pour tout statut d’extraction de facture qui n’est pas vert, sélectionnez Afficher les détails de ce fichier spécifique.

 

Voir les détails bouton en surbrillance sur le Moniteur d’extraction



En fonction de ce que le message d’erreur indique, utilisez ce guide pour résoudre l’erreur.

 

Message d’erreur d’extraction


Haut de page

 

Codes d’erreur QuickBooks

Le reste de ce guide fera référence aux codes d’erreurs d’extraction QuickBooks et à la manière de les corriger.

 

Haut de page

 

Référence invalide au fournisseur

« Il y a une référence invalide au “nom du fournisseur” dans la facture. Message d’erreur QuickBooks : Argument invalide. »
OU
« Le « nom du fournisseur » n’existe pas dans QuickBooks »


Ce type d’erreur est dû au fait que le code fournisseur ne correspond pas à ce qui est indiqué comme le nom du fournisseur ou le nom d’affichage sous pour le fournisseur indiqué dans QuickBooks. Le Code fournisseur peut être corrigé en procédant comme suit :

 

  • Ouvrez la page Vendeurs sur votre barre de menu de gauche dans xtraCHEF.
  • Recherchez le fournisseur spécifique en question.
  • Sélectionnez le code fournisseur du locataire à mettre à jour.
  • Apporte des modifications et sélectionne le bouton Vérifier.
    • Le code fournisseur dans xtraCHEF doit correspondre à la façon dont le fournisseur apparaît dans QuickBooks.
      • QuickBooks en ligne : Le code fournisseur dans xtraCHEF doit correspondre au « Nom d’affichage sous » pour le fournisseur.
      • QuickBooks Desktop : Le code fournisseur dans xtraCHEF doit correspondre au nom du fournisseur dans Quickbooks.
  • Une fois le code fournisseur du locataire mis à jour, vous pouvez extraire de nouveau le fichier échoué du Moniteur d’extraction.

 

Mettre à jour la colonne Code fournisseur sur la page Fournisseurs


Haut de page

 

Référence invalide à XCG-TAX

« Il y a une référence invalide au compte QuickBooks « XCG-TAX » dans le projet de loi. Message d’erreur QuickBooks : Argument invalide. »


Cette erreur est due à la répartition des frais au niveau de l’en-tête. xtraCHEF propose quatre frais au niveau de l’en-tête qui peuvent être répartis selon vos préférences.

 

  • Taxe de vente
  • Frais de transport/distribution
  • Rabais
  • Autres frais

 

Il existe 3 options pour gérer ces frais au niveau de l’en-tête. Choisissez l’une des trois options :

 

  1. Répartissez également entre tous les codes GLG appliqués à la facture.
  2. Appliquer uniquement au code GLG dont le coût le plus élevé est indiqué sur la facture.
  3. Appliquer à un code GLG spécifique dans votre système QB.

 

Si aucune préférence n’apparaît, xtraCHEF les appliquera aux codes GLG par défaut : XCG-FC, XCG-OC, XCG-DC et XCG-TAX.


Haut de page

 

Le compte n’existe pas dans QuickBooks

« Le compte « 1234 » n’existe pas dans QuickBooks »
OU
« Il y a une référence invalide au compte QuickBooks « 1234 » dans le projet de loi. Message d’erreur QuickBooks : Argument invalide. L’enregistrement spécifié n’existe pas dans la liste. »

 

Cette erreur peut apparaître lorsque le code GLG indiqué pour une facture n’apparaît pas dans votre système QuickBooks. Cette erreur apparaîtra sur toutes les factures avec le code GLG spécifié dans le message d’erreur d’extraction.


Option 1 : Si le code GLG est correct, mais qu’il apparaît différemment dans xtraCHEF, le code GLG peut être modifié comme suit :

 

  1. Sélectionnez l’icône engrenage > Codes GLG dans le coin supérieur droit du compte xtraCHEF. Seuls les administrateurs de locataires auront cet accès.
  2. Sélectionnez le code GLG spécifique indiqué dans le message d’erreur et sélectionnez Modifier le code GLG.
  3. Mettez ensuite à jour le code GLG pour qu’il corresponde à la façon dont il est répertorié dans QuickBooks. Sélectionnez Enregistrer.

 

Mise à jour d’un code GLG pour le faire correspondre dans QB


Option 2 : Si le code GLG incorrect est affiché dans le message d’erreur, cela indiquera que la catégorie incorrecte a été attribuée à un produit indiqué sur la facture. Pour corriger cela, mettez à jour la catégorie (code GLG) de la Bibliothèque d’articles en suivant ces étapes :

 

  1. Naviguez vers la bibliothèque d’articles dans la navigation de gauche dans xtraCHEF.
  2. Utilisez le menu déroulant pour filtrer selon le fournisseur spécifique associé à la facture et sélectionner l’article de facture.
  3. Au bas de la page, mettez à jour le champ Catégorie et vous verrez le champ de code GLG mis à jour en conséquence. Sélectionnez Enregistrer les modifications.
  4. Une fois la catégorie mise à jour, essayez d’extraire de nouveau la facture.

 

Modification de la catégorie d’un article de facture dans la bibliothèque des articles


Haut de page

 

Message=AuthenticationFailed

"message=authentification échouée; errorCode=003200; statusCode=401"


Cette erreur est généralement liée à l’expiration du jeton QuickBooks en ligne ou peut simplement être une erreur de délai dans QuickBooks. Tout d’abord, essayez de réextraire le fichier d’extraction ou la facture spécifique à partir du Moniteur d’extraction ou de la Recherche de factures. Si la même erreur est reçue, demandez au client d’actualiser le jeton QuickBooks.


Pour actualiser le jeton QuickBooks, le client devra :

 

  1. Accédez à l’icône engrenage > Configuration du compte dans le coin supérieur droit de xtraCHEF.
  2. Sélectionnez l’onglet Intégrations.
  3. Sélectionnez Connecter à QuickBooks.

 

Cela l’invitera à se connecter à QuickBooks en ligne et devra être complété par quelqu’un ayant accès à QuickBooks Admin.


Haut de page

 

Longueur de la chaîne

« La longueur de la chaîne est soit plus courte, soit plus longue que celle prise en charge par la spécification »


L’ID de facture est trop long. QuickBooks a une limite de 21 caractères pour un ID de facture.

 

  1. Naviguez vers Rechercher des factures dans la navigation de gauche dans xtraCHEF.
  2. Repérez la facture et sélectionnez Modifier la facture.
  3. Corrigez le numéro de facture de moins de 21 caractères.
  4. Soumettez la facture.
  5. Vous devriez ensuite pouvoir extraire de nouveau la facture à partir de la recherche de facture.


Haut de page

 

Fonctionnalité non prise en charge

Message d’erreur : Erreur de fonctionnalité non prise en charge. »


Cette erreur indique que la version de QuickBooks n’est pas prise en charge pour l’intégration API. Les versions de QuickBooks en ligne pour travailleurs indépendants et démarrage simple ne prennent pas en charge l’intégration avec xtraCHEF. Vous trouverez ci-dessous les versions QuickBooks en ligne prises en charge qui prennent en charge l’intégration de l’API :

 

  • QuickBooks Online Essentiels
  • QuickBooks Online Plus
  • QuickBooks en ligne avancé


Haut de page

 

Numéro de compte d’emplacement non attribué

Avertissement : Le numéro de compte d’emplacement n’est pas attribué dans XtraCHEF. Bill a été envoyé à QuickBooks sans affectation de classe. »


Il ne s’agit pas d’un échec d’extraction; les factures contenant cet avertissement seront tout de même extraites vers QuickBooks. Il s’agit d’un avertissement extrait de QuickBooks indiquant que le numéro de compte de cet emplacement ne correspond pas à la façon dont le nom de cet emplacement apparaît dans QuickBooks. Cette erreur peut être résolue par un administrateur de locataire en suivant les étapes suivantes :

 

  1. Sélectionnez l’icône d’engrenage > Emplacements dans le coin supérieur droit de xtraCHEF.
  2. Sélectionnez l’emplacement spécifique en question.
  3. Sélectionnez Modifier les détails de l’emplacement.
  4. Modifiez le numéro de compte selon le nom de classe saisi dans xtraCHEF.
  5. Après avoir résolu l’erreur, extrayez de nouveau la facture.
  6. Accédez au Moniteur d’extraction.
  7. Sélectionnez le fichier qui n’a pas pu être extrait.
  8. Une fois le fichier mis en évidence, sélectionnez Réextraire dans le coin supérieur droit.

 

Si la facture en question n’a pas été extraite du tout, vous voudrez confirmer ce qui suit :

 

  • Confirmez si tous les postes sont associés à des codes du grand livre sur les factures.
    • Accédez à la recherche de factures, sélectionnez le numéro de facture et il listera tous les codes GLG attribués à cette facture. Si Non affecté est répertorié, cet article devrait se trouver dans votre file d’attente Mapper les articles de facture pour ce fournisseur.
  • Confirmez que la facture est en état de traitement. Si ce n’est pas le cas, cela peut se trouver dans votre file d’attente Exception, Vérification de produit ou Approbations.
  • Confirmez qu’un code fournisseur est répertorié pour le fournisseur spécifique en question. Vous pouvez vérifier cela en recherchant le fournisseur dans votre plateforme de fournisseurs. Le code fournisseur doit correspondre à 1 pour 1 avec :
    • QuickBooks en ligne : Le code fournisseur doit correspondre au nom d’affichage sous.
    • QuickBooks Desktop: Le code fournisseur doit correspondre au nom du fournisseur.

 

Après avoir confirmé que les étapes indiquées ci-dessus ne s’appliquent pas à la facture, mais qu’elle n’a toujours pas été extraite, exécutez une extraction sur demande. Pour QuickBooks en ligne, vous pouvez exécuter une extraction à la demande avec ces étapes :

 

  • Sélectionnez le Moniteur d’extraction dans le menu de gauche dans xtraCHEF.
  • Sélectionnez le bouton Extraction à la demande en haut à gauche.
  • Une fenêtre contextuelle apparaîtra indiquant combien de factures sont incluses dans l’extraction à la demande.

 

Si vous utilisez QuickBooks Desktop, utilisez le connecteur Web en suivant les étapes de cet article pour exécuter une synchronisation manuelle.


Haut de page

 

Échec de l’actualisation du jeton

QuickBooks utilise des jetons d’authentification pour l’authentification API sécurisée. Ces jetons expirent avec le temps et pourraient devoir être actualisés en vous reconnectant à votre compte QuickBooks.

 

  1. Connectez-vous à xtraCHEF en tant qu’administrateur de locataire.
  2. Naviguez en haut de l’onglet Intégration de Quickbooks en sélectionnant l’icône Engrenage, suivie de la configuration du compte.
  3. Sélectionnez le bouton Déconnecter de QuickBooks.
  4. Sélectionnez le bouton Se connecter à QuickBooks et connectez-vous à votre compte QuickBooks. Cela réautorisera l’intégration.
  5. Exécuter une synchronisation manuelle pour confirmer que la connexion fonctionne.

 


Haut de page

 
 

Erreur de transaction associée

Si vous recevez une erreur indiquant que vous ne pouvez pas supprimer une transaction parce qu’elle correspond à une transaction téléchargée dans un autre compte, vous pouvez résoudre ce problème en procédant comme suit :

 

  1. Localiser la transaction dans QuickBooks
  2. Consultez l’historique des correspondances de la transaction et identifiez la transaction de fil bancaire associée
  3. Ne correspondez pas à la transaction de la transaction bancaire téléchargée, le cas échéant.
  4. Une fois la correspondance supprimée, réessayez la synchronisation dans le moniteur de synchronisation xtraCHEF.

 

Si la transaction reste appariée à des fins comptables, vous devrez peut-être l’ajuster directement dans QuickBooks plutôt que dans le moniteur de synchronisation xtraCHEF.

 

Une image d’un compte QuickBooks, mettant en évidence les rapports

 

Une image dans le module Rapports de QuickBooks dans la barre de recherche en haut à droite

 

Une image d’un journal dans QuickBooks et des instructions indiquant Localiser l’écriture de journal pour la date à laquelle le message d’erreur de transaction de correspondance apparaît dans xtraCHEF et l’ouvrir.

 

Une image d’un journal dans QuickBooks mettant en évidence l’étape 4 comme affichant 1 correspondance bancaire en ligne et l’étape 5 comme bouton de non correspondance

 


Haut de page