Erreurs courantes d'import de factures CSV dans QuickBooks et solutions

L'import CSV de QuickBooks Online est strict. Une seule erreur de format peut faire échouer l'ensemble de l'import ou, pire, créer des données partielles difficiles à annuler.

Ce guide présente les erreurs les plus courantes lors de l'import de factures dans QuickBooks Online et explique comment les éviter avec QuickBooks Invoice CSV Preparer.

« Référence invalide » ou « Client introuvable »

QuickBooks compare la colonne Customer aux noms de clients déjà présents dans le fichier de votre entreprise. La comparaison est sensible à la casse et doit être exacte.

Causes fréquentes :

• Espaces en fin de nom de client
• Différences de casse (par exemple « acme studio » au lieu de « Acme Studio »)
• Utilisation d'un nom d'affichage au lieu du nom légal dans QuickBooks

« Format de date invalide »

QuickBooks Online vous demande de sélectionner lors de l'import le format de date utilisé dans le fichier, par exemple DD/MM/YYYY ou MM/DD/YYYY. Utilisez un seul format de façon cohérente dans tout le fichier.

L'outil conserve le texte de date tel qu'il est fourni et ne valide ni ne normalise les formats de date. Vérifiez donc que les dates correspondent au format sélectionné dans QuickBooks.

« Le montant ne peut pas être négatif »

QuickBooks Online n'autorise pas les montants négatifs sur les lignes de facture. Zéro est autorisé ; les avoirs et remboursements doivent être importés séparément comme credit memos, et non comme lignes de facture négatives.

L'outil signale les montants négatifs comme erreurs de validation. Pour gérer les avoirs :

1. Retirez de votre CSV de factures les lignes comportant des montants négatifs.
2. Importez-les séparément dans QuickBooks comme credit memos.

« La ligne contient trop/pas assez de colonnes »

Chaque ligne de données doit contenir le même nombre de colonnes que la ligne d'en-tête. Les lignes irrégulières, avec des cellules manquantes ou supplémentaires, provoquent des échecs d'import.

Causes fréquentes :

• Cellules contenant des virgules sans guillemets
• Sauts de ligne à l'intérieur des cellules
• Virgules superflues en fin de ligne

L'outil valide la largeur des lignes et signale les lignes non conformes par leur numéro.

Numéros de facture répétés

Plusieurs lignes portant le même numéro de facture sont normales lorsqu'une facture contient plusieurs lignes. L'outil autorise ces valeurs répétées et ne compte que les numéros de facture distincts pour la limite de 100 factures par lot.

Pour détecter une réexportation ou un réimport accidentel, comparez séparément les données source avec votre historique d'imports. L'outil ne classe pas les numéros de facture répétés comme des doublons.

Limites d'import de QuickBooks Online

| Limite | Valeur | | ------------------------------------- | ------------------------------ | | Nombre maximal de lignes par import | 1 000 | | Nombre maximal de factures distinctes | 100 | | Taille maximale du fichier | Varie selon l'offre QuickBooks |

La limite de 200 MiB de Nablyx est une limite de traitement dans le navigateur, pas une limite d’importation QuickBooks. QuickBooks Online accepte au maximum 1 000 lignes et 100 factures dans une seule importation de factures. Vous pouvez néanmoins traiter localement avec Nablyx un CSV source plus volumineux, jusqu’à 200 MiB. Après validation, Nablyx crée autant de fichiers de lot prêts pour QuickBooks que nécessaire tout en conservant chaque facture entière dans un seul lot. Pour les jeux de données volumineux, téléchargez le ZIP puis importez quickbooks-invoices-batch-01.csv, quickbooks-invoices-batch-02.csv et les autres lots un par un dans QuickBooks Online.

Liste de contrôle préventive

Avant d'importer votre CSV :

• [ ] Toutes les colonnes obligatoires sont associées (Invoice number, Customer, Invoice Date, Due Date, Item Amount).
• [ ] Les noms de clients correspondent exactement à ceux de QuickBooks.
• [ ] Un seul format de date est utilisé dans tout le fichier et sélectionné lors de l'import (par exemple DD/MM/YYYY ou MM/DD/YYYY).
• [ ] Aucun montant n'est négatif (zéro est autorisé).
• [ ] Aucune ligne irrégulière : toutes les lignes ont le même nombre de colonnes.
• [ ] Chaque lot QuickBooks généré contient au maximum 1 000 lignes.
• [ ] Chaque lot QuickBooks généré contient au maximum 100 factures distinctes.
• [ ] Aucun numéro de facture en double entre les différents lots d'import.

Passez votre CSV dans QuickBooks Invoice CSV Preparer pour contrôler automatiquement les règles structurelles — colonnes obligatoires associées, montants non négatifs et largeur de ligne cohérente — et créer des lots compatibles avec QuickBooks lorsque la source validée dépasse 1 000 lignes ou 100 factures. La correspondance des noms de clients, la conversion ou la validation des formats de date et la détection des doublons entre lots ne sont pas automatisées ; vérifiez ces points avec vos données QuickBooks avant l'import.

customer_id ; name ; email

1042 ;  Alex  ; alex@example.com
1043 ; Sam ; sam@example.com ;

customer_id,name,email
1042,Alex,alex@example.com
1043,Sam,sam@example.com