Blog

Dividir el CSV del catálogo de productos de freee Sales en lotes de 999

La importación del catálogo de productos de freee Sales admite 1.000 registros CSV, incluida la cabecera. Aprende a crear archivos de 999 productos, conservar los ceros iniciales y revisar los datos antes de importarlos.

Esquema de un CSV dividido en dos archivos, uno grande y otro pequeño, ambos con la misma cabecera

Para dividir un CSV del catálogo de productos de freee Sales (freee販売), abre el Divisor CSV, selecciona «Número máximo de filas de datos» e introduce 999 en «Máximo de filas de datos por archivo». Activa también la opción para repetir el primer registro como cabecera en cada archivo. Así, cada archivo contendrá como máximo 999 registros de productos más una fila de cabecera: 1.000 registros en total.

Esta configuración no es válida para todas las importaciones CSV de freee. Se refiere a la importación de información del catálogo de productos en freee Sales. La documentación oficial de importación y exportación indica un máximo de 1.000 filas, incluida la cabecera. Como la exportación no tiene ese límite de filas, un archivo exportado no siempre podrá volver a importarse completo. La especificación se comprobó el 21 de noviembre de 2026.

Configurar por separado los 999 productos y la cabecera

Conserva una copia del CSV original y utiliza el modelo y la definición de columnas de la documentación oficial. El divisor no transforma los nombres de columnas ni los valores al formato exigido por freee.

  1. Abre el Divisor CSV y selecciona el archivo en «Archivo CSV o TSV que se dividirá».
  2. En «Separador», elige «Coma (CSV)». Abre «Vista previa (comprobar codificación)» y revisa tanto los caracteres japoneses como las columnas. Si el texto aparece ilegible, configura «Codificación de entrada» según la codificación real del archivo.
  3. En «Dividir por», elige «Número máximo de filas de datos» y escribe 999 en «Máximo de filas de datos por archivo».
  4. Activa la casilla que añade el primer registro como cabecera a cada archivo. Los 999 registros de datos no incluyen la cabecera.
  5. Para un CSV UTF-8 que no necesita conversión, en «Codificación de salida» selecciona «Igual que la entrada (conservar BOM)». Si necesitas el mismo UTF-8 con BOM que el modelo oficial, puedes elegir «UTF-8 (con BOM)»; esto no significa que la BOM sea obligatoria en todos los casos. En «Separador de registros de salida», selecciona «Igual que la entrada (conservar finales de línea mixtos)».
  6. En «Método de guardado», elige «Descargar un archivo a la vez» y pulsa «Validar y dividir».
  7. Pulsa «Guardar este CSV». Comprueba que el navegador terminó la descarga antes de pulsar «Confirmar descarga y continuar». Repite la comprobación con el último archivo y revisa «Archivos generados» al finalizar.

En navegadores compatibles también puedes utilizar «Guardar directamente en una carpeta», más adecuado para archivos grandes. En el modo de descarga individual, avanzar sin guardar hace que deje de estar disponible el enlace del archivo anterior; no omitas la confirmación.

El procesamiento del CSV seleccionado se realiza dentro del navegador. El divisor no envía el contenido del archivo a un servidor.

Con 1.001 productos ficticios se obtienen archivos de 999 y 2

Imagina un CSV de 1.001 productos de ejemplo con estas columnas. El siguiente bloque muestra solo los tres primeros registros; por sí solo no constituye un archivo con 1.001 productos. Para trabajar con datos reales, parte de la plantilla oficial actualizada.

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

Las columnas japonesas son nombre, nombre mostrado en documentos y detalles, código y precio unitario de venta. Si los códigos van de 0001 a 1001, dividir products.csv en lotes de 999 produce dos archivos:

Archivo Productos Registros con cabecera Intervalo de códigos
products_part_000001.csv 999 1.000 0001–0999
products_part_000002.csv 2 3 1000–1001

El segundo archivo también empieza con la misma fila de cabecera. Dos errores que deben evitarse son omitirla o configurar 1.000 filas de datos, lo que daría 1.001 registros al contar la cabecera.

El ejemplo no contiene saltos de línea dentro de las celdas. El divisor cuenta registros CSV, no líneas físicas: un salto de línea dentro de un campo entrecomillado no crea otro registro. Esto no garantiza que freee acepte todos los datos con saltos de línea internos. Revísalos también en la vista previa de importación.

Comprobar por separado los ceros iniciales y los campos vacíos

El divisor no convierte los campos a números o fechas: el código 0001 permanece exactamente como 0001. Sin embargo, abrir y volver a guardar el CSV en una hoja de cálculo puede convertir ese código en un número y eliminar los ceros. Importa la columna de códigos como texto o inspecciona directamente el CSV. La herramienta no puede restaurar ceros que ya faltaban en el archivo original.

En freee, un código que coincide con un producto existente puede actualizarlo, mientras que un código nuevo da lugar a un alta. Omitir una columna y mantenerla con una celda vacía no son operaciones equivalentes: los efectos de la actualización dependen del campo. Consulta la tabla de campos de la documentación oficial antes de cargar datos reales, aunque la división haya terminado correctamente.

Revisar la vista previa de freee antes de importar

En la lista de productos de freee Sales («商品一覧»), abre el menú «・・・» y selecciona «CSVインポート» (importar CSV). Escoge uno de los archivos divididos y pasa a «プレビュー画面へ» (pantalla de vista previa). Comprueba el número de productos y, sobre todo, los códigos, nombres y valores que podrían actualizar registros existentes. Si algo no está bien, corrige el origen y vuelve a dividirlo; no mezcles resultados antiguos y nuevos.

Los productos de este artículo son ficticios y no se ha verificado su importación en un entorno real de freee Sales. La documentación oficial prevalece respecto a las columnas obligatorias, los permisos y los valores aceptados. Comprueba también el resultado de la importación. El divisor CSV de iXam no es una herramienta oficial de freee ni implica colaboración entre ambas empresas.