Adicione os identificadores de produto que a UE exige em remessas B2C de baixo
valor, para cada integração da Zonos.
A partir de 1º de novembro de 2026, a UE exige identificadores de produto (PIDs) em todos os itens de remessas business-to-consumer que entram na UE com valor de até €150. Remessas sem esses identificadores podem ser retidas ou recusadas pela alfândega. Este guia mostra onde adicionar os identificadores para cada integração da Zonos.
Os comerciantes da Shopify adicionam os identificadores na Shopify, e a Zonos os obtém automaticamente. Para todas as outras integrações, adicione-os no Zonos Catalog ou mapeie-os a partir dos campos da sua própria loja, se as configurações do seu plugin oferecerem mapeamento personalizado.
Integração↕
Onde adicionar os identificadores↕
Shopify (Zonos Duty and Tax)
Em cada variante de produto no painel administrativo da Shopify
Magento
Zonos Catalog ou mapeamento de atributos nas configurações do plugin da Zonos (etapas abaixo)
Adicione os três identificadores em cada variante no painel administrativo da Shopify. O Zonos Duty and Tax os obtém no checkout; não há nada a alterar no app.
No painel administrativo da Shopify, abra Products e selecione um produto.
Abra a variante que você deseja atualizar.
Insira o seu SKU no campo SKU.
Adicione o número do fabricante como um código de barras com o tipo NS-PID (identificador de produto do fabricante não padronizado).
Se o produto tiver um UPC, EAN, GTIN ou ISBN, adicione-o como um segundo código de barras com o tipo correspondente.
Salve e repita para cada variante.
Dicas:
Coloque o número do fabricante em um código de barras NS-PID próprio, e não no campo SKU ou UPC. A Zonos envia cada tipo de código de barras à alfândega como um identificador diferente.
Uma variante pode conter vários códigos de barras, mas a Zonos lê os cinco primeiros. Mantenha o NS-PID e o código de barras principal do produto entre eles.
Os códigos de barras que você inseriu antes dessa mudança continuam funcionando como UPC/EAN. Somente o número do fabricante é novo.
Magento, WooCommerce, BigCommerce, Miva e qualquer outra integração podem adicionar os identificadores no Zonos Catalog. Alguns plugins também podem mapeá-los a partir dos campos da sua própria loja. Use a opção que melhor se adapta à forma como você já gerencia os dados dos seus produtos.
Encontre o produto. Cada variante é um item próprio do catálogo.
Preencha os três campos de identificador:
SKU: o seu ID de produto do comerciante
Manufacturer product ID: o número do fabricante
GTIN: o UPC, EAN, GTIN ou ISBN, se o produto tiver um
Salve e repita para cada item.
Para um catálogo grande, adicione os identificadores a um arquivo de importação do catálogo em vez de editar os itens um de cada vez. Certifique-se de que o SKU de cada item no Zonos Catalog corresponda exatamente ao SKU na sua loja.
Os identificadores do Catalog só chegam às suas etiquetas em dois casos
A Zonos usa os identificadores do Zonos Catalog somente se:
Você imprime etiquetas de envio pelo Dashboard.
Você imprime etiquetas fora do Dashboard e chama a API da Zonos para obter os detalhes do produto no catálogo antes de solicitar a etiqueta à sua transportadora. Consulte Encontrar um produto para saber como pesquisar um item do catálogo.
Se você imprime etiquetas fora do Dashboard e não chama a API da Zonos para obter os detalhes do catálogo, trabalhe com o seu provedor de etiquetas para incluir os identificadores quando a etiqueta for impressa.
Opção 2: Mapeamento personalizado nas configurações do seu plugin
Alguns plugins da Zonos podem ler os identificadores de campos que você já mantém na sua loja, como um atributo personalizado. Abra as configurações do seu plugin da Zonos e procure uma opção de mapeamento personalizado ou de atributos. Se ela existir, mapeie:
o seu campo de SKU para SKU
o campo que contém o número do fabricante para Manufacturer product ID
o seu campo de UPC ou EAN para GTIN
Se o seu plugin não oferecer mapeamento personalizado, use o Zonos Catalog. Escolha a sua plataforma para ver as etapas de configuração.
Importante: O mapeamento de atributos para o número do fabricante e o GTIN exige o módulo Zonos Checkout (zonos/checkout) versão 2.3.40 ou posterior. Para verificar a versão instalada, execute composer show zonos/checkout. Para ver as etapas de instalação, consulte o guia de integração do Magento.
O plugin do Magento lê o número do fabricante e o GTIN a partir de atributos do produto. Se os seus produtos ainda não tiverem atributos para eles, crie-os primeiro.
1. Criar os atributos
Pule os atributos que você já tiver.
Vá para Stores > Attributes > Product e clique em Add New Attribute.
Defina Default Label com um nome que você reconheça, como ns_pid para o número do fabricante ou gtin para o código de barras.
Defina Catalog Input Type for Store Owner como Text Field e Values Required como No.
Clique em Save Attribute e repita para o segundo atributo.
2. Adicionar os atributos aos seus conjuntos de atributos
Vá para Stores > Attributes > Attribute Set e abra o conjunto que os seus produtos usam.
Arraste cada novo atributo de Unassigned Attributes para um grupo, como Product Details.
Clique em Save. Repita para cada conjunto de atributos que os seus produtos para a UE usam.
3. Preencher os valores nos seus produtos
Abra cada produto em Catalog > Products e insira o número do fabricante e o GTIN. Para definir valores em vários produtos de uma vez, selecione-os na grade de produtos e escolha Update attributes no menu Actions.
4. Mapear os atributos nas configurações da Zonos
Vá para Stores > Configuration > Zonos > Zonos Duty and Tax.
Role até os campos de mapeamento de atributos (Brand, HS code, Length e assim por diante).
Defina GTIN / EAN / UPC como o seu atributo de código de barras, por exemplo gtin.
Defina Manufacturer Product ID como o seu atributo de número do fabricante, por exemplo ns_pid.
Se você se integra diretamente com a Zonos, em vez de usar um plugin de plataforma, há duas formas de fornecer os identificadores: armazená-los uma vez por produto no Zonos Catalog ou enviá-los em cada item da sua solicitação. O Catalog preenche qualquer identificador que a sua solicitação deixar em branco, por isso a maioria dos comerciantes os armazena uma vez e não envia nada a mais no momento da cotação.
Identificador nesta página↕
Campo da API↕
ID de produto do comerciante
sku
Número do fabricante
manufacturerProductId
S-PID (GTIN, UPC, EAN, ISBN)
gtin
Os nomes dos campos são os mesmos em itemCreateWorkflow, nos itens de um carrinho e em catalogItemCreate, então nada muda entre o fluxo de cotação e o fluxo do catálogo.
Adicione os identificadores a cada item em itemCreateWorkflow. Use esta opção se você não mantém um catálogo na Zonos ou quando os identificadores de um item forem diferentes dos do seu registro no catálogo.
Envie o gtin somente com dígitos, sem hífens nem espaços. Valores de UPC, EAN, JAN e ISBN de 13 dígitos vão todos neste mesmo campo, e a Zonos identifica qual é o padrão a partir do próprio número.
Correto: 012345678905
Recusado: 0-12345-67890-5
Se você tiver um ISBN de 10 dígitos, envie a versão de 13 dígitos, pois um ISBN de 10 dígitos pode terminar com a letra X.
Se um produto não tiver código de barras, omita o gtin em vez de enviar uma string vazia, reutilizar o seu SKU ou preenchê-lo com um texto provisório como N/A. Um identificador que aponta para o produto errado é pior do que nenhum, porque a alfândega pode usá-lo para consultar as mercadorias.
Adicionar identificadores de produto da UE
Adicionar identificadores de produto da UE (PIDs)
Adicione os identificadores de produto que a UE exige em remessas B2C de baixo valor, para cada integração da Zonos.
A partir de 1º de novembro de 2026, a UE exige identificadores de produto (PIDs) em todos os itens de remessas business-to-consumer que entram na UE com valor de até €150. Remessas sem esses identificadores podem ser retidas ou recusadas pela alfândega. Este guia mostra onde adicionar os identificadores para cada integração da Zonos.
Para obter informações sobre a regulamentação, incluindo códigos TARIC e exceções, consulte o guia de identificadores de produto da UE (PID).
O que é exigido
Cada produto precisa de até três identificadores. Dois são sempre obrigatórios; o S-PID é obrigatório apenas quando o produto tiver um.
TSHIRT-BLU-MMX-500-BLK012345678905Se você mesmo fabrica o produto, o seu próprio número de modelo ou de peça é o número do fabricante.
Onde adicioná-los
Os comerciantes da Shopify adicionam os identificadores na Shopify, e a Zonos os obtém automaticamente. Para todas as outras integrações, adicione-os no Zonos Catalog ou mapeie-os a partir dos campos da sua própria loja, se as configurações do seu plugin oferecerem mapeamento personalizado.
Shopify
Adicione os três identificadores em cada variante no painel administrativo da Shopify. O Zonos Duty and Tax os obtém no checkout; não há nada a alterar no app.
Dicas:
Qualquer integração: Zonos Catalog ou mapeamento no plugin
Magento, WooCommerce, BigCommerce, Miva e qualquer outra integração podem adicionar os identificadores no Zonos Catalog. Alguns plugins também podem mapeá-los a partir dos campos da sua própria loja. Use a opção que melhor se adapta à forma como você já gerencia os dados dos seus produtos.
Opção 1: Zonos Catalog
Para um catálogo grande, adicione os identificadores a um arquivo de importação do catálogo em vez de editar os itens um de cada vez. Certifique-se de que o SKU de cada item no Zonos Catalog corresponda exatamente ao SKU na sua loja.
A Zonos usa os identificadores do Zonos Catalog somente se:
Se você imprime etiquetas fora do Dashboard e não chama a API da Zonos para obter os detalhes do catálogo, trabalhe com o seu provedor de etiquetas para incluir os identificadores quando a etiqueta for impressa.
Para saber onde inserir os seus PIDs na sua transportadora específica, consulte o nosso guia de identificadores de produto da UE.
Opção 2: Mapeamento personalizado nas configurações do seu plugin
Alguns plugins da Zonos podem ler os identificadores de campos que você já mantém na sua loja, como um atributo personalizado. Abra as configurações do seu plugin da Zonos e procure uma opção de mapeamento personalizado ou de atributos. Se ela existir, mapeie:
Se o seu plugin não oferecer mapeamento personalizado, use o Zonos Catalog. Escolha a sua plataforma para ver as etapas de configuração.
O plugin do Magento lê o número do fabricante e o GTIN a partir de atributos do produto. Se os seus produtos ainda não tiverem atributos para eles, crie-os primeiro.
1. Criar os atributos
Pule os atributos que você já tiver.
ns_pidpara o número do fabricante ougtinpara o código de barras.2. Adicionar os atributos aos seus conjuntos de atributos
3. Preencher os valores nos seus produtos
Abra cada produto em Catalog > Products e insira o número do fabricante e o GTIN. Para definir valores em vários produtos de uma vez, selecione-os na grade de produtos e escolha Update attributes no menu Actions.
4. Mapear os atributos nas configurações da Zonos
gtin.ns_pid.Checkout e Landed Cost API
Se você se integra diretamente com a Zonos, em vez de usar um plugin de plataforma, há duas formas de fornecer os identificadores: armazená-los uma vez por produto no Zonos Catalog ou enviá-los em cada item da sua solicitação. O Catalog preenche qualquer identificador que a sua solicitação deixar em branco, por isso a maioria dos comerciantes os armazena uma vez e não envia nada a mais no momento da cotação.
skumanufacturerProductIdgtinOs nomes dos campos são os mesmos em
itemCreateWorkflow, nos itens de um carrinho e emcatalogItemCreate, então nada muda entre o fluxo de cotação e o fluxo do catálogo.Adicione os identificadores a cada item em
itemCreateWorkflow. Use esta opção se você não mantém um catálogo na Zonos ou quando os identificadores de um item forem diferentes dos do seu registro no catálogo.mutation ItemCreateWorkflow($input: [ItemCreateWorkflowInput!]!) {itemCreateWorkflow(input: $input) {idskumanufacturerProductIdgtin}}Envie o
gtinsomente com dígitos, sem hífens nem espaços. Valores de UPC, EAN, JAN e ISBN de 13 dígitos vão todos neste mesmo campo, e a Zonos identifica qual é o padrão a partir do próprio número.0123456789050-12345-67890-5Se você tiver um ISBN de 10 dígitos, envie a versão de 13 dígitos, pois um ISBN de 10 dígitos pode terminar com a letra X.
Se um produto não tiver código de barras, omita o
gtinem vez de enviar uma string vazia, reutilizar o seu SKU ou preenchê-lo com um texto provisório comoN/A. Um identificador que aponta para o produto errado é pior do que nenhum, porque a alfândega pode usá-lo para consultar as mercadorias.Antes de 1º de novembro
Esta página foi útil?