Tutorial

Atualizar Código HS e País em Massa

November 21, 2025

Definir ou alterar o Código HS e o País de origem para muitas variantes manualmente pode ser extremamente demorado. DataEase facilita: exporte suas variantes de produto, edite os campos de código HS e país, e importe-os de volta para o Shopify — tudo com validação.

🎯 Objetivo

Defina ou altere o Código HS e o País de origem para muitas variantes de uma vez usando CSV/Excel e DataEase.

📋 Instruções Passo a Passo

1. Exporte Produtos com Variantes

No DataEase, vá para Nova Exportação → Produtos. Inclua no mínimo:

Identificadores:

  • id
  • variantId (recomendado)
  • Opcional: handle, variantSKU

Campos para editar:

  • variantHsCode
  • variantCountryOfOrigin
  • Opcionalmente adicione title, variantTitle para contexto

2. Edite o Arquivo

Abra o arquivo exportado no Excel ou Google Sheets. Para cada variante que você deseja alterar:

  • Defina variantCommand = UPDATE
  • Preencha variantHsCode com o código do Sistema Harmonizado (apenas dígitos, tipicamente 6–10)
  • Preencha variantCountryOfOrigin com um código de país ISO de duas letras (ex.: US, PL, CN)

Quando terminar, salve o arquivo como .xlsx ou .csv.

3. Importe e Valide

  1. No DataEase, inicie Nova Importação
  2. Carregue seu arquivo editado
  3. Mapeie colunas (ID da Variante ou SKU único → variant)
  4. Execute a Validação

Corrija quaisquer problemas sinalizados no Status de Validação (ex.: código ISO inválido, HS não numérico).

4. Execute a Importação

Após a validação ser aprovada, clique em Executar Importação para aplicar suas alterações ao Shopify.

Uma vez concluído, verifique alguns produtos no Shopify Admin para confirmar as atualizações.

📝 Notas Importantes

  • Estes são campos a nível de variante; cada variante de produto pode ter seu próprio código HS e origem
  • Mantenha os códigos HS numéricos (sem espaços/traços). Use códigos oficiais da sua autoridade aduaneira
  • O país deve ser um código ISO-3166-1 alpha-2 válido
  • Prefira correspondência por variantId; use SKU apenas se for único e estável

💡 Exemplos Mínimos de CSV

Atualização por ID da Variante:

variantId,variantCommand,variantHsCode,variantCountryOfOrigin
gid://shopify/ProductVariant/111,UPDATE,610910,PL
gid://shopify/ProductVariant/112,UPDATE,420222,CN

Atualização por SKU (único):

variantSKU,variantCommand,variantHsCode,variantCountryOfOrigin
TEE-ORG-M,UPDATE,610910,US

🎉 É isso!

Seus códigos HS e países de origem agora estão atualizados em massa.
Se você encontrar algum problema ou tiver dúvidas, sinta-se à vontade para contatar nossa equipe de suporte.