PS PrestaShop Intermédio

DataFirefly Amazon Connector: ligar o PrestaShop ao Amazon Seller Central

Instalação, ligação SP-API, marketplaces, correspondência de categorias, publicação, preços, stock, encomendas, envios, faturas, cancelamentos, reembolsos e resolução de problemas.

Atualizado Versão do módulo 2.0.0

Apresentação

O módulo liga a sua loja PrestaShop à sua conta de vendedor Amazon através da API oficial Selling Partner API (SP-API). Publica os seus produtos nos marketplaces escolhidos, envia o stock e os preços, importa as encomendas Amazon para o PrestaShop, confirma os envios, envia as suas faturas e lê os reembolsos e o stock FBA.

Compatibilidade: PrestaShop 1.7.8 a 9.x, o mesmo ZIP para todas as versões. Multiloja, multilíngue, regiões Amazon Europa, América do Norte e Extremo Oriente. Interface em 8 idiomas: francês, inglês, espanhol, alemão, italiano, neerlandês, polaco e português.

Novidades da versão 2.0.0: assistente de ligação, painel de sincronização, editor visual de correspondências com os atributos obrigatórios da Amazon, fila com explicação e correção de cada erro, preço mínimo e máximo por produto e por marketplace, modo de IVA por marketplace, reembolso a partir do PrestaShop, anonimização dos dados do comprador e compatibilidade com o PrestaShop 1.7.8.

A 2.0.0 corrige também defeitos da 1.2.1: atualizações de stock não colocadas em fila e definições do produto não guardadas em MySQL strict, encomendas recusadas para um país desativado na loja ou para Espanha, importação impossível pelo cron em linha de comandos, marca desativada a bloquear o anúncio. A atualização a partir da 1.2.1 mantém todos os seus dados.

Instalação

  1. Em Módulos > Gestor de Módulos, clique em Carregar um módulo e envie o ficheiro ZIP. As extensões PHP cURL e OpenSSL são obrigatórias.
  2. O módulo cria as suas tabelas, o separador Conector Amazon no menu Vender, uma transportadora «Amazon» reservada às encomendas importadas (nunca proposta aos seus clientes) e os estados de encomenda Amazon.
  3. Abra o separador: o painel mostra os passos iniciais, por ordem.

Para passar da 1.2.1 para a 2.0.0, envie o novo ZIP. Definições, credenciais, marketplaces, correspondências, anúncios, encomendas e registos são mantidos, e os segredos são novamente cifrados com o novo algoritmo. A anonimização dos dados do comprador fica desativada após uma atualização: nada do que já foi importado é alterado enquanto não a ativar.

Preparar a sua conta Amazon

O módulo liga-se com a sua própria aplicação privada SP-API. Precisa de uma conta Seller Central profissional.

  1. No Seller Central, abra Apps and Services > Develop Apps e registe-se como programador privado, se ainda não o fez.
  2. Crie uma aplicação e peça as funções necessárias às funcionalidades que vai utilizar: Product Listing e Pricing para o catálogo, Inventory and Order Tracking para as encomendas, Direct-to-Consumer Shipping (Restricted) para a morada de entrega, Amazon Fulfillment para o stock FBA, Finance and Accounting para os reembolsos, Tax Invoicing para as faturas.
  3. Autorize a aplicação na sua conta para obter um refresh token e anote o ID de cliente LWA e o segredo de cliente LWA.
  4. Anote o seu ID de vendedor (Merchant Token) em Settings > Account Info.

A API Orders v2026-01-01 utilizada pelo módulo não pede Restricted Data Token: o acesso à morada de entrega depende da função Direct-to-Consumer Shipping da sua aplicação. Sem esta função, as encomendas são importadas com uma morada de substituição, assinalada na encomenda.

Ligação

O separador Ligação guia a configuração em quatro passos: a região, as credenciais Login with Amazon, o ID de vendedor e, por fim, o teste. O teste pede um token de acesso à Amazon e lê os marketplaces da sua conta; depois, assinala as lojas Amazon a ativar.

O segredo de cliente e o refresh token são cifrados na base de dados (AES-256-GCM) e nunca voltam a ser mostrados: deixe os campos vazios para manter os valores guardados. O botão Desligar apaga as credenciais e para a sincronização.

Assistente de ligação: região, credenciais Login with Amazon encriptadas, ID de vendedor, teste e escolha das lojas Amazon europeias
Assistente de ligação: região, credenciais Login with Amazon encriptadas, ID de vendedor, teste e escolha das lojas Amazon europeias

Marketplaces e regras de preço

O separador Marketplaces mostra um cartão por loja Amazon. Para cada uma, defina:

  • a ativação e o idioma do anúncio (título, descrição, pontos-chave);
  • o acréscimo em percentagem, o montante fixo e o arredondamento (nenhum, x,99, x,90, inteiro superior);
  • o preço mínimo do marketplace: nenhum preço é publicado abaixo dele;
  • os preços com ou sem IVA, e a sincronização dos preços, a desligar se utilizar um repricer Amazon;
  • o modo de IVA: IVA segundo as regras da loja, ou nenhum imposto quando a Amazon cobra o IVA. Esta escolha depende do seu regime fiscal: confirme-a com o seu contabilista.

Cada cartão indica também o número de anúncios em linha e com erro e as encomendas recentes desse marketplace.

Marketplaces europeus: idioma dos anúncios, margem, montante fixo, arredondamento, preço mínimo e IVA por loja Amazon
Marketplaces europeus: idioma dos anúncios, margem, montante fixo, arredondamento, preço mínimo e IVA por loja Amazon

Correspondências: categorias e tipos de produto

Uma correspondência só é útil para criar novas fichas na Amazon. Um produto vendido num ASIN existente, ou associado pelo seu EAN, só precisa de uma oferta.

No separador Mapeamento, associe uma categoria PrestaShop a um tipo de produto Amazon. Um produto utiliza a correspondência da sua categoria predefinida ou, na falta desta, a da categoria-mãe mais próxima. O botão de pesquisa consulta a Amazon por palavras-chave e propõe os tipos de produto correspondentes.

Pesquisa de um tipo de produto Amazon por palavra-chave e adição dos atributos obrigatórios em falta
Pesquisa de um tipo de produto Amazon por palavra-chave e adição dos atributos obrigatórios em falta

Depois de escolhido o tipo, Carregar os atributos obrigatórios lê o esquema do tipo de produto na Amazon. O editor indica, para cada atributo obrigatório, se é preenchido automaticamente pelo módulo (título, marca, EAN, preço…), associado por si, ou ainda em falta, com um contador «cobertos». Para cada atributo em falta, escolha uma origem:

  • uma característica PrestaShop;
  • um atributo de combinação (tamanho, cor, material…);
  • um valor fixo.

O tema de variação (por exemplo SIZE_NAME/COLOR_NAME) agrupa as combinações numa família pai-filho; vazio, cada combinação é publicada como um produto independente. Os atributos avançados (JSON) continuam disponíveis para casos particulares, com as variáveis {marketplace_id}, {language_tag}, {currency}, {reference}, {ean13}, {mpn} e {brand}.

Mapeamento das categorias para tipos de produto Amazon: atributos obrigatórios cobertos, características, combinações e valores fixos
Mapeamento das categorias para tipos de produto Amazon: atributos obrigatórios cobertos, características, combinações e valores fixos

Publicar os produtos

A partir da ficha do produto

O separador Módulos da ficha do produto contém o bloco Amazon:

  • Vender na Amazon ativa o produto.
  • Modo de publicação: automático, oferta num produto existente (ASIN ou EAN) ou criação da ficha completa.
  • Expedição: por si (FBM) ou pela Amazon (FBA).
  • ASIN, tipo de produto, estado e preço Amazon fixo substituem os valores predefinidos para este produto.
  • Preço mínimo e preço máximo do produto: delimitam o preço calculado e são enviados à Amazon como limites de preço do vendedor.
  • Marketplaces: desmarque um país para retirar o produto desse marketplace.

A tabela «O que será enviado para a Amazon» mostra, por combinação e por país, o preço, o preço promocional e as suas datas, os limites de preço, o preço Business e a quantidade. Um preço ajustado a um limite é assinalado. Os anúncios já em linha aparecem com o seu estado e o seu ASIN.

Página de produto, bloco Amazon: modo de publicação, FBM ou FBA, preço mínimo e máximo, preço calculado por loja e anúncios online
Página de produto, bloco Amazon: modo de publicação, FBM ou FBA, preço mínimo e máximo, preço calculado por loja e anúncios online

Verificar com a Amazon faz a Amazon validar o anúncio sem publicar nada. Cada erro é explicado de forma clara com a correção a aplicar, por exemplo um EAN não registado na GS1 ou um atributo obrigatório em falta. Enviar agora, Adicionar à próxima sincronização e Atualizar estado completam o bloco. Um anúncio já em linha é atualizado por alteração parcial: os atributos introduzidos no Seller Central e não geridos pelo módulo não são apagados.

Verificação com a Amazon antes do envio: erros do anúncio explicados (EAN inválido, atributo obrigatório) com a correção a aplicar
Verificação com a Amazon antes do envio: erros do anúncio explicados (EAN inválido, atributo obrigatório) com a correção a aplicar

Em massa

O separador Produtos lista o catálogo com, para cada produto, o modo FBM ou FBA, o estado por marketplace, o stock da loja e o stock FBA. Filtre por nome, referência, EAN, SKU, ASIN, categoria ou estado, assinale produtos ou todos os produtos que correspondem ao filtro e aplique uma ação em massa: ativar e publicar, publicar novamente, enviar preços, enviar quantidades, desativar (quantidade 0) ou remover da Amazon.

Produtos enviados para a Amazon: FBM ou FBA, estado por loja, stock da loja e stock FBA, ações em massa
Produtos enviados para a Amazon: FBM ou FBA, estado por loja, stock da loja e stock FBA, ações em massa

Anúncios já presentes na Amazon

Ligar os anúncios Amazon existentes pede à Amazon o relatório dos seus anúncios. Nas execuções seguintes do cron, cada SKU é associado ao produto PrestaShop que tem o mesmo SKU, a mesma referência ou o mesmo EAN. Os SKU não encontrados são listados no registo.

SKU Amazon

O SKU é criado na primeira publicação segundo a definição escolhida: referência, EAN13 ou padrão (por predefinição PS{id_product}-{id_product_attribute}). Um SKU já criado nunca muda, mesmo que a referência mude, e duas combinações não podem receber o mesmo SKU.

Preços

O preço é calculado pelo módulo, no servidor, por esta ordem: preço do grupo de preços escolhido, conversão para a moeda do marketplace, acréscimo e montante fixo, arredondamento e, por fim, limites. O preço mínimo aplicado é o mais elevado entre o preço mínimo do produto, o preço mínimo do marketplace e o preço de custo acrescido da margem mínima; o máximo é o preço máximo do produto. Um preço nulo ou negativo nunca é publicado, e um mínimo superior ao máximo é recusado com uma mensagem.

Opções da secção Preços das definições:

  • Grupo de preços: os preços deste grupo de clientes servem de base aos preços Amazon.
  • Aplicar os descontos da loja: preços específicos e regras de catálogo integrados no preço Amazon.
  • Enviar os descontos da loja como preços promocionais Amazon: o preço normal continua a ser o preço de referência e o desconto torna-se um preço promocional com datas. Um desconto criado, alterado ou eliminado no PrestaShop atualiza a Amazon; ao eliminá-lo, o preço promocional é retirado da Amazon.
  • Margem mínima sobre o preço de custo: nenhum preço é publicado abaixo do preço de custo acrescido desta margem, e este mínimo é enviado à Amazon para a fixação automática de preços.
  • Preços Amazon Business: o preço de um grupo de clientes torna-se o preço Business, e os seus descontos por quantidade tornam-se escalões (5 no máximo). Reservado aos vendedores inscritos no Amazon Business.
Definições de preços: grupo de preços, descontos enviados como preço promocional Amazon, margem mínima sobre o preço de compra, preços Amazon Business
Definições de preços: grupo de preços, descontos enviados como preço promocional Amazon, margem mínima sobre o preço de compra, preços Amazon Business

Stock e FBA

Cada movimento de stock no PrestaShop coloca o produto na fila de envio, para cada marketplace onde o anúncio está em linha. Definições: stock de segurança (unidades mantidas fora da Amazon), quantidade máxima, tempo de preparação, quantidade 0 para os produtos desativados e ressincronização completa diária. Uma quantidade negativa é enviada como 0.

Os produtos em FBA não recebem quantidade a partir do PrestaShop. Ler o stock FBA obtém, de hora a hora, a quantidade disponível nos armazéns Amazon, mostrada na lista de produtos e na ficha do produto; Copiar o stock FBA para o PrestaShop aplica-a ao stock da loja para os produtos em FBA.

Tarefa cron

A sincronização funciona por tarefa cron, idealmente a cada 5 a 15 minutos. A secção Tarefa cron das definições mostra o URL protegido por token e o comando em linha de comandos:

php /caminho/para/modules/dfamazonconnector/cron.php --shop=1

Duas execuções nunca se sobrepõem: um bloqueio impede que uma segunda execução comece enquanto a primeira estiver em curso. Em cada execução, o módulo importa as encomendas, confirma os envios, envia as faturas, cancelamentos e reembolsos, lê os reembolsos e o stock FBA, anonimiza os dados do comprador cujo prazo terminou e, por fim, envia os anúncios, stocks e preços pendentes sob a forma de feeds agrupados. Quando a Amazon limita o número de chamadas, o módulo espera e tenta novamente, dentro de um tempo limitado por execução. O botão Novo token invalida o URL anterior.

Tarefa cron: URL protegido por token e comando PHP CLI, execuções sem sobreposição, reenvio das quantidades e leitura do stock FBA
Tarefa cron: URL protegido por token e comando PHP CLI, execuções sem sobreposição, reenvio das quantidades e leitura do stock FBA

Painel

O painel apresenta os anúncios ativos e com erro, as encomendas Amazon dos últimos 14 dias em FBM e em FBA, as tarefas pendentes, os erros de anúncios mais frequentes com a respetiva correção, o estado de cada marketplace e o histórico das últimas sincronizações, com o número de chamadas limitadas pela Amazon e de erros. Uma faixa assinala um cron parado há mais de uma hora.

Painel do conector Amazon: anúncios ativos e com erro, encomendas FBM e FBA de 14 dias, fila, erros frequentes e últimas sincronizações
Painel do conector Amazon: anúncios ativos e com erro, encomendas FBM e FBA de 14 dias, fila, erros frequentes e últimas sincronizações

Fila e erros

O separador Fila e erros conta as tarefas por tipo (anúncios, preços, stock, faturas, cancelamentos, reembolsos) e por estado. Os erros são agrupados por causa: cada grupo dá a explicação, a correção a aplicar e uma ligação para o ecrã em causa. Repita ou elimine as tarefas em lote e consulte os últimos feeds e relatórios enviados à Amazon.

Fila e erros: tarefas por tipo, erros agrupados com explicação, correção proposta e nova tentativa com um clique
Fila e erros: tarefas por tipo, erros agrupados com explicação, correção proposta e nova tentativa com um clique

Encomendas

As encomendas são lidas com a API Orders v2026-01-01 a partir da data de início escolhida. Uma encomenda a aguardar pagamento é memorizada sem ser criada; é importada assim que a Amazon a passa para enviar. A importação é idempotente: um bloqueio por encomenda Amazon e o número de encomenda guardado como identificador de transação impedem qualquer encomenda duplicada, mesmo que dois crons estejam em execução ou que uma execução pare a meio.

Cada encomenda importada cria ou reutiliza um cliente convidado (um por comprador, ou um único cliente para todas as encomendas Amazon), sem newsletter nem ofertas de parceiros, uma morada de entrega e uma encomenda PrestaShop com a transportadora Amazon, os preços e portes Amazon e, opcionalmente, a data de compra Amazon. As encomendas para um país desativado na sua loja são importadas sem reativar esse país. A fatura é numerada pelo PrestaShop segundo a sua numeração habitual e nunca é renumerada.

As encomendas FBA são importadas depois de enviadas pela Amazon, com o estado dedicado. Com a opção «As encomendas FBA não alteram o stock da loja», a quantidade é devolvida ao stock após a criação: nunca é descontada duas vezes.

Definições de encomendas: importação FBA, stock FBA não descontado, estados, confirmação de envio, clientes convidados e transportadoras
Definições de encomendas: importação FBA, stock FBA não descontado, estados, confirmação de envio, clientes convidados e transportadoras

O separador Encomendas lista as encomendas Amazon com os filtros «A enviar», «Pedidos de cancelamento», «Erros de importação», «FBA» e «Reembolsadas». Uma encomenda não importada mostra a causa e a correção (SKU desconhecido, moeda não instalada, país não configurado…) e um botão Tentar novamente.

Encomendas Amazon importadas: a enviar, pedidos de cancelamento, erros de importação com correção, FBA, reembolsos
Encomendas Amazon importadas: a enviar, pedidos de cancelamento, erros de importação com correção, FBA, reembolsos

Envios, faturas, cancelamentos e reembolsos

O bloco Amazon da página da encomenda reúne todas as ações sobre a encomenda.

  • Envio: quando a encomenda passa para um dos estados escolhidos nas definições, o módulo envia à Amazon o código da transportadora, o número de seguimento e a data de envio. A Amazon exige um número de seguimento: sem ele, nada é enviado e o bloco assinala-o. A tabela de correspondência de transportadoras associa cada transportadora PrestaShop a um código Amazon; altere a transportadora da encomenda antes do envio para que seja enviado o código correto. O botão Confirmar o envio agora evita esperar pelo cron.
  • Fatura: se utilizar o serviço de cálculo de IVA da Amazon com o envio das suas próprias faturas, a fatura PDF do PrestaShop é enviada após a confirmação do envio. O seu estado (enviada, pendente, rejeitada) aparece na encomenda. A Amazon rejeita o envio se a geração automática das faturas Amazon estiver ativa no Seller Central.
  • Reembolso: reembolse a encomenda total ou parcialmente, artigo a artigo, com um motivo da lista Amazon. O montante não pode exceder o que foi pago. A Amazon reembolsa o comprador e, depois, o reembolso é lido e anotado na encomenda.
Página da encomenda, bloco Amazon: envio confirmado com seguimento, fatura enviada, reembolso por artigo enviado para a Amazon e reembolsos lidos
Página da encomenda, bloco Amazon: envio confirmado com seguimento, fatura enviada, reembolso por artigo enviado para a Amazon e reembolsos lidos

Quando um comprador pede o cancelamento de uma encomenda não enviada, aparece um alerta vermelho na lista e na encomenda, com o motivo. Não envie: cancele na Amazon a partir do bloco, ou ative Cancelar na Amazon quando a encomenda é cancelada no PrestaShop. Um cancelamento pedido pelo comprador segue com o motivo BuyerCanceled. Inversamente, uma encomenda cancelada do lado da Amazon passa para o estado de cancelamento escolhido, sem e-mail ao cliente.

Pedido de cancelamento do comprador detetado: alerta antes do envio e cancelamento na Amazon com o motivo BuyerCanceled
Pedido de cancelamento do comprador detetado: alerta antes do envio e cancelamento na Amazon com o motivo BuyerCanceled

Com Ler os reembolsos Amazon, os reembolsos feitos no Seller Central são lidos através da API Finances e anotados na encomenda PrestaShop. Quando todas as unidades estão reembolsadas, a encomenda passa para o estado escolhido.

Dados do comprador

A secção Dados do comprador das definições aplica as regras da Amazon sobre dados pessoais:

  • Anonimizar os dados do comprador após (dias): o nome, a rua, o código postal, o telefone e o e-mail do comprador são substituídos este número de dias após o envio (30 por predefinição numa instalação nova). O país, a cidade, a empresa, os montantes e as faturas são mantidos. A política de proteção de dados da Amazon pede que estes dados não sejam guardados mais de 30 dias após a entrega, salvo obrigação legal. Descarregue antes as suas faturas se precisar de as gerar novamente.
  • Bloquear e-mails da loja para compradores Amazon: confirmações, faturas, alterações de estado e e-mails de marketing do PrestaShop não são enviados aos compradores Amazon. A Amazon gere a comunicação com o comprador; os seus próprios alertas de encomenda continuam a chegar.
  • Manter registos (dias): os registos nunca contêm dados pessoais de compradores nem credenciais.
Dados dos compradores: anonimização após o envio, e-mails da loja bloqueados para os compradores Amazon, registos sem dados pessoais
Dados dos compradores: anonimização após o envio, e-mails da loja bloqueados para os compradores Amazon, registos sem dados pessoais

Alertas e registos

O e-mail de alerta diário é enviado aos destinatários escolhidos, apenas se houver uma ação a realizar: pedidos de cancelamento, encomendas não confirmadas, encomendas não importadas, faturas rejeitadas, anúncios com erro, feeds rejeitados, cron parado. O separador Registos guarda cada operação com o seu detalhe técnico, filtrável por nível e por canal.

Permissões dos funcionários

O módulo respeita as permissões do perfil do funcionário no separador Conector Amazon. Um perfil só de leitura consulta tudo mas não pode alterar as definições nem as credenciais, nem enviar um cancelamento, um reembolso ou uma publicação; a interface assinala-o.

Resolução de problemas

O teste de ligação falha

Verifique a região, o ID de cliente LWA, o segredo e o refresh token. Um refresh token corresponde a uma aplicação e a uma conta: gere-o novamente após qualquer alteração das funções da aplicação.

Um anúncio está com erro

Abra Fila e erros ou a ficha do produto: cada erro Amazon é aí explicado com a correção. O código 90220 assinala um atributo obrigatório em falta, a completar na correspondência; o código 90188, um EAN não reconhecido. Utilize Verificar com a Amazon para validar a correção antes do envio.

Uma encomenda não é importada

A causa é mostrada no separador Encomendas. O caso mais frequente é um SKU Amazon que não corresponde a nenhum produto: ligue os anúncios existentes ou corrija a referência e clique em Tentar novamente. Verifique também se a moeda do marketplace está instalada no PrestaShop.

O stock ou os preços não são atualizados

Verifique a última sincronização no painel e as tarefas pendentes. As atualizações seguem na execução seguinte do cron e a Amazon processa-as em poucos minutos. Para forçar um envio completo, utilize Reenviar todas as quantidades.

Limitações

  • O módulo foi testado com um simulador fiel à documentação SP-API: faça um primeiro teste com alguns produtos antes de publicar todo o catálogo. O módulo não garante vendas nem conformidade com as políticas da Amazon: continua responsável pelos seus anúncios, pelo seu IVA e pela proteção de dados no seu alojamento.
  • Os atributos exigidos variam consoante o tipo de produto e o marketplace: a cobertura mostrada depende do último carregamento do esquema.
  • Uma encomenda enviada em vários volumes não é confirmada linha a linha: todas as linhas são confirmadas em conjunto.
  • O cron continua a ser necessário; o módulo não utiliza as notificações da Amazon.
Esta página foi útil?

Ainda com dúvidas? Contacte o suporte