Saltar al contenido
Voltar ao blog Guias

Códigos EAN para PrestaShop: onde colocar o EAN-13

Se vende com o PrestaShop e precisa de saber onde e como adicionar os códigos EAN aos seus produtos, este guia resolve-lhe isso. Vai ver onde está o campo EAN-13 em cada versão do backoffice, como atribuí-lo ao nível do produto e da combinação, como importá-lo em massa por CSV e como exportá-lo para o Google Shopping e os marketplaces. E se ainda não tem os códigos, explicamos como obter códigos EAN oficiais GS1 em minutos.

Em resumo

  • O campo EAN-13 está na ficha do produto: no PrestaShop 1.7, 8.x e 9 encontra-o no separador Quantidades (ou Combinações se o produto tiver variantes); no PrestaShop 1.6 está no separador Informação.
  • Não precisa de nenhum módulo pago: o suporte dos códigos de barras EAN-13, UPC, ISBN e MPN vem de origem no núcleo do PrestaShop.
  • Cada combinação tem o seu próprio EAN-13: o tamanho M e o tamanho L da mesma t-shirt precisam de códigos diferentes, tal como cada produto simples.
  • Para muitos produtos, importe por CSV a partir de Catálogo > Importar, mapeando a sua coluna para o campo EAN13 e formatando os códigos como texto para evitar a notação científica do Excel.
  • O EAN é exportado como GTIN para o Google Shopping e os marketplaces (Amazon, eBay, Carrefour); sem um GTIN válido, muitos produtos são rejeitados ou penalizados.
  • Use códigos EAN oficiais GS1: os inventados falham no dígito de controlo e os reciclados dão problemas de propriedade. Na EAN CODA obtém-nos com pagamento único, sem taxas anuais, a partir de 3 €.

O PrestaShop é uma das plataformas de e-commerce de código aberto mais utilizadas em Espanha e na Europa, e inclui suporte nativo para códigos de barras. Isso significa que não precisa de nenhum módulo pago para atribuir os seus EAN: o campo vem de origem na ficha de cada produto. Se quiser primeiro rever o que é um EAN, tem uma explicação completa em o que é um código de barras EAN.

Comprar os meus códigos EAN — oficiais GS1, a partir de 3 €, pagamento único e sem taxas anuais. Recebe-os por e-mail em minutos, prontos a colar no PrestaShop.

EAN-13, GTIN e os campos do PrestaShop: o que é cada coisa

Antes de mexer no backoffice convém esclarecer a terminologia, porque o PrestaShop tem vários campos parecidos e é fácil confundi-los:

Campo no PrestaShopO que éFormato
EAN-13 (ou JAN)O código de barras padrão na Europa. É o GTIN-13.13 dígitos
UPCO código de barras padrão na América do Norte.12 dígitos
ReferênciaO seu código interno (SKU). É você que o define, não é um código de barras.Livre
MPNNúmero de peça do fabricante. Útil em alguns feeds, mas não substitui o EAN.Livre
ISBNIdentificador específico para livros.13 dígitos

O essencial: GTIN é o termo genérico que engloba o EAN e o UPC. Um EAN-13 é um GTIN-13 e um UPC-A é um GTIN-12. Quando um feed ou um marketplace lhe pede o "GTIN", refere-se ao seu EAN-13. A referência é o seu SKU interno e nunca deve ser colocada no campo EAN. Convém saber que o campo MPN (número de peça do fabricante) foi adicionado no PrestaShop 1.7.7; em versões anteriores não existia, e por isso em feeds antigos verá que só se exportava EAN-13 e UPC. Se se baralha entre o EAN-13 e a versão curta de 8 dígitos, esclarecemos a diferença entre EAN-13 e EAN-8 noutro guia.

Onde se introduz o EAN no PrestaShop (passo a passo)

A localização exata do campo mudou entre versões, por isso atenção se está a seguir um tutorial antigo. Em todas as versões o caminho começa por Catálogo > Produtos; o que muda é o separador dentro da ficha.

PrestaShop 1.7, 8.x e 9 (ao nível do produto)

  1. Entre no backoffice e vá a Catálogo > Produtos.
  2. Abra a ficha do produto que quer editar.
  3. Para um produto simples (sem variantes), abra o separador Quantidades. Aí, por baixo da gestão de stock, encontrará o bloco de identificadores com os campos Referência, ISBN, EAN-13, UPC e, desde a 1.7.7, MPN.
  4. Introduza o seu código de 13 dígitos no campo EAN-13 ou JAN. Mesmo ao lado verá o campo UPC caso também venda na América do Norte.
  5. Guarde as alterações.

Nota sobre versões: no PrestaShop 1.7.0 a 1.7.6 estes identificadores estavam dentro do separador Detalhes. A partir da 1.7.7 e em todas as 8.x e 9.x foram reorganizados e vivem no separador Quantidades. A lógica e o formato do código são idênticos; só muda o nome do separador.

PrestaShop 1.7, 8.x e 9 (ao nível da combinação ou variante)

Se o produto tiver combinações (tamanhos, cores, formatos), o EAN não se coloca no campo geral, mas em cada combinação:

  1. Na ficha do produto, ative o modo com combinações e abra o separador Combinações.
  2. Expanda a combinação concreta (por exemplo, "T-shirt - Tamanho M - Azul").
  3. Dentro dessa combinação verá os seus próprios campos Referência, EAN-13, UPC e ISBN. Introduza o EAN-13 que corresponde a essa variante.
  4. Repita com cada combinação e guarde.

Lembre-se de que cada combinação tem o seu próprio EAN-13: o tamanho M e o tamanho L da mesma t-shirt são produtos diferentes para um leitor e para um marketplace, por isso precisam de códigos diferentes. Se um produto tiver combinações, o EAN da combinação tem prioridade sobre o campo geral do produto na altura de exportar o feed. Uma captura de ecrã do backoffice da sua versão concreta ajuda-o a localizar o campo se se perder entre separadores.

PrestaShop 1.6

Nas versões antigas, o campo EAN-13 está na ficha do produto, dentro do separador Informação (ou no separador Combinações se usar variantes, onde cada combinação tem o seu próprio campo EAN-13). A lógica é a mesma, só muda a localização visual do campo. O caminho do menu continua a ser Catálogo > Produtos, como nas versões modernas.

Como importar EAN em massa por CSV

Se tem dezenas ou centenas de produtos, introduzir os EAN um a um é inviável. O PrestaShop permite a importação em massa:

  1. Vá a Catálogo > Importar (em algumas versões, dentro de Parâmetros avançados ou de Produtos).
  2. Selecione o tipo de entidade Produtos (ou Combinações se vai atribuir EAN a variantes).
  3. Carregue o seu ficheiro CSV. Precisa de uma coluna de identificação (por exemplo a referência ou o ID do produto) e uma coluna com o EAN-13.
  4. No passo de mapeamento, associe a sua coluna de códigos ao campo EAN13 do PrestaShop.
  5. Marque a opção "Atualizar produtos existentes" e, em muitas versões, indique que a correspondência seja feita por referência ou por ID, se só quiser adicionar o EAN sem recriar as fichas. Depois inicie a importação.

Dica: faça primeiro um teste com algumas linhas. Se o CSV usar o separador errado (o PrestaShop costuma esperar ponto e vírgula) ou se o EAN vier em notação científica do Excel (o típico 8,41E+12), será importado mal. Formate a coluna do EAN como texto antes de exportar e, se puder, guarde o ficheiro em UTF-8 para evitar problemas com acentos noutros campos.

Como é um EAN-13 válido (com exemplo)

Um EAN-13 não é uma sequência qualquer de 13 algarismos: tem uma estrutura. Tomemos um exemplo da forma 84xxxxxxxxxx C, em que os primeiros dígitos são o prefixo GS1, o bloco central identifica o produto e o último algarismo é o dígito de controlo.

  • Prefixo (os primeiros dígitos): é atribuído pela GS1. O intervalo 84x corresponde a códigos registados a partir de Espanha. Esse prefixo está dentro do EAN-13; não existe um formato à parte chamado "EAN-84", e o prefixo apenas indica onde o código foi registado, não onde o produto é fabricado nem vendido.
  • Bloco de produto: identifica de forma única o seu artigo.
  • Dígito de controlo (o último algarismo): é calculado matematicamente a partir dos 12 dígitos anteriores. É o que permite a um leitor ou a um feed detetar de imediato se o código foi mal digitado ou inventado.

Por isso um EAN tem de estar bem formado: se o inventar, o mais provável é que o dígito de controlo não bata certo e qualquer validador o rejeite. E mesmo que por acaso batesse certo, estaria a usar um número que pertence a outra empresa.

Como exportar o EAN para o Google Shopping e os marketplaces a partir do PrestaShop

Assim que o EAN está na ficha, o passo seguinte é que chegue aos seus canais de venda. O PrestaShop não gera o feed do Google Shopping por si só: precisa de um módulo de feed que leia o campo EAN-13 e o exporte como atributo GTIN.

  • Google Shopping: instale um módulo de exportação (o oficial "Google & YouTube Shopping", PS Facebook/Google, ou módulos de terceiros como o Doofinder, o Beezup ou o ShoppingFeed). Na configuração do feed, mapeie o campo EAN-13 do PrestaShop para o atributo gtin do Google. Se vende produtos de marca, preencha também brand e, quando aplicável, mpn: o Google exige pelo menos dois dos três identificadores. O feed é publicado como XML ou ligado via API ao Merchant Center.
  • Marketplaces: ao sincronizar com a Amazon, o eBay ou o Carrefour através do seu módulo ou de um conector (como o Lengow, o ShoppingFeed ou o conector nativo do marketplace), o GTIN serve para criar a ficha ou ligá-la a um produto já catalogado. Na Amazon, o EAN-13 vai no campo product ID com o tipo "EAN". Tem o detalhe nos nossos guias de códigos de barras para a Amazon e de código de barras para o eBay.
  • Verifique o mapeamento: antes de carregar todo o catálogo, exporte algumas referências e verifique no XML ou no conector que o GTIN sai preenchido e com 13 dígitos. É o erro silencioso mais frequente: o EAN está na ficha mas o feed não o mapeia. É fundamental para o seu código de barras para o Google Shopping: sem um GTIN válido, muitos produtos são rejeitados no Merchant Center com avisos do tipo "GTIN inválido" ou "Identificadores de produto incorretos".

Para que serve o EAN no PrestaShop

  • Feeds e comparadores: os módulos de exportação usam o EAN para identificar cada produto e evitar duplicados entre canais.
  • Marketplaces: o GTIN liga o seu produto ao catálogo da Amazon, do eBay ou do Carrefour, ou cria uma ficha nova se não existir.
  • Inventário e POS: com um EAN real pode gerir o stock com leitores de código de barras e ligar o seu PrestaShop a um ponto de venda físico.

Erros comuns (e como evitá-los)

  • Inventar o número: como já vimos, o dígito de controlo denuncia os códigos inventados e o feed rejeita-os de imediato.
  • Repetir o mesmo EAN em vários produtos: cada referência e cada combinação precisa de um código único. Os duplicados provocam erros de "GTIN já em uso" ou produtos fundidos por engano.
  • Confundir referência com EAN: o seu SKU interno vai no campo Referência, não no EAN-13. O MPN e o ISBN também não substituem o EAN.
  • Colocar o EAN só no produto e não nas combinações: se usa variantes, o campo geral do produto é ignorado no feed e exporta combinações sem GTIN. Preencha cada combinação.
  • EAN em notação científica: ao importar do Excel, um código como 8,41E+12 entra truncado. Formate a coluna como texto.
  • Não mapear o campo no módulo de feed: ter o EAN na ficha não basta; é preciso mapeá-lo para o atributo gtin do módulo de exportação.
  • Códigos não oficiais: os pacotes de EAN "reciclados" ou de origem duvidosa acabam por dar problemas de propriedade nos marketplaces mais rigorosos. Use códigos GS1 legítimos.

Comprar os meus códigos EAN — oficiais GS1, pagamento único, sem taxas anuais e entrega em minutos.

Usa mais do que uma plataforma?

O mesmo EAN-13 serve em qualquer sistema: é um identificador global, não está preso ao PrestaShop. Se também gere outra loja, se usa o Shopify, veja este guia para colocar os códigos nessa plataforma. Um EAN único por produto serve-lhe ao mesmo tempo no PrestaShop, nos seus feeds e em cada marketplace.

Perguntas frequentes

Onde está exatamente o campo EAN-13 no PrestaShop 8?

No PrestaShop 8 (e também da 1.7.7 em diante e na 9) o campo EAN-13 está na ficha do produto, dentro do separador Quantidades, no bloco de identificadores junto a Referência, ISBN, UPC e MPN. Se o produto tiver combinações, o EAN-13 de cada variante introduz-se no separador Combinações, dentro de cada combinação.

O EAN é obrigatório no PrestaShop?

O PrestaShop não o obriga a preencher o campo para guardar o produto, por isso tecnicamente é opcional. Mas na prática é imprescindível: assim que exporta para o Google Shopping ou para qualquer marketplace, o EAN (GTIN) deixa de ser opcional e os produtos sem ele são rejeitados ou penalizados.

Posso inventar um EAN?

Não. Mesmo que coloque 13 dígitos ao acaso, o dígito de controlo quase nunca vai bater certo e o código será inválido. E mesmo que batesse, estaria a usar um número que pertence a outra empresa, o que gera conflitos nos marketplaces. Precisa de códigos atribuídos de forma legítima.

Preciso de um EAN para cada combinação ou tamanho?

Sim. Cada variante (tamanho, cor, formato) é um produto diferente para um leitor e para um marketplace, por isso precisa do seu próprio EAN-13. Uma t-shirt em tamanhos S, M e L requer três códigos diferentes, e cada um introduz-se na sua combinação dentro do separador Combinações.

Como se exporta o EAN-13 para o Google Shopping a partir do PrestaShop?

Precisa de um módulo de feed (o oficial Google & YouTube Shopping ou um de terceiros). Na sua configuração, mapeie o campo EAN-13 do PrestaShop para o atributo gtin do Google e preencha também a marca. O módulo gera o XML ou liga-se por API ao Merchant Center; verifique que o GTIN sai preenchido antes de carregar todo o catálogo.

O mesmo EAN serve para a Amazon e para o PrestaShop?

Sim. O EAN-13 identifica o produto, não a plataforma. O mesmo código que coloca no campo EAN-13 do PrestaShop é o que usará na Amazon, no eBay, no Google Shopping ou no seu POS físico.

Como importo muitos EAN de uma vez no PrestaShop?

A partir de Catálogo > Importar, escolhendo a entidade Produtos ou Combinações, carregando um CSV com uma coluna de identificação e outra de EAN, e mapeando esta para o campo EAN13. Marque "Atualizar produtos existentes" para não recriar as fichas e formate os EAN como texto para evitar a notação científica do Excel.

Onde obtenho códigos EAN oficiais sem pagar taxas anuais?

Com a EAN CODA. Atribuímos-lhe códigos EAN oficiais da base de dados GS1 com um pagamento único, sem renovações nem taxas anuais, e entregamo-los por e-mail em minutos, prontos a colar nos campos EAN-13 do PrestaShop.

Obtenha os seus códigos EAN para PrestaShop

Com a EAN CODA obtém códigos EAN oficiais GS1 a partir de 3 €, pagamento único e sem taxas anuais, prontos a colar nos campos EAN-13 do seu PrestaShop e importáveis por CSV se tiver muitos produtos. Somos revendedor de códigos GS1 legítimos: uma alternativa mais rápida e económica do que tratar do registo por conta própria, e recebe-os em minutos.

Comprar os meus códigos EAN

Precisa de códigos EAN para os seus produtos?

Comprar EAN