Orientação BigCommerce CSV

Erros de importação BigCommerce CSV

Use esses dez grupos de erros para localizar riscos de arquivo, modelo, produto, variante, imagem, categoria e campo personalizado antes de uma importação de teste.
Orientação oficial do BigCommerce verificada em 1º de outubro de 2026.

Arquivo e estrutura CSV

Arquivos vazios, UTF-8 inválidos, cotações malformadas, contagens de colunas inconsistentes e cabeçalhos duplicados podem bloquear a pré-verificação. Uma marca de ordem de bytes ou finais de registros mistos produzem um aviso de formato; a ferramenta pode oferecer uma cópia de formatação revisada sem alterar os valores comerciais.

Diferenças de modelo

Campos ausentes, reordenados, duplicados ou desconhecidos devem ser comparados com uma exportação recente do armazenamento de destino porque as configurações de armazenamento e exportação podem ser diferentes.

Campos em branco

Um valor importado em branco pode significar claro, ignorado ou inválido dependendo do campo e do comportamento do importador. Revise os valores comerciais em branco em vez de preenchê-los automaticamente.

Riscos SKU

SKUs ausentes ou duplicados reduzem a confiança na correspondência. Mantenha os SKUs de produtos e variantes exclusivos e verifique como os registros de catálogo existentes são identificados.

Grupos de linhas Product, variante e imagem

Variant e linhas de imagem precisam de um produto pai válido e uma ordem coerente. Linhas órfãs ou intercaladas podem anexar dados ao produto errado.

Opções Variant

Mantenha os nomes das opções consistentes dentro de um produto e mantenha cada combinação de valor de opção exclusiva. Não adivinhe um substituto para uma variante conflitante.

Valores de campo

Por exemplo, Price usa um valor ponto-decimal como 29,00, o Estoque Atual usa um número inteiro como 12 e o formato É Visível suportado usa letras maiúsculas VERDADEIRO ou FALSO. Verifique o tipo e o rastreamento de estoque em relação aos valores suportados; categorias dependentes da loja ou diferenças de campo personalizado permanecem itens de revisão.

Referências Image

As referências Image devem ser URLs HTTP(S) públicos válidos quando o importador precisar buscá-las. Uma verificação de sintaxe não pode provar que uma imagem remota está acessível.

Categorias

Os caminhos das categorias dependem do armazenamento de destino. As diferenças em relação à linha de base precisam ser revisadas após a preparação da árvore de categorias.

Campos personalizados

Compare os nomes dos campos personalizados com a linha de base de destino. Campos ausentes podem remover os dados pretendidos, enquanto os dados privados podem pertencer a metacampos.

Verifique o formato real da loja de destino

Compare uma nova exportação da loja de destino com o CSV que você planeja importar. A ferramenta relata riscos detectáveis, mas não pode prever o resultado final do importador.

Fonte: Documentação BigCommerce