Comment préparer un CSV pour importer des factures dans QuickBooks Online

L'import natif de factures de QuickBooks Online accepte les fichiers CSV, mais uniquement dans un format précis. Si vos données source utilisent d'autres noms de colonnes, contiennent des colonnes supplémentaires ou présentent des erreurs de validation, l'import peut échouer avec des messages difficiles à comprendre ou, pire, créer silencieusement des factures en double.

QuickBooks Invoice CSV Preparer associe vos colonnes source au format attendu par QuickBooks, valide les données de facture et crée automatiquement des lots d’importation compatibles avec QuickBooks lorsqu’une source valide dépasse un seul lot de destination.

Ce que QuickBooks Online attend

L'import natif de factures de QuickBooks Online nécessite les colonnes suivantes :

| Colonne | Obligatoire | Remarques | | ----------------- | ----------- | ------------------------------------------------------------------- | | Numéro de facture | Oui | À répéter pour les factures sur plusieurs lignes | | Client | Oui | Doit correspondre à un nom de client existant | | Date de facture | Oui | Utilisez un seul format de date et sélectionnez-le lors de l'import | | Date d'échéance | Oui | Utilisez le même format de date sélectionné dans tout le fichier | | Montant de ligne | Oui | Ne peut pas être négatif (zéro est autorisé) | | Description | Non | Description de la ligne de facture |

Une facture peut contenir plusieurs lignes. Chaque ligne de facture correspond à une ligne CSV distincte portant le même numéro de facture. Le montant total de la facture est la somme de ses lignes.

Un point de départ réaliste

Un export de factures courant peut ressembler à ceci. Les colonnes portent les noms de votre système, pas ceux de QuickBooks.

La facture INV-1001 comporte deux lignes. Les deux lignes CSV partagent le même numéro de facture. L'outil conserve cette structure pendant l'association des colonnes et la validation des données.

Ce que fait réellement l'outil

Un flux ciblé : associer les colonnes → valider les règles → exporter un CSV propre.

1. 01

   Ajoutez votre CSV

   Importez un CSV contenant les données de facturation. Les premières lignes sont examinées pour détecter les en-têtes. Les fichiers allant jusqu'à 200 MB sont pris en charge.

2. 02

   Associez vos colonnes

   Associez chaque champ QuickBooks à la colonne correspondante de votre source. L'outil suggère automatiquement des correspondances à partir des noms d'en-têtes.

3. 03

   Lancez le contrôle préalable

   Valide les valeurs obligatoires, les montants non négatifs et la largeur de ligne, puis planifie des lots QuickBooks de 1 000 lignes et 100 factures maximum.

4. 04

   Examinez les problèmes

   Les erreurs de validation sont listées avec les numéros de ligne et les champs concernés. Corrigez-les dans la source puis réimportez le fichier ; le téléchargement reste désactivé tant que la validation échoue.

5. 05

   Téléchargez la sortie préparée

   Un seul lot est téléchargé sous le nom quickbooks-invoices.csv. Plusieurs lots sont téléchargés dans quickbooks-invoices.zip sous forme de CSV numérotés prêts pour QuickBooks.

Factures sur plusieurs lignes

QuickBooks Online prend en charge plusieurs lignes par facture. Dans vos données source, chaque ligne de facture occupe une ligne CSV distincte avec le même numéro de facture.

L'outil conserve cette structure : INV-2001 comporte trois lignes, et le CSV de sortie garde les trois lignes correspondantes. Le total de INV-2001 est de $725.00.

Erreurs de validation fréquentes

L'outil détecte les problèmes qui entraîneraient le rejet de l'import par QuickBooks :

| Erreur | Signification | Correction | | -------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------ | | Valeur manquante | Une cellule obligatoire est vide | Renseignez la cellule vide dans la source | | Montant invalide | Le montant de ligne n'est pas un nombre | Vérifiez les symboles monétaires, virgules ou texte | | Montant négatif | Le montant de ligne est inférieur à zéro | Traitez les avoirs séparément | | Largeur de ligne | La ligne n'a pas le même nombre de colonnes que l'en-tête | Corrigez les lignes irrégulières dans la source | | Une facture dépasse 1 000 lignes | Une facture seule ne tient pas dans un lot d’importation QuickBooks | Réduisez cette facture ou utilisez une autre méthode d’importation |

Limites de QuickBooks Online

QuickBooks Online impose des limites strictes aux imports CSV :

• 1 000 lignes de données maximum par fichier d'import
• 100 factures distinctes maximum par fichier d'import
• Les montants ne peuvent pas être négatifs pour les lignes de facture (zéro est autorisé)

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.

Ce que l'outil ne fait pas

L'outil sert à la validation et à l'association des colonnes. Il ne :

• crée ni ne modifie directement les factures dans QuickBooks ;
• gère les avoirs ou remboursements (les montants négatifs sont signalés comme erreurs) ;
• convertit ni ne valide les formats de date (QuickBooks Online vous demande de sélectionner lors de l'import le format utilisé, par exemple DD/MM/YYYY ou MM/DD/YYYY ; utilisez un seul format de façon cohérente dans tout le fichier) ;
• fusionne les numéros de facture en double.

Après avoir téléchargé le CSV préparé, importez-le dans QuickBooks Online via Settings → Import Data → Invoices.

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