Preparar um CSV de produtos e SKUs para a VTEX

Separe o que é produto do que é SKU

Um produto pode ter vários SKUs. Um relatório achatado pode repetir o código do produto em várias linhas, e isso não significa duplicidade. Use os cabeçalhos e a relação esperada pela integração VTEX.

• Campos de produto e SKU aparecem misturados no mesmo relatório
• Colunas extras do ERP não existem no endpoint de integração
• SKU com zeros à esquerda é convertido para número

• Escolher apenas as colunas do template →Remova campos de exportação e deixe a ordem exigida.
• Encontrar linhas com quantidade de colunas diferente →Revise aspas, linhas vazias e a estrutura antes de corrigir.

Montar o mapeamento antes de remover colunas

A documentação da VTEX define a relação e os campos da integração, mas não conhece o significado dos seus campos auxiliares. Registre o mapeamento origem-destino antes de selecionar colunas.

• Mantenha IDs e SKUs como texto
• Não remova uma coluna de variação sem confirmar o vínculo do SKU
• Separe dados de preço e estoque se a integração usar rotinas diferentes

• Escolher apenas as colunas do template →Remova campos de exportação e deixe a ordem exigida.
• Organizar linhas CSV duplicadas por uma chave →Confirme a coluna de comparação e a quantidade excluída.

Preparar a cópia no LocaCSV

LocaCSV não cria relacionamentos entre entidades nem valida catálogo. Ele mantém os valores e torna o layout do arquivo explícito.

1. 1Execute o diagnóstico para conferir cabeçalhos, colunas e linhas repetidas
2. 2Selecione e ordene as colunas exigidas pelo fluxo VTEX escolhido
3. 3Filtre somente linhas de teste ou vazias confirmadas
4. 4Envie uma amostra e compare produto, SKU e variações no retorno da integração

Conferir o retorno da integração VTEX

• O número de produtos e SKUs corresponde ao arquivo de origem
• Cada SKU mantém o produto e a variação corretos
• Cabeçalhos e tipos de campo atendem ao fluxo escolhido
• Linhas excluídas e arquivos enviados estão registrados

• Escolher apenas as colunas do template →Remova campos de exportação e deixe a ordem exigida.
• Encontrar linhas com quantidade de colunas diferente →Revise aspas, linhas vazias e a estrutura antes de corrigir.
• Manter apenas as linhas da importação →Confira as linhas encontradas e a quantidade excluída.

Se a VTEX rejeitar itens

Use o erro retornado para diferenciar layout, ID inexistente e regra de catálogo. Corrija o campo apontado sem reformatar todo o arquivo.

• Encontrar linhas com quantidade de colunas diferente →Revise aspas, linhas vazias e a estrutura antes de corrigir.
• Escolher apenas as colunas do template →Remova campos de exportação e deixe a ordem exigida.
• Conferir e converter a codificação de um CSV ilegível →Escolha na prévia a codificação que exibe o texto corretamente.

Preparar CSV para VTEX