Adicione os identificadores de produto que a UE exige nos envios 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 artigos de envios entre empresas e consumidores (B2C) que entram na UE com um valor igual ou inferior a 150 €. Os envios sem estes identificadores podem ser retidos ou rejeitados pela alfândega. Este guia indica onde adicionar os identificadores em cada integração da Zonos.
Os 150 € são calculados por remessa (o que envia a um cliente ao abrigo de um único contrato de transporte, ou seja, uma carta de porte) e incluem apenas o valor das mercadorias, excluindo o transporte e o seguro. Um envio de várias caixas com uma única carta de porte constitui uma só remessa, pelo que essas caixas são avaliadas em conjunto. Uma encomenda que expede em dois envios separados corresponde a duas remessas, cada uma avaliada pelo seu próprio valor. Como isto depende da forma como a encomenda é embalada e expedida, a abordagem mais simples é preencher os identificadores de tudo o que vende para a UE.
Os comerciantes da Shopify adicionam os identificadores na Shopify e a Zonos obtém-nos automaticamente. Em todas as outras integrações, adicione-os no Zonos Catalog ou mapeie-os a partir dos campos da sua própria loja, se as definiçõ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 de administração da Shopify
Magento
Zonos Catalog ou mapeamento de atributos nas definições do plugin da Zonos (passos abaixo)
Adicione os três identificadores em cada variante no painel de administração da Shopify. A aplicação Zonos obtém-nos.
No painel de administração da Shopify, abra Products e selecione um produto.
Abra a variante que pretende atualizar.
Para o ID de produto do comerciante (M-PID), a aplicação Zonos utiliza automaticamente o ID do produto da Shopify. Para utilizar o seu SKU, todos os produtos têm de ter um SKU e cada SKU tem de ser único: certifique-se de que o campo SKU está preenchido e de que o SKU não é utilizado em nenhuma outra variante.
Adicione o número do fabricante como um código de barras do tipo NS-PID (identificador de produto do fabricante não normalizado).
Se o produto tiver um UPC, EAN, GTIN ou ISBN, adicione-o como segundo código de barras com o tipo correspondente.
Guarde e repita para cada variante.
Sugestões:
Coloque o número do fabricante num 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ê apenas os cinco primeiros. Mantenha o NS-PID e o código de barras principal do produto entre eles.
Os códigos de barras que introduziu antes desta alteração continuam a funcionar como UPC/EAN. Só 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 os podem mapear a partir dos campos da sua própria loja. Utilize a opção que melhor se adequa à forma como já gere os dados dos seus produtos.
Encontre o produto. Cada variante é um artigo próprio do catálogo.
Preencha os três campos de identificador:
SKU ou Product ID: o seu ID de produto do comerciante (M-PID). Qualquer um deles serve.
Manufacturer product ID: o número do fabricante
GTIN: o UPC, EAN, GTIN ou ISBN, se o produto tiver um
Guarde e repita para cada artigo.
Num catálogo grande, adicione os identificadores a um ficheiro de importação do catálogo em vez de editar os artigos um a um. Certifique-se de que o SKU de cada artigo no Zonos Catalog corresponde exatamente ao SKU da sua loja.
Os identificadores do Catalog só chegam às suas etiquetas em dois casos
A Zonos só utiliza os identificadores do Zonos Catalog se:
Imprimir as etiquetas de envio a partir do Dashboard.
Imprimir as etiquetas fora do Dashboard e chamar a API da Zonos para obter os dados do produto no catálogo antes de pedir a etiqueta à sua transportadora. Consulte Encontrar um produto para saber como pesquisar um artigo do catálogo.
Se imprimir as etiquetas fora do Dashboard e não chamar a API da Zonos para obter os dados do catálogo, trabalhe com o seu fornecedor de etiquetas para incluir os identificadores quando a etiqueta for impressa.
Opção 2: Mapeamento personalizado nas definições do seu plugin
Alguns plugins da Zonos conseguem ler os identificadores a partir de campos que já mantém na sua loja, como um atributo personalizado. Abra as definições do seu plugin da Zonos e procure uma opção de mapeamento personalizado ou de atributos. Se 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, utilize o Zonos Catalog. Escolha a sua plataforma para ver os passos de configuração.
Importante: O mapeamento de atributos para o número do fabricante e o GTIN requer o módulo Zonos Checkout (zonos/checkout) na versão 2.3.40 ou posterior. Para verificar a versão instalada, execute composer show zonos/checkout. Para os passos 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 estes dados, crie-os primeiro.
1. Criar os atributos
Ignore os atributos que já tiver.
Aceda a Stores > Attributes > Product e clique em Add New Attribute.
Defina Default Label com um nome que 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
Aceda a Stores > Attributes > Attribute Set e abra o conjunto que os seus produtos utilizam.
Arraste cada novo atributo de Unassigned Attributes para um grupo, como Product Details.
Clique em Save. Repita para cada conjunto de atributos utilizado pelos seus produtos destinados à UE.
3. Preencher os valores nos seus produtos
Abra cada produto em Catalog > Products e introduza o respetivo número do fabricante e GTIN. Para definir valores em vários produtos de uma só vez, selecione-os na grelha de produtos e escolha Update attributes no menu Actions.
4. Mapear os atributos nas definições da Zonos
Aceda a Stores > Configuration > Zonos > Zonos Duty and Tax.
Desloque-se até aos campos de mapeamento de atributos (Brand, HS code, Length, etc.).
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 um produto não tiver o seu próprio número do fabricante (NS-PID), pode fazer com que a Zonos envie o respetivo S-PID (GTIN) como NS-PID. A definição aplica-se a todas as integrações, está desativada por predefinição e nunca substitui um número do fabricante que já tenha adicionado.
No Dashboard, aceda a Settings > Landed cost > Catalog.
Em Product identifiers, selecione Use S-PID as NS-PID.
Leia a declaração de reconhecimento que aparece abaixo da caixa de verificação e, em seguida, clique em Save.
Para que a definição seja útil, o produto tem de ter um S-PID. Se um produto não tiver nem número do fabricante nem S-PID, continua a ter de adicionar um número do fabricante.
Obtenha primeiro a autorização do fabricante
Ao ativar esta definição, confirma que recebeu uma declaração do fabricante que autoriza a utilização do respetivo S-PID (GTIN) como NS-PID. A Zonos guarda o texto da declaração que aceitou, quem ativou a definição e quando.
Se integrar diretamente com a Zonos em vez de utilizar um plugin de plataforma, tem duas formas de fornecer os identificadores: guardá-los uma vez por produto no Zonos Catalog ou enviá-los em cada artigo do seu pedido. O Catalog preenche qualquer identificador que o seu pedido deixe em branco, pelo que a maioria dos comerciantes os guarda uma vez e não envia nada adicional no momento da cotação.
Identificador nesta página↕
Campo da API↕
ID de produto do comerciante (M-PID)
sku ou productId
Número do fabricante
manufacturerProductId
S-PID (GTIN, UPC, EAN, ISBN)
gtin
Para o M-PID, envie sku ou productId. Os nomes dos campos são os mesmos em itemCreateWorkflow, nos artigos de um carrinho e em catalogItemCreate, pelo que nada muda entre o fluxo de cotação e o fluxo do catálogo.
Adicione os identificadores a cada artigo em itemCreateWorkflow. Utilize esta opção se não mantiver um catálogo na Zonos ou quando os identificadores de um artigo forem diferentes dos da respetiva entrada no catálogo.
Envie o gtin apenas com dígitos, sem hífenes nem espaços. Os valores UPC, EAN, JAN e ISBN de 13 dígitos vão todos para este mesmo campo, e a Zonos identifica a norma a partir do próprio número.
Correto: 012345678905
Rejeitado: 0-12345-67890-5
Se tiver um ISBN de 10 dígitos, envie a versão de 13 dígitos, porque 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 cadeia vazia, reutilizar o seu SKU ou preenchê-lo com texto genérico como N/A. Um identificador que aponta para o produto errado é pior do que nenhum, porque a alfândega pode utilizá-lo para consultar as mercadorias.
Depois de os identificadores estarem nos seus produtos, a Zonos coloca-os onde cada transportadora os espera quando cria a etiqueta e a fatura comercial. Não precisa de formatar nada.
A Zonos envia os identificadores nos envios para a UE, onde são obrigatórios, para:
FedEx
UPS
DHL Express
APC
Asendia
USPS
A Zonos está a adicionar mais transportadoras. Adicione os identificadores aos seus produtos seja qual for a transportadora que utiliza: ficam guardados no seu catálogo e já são utilizados para o landed cost, e serão enviados assim que essa transportadora for adicionada, sem nada para refazer mais tarde. Para saber em que ponto está uma transportadora, contacte o suporte da Zonos.
Se criar as suas próprias etiquetas
Se gerar etiquetas através da sua própria integração com a transportadora em vez de através da Zonos, é responsável por enviar os identificadores. Cada transportadora espera-os num local diferente, e diferem quanto ao que enviar quando um produto não tem S-PID: algumas pedem um valor explícito de "nenhum", outras pedem que o campo seja omitido. Contacte o suporte da Zonos para obter os detalhes aplicáveis às suas transportadoras.
Adicionar identificadores de produto da UE
Adicionar identificadores de produto da UE (PIDs)
Adicione os identificadores de produto que a UE exige nos envios 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 artigos de envios entre empresas e consumidores (B2C) que entram na UE com um valor igual ou inferior a 150 €. Os envios sem estes identificadores podem ser retidos ou rejeitados pela alfândega. Este guia indica onde adicionar os identificadores em cada integração da Zonos.
Os 150 € são calculados por remessa (o que envia a um cliente ao abrigo de um único contrato de transporte, ou seja, uma carta de porte) e incluem apenas o valor das mercadorias, excluindo o transporte e o seguro. Um envio de várias caixas com uma única carta de porte constitui uma só remessa, pelo que essas caixas são avaliadas em conjunto. Uma encomenda que expede em dois envios separados corresponde a duas remessas, cada uma avaliada pelo seu próprio valor. Como isto depende da forma como a encomenda é embalada e expedida, a abordagem mais simples é preencher os identificadores de tudo o que vende para a UE.
Para obter informações sobre o regulamento, incluindo os códigos TARIC e as exceções, consulte o guia de identificadores de produto da UE (PID).
O que é exigido
Cada produto necessita de até três identificadores. Dois são sempre obrigatórios; o S-PID só é obrigatório quando o produto tiver um.
TSHIRT-BLU-MMX-500-BLK012345678905Para o ID de produto do comerciante (M-PID), pode utilizar o SKU do produto ou o respetivo ID do produto. Basta um deles.
Se for o próprio a fabricar o produto, o seu 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 obtém-nos automaticamente. Em todas as outras integrações, adicione-os no Zonos Catalog ou mapeie-os a partir dos campos da sua própria loja, se as definições do seu plugin oferecerem mapeamento personalizado.
Shopify
Adicione os três identificadores em cada variante no painel de administração da Shopify. A aplicação Zonos obtém-nos.
Sugestões:
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 os podem mapear a partir dos campos da sua própria loja. Utilize a opção que melhor se adequa à forma como já gere os dados dos seus produtos.
Opção 1: Zonos Catalog
Num catálogo grande, adicione os identificadores a um ficheiro de importação do catálogo em vez de editar os artigos um a um. Certifique-se de que o SKU de cada artigo no Zonos Catalog corresponde exatamente ao SKU da sua loja.
A Zonos só utiliza os identificadores do Zonos Catalog se:
Se imprimir as etiquetas fora do Dashboard e não chamar a API da Zonos para obter os dados do catálogo, trabalhe com o seu fornecedor de etiquetas para incluir os identificadores quando a etiqueta for impressa.
Para saber onde introduzir os seus PIDs na sua transportadora, consulte o nosso guia de identificadores de produto da UE.
Opção 2: Mapeamento personalizado nas definições do seu plugin
Alguns plugins da Zonos conseguem ler os identificadores a partir de campos que já mantém na sua loja, como um atributo personalizado. Abra as definições do seu plugin da Zonos e procure uma opção de mapeamento personalizado ou de atributos. Se existir, mapeie:
Se o seu plugin não oferecer mapeamento personalizado, utilize o Zonos Catalog. Escolha a sua plataforma para ver os passos 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 estes dados, crie-os primeiro.
1. Criar os atributos
Ignore os atributos que 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 introduza o respetivo número do fabricante e GTIN. Para definir valores em vários produtos de uma só vez, selecione-os na grelha de produtos e escolha Update attributes no menu Actions.
4. Mapear os atributos nas definições da Zonos
gtin.ns_pid.Utilizar o S-PID como NS-PID
Se um produto não tiver o seu próprio número do fabricante (NS-PID), pode fazer com que a Zonos envie o respetivo S-PID (GTIN) como NS-PID. A definição aplica-se a todas as integrações, está desativada por predefinição e nunca substitui um número do fabricante que já tenha adicionado.
Para que a definição seja útil, o produto tem de ter um S-PID. Se um produto não tiver nem número do fabricante nem S-PID, continua a ter de adicionar um número do fabricante.
Ao ativar esta definição, confirma que recebeu uma declaração do fabricante que autoriza a utilização do respetivo S-PID (GTIN) como NS-PID. A Zonos guarda o texto da declaração que aceitou, quem ativou a definição e quando.
Checkout e Landed Cost API
Se integrar diretamente com a Zonos em vez de utilizar um plugin de plataforma, tem duas formas de fornecer os identificadores: guardá-los uma vez por produto no Zonos Catalog ou enviá-los em cada artigo do seu pedido. O Catalog preenche qualquer identificador que o seu pedido deixe em branco, pelo que a maioria dos comerciantes os guarda uma vez e não envia nada adicional no momento da cotação.
skuouproductIdmanufacturerProductIdgtinPara o M-PID, envie
skuouproductId. Os nomes dos campos são os mesmos emitemCreateWorkflow, nos artigos de um carrinho e emcatalogItemCreate, pelo que nada muda entre o fluxo de cotação e o fluxo do catálogo.Adicione os identificadores a cada artigo em
itemCreateWorkflow. Utilize esta opção se não mantiver um catálogo na Zonos ou quando os identificadores de um artigo forem diferentes dos da respetiva entrada no catálogo.mutation ItemCreateWorkflow($input: [ItemCreateWorkflowInput!]!) {itemCreateWorkflow(input: $input) {idskumanufacturerProductIdgtin}}Envie o
gtinapenas com dígitos, sem hífenes nem espaços. Os valores UPC, EAN, JAN e ISBN de 13 dígitos vão todos para este mesmo campo, e a Zonos identifica a norma a partir do próprio número.0123456789050-12345-67890-5Se tiver um ISBN de 10 dígitos, envie a versão de 13 dígitos, porque 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 cadeia vazia, reutilizar o seu SKU ou preenchê-lo com texto genérico comoN/A. Um identificador que aponta para o produto errado é pior do que nenhum, porque a alfândega pode utilizá-lo para consultar as mercadorias.Como a Zonos os envia à sua transportadora
Depois de os identificadores estarem nos seus produtos, a Zonos coloca-os onde cada transportadora os espera quando cria a etiqueta e a fatura comercial. Não precisa de formatar nada.
A Zonos envia os identificadores nos envios para a UE, onde são obrigatórios, para:
A Zonos está a adicionar mais transportadoras. Adicione os identificadores aos seus produtos seja qual for a transportadora que utiliza: ficam guardados no seu catálogo e já são utilizados para o landed cost, e serão enviados assim que essa transportadora for adicionada, sem nada para refazer mais tarde. Para saber em que ponto está uma transportadora, contacte o suporte da Zonos.
Se gerar etiquetas através da sua própria integração com a transportadora em vez de através da Zonos, é responsável por enviar os identificadores. Cada transportadora espera-os num local diferente, e diferem quanto ao que enviar quando um produto não tem S-PID: algumas pedem um valor explícito de "nenhum", outras pedem que o campo seja omitido. Contacte o suporte da Zonos para obter os detalhes aplicáveis às suas transportadoras.
Antes de 1 de novembro
Esta página foi útil?