Envie para eMAG os produtos que valem a pena mostrar.

A eMAG é o maior marketplace de e-commerce da Romênia e opera plataformas de Marketplace equivalentes na Bulgária (emag.bg) e na Hungria (emag.hu) com o mesmo programa de vendedores. Os vendedores terceiros não vendem por meio de uma loja separada — eles cadastram ofertas diretamente no catálogo de produtos da própria eMAG pelo eMAG Marketplace, e cada oferta concorre na mesma página de produto que os anúncios de varejo da própria eMAG e os de outros vendedores do marketplace. A eMAG oferece aos vendedores duas formas de publicar e manter esse catálogo: a eMAG Marketplace API (JSON, atualmente documentada na versão 4.5.1) ou um Feed Import hospedado em XML/CSV, que a eMAG busca e reprocessa de forma programada.

Recadastrar produtos manualmente e digitar de novo as alterações de estoque ou preço no painel de vendedor da eMAG não escala quando o catálogo passa de algumas dezenas de SKUs, e essa é a maior causa de preços desatualizados e de vendas acima do estoque em um marketplace dinâmico. Alimentar a eMAG de forma programática permite enviar novas ofertas, alterações de preço e níveis de estoque a partir do seu próprio PIM ou loja no momento em que eles mudam, e não no ritmo em que alguém se lembra de entrar e editar os anúncios manualmente. Isso também permite alcançar três mercados — Romênia, Bulgária e Hungria — a partir dos mesmos dados de produtos, já que os três funcionam com a mesma Marketplace API e a mesma mecânica de Feed Import.

A eMAG não cobra taxa de cadastro, mensalidade nem taxa por anúncio. Os vendedores pagam uma comissão por categoria apenas sobre as vendas concluídas, e a própria documentação para vendedores da eMAG informa que a comissão 'varia entre 7 e 25%, dependendo da categoria' em que o produto está cadastrado — a taxa exata de cada categoria é definida no contrato de Marketplace do vendedor. A comissão é descontada automaticamente antes do repasse, e os vendedores recebem duas vezes por mês. Vendedores que aderem ao Fulfilled by eMAG (FBE) pagam taxas adicionais de armazenagem de acordo com o tempo que o estoque fica em um armazém da eMAG, além de uma taxa de processamento por pedido que começa em 3,99 RON e aumenta conforme o tamanho e o peso do pacote.

A eMAG oferece dois caminhos de integração distintos, e a Feedance foi construída em torno do caminho da API, porque ele dá o controle mais preciso sobre a validação e o momento das atualizações:

1. Marketplace API (recomendada para automação) — payloads JSON enviados por requisições POST autenticadas para endpoints de recursos como product_offer, category e order (por exemplo, product_offer/save, product_offer/read, product_offer/count). Toda resposta é um JSON padronizado contendo um booleano isError e um array messages, e uma única chamada save é limitada a 50 entidades (10-50 é a faixa que a eMAG recomenda para um processamento confiável), com um teto absoluto de 4000 elementos por chamada.
2. Feed Import (XML/CSV) — uma única URL de arquivo hospedado que o módulo Feed Import da eMAG busca novamente conforme a programação que você configura no painel de vendedor. Um arquivo de feed é limitado a 100 MB, a no máximo 100.000 produtos e a no máximo 150 categorias por feed.

Os dois caminhos acabam preenchendo os mesmos registros de produtos/ofertas, então a escolha depende de quanto controle em tempo real você precisa sobre as respostas de validação e o tratamento de erros — e é por isso que a Feedance usa a API JSON por padrão.

1. Obtenha a aprovação da sua conta de vendedor no eMAG Marketplace e gere as credenciais de API no painel de vendedor.
2. Na Feedance, adicione a eMAG como destino e insira essas credenciais para que a Feedance possa se autenticar na Marketplace API.
3. Mapeie os campos do seu catálogo de produtos para o schema product_offer — name, part_number, brand, sale_price, vat_id, stock, EAN, images e as características específicas que a eMAG exige para cada category_id em que você vende.
4. Defina seus limites de min_sale_price / max_sale_price para que futuras atualizações de preço não sejam rejeitadas silenciosamente depois que a oferta estiver no ar.
5. Deixe a Feedance validar o feed mapeado, dividi-lo nos lotes de 10-50 entidades por chamada save recomendados pela eMAG e enviá-lo — cadenciando automaticamente as requisições para ficar abaixo do limite de requisições da eMAG, em vez de disparar tudo de uma vez.
6. Revise as respostas isError / messages que a Feedance exibe a cada envio, para que ofertas rejeitadas (combinação inválida de categoria e característica, preço fora da faixa, EAN inválido etc.) sejam sinalizadas para correção em vez de desaparecerem silenciosamente.

As orientações da própria eMAG são explícitas sobre a cadência: a Marketplace API permite no máximo 1 requisição a cada 3 segundos e 20 requisições por minuto por conta, e a eMAG recomenda não programar chamadas em horários redondos e fixos (por exemplo, iniciar um lote às 12:04:42 em vez de às 12:00:00), para que as tarefas de muitos vendedores não colidam no mesmo segundo. Dentro desse limite, preço e estoque são os campos que vale a pena atualizar com mais frequência — idealmente sempre que mudarem do seu lado e, no mínimo, várias vezes por dia —, já que um número de estoque desatualizado em um marketplace dinâmico custa diretamente pedidos que você não consegue atender ou sua posição em relação às ofertas concorrentes na mesma página de produto. Uma ressincronização completa do catálogo (novos produtos, descrições, imagens e características atualizadas) com cadência diária é razoável para a maioria dos vendedores; se você usa o Feed Import em vez da API, o arquivo só está tão atualizado quanto a última vez que o módulo Feed Import da eMAG buscou sua URL hospedada, então verifique o intervalo de atualização que você configurou no painel de vendedor.

As rejeições mais comuns documentadas na referência da Marketplace API da eMAG são:

• isError: true com um array messages — o envelope de falha padrão da eMAG; toda requisição deve ser verificada quanto a isso, em vez de ser considerada bem-sucedida só porque retornou HTTP 200.
• Preço inválido (status de validação 11) — ocorre quando uma atualização de sale_price fica fora da faixa min_sale_price/max_sale_price definida no primeiro envio da oferta.
• Validação de EAN/marca/documentação pendente ou rejeitada (status 1-8) — a eMAG submete as novas ofertas às etapas de validação de Marketplace, marca, EAN e documentação antes de aprovar uma oferta (status 9); um código de barras malformado (deve ter de 6 a 14 caracteres numéricos em um formato EAN/UPC/GTIN reconhecido) é uma causa frequente de travamento na etapa de EAN.
• Incompatibilidade entre categoria e característica — enviar uma entrada em characteristics cujo ID não é válido para o category_id da oferta faz com que esse envio seja rejeitado.
• Erros de imagem — imagens acima de 6000x6000 px ou 8 MB, ou em um formato diferente de JPG/JPEG/PNG, são rejeitadas.
• HTTP 429, limite de requisições excedido — retornado quando você ultrapassa 1 requisição/3 segundos ou 20 requisições/minuto, junto com os cabeçalhos X-RateLimit-Limit-3second / X-RateLimit-Remaining-3second, que você pode usar para desacelerar antes de atingir o limite novamente.

• Se um produto já existe no catálogo da eMAG, vincule sua oferta a ele com part_number_key em vez de enviar um produto totalmente novo — isso evita a revalidação e coloca sua oferta no ar mais rápido.
• Defina desde o início limites realistas de min_sale_price/max_sale_price; uma faixa estreita demais faz com que ajustes de preço rotineiros sejam rejeitados depois, e a eMAG só permite defini-los no primeiro envio.
• Acerte o EAN logo na primeira vez — a validação de código de barras é uma das etapas de aprovação mais lentas, e um EAN rejeitado impede que a oferta inteira entre no ar, não apenas aquele campo.
• Preencha todas as características obrigatórias da categoria, e não apenas o mínimo para passar na validação — os filtros do site da eMAG são criados a partir desses valores, e características incompletas reduzem silenciosamente a facilidade com que sua oferta é encontrada na navegação por categorias.
• Agrupe as chamadas product_offer/save na faixa de 10-50 entidades recomendada pela eMAG e desloque o horário de início das suas tarefas para longe de minutos redondos, para evitar colisões no limite de requisições com as tarefas programadas de outros vendedores.
• Trate toda resposta isError: true como algo que exige ação, e não como um detalhe estético — a própria documentação da eMAG observa que alguns envios com falha ainda são parcialmente processados, o que pode deixar um anúncio em estado inconsistente se o erro for ignorado.

A eMAG usa um feed XML ou uma API JSON?
Os dois existem. A Marketplace API usa JSON por meio de requisições POST autenticadas e é o caminho que a Feedance automatiza. A eMAG também oferece uma opção separada de Feed Import, que aceita um arquivo XML ou CSV hospedado, limitado a 100 MB, 100.000 produtos e 150 categorias.

Um único feed pode atender Romênia, Bulgária e Hungria ao mesmo tempo?
Cada país tem sua própria conta de Marketplace e sua própria instância de API/painel de vendedor (emag.ro, emag.bg, emag.hu), então você se conecta a cada uma separadamente, embora o schema e a mecânica sejam os mesmos nos três.

O que acontece se eu exceder o limite de requisições da API da eMAG?
Você recebe uma resposta HTTP 429 com uma mensagem de limite excedido. O limite da eMAG é de 1 requisição a cada 3 segundos e 20 requisições por minuto por conta.

Há algum custo para usar a própria eMAG Marketplace API?
Não — não há taxa separada para o acesso à API. A receita da eMAG vem da comissão por categoria (cerca de 7-25%) cobrada sobre as vendas concluídas, e não da integração ou da atividade de anúncios.

Quantos produtos posso incluir em uma única chamada save da API?
Até 50 entidades por chamada product_offer/save, sendo 10-50 o recomendado para um processamento confiável, com um limite geral de 4000 elementos por chamada.

A Emag é uma plataforma de e-commerce que oferece uma ampla variedade de produtos aos consumidores. Ela foi lançada em 2001, o que a torna um dos marketplaces online mais antigos e consolidados. A Emag tem origem na Romênia e, desde então, expandiu suas operações para outros países da Europa Central e Oriental.

A plataforma oferece aos clientes uma seleção diversificada de produtos, incluindo eletrônicos, eletrodomésticos, moda, beleza, artigos esportivos, itens para casa e jardim e muito mais. Com uma interface amigável e uma ampla gama de produtos, a Emag busca atender às diversas necessidades e preferências de seus clientes.

Uma das principais características da Emag é seu forte foco no atendimento e na satisfação do cliente. A plataforma prioriza uma experiência de compra fluida e confiável, com recursos como métodos de pagamento seguros, serviços de entrega eficientes e uma equipe de suporte ao cliente ágil. Esse compromisso com a satisfação do cliente foi fundamental para conquistar uma base de clientes fiéis ao longo dos anos.

A Emag também firmou parcerias com diversas marcas e vendedores para oferecer aos clientes uma enorme seleção de produtos. Isso ajuda a oferecer aos clientes várias opções e preços competitivos. Além disso, a plataforma frequentemente realiza campanhas promocionais, descontos e ofertas exclusivas para atrair e reter ainda mais clientes.

Nos últimos anos, a Emag ampliou ainda mais seus serviços com o lançamento de recursos adicionais, como o Emag Pay, uma carteira digital que permite aos clientes fazer pagamentos rápidos e seguros, e o Emag Marketplace, que permite que vendedores terceiros anunciem e vendam seus produtos na plataforma.

Como uma plataforma de e-commerce de destaque, a Emag recebeu diversos reconhecimentos e prêmios por sua contribuição ao setor. Seu crescimento e sucesso podem ser atribuídos à dedicação à satisfação do cliente, ao compromisso com a qualidade e à inovação contínua para oferecer uma experiência de compra online fluida.

Em conclusão, a Emag é uma plataforma de e-commerce consolidada, criada na Romênia em 2001. Ela oferece aos clientes uma grande variedade de produtos e se concentra em oferecer um excelente atendimento. O crescimento e a expansão constantes da Emag fizeram dela uma escolha popular para compras online na Europa Central e Oriental.