Conector Odoo Allegro: integración del mercado polaco

Allegro es el líder indiscutible del comercio electrónico de Polonia con más de 21 millones de compradores registrados y una penetración de mercado del 80 % entre los compradores online polacos. Cualquier marca o minorista que venda en Polonia debe tener presencia en Allegro; no es opcional. Para los equipos de operaciones que administran Allegro junto con otros canales en Odoo 19 Enterprise, ECOSIRE Allegro Connector automatiza todo el flujo de trabajo del vendedor.

Esta guía cubre la integración de Allegro API, gestión de ofertas, automatización de pedidos, ¡Smart! cumplimiento del programa, cumplimiento del IVA polaco y los detalles de conciliación financiera de la venta en Allegro.

Conclusiones clave

• La API REST de Allegro utiliza OAuth 2.0; registro en apps.allegro.pl
• Las ofertas (término de Allegro para listados) tienen datos de productos estructurados del sistema de categorías de Allegro.
• La importación de pedidos incluye el ID del pedido de Allegro, los detalles del comprador y la preferencia de entrega.
• ¡Allegro inteligente! El programa requiere envío rápido (máximo 1 día hábil para la insignia Smart!)
• El IVA polaco (23% estándar) es obligatorio; tarifas reducidas para libros (5%), comida (5-8%)
• Allegro Billing exporta para la importación de informes de IVA a Odoo automáticamente
• La política de precios de Allegro: precios competitivos controlados por el mercado
• Mercados de República Checa y República Eslovaca disponibles a través de Allegro Lokalnie

---

Descripción general del mercado Allegro

Por qué Allegro domina Polonia:

Allegro no es sólo un mercado: es la principal plataforma de descubrimiento minorista de Polonia. Los consumidores inician búsquedas de productos en Allegro, no en Google, para la mayoría de las categorías de productos.

Allegro vs. Amazon en Polonia:

Amazon entró en Polonia en 2021 pero no ha desalojado a Allegro. Los consumidores polacos confían en la protección del comprador de Allegro, Smart! programa de entrega y ecosistema de vendedores locales. Para la mayoría de las categorías, Allegro genera entre 5 y 10 veces más volumen de ventas que Amazon.pl en Polonia.

---

Configuración de la API de Allegro

Paso 1: Regístrese como desarrollador de Allegro

1. Cree una aplicación en apps.allegro.pl
2. Elija el tipo "Aplicación web" (para OAuth del lado del servidor)
3. Ingrese su URI de redireccionamiento: https://your-odoo.com/allegro/oauth/callback
4. Anote su ID de cliente y su Secreto de cliente

Paso 2: autorización de OAuth 2.0

Allegro utiliza el código de autorización flujo OAuth (autenticación a nivel de usuario):

1. En la configuración del conector Odoo, haga clic en Conectar cuenta Allegro
2. Se abre la ventana emergente OAuth en allegro.pl
3. Inicia sesión y autoriza el conector.
4. Token de acceso y token de actualización almacenados automáticamente
5. Los tokens caducan después de 12 horas; los tokens de actualización duran 30 días (actualizados automáticamente por conector)

Entorno de zona de pruebas:

Allegro proporciona un entorno de pruebas completo en allegro.pl.allegrosandbox.pl para realizar pruebas:

• Registre un vendedor de prueba en allegrolokalnie.pl/developer/sandbox
• API de zona de pruebas: https://api.allegro.pl.allegrosandbox.pl
• Pruebe con ofertas reales y pedidos simulados antes de publicarlo.

---

Configuración del conector

Navegue a Ventas → Allegro o Inventario → Allegro Marketplace después de la instalación.

Configuración de cuenta:

Configuración de preferencias de entrega:

Allegro utiliza sus propios servicios de entrega (Allegro Courier, InPost, DPD, DHL, Poczta Polska). Configura qué servicios ofreces y tus tiempos de manipulación:

---

Gestión de ofertas

En Allegro, los listados se denominan "ofertas". Cada oferta tiene un ID de Allegro único y puede enumerarse como:

• Comprar ahora (precio fijo): equivalente al Comprar ahora de otros mercados
• Subasta: la puja comienza a un precio fijo
• Comprar Ahora + Subasta: formato combinado

El conector gestiona principalmente las ofertas Comprar ahora (más comunes para vendedores comerciales).

Creación de ofertas a partir de productos Odoo:

1. Abra el producto → pestaña Allegro → Crear oferta
2. Configurar campos de oferta:

• Título de la oferta: hasta 50 caracteres (conciso, rico en palabras clave)
• Categoría: explora la taxonomía de Allegro
• Parámetros: atributos requeridos específicos de la categoría
• Descripción: HTML permitido, idioma principal en polaco
• Imágenes: hasta 8 imágenes, mínimo 600×600 píxeles
• Precio: PLN (IVA incluido)
• Cantidad: stock disponible
• Condición: Nuevo, Usado (con subcondición)
• Configuración de entrega: qué métodos de entrega se ofrecen, gratuitos/de pago
• Pago: Allegro Pay, transferencia bancaria
• Devoluciones: derecho de devolución de 14 días (mínimo legal en Polonia) o ampliado

Parámetros de categoría Allegro:

Cada categoría de Allegro tiene parámetros requeridos específicos. El conector descarga los parámetros disponibles por categoría y crea un formulario de configuración guiada. Ejemplo de "portátiles":

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

Asigne los atributos del producto Odoo a los parámetros de Allegro en la tabla de asignación de parámetros del conector.

---

¡Alegro inteligente! Programa

Allegro Inteligente! es un programa de suscripción (similar a Amazon Prime) que ofrece entrega gratuita en ofertas elegibles. ¡Elegante! Los artículos muestran una insignia destacada y tienen una clasificación más alta en los resultados de búsqueda.

¡Elegante! requisitos de elegibilidad:

• Tiempo máximo de envío: 1 día hábil
• Entrega a través de un transportista elegible para Smart! (Allegro Courier, InPost, DPD, DHL)
• Puntuación mínima de comentarios positivos
• No hay sanciones activas en su cuenta.

¡Configuración inteligente! en el conector:

1. ¡Habilite Inteligente! en la configuración del mercado
2. Establezca la hora de envío en "Mismo día" o "Día siguiente" en ofertas elegibles.
3. Configure métodos de entrega elegibles para Smart!
4. ¡El conector marca automáticamente las ofertas elegibles con Smart! insignia

¡Elegante! impacto operativo:

¡Con Inteligente! habilitado:

• Los pedidos realizados antes de la hora límite (por ejemplo, 14:00) deben enviarse el mismo día
• Los pedidos realizados después del corte de envío el siguiente día hábil
• El conector aplica el cálculo de la fecha de envío en función de la hora límite y la hora de realización del pedido.
• ¡El envío tardío activa Smart! penalización (pérdida de la tarjeta por reincidencia)

---

Gestión de pedidos

Importación y procesamiento de pedidos:

1. El comprador completa la compra en Allegro
2. Connector sondea la API de Allegro Orders cada 15 minutos
3. Pedido importado a Odoo con todos los detalles requeridos
4. Orden de venta creada y confirmada automáticamente
5. Orden de entrega creada en el inventario de Odoo
6. El almacén cumple el pedido mediante un transportista elegible para Smart!
7. Número de seguimiento ingresado en Odoo → el conector envía a Allegro
8. Allegro notifica al comprador con un enlace de seguimiento

Mapeo de datos del pedido:

Cumplimiento de Allegro InPost Parcel Locker:

InPost es extremadamente popular en Polonia (más de 13.000 casilleros para paquetes en todo el país). Para pedidos InPost:

1. Genere una etiqueta InPost a través de la integración API de etiquetas del conector
2. Imprima y adjunte al paquete
3. Deje el paquete en el casillero de paquetes InPost o en el punto de recogida del servicio de mensajería más cercano.
4. Seguimiento InPost cargado automáticamente en Allegro

---

Cumplimiento del IVA polaco

Tasas de IVA en Polonia:

Requisitos de factura con IVA de Allegro:

En Polonia, los vendedores deben emitir facturas con IVA (IVA faktury) a los compradores comerciales. El conector maneja:

1. Detectar cuando un comprador proporciona un NIP (número fiscal polaco): comprador empresarial
2. Generar una factura con IVA con NIP de vendedor y comprador, número de factura, desglose de impuestos
3. Publicar la factura en el módulo de contabilidad de Odoo
4. Poner la factura a disposición del comprador (a través del portal Odoo o correo electrónico)

Informe JPK_V7M:

Polonia exige informes de IVA mensuales de JPK_V7M. La localización fiscal polaca de Odoo genera este informe a partir de sus facturas publicadas y facturas de compra. El conector garantiza que las ventas de Allegro estén etiquetadas correctamente para la inclusión en JPK.

OSS (One Stop Shop) para ventas en toda la UE:

Si eres un vendedor polaco que realiza envíos a compradores de la UE fuera de Polonia:

• Ventas por debajo del umbral anual de 10.000 €: informe a través del IVA polaco (estándar)
• Ventas por encima del umbral: registrarse en EU OSS e informar en el país de cada comprador
• El conector marca las ventas entre la UE con posiciones fiscales apropiadas para el seguimiento de OSS

---

Allegro Finanzas y Reconciliación

Pago Allegro:

Desde 2021, Allegro opera su propia plataforma de pago (Allegro Pay). Los vendedores reciben:

• Pagos de Allegro Pay cobrados a los compradores
• Remesas de Allegro (menos tarifas) semanales

Estructura de tarifas de Allegro:

Flujo de trabajo de conciliación:

1. Descargue el CSV de facturación de Allegro desde la Zona de vendedores → Facturación
2. Importar a través de Allegro → Finanzas → Importar facturación
3. Connector crea entradas de diario de Odoo:

• Débito: Allegro Por Cobrar / Crédito: Ingresos por Ventas
• Débito: Allegro Comisión Gasto / Crédito: Allegro Por Pagar

4. Cuando la transferencia semanal llegue al banco: concilie con el diario Allegro Pay
5. Fin de mes: generar informe de ventas de Allegro para declaración de IVA

---

Allegro Localnie (República Checa y Eslovaquia)

Allegro se expandió a la República Checa y Eslovaquia como parte de la expansión de CEE (Europa Central y del Este). El conector admite estos mercados adicionales:

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

Configure mercados adicionales en el conector con credenciales API independientes (las cuentas checas y eslovacas de Allegro requieren un registro de vendedor por separado).

---

Preguntas frecuentes

¿Es posible vender Allegro como empresa extranjera (no polaca)?

Sí. Allegro acepta vendedores de países de la UE. Los vendedores de la UE no polacos deben tener un número de IVA de la UE y cumplir con las obligaciones del IVA polaco (ya sea registrarse para el IVA polaco o utilizar OSS por encima del umbral). Los vendedores no pertenecientes a la UE se enfrentan a requisitos adicionales, incluido un representante fiscal polaco. El conector maneja el IVA tanto para vendedores registrados en Polonia como para vendedores extranjeros con la configuración de posición fiscal adecuada.

¿Cómo afecta la resolución de disputas de Allegro a mi integración con Odoo?

La protección del comprador de Allegro permite disputas dentro de los 20 días posteriores a la compra. Si un comprador abre una disputa, Allegro media. El conector importa casos de disputa como tickets de soporte de Odoo, vinculados a la orden de venta correspondiente. El personal de operaciones responde a través de Odoo; La resolución se confirma a través del portal de vendedores de Allegro. Las disputas resueltas (reembolso o victoria del vendedor) actualizan el estado del pedido de Odoo en consecuencia.

¿Cuáles son las reglas de renovación y duración del listado de Allegro?

Las ofertas Comprar ahora pueden ejecutarse indefinidamente (equivalente a válida hasta cancelar). Las ofertas de subasta tienen una duración de 3, 5, 7 o 10 días. El conector gestiona la renovación de ofertas automáticamente para las ofertas Comprar ahora: si una oferta finaliza debido a que no hay existencias, se reinicia cuando se repone el inventario. La renovación de ofertas para subastas requiere una acción manual o una configuración de puesta en venta automática.

¿Puedo usar el programa One Fulfilment de Allegro (similar a Logística de Amazon) a través del conector?

One Fulfilment es el servicio de almacenamiento y cumplimiento de Allegro (lanzado en 2023). El conector admite envíos entrantes de One Fulfilment, seguimiento de inventario en la ubicación virtual "Allegro One Fulfilment" de Odoo y validación automática de pedidos cumplidos. La inscripción de One Fulfilment se gestiona directamente en Seller Zone; el conector maneja la integración operativa.

¿Cómo maneja el conector las campañas promocionales de Allegro (Super Week, Black Friday)?

Allegro organiza importantes eventos promocionales en los que los vendedores participantes ven picos de tráfico de entre 3 y 10 veces. La función de campaña promocional del conector le permite preconfigurar reducciones de precios para campañas específicas con fechas de inicio/finalización. Habilite el "Modo de campaña" antes de eventos importantes para aumentar la frecuencia de sincronización a cada 5 minutos y activar buffers de inventario adicionales.

---

Próximos pasos

El dominio de Allegro en Polonia lo convierte en un canal de ventas no negociable para cualquier marca dirigida a los consumidores de Europa Central. Pero la excelencia operativa en Allegro: ¡inteligente! cumplimiento, precisión del IVA, servicio al cliente polaco: requiere sistemas diseñados específicamente para el mercado.

Obtenga el conector ECOSIRE Allegro para Odoo 19 →

Nuestro equipo de implementación incluye especialistas del mercado polaco con experiencia directa como vendedor de Allegro. Configuraremos su conector, configuraremos el IVA polaco correctamente y capacitaremos a su equipo de operaciones en Smart. flujos de trabajo de cumplimiento. Contáctenos para comenzar su integración Allegro.