Blog

Dividir o CSV de produtos do freee Sales em lotes de 999 registos

O freee Sales aceita até 1.000 linhas no CSV de produtos, incluindo o cabeçalho. Configure 999 registos por ficheiro, repita o cabeçalho e verifique os zeros à esquerda antes da importação.

Esquema de um CSV dividido em dois ficheiros, um maior e outro menor, ambos com o mesmo cabeçalho.

Para dividir um CSV do cadastro de produtos do freee Sales (freee販売), abra o CSV Splitter em inglês, defina Maximum data rows per output file como 999 e ative a opção para repetir o primeiro registo como cabeçalho em cada ficheiro. Cada resultado terá, no máximo, 999 produtos e uma linha de cabeçalho: 1.000 registos no total.

Este limite não se aplica a todas as importações CSV da freee. Trata-se da importação de informações de produtos no freee Sales. A documentação oficial de importação e exportação estabelece o máximo de 1.000 linhas, incluindo o cabeçalho. As exportações não têm o mesmo limite, pelo que um CSV exportado pode não ser reimportável num único ficheiro. Informação confirmada a 21 de novembro de 2026.

Ainda não existe uma interface em português para este divisor; a ligação abre a interface em inglês. Indicamos abaixo os nomes dos controlos em inglês. Os nomes japoneses das colunas no exemplo pertencem ao formato de importação do freee.

Configurar separadamente as 999 linhas e o cabeçalho

Guarde o CSV original e prepare os dados segundo o modelo oficial atualizado. O divisor não traduz os nomes das colunas nem altera valores para cumprir o formato exigido pelo freee.

  1. Em CSV / TSV file to split, selecione o ficheiro no dispositivo.
  2. Escolha Comma (CSV) em Delimiter. Abra a pré-visualização para confirmar os caracteres japoneses e as colunas. Se houver texto ilegível, selecione a Input encoding real.
  3. Em Split by, escolha o limite de linhas de dados e introduza 999 em Maximum data rows per output file.
  4. Ative Repeat the first record as a header in each output file. Os 999 registos de dados não incluem o cabeçalho.
  5. Se o CSV já estiver em UTF-8 e não precisar de conversão, em Output encoding use Same as input (preserve BOM). UTF-8 (with BOM) também está disponível para modelos que o requeiram; a BOM não é sempre obrigatória. Em Output record separator, mantenha Same as input (preserve mixed line endings).
  6. Em Save method, escolha Download one file at a time e clique em Validate and split.
  7. Guarde cada parte em Save this CSV. Confirme que a transferência terminou antes de Confirm download and continue. Faça a mesma verificação no último ficheiro e reveja os resultados.

Em navegadores compatíveis, a gravação direta numa pasta é uma alternativa para ficheiros grandes. No modo de transferência individual, avançar sem guardar faz perder a ligação da parte anterior. Todo o processamento do CSV ocorre no navegador, sem enviar o seu conteúdo ao servidor.

Com 1.001 produtos fictícios, os lotes têm 999 e 2 registos

Considere um CSV fictício com 1.001 produtos. O excerto seguinte contém apenas os três primeiros registos; não é um ficheiro completo para importar. Nos dados reais, use o modelo oficial mais recente.

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

As colunas japonesas correspondem ao nome, nome apresentado nos documentos, código e preço unitário de venda. Com códigos entre 0001 e 1001, dividir products.csv produz:

Ficheiro Produtos Registos com cabeçalho Códigos
products_part_000001.csv 999 1.000 0001–0999
products_part_000002.csv 2 3 1000–1001

O segundo ficheiro também tem de incluir o cabeçalho. Definir incorretamente um limite de 1.000 linhas de dados cria um ficheiro com 1.001 registos ao contar o cabeçalho. A ferramenta conta registos CSV, não linhas físicas: uma mudança de linha numa célula entre aspas não cria outro registo. Confirme na pré-visualização se o freee aceita esses valores.

Verificar os zeros à esquerda e as colunas vazias

O divisor não converte campos em números ou datas: 0001 continua a ser 0001. Porém, abrir e guardar novamente o CSV numa folha de cálculo pode remover zeros iniciais. Importe os códigos como texto ou verifique o CSV num editor de texto; zeros já perdidos não podem ser recuperados pela ferramenta.

Na importação, um código existente pode atualizar o produto, enquanto um código novo pode criar outro. Omitir uma coluna é diferente de enviá-la com valor vazio. O efeito varia conforme o campo; consulte a tabela oficial de campos. A divisão concluída não garante que a importação tenha os efeitos pretendidos.

Conferir a pré-visualização do freee antes de importar

No freee Sales, aceda a 商品一覧 (lista de produtos), depois ・・・ → CSVインポート (importar CSV), e avance para プレビュー画面へ (pré-visualização). Confira a contagem, os códigos, os nomes e os valores a atualizar. Se encontrar erros, corrija a origem, divida de novo e não misture ficheiros antigos com os novos.

Os dados são fictícios e não foi testada uma importação real no freee Sales. Dê prioridade à documentação oficial quanto a campos obrigatórios, permissões e restrições. Verifique os resultados após importar. O CSV Splitter da iXam não é uma ferramenta oficial da freee nem implica parceria.