Odoo Allegro Connector: integração com o mercado polonês

Allegro é líder indiscutível de comércio eletrônico na Polônia, com mais de 21 milhões de compradores registrados e 80% de penetração de mercado entre os compradores on-line poloneses. Qualquer marca ou retalhista que venda para a Polónia deve ter presença Allegro – não é opcional. Para equipes de operações que gerenciam Allegro juntamente com outros canais no Odoo 19 Enterprise, o ECOSIRE Allegro Connector automatiza todo o fluxo de trabalho do vendedor.

Este guia cobre a integração da API Allegro, gerenciamento de ofertas, automação de pedidos, Smart! cumprimento do programa, conformidade com o IVA na Polônia e as especificidades da reconciliação financeira das vendas no Allegro.

Principais conclusões

• API REST Allegro usa OAuth 2.0; registro em apps.allegro.pl
• As ofertas (termo da Allegro para listagens) possuem dados estruturados de produtos do sistema de categorias da Allegro
• A importação do pedido inclui ID do pedido Allegro, detalhes do comprador e preferência de entrega
• Allegro Inteligente! o programa requer envio rápido (máximo de 1 dia útil para o selo Smart!)
• O IVA polaco (padrão de 23%) é obrigatório; taxas reduzidas para livros (5%), alimentos (5-8%)
• Allegro Billing exporta para importação de relatórios de IVA para Odoo automaticamente
• Política de preços da Allegro: preços competitivos monitorados pelo mercado
• Mercados da República Checa e da República Eslovaca disponíveis através da Allegro Lokalnie

---

Visão geral do mercado Allegro

Por que Allegro domina a Polônia:

Allegro não é apenas um mercado – é a principal plataforma de descoberta de varejo da Polônia. Os consumidores iniciam pesquisas de produtos no Allegro, não no Google, para a maioria das categorias de produtos.

Allegro x Amazon na Polônia:

A Amazon entrou na Polônia em 2021, mas não desalojou Allegro. Os consumidores polacos confiam na protecção do comprador da Allegro, Smart! programa de entrega e ecossistema de vendedores locais. Para a maioria das categorias, a Allegro gera de 5 a 10 vezes mais volume de vendas do que a Amazon.pl na Polônia.

---

Configuração da API Allegro

Etapa 1: Registre-se como desenvolvedor Allegro

1. Crie um aplicativo em apps.allegro.pl
2. Escolha o tipo "Aplicativo Web" (para OAuth do lado do servidor)
3. Insira seu URI de redirecionamento: https://your-odoo.com/allegro/oauth/callback
4. Anote seu ID do cliente e Segredo do cliente

Etapa 2: autorização OAuth 2.0

Allegro usa código de autorização de fluxo OAuth (autenticação em nível de usuário):

1. Nas configurações do conector Odoo, clique em Conectar conta Allegro
2. O pop-up OAuth é aberto em allegro.pl
3. Faça login e autorize o conector
4. Token de acesso e token de atualização armazenados automaticamente
5. Os tokens expiram após 12 horas; tokens de atualização duram 30 dias (atualizados automaticamente pelo conector)

Ambiente sandbox:

Allegro fornece um sandbox completo em allegro.pl.allegrosandbox.pl para testes:

• Registre um vendedor de teste em allegrolokalnie.pl/developer/sandbox
• API de sandbox: https://api.allegro.pl.allegrosandbox.pl
• Teste ofertas reais e pedidos simulados antes de ir ao ar

---

Configuração do conector

Navegue até Vendas → Allegro ou Inventário → Allegro Marketplace após a instalação.

Configuração da conta:

Configuração de preferências de entrega:

Allegro utiliza serviços de entrega próprios (Allegro Courier, InPost, DPD, DHL, Poczta Polska). Configure quais serviços você oferece e seus tempos de processamento:

---

Gerenciamento de ofertas

No Allegro, as listagens são chamadas de “ofertas”. Cada oferta possui um Allegro ID exclusivo e pode ser listada como:

• Compre agora (preço fixo): equivalente ao Compre agora de outros mercados
• Leilão: os lances começam com um preço definido
• Compre agora + Leilão: formato combinado

O conector gerencia principalmente ofertas Comprar Agora (mais comuns para vendedores empresariais).

Criando ofertas de produtos Odoo:

1. Abra o produto → guia Allegro → Criar oferta
2. Configure os campos de oferta:

• Título da oferta: até 50 caracteres (conciso e rico em palavras-chave)
• Categoria: navegue na taxonomia do Allegro
• Parâmetros: atributos obrigatórios específicos da categoria
• Descrição: HTML permitido, idioma polonês principal
• Imagens: até 8 imagens, mínimo 600×600 pixels
• Preço: PLN (incluindo IVA)
• Quantidade: estoque disponível
• Condição: Novo, Usado (com subcondição)
• Configurações de entrega: quais métodos de entrega oferecidos, grátis/pago
• Pagamento: Allegro Pay, transferência bancária
• Devoluções: direito de devolução de 14 dias (mínimo legal na Polónia) ou prorrogado

Parâmetros da categoria Allegro:

Cada categoria Allegro possui parâmetros específicos exigidos. O conector baixa os parâmetros disponíveis por categoria e cria um formulário de configuração guiado. Exemplo para "Laptops":

Required Parameters:
- Processor Brand (Intel, AMD)
- Processor Model (Core i7-13700H, etc.)
- RAM (GB)
- Storage (GB)
- Screen Size (inches)
- Operating System
- Graphics Card

Optional Parameters:
- Battery Life (hours)
- Weight (kg)
- Bluetooth version
- USB ports count

Mapeie atributos do produto Odoo para parâmetros Allegro na tabela de mapeamento de parâmetros do conector.

---

##Allegro Inteligente! Programa

Alegro Inteligente! é um programa de assinatura (semelhante ao Amazon Prime) que oferece entrega gratuita em ofertas qualificadas. Inteligente! os itens exibem um emblema de destaque e têm uma classificação mais elevada nos resultados de pesquisa.

Inteligente! requisitos de elegibilidade:

• Prazo máximo de envio: 1 dia útil
• Entrega via transportadora qualificada para Smart! (Allegro Courier, InPost, DPD, DHL)
• Pontuação mínima de feedback positivo
• Nenhuma sanção ativa em sua conta

Configurando o Smart! no conector:

1. Ative o Smart! nas configurações do mercado
2. Defina o horário de envio para "Mesmo dia" ou "Dia seguinte" em ofertas qualificadas
3. Configure métodos de entrega elegíveis para Smart!
4. O conector marca automaticamente as ofertas qualificadas com Smart! distintivo

Inteligente! impacto operacional:

Com Inteligente! habilitado:

• Pedidos feitos antes do horário limite (por exemplo, 14h) devem ser enviados no mesmo dia
• Pedidos feitos após o horário limite de envio no próximo dia útil
• O conector aplica o cálculo da data de envio com base no horário limite e no horário de colocação do pedido
• O envio tardio aciona o Smart! penalidade (perda do crachá por reincidência de violações)

---

Gerenciamento de pedidos

Importação e processamento de pedidos:

1. O comprador conclui a compra no Allegro
2. O conector pesquisa a API Allegro Orders a cada 15 minutos
3. Pedido importado para Odoo com todos os detalhes necessários
4. Pedido de venda criado e confirmado automaticamente
5. Pedido de entrega criado no inventário Odoo
6. O armazém atende o pedido usando uma transportadora qualificada para Smart!
7. Número de rastreamento inserido no Odoo → conector envia para Allegro
8. Allegro notifica o comprador com link de rastreamento

Mapeamento de dados do pedido:

Atendimento do Allegro InPost Parcel Locker:

O InPost é extremamente popular na Polônia (mais de 13.000 armários de pacotes em todo o país). Para pedidos InPost:

1. Gere o rótulo InPost por meio da integração da API do rótulo do conector
2. Imprima e anexe ao pacote
3. Deixe o pacote no armário de pacotes InPost mais próximo ou no ponto de coleta de correio
4. Rastreamento InPost carregado automaticamente para Allegro

---

Conformidade com o IVA na Polônia

Taxas de IVA na Polónia:

Requisitos de fatura de IVA Allegro:

Na Polónia, os vendedores devem emitir faturas com IVA (IVA faktury) aos compradores empresariais. O conector lida com:

1. Detectar quando um comprador fornece um NIP (número fiscal polonês) — comprador empresarial
2. Geração de uma fatura de IVA com NIP do vendedor e do comprador, número da fatura, discriminação fiscal
3. Lançamento da fatura no módulo contábil do Odoo
4. Disponibilização da fatura ao comprador (via portal Odoo ou email)

Relatórios JPK_V7M:

A Polónia exige relatórios mensais de IVA JPK_V7M. A localização fiscal polonesa da Odoo gera este relatório a partir de suas faturas publicadas e faturas de compra. O conector garante que as vendas do Allegro sejam marcadas corretamente para inclusão em JPK.

OSS (One Stop Shop) para vendas entre a UE:

Se você é um vendedor polonês que envia para compradores da UE fora da Polônia:

• Vendas abaixo do limite anual de 10.000 euros: relatório através do IVA polaco (padrão)
• Vendas acima do limite: registre-se no EU OSS e relate no país de cada comprador
• O conector marca as vendas entre a UE com posições fiscais apropriadas para rastreamento de OSS

---

Allegro Finanças e Reconciliação

Allegro Pagamento:

Desde 2021, a Allegro opera sua própria plataforma de pagamento (Allegro Pay). Os vendedores recebem:

• Pagamentos do Allegro Pay coletados dos compradores
• Remessa do Allegro (menos taxas) semanalmente

Estrutura de taxas do Allegro:

Fluxo de trabalho de reconciliação:

1. Baixe o CSV de faturamento do Allegro na Zona do Vendedor → Faturamento
2. Importe via Allegro → Finanças → Faturamento de Importação
3. O Connector cria entradas de diário Odoo:

• Débito: Allegro a Receber / Crédito: Receita de Vendas
• Débito: Despesa de Comissão Allegro / Crédito: Allegro a Pagar

4. Quando a transferência semanal chega ao banco: reconcilie com o diário Allegro Pay
5. Fim do mês: gerar relatório de vendas Allegro para declaração de IVA

---

Allegro Localnie (República Tcheca e Eslováquia)

Allegro expandiu-se para a República Tcheca e Eslováquia como parte da expansão da CEE (Europa Central e Oriental). O conector oferece suporte a estes mercados adicionais:

• Allegro.cz: mercado tcheco, moeda CZK, IVA tcheco (21%)
• Allegro.sk: mercado eslovaco, moeda EUR, IVA eslovaco (20%)

Configure mercados adicionais no conector com credenciais de API separadas (as contas Checa e Eslovaca Allegro exigem registro de vendedor separado).

---

Perguntas frequentes

É possível vender na Allegro como uma empresa estrangeira (não polaca)?

Sim. Allegro aceita vendedores de países da UE. Os vendedores não polacos da UE devem ter um número de IVA da UE e cumprir as obrigações do IVA polaco (registar-se para obter o IVA polaco ou utilizar OSS acima do limite). Os vendedores fora da UE enfrentam requisitos adicionais, incluindo um representante fiscal polaco. O conector trata do IVA tanto para vendedores registados na Polónia como para vendedores estrangeiros com configuração de posição fiscal adequada.

Como a resolução de disputas da Allegro afeta minha integração com o Odoo?

A proteção ao comprador da Allegro permite disputas no prazo de 20 dias após a compra. Se um comprador abrir uma disputa, a Allegro mediará. O conector importa casos de disputa como tickets de suporte Odoo, vinculados à ordem de venda relevante. A equipe de operações responde por meio do Odoo; a resolução é confirmada através do portal do vendedor Allegro. Disputas resolvidas (reembolso ou vitórias do vendedor) atualizam o status do pedido Odoo de acordo.

Quais são as regras de duração e renovação da listagem do Allegro?

As ofertas Compre agora podem ser executadas indefinidamente (equivalente a Good Till Canceled). As ofertas de leilão duram 3, 5, 7 ou 10 dias. O conector gerencia a renovação de ofertas automaticamente para ofertas Comprar Agora — se uma oferta terminar devido ao estoque zero, ela será reiniciada quando o estoque for reabastecido. A renovação da oferta para leilões requer ação manual ou configuração de recadastramento automático.

Posso usar o programa One Fulfillment da Allegro (semelhante ao FBA) por meio do conector?

One Fulfillment é o serviço de armazenamento e atendimento da Allegro (lançado em 2023). O conector oferece suporte a remessas de entrada One Fulfillment, rastreamento de estoque no local virtual "Allegro One Fulfillment" do Odoo e validação automática de pedidos atendidos. Uma inscrição no Fulfillment é gerenciada diretamente na Seller Zone; o conector cuida da integração operacional.

Como o conector lida com as campanhas promocionais da Allegro (Super Week, Black Friday)?

A Allegro realiza grandes eventos promocionais onde os vendedores participantes observam picos de tráfego de 3 a 10 vezes. O recurso de campanha promocional do conector permite pré-configurar reduções de preço para campanhas específicas com datas de início/término. Ative o "Modo Campanha" antes de grandes eventos para aumentar a frequência de sincronização para cada 5 minutos e ativar buffers de inventário extras.

---

Próximas etapas

O domínio da Allegro na Polónia torna-a um canal de vendas inegociável para qualquer marca dirigida aos consumidores da Europa Central. Mas a excelência operacional no Allegro — Smart! conformidade, exatidão do IVA, atendimento ao cliente polonês — exigem sistemas desenvolvidos especificamente para o mercado.

Obtenha o conector ECOSIRE Allegro para Odoo 19 →

Nossa equipe de implementação inclui especialistas do mercado polonês com experiência direta em vendas Allegro. Configuraremos seu conector, configuraremos o IVA polonês corretamente e treinaremos sua equipe de operações no Smart! fluxos de trabalho de atendimento. Entre em contato conosco para iniciar sua integração Allegro.