Blog

Découper le CSV des produits freee Sales en lots de 999

L'import CSV des produits dans freee Sales est limité à 1 000 lignes avec l'en-tête. Réglez le découpeur à 999 produits par fichier, conservez les zéros initiaux et vérifiez l'aperçu avant l'importation.

Schéma d'un fichier CSV réparti en un grand et un petit fichier, chacun reprenant le même en-tête

Pour découper un CSV du catalogue de produits de freee Sales (freee販売), ouvrez le Découpeur CSV, sélectionnez « Nombre maximal de lignes de données », puis saisissez 999 dans « Nombre maximal de lignes par fichier ». Activez l’option qui reproduit le premier enregistrement comme en-tête dans chaque fichier. Chaque résultat contiendra alors au maximum 999 produits et une ligne d’en-tête, soit 1 000 enregistrements.

Ce réglage ne s’applique pas à tous les imports CSV de freee. Il concerne précisément l’import des informations du catalogue produits de freee Sales. La documentation officielle d’import et d’export fixe un plafond de 1 000 lignes, en-tête inclus. Les exports n’étant pas soumis à cette limite de lignes, un CSV exporté n’est pas nécessairement réimportable en un seul fichier. Les règles ont été vérifiées le 21 novembre 2026.

Régler séparément les 999 produits et l’en-tête

Conservez le fichier CSV d’origine et préparez les colonnes selon le modèle et les descriptions officielles. Le découpeur ne transforme ni les noms de champs ni leurs valeurs pour les rendre compatibles avec freee.

  1. Ouvrez le Découpeur CSV et choisissez le fichier sous « Fichier CSV ou TSV à découper ».
  2. Dans « Séparateur », choisissez « Virgule (CSV) ». Ouvrez « Aperçu (vérifier l’encodage) » et examinez les caractères japonais ainsi que les séparateurs. Si les caractères sont illisibles, précisez l’« Encodage d’entrée » réel.
  3. Sous « Découper par », choisissez « Nombre maximal de lignes de données » et saisissez 999 dans « Nombre maximal de lignes par fichier ».
  4. Cochez l’option qui reprend le premier enregistrement comme en-tête dans chaque fichier. L’en-tête ne compte pas dans les 999 lignes de données.
  5. Pour un CSV UTF-8 dont l’encodage doit rester inchangé, choisissez « Identique à l’entrée (conserver la BOM) » dans « Encodage de sortie ». Si le modèle officiel exige le même UTF-8 avec BOM, sélectionnez « UTF-8 (avec BOM) ». La BOM n’est pas systématiquement obligatoire. Dans « Séparateur des enregistrements de sortie », choisissez « Identique à l’entrée (conserver les fins de ligne mixtes) ».
  6. Dans « Mode d’enregistrement », sélectionnez « Télécharger un fichier à la fois », puis cliquez sur « Valider et découper ».
  7. Cliquez sur « Enregistrer ce CSV », vérifiez que le navigateur a terminé le téléchargement, puis seulement sur « Confirmer le téléchargement et continuer ». Faites aussi cette vérification pour le dernier fichier et consultez « Fichiers de sortie » à la fin.

Les navigateurs compatibles proposent également « Enregistrer directement dans un dossier », utile pour les fichiers volumineux. En téléchargement individuel, passer au suivant avant d’avoir enregistré le précédent rend son lien inutilisable : ne sautez pas l’étape de confirmation.

Le traitement du CSV s’effectue entièrement dans votre navigateur, sans transmission du contenu à un serveur.

Avec 1 001 produits fictifs, les deux lots contiennent 999 et 2 produits

Prenons un CSV fictif de 1 001 produits utilisant les colonnes ci-dessous. Le bloc ne montre que les trois premiers produits : il ne constitue pas, à lui seul, un fichier de 1 001 produits. Pour des données réelles, partez du modèle officiel le plus récent.

名称,帳票・明細への表示名称,コード,販売単価
サンプル商品0001,サンプル商品0001,0001,100
サンプル商品0002,サンプル商品0002,0002,100
サンプル商品0003,サンプル商品0003,0003,100

Les quatre intitulés japonais signifient nom, nom affiché dans les documents et les lignes de détail, code et prix unitaire de vente. Si les codes vont de 0001 à 1001, découper products.csv par groupes de 999 donne :

Fichier Produits Enregistrements avec en-tête Plage de codes
products_part_000001.csv 999 1 000 0001 à 0999
products_part_000002.csv 2 3 1000 à 1001

Le deuxième fichier possède lui aussi la même première ligne d’en-tête. Il ne faut ni oublier de la reproduire, ni choisir 1 000 lignes de données, ce qui donnerait 1 001 enregistrements avec l’en-tête.

L’exemple ne contient aucun retour à la ligne dans les cellules. Le découpeur compte les enregistrements CSV plutôt que les lignes physiques : un retour à la ligne à l’intérieur d’un champ entre guillemets ne crée pas d’enregistrement supplémentaire. Cela ne garantit pas que freee accepte de tels champs ; contrôlez-les également dans l’aperçu d’importation.

Préserver les zéros initiaux et interpréter correctement les cellules vides

Le découpeur ne convertit pas les champs en nombres ou en dates : le code 0001 reste 0001. En revanche, ouvrir puis réenregistrer le CSV dans un tableur peut convertir ce code en nombre et supprimer les zéros. Importez la colonne comme du texte ou vérifiez directement le CSV. Le découpeur ne rétablit pas les zéros déjà perdus dans le fichier source.

À l’import dans freee, un code correspondant à un produit existant peut provoquer sa mise à jour, tandis qu’un code nouveau correspond à une création. Supprimer une colonne et conserver cette colonne avec une cellule vide ne sont pas équivalents. Le comportement en mise à jour varie selon le champ. Consultez la liste des champs de la documentation officielle avant d’importer de vraies données, même si le découpage a réussi.

Contrôler l’aperçu dans freee avant de lancer l’import

Dans la liste des produits (« 商品一覧 ») de freee Sales, ouvrez « ・・・ » puis « CSVインポート » (importer un CSV). Choisissez le fichier découpé et accédez à « プレビュー画面へ » (écran d’aperçu). Vérifiez non seulement le nombre de lignes, mais aussi les codes, les noms et les valeurs des champs qui seront mis à jour. En cas de problème, corrigez la source et relancez le découpage, sans mélanger anciens et nouveaux résultats.

Les données présentées ici sont fictives ; aucun import réel dans freee Sales n’a été testé. Reportez-vous en priorité à la documentation officielle pour les champs obligatoires, les autorisations et les valeurs acceptées. Vérifiez également le résultat de l’import. Le découpeur CSV d’iXam n’est pas un outil officiel de freee et ne suppose aucun partenariat.