Integración de Shop Apotheke Marketplace en M2E Cloud

Esta guía le explica cómo configurar Shop Apotheke con M2E Cloud y cómo gestionar la integración en el día a día.

En primer lugar, complete los pasos necesarios en Shop Apotheke y, una vez que la conexión esté activa, configure los ajustes clave en M2E Cloud.

ℹ️ Shop Apotheke es un marketplace basado en Mirakl. La mayoría de las reglas que se describen a continuación también se aplican a otros marketplaces Mirakl compatibles con M2E Cloud.

¿Qué ocurre fuera de M2E Cloud? #

Shop Apotheke es una farmacia online europea y un marketplace centrado en la salud. Conecta marcas y comerciantes con clientes que compran online productos sanitarios, de bienestar y de salud cotidiana.

Shop Apotheke opera a través de varias tiendas localizadas. Cada tienda se dirige a un país específico:

• shop-apotheke.com (Alemania)
• shop-apotheke.at (Austria)
• farmaline.be (Bélgica)
• redcare.it (Italia)

Shop Apotheke se basa en Mirakl. Esto significa que cumple con los estándares de Mirakl para validar y procesar los datos del mercado. Estas reglas las define el mercado, no M2E Cloud.

Esto incluye cómo Shop Apotheke gestiona:

• contenido del producto (títulos, imágenes, descripciones, atributos)
• ofertas y precios (precios, IVA, descuentos)
• pedidos y envíos (importación de pedidos, confirmación de envíos, seguimiento)

ℹ️ Nota: Shop Apotheke no admite canales de venta. Si desea vender en más de un país, debe firmar un contrato independiente y completar el proceso de incorporación para cada tienda.

Para quién es adecuada Shop Apotheke #

Shop Apotheke es adecuada para comerciantes que venden productos relacionados con la salud con identificadores estables y datos de productos claros.

Las categorías típicas para las que es adecuada incluyen:

• Productos para la salud y el bienestar
• Productos de venta libre y suplementos
• Cuidado personal e higiene
• Dispositivos médicos y óptica
• Productos relacionados con la salud para bebés, mascotas y el hogar

ℹ️ Los productos farmacéuticos y regulados pueden requerir aprobaciones y documentación adicionales. El acceso a las categorías y los permisos de venta los define Shop Apotheke, no M2E Cloud.

Solicitar una cuenta de vendedor en Shop Apotheke #

Antes de poder configurar Shop Apotheke en M2E Cloud, debe solicitar una cuenta de vendedor directamente a Shop Apotheke.

Puede iniciar el proceso de registro de la siguiente manera:

• Póngase en contacto con Shop Apotheke por correo electrónico y solicite su incorporación

Durante el proceso de registro, Shop Apotheke puede solicitar:

• Datos de la empresa e información sobre el IVA
• Categorías de productos que planea vender
• Una muestra del feed de productos para su revisión

En algunos casos, Shop Apotheke revisa tu feed de productos antes de crear tu tienda. Esto les ayuda a validar si tu catálogo cumple con sus normas y el alcance de sus categorías.

La aprobación de la cuenta la gestiona Shop Apotheke. Los plazos pueden variar.

Una vez que tu cuenta haya sido aprobada, recibirás acceso al administrador de vendedores de Mirakl. Este acceso es necesario para continuar, ya que necesitas las credenciales de Mirakl para conectar Shop Apotheke a M2E Cloud.

ℹ️ Shop Apotheke no cobra cuota de alta. Se paga una cuota mensual fija de 39,00 €. También se paga una comisión que depende de la categoría del producto. La tarifa exacta se acuerda con el marketplace durante el registro del vendedor.

¿Qué ocurre dentro de M2E Cloud? #

Una vez aprobada su cuenta de vendedor en Shop Apotheke, M2E Cloud se convierte en el sistema para gestionar sus operaciones diarias en el mercado. Actúa como capa de control entre su tienda y el mercado Shop Apotheke.

Con M2E Cloud, gestionas Shop Apotheke desde un solo lugar. La plataforma se encarga del intercambio, la validación y la sincronización de datos, por lo que no es necesario que trabajes directamente en el back-end de Mirakl para las tareas rutinarias.

Con M2E Cloud, puedes:

• Conecta Shop Apotheke a través de la API de Mirakl
• Exporta el contenido de los productos de tu tienda al marketplace
• Asigna categorías y atributos necesarios
• Gestiona precios, IVA y descuentos
• Sincroniza pedidos, niveles de stock y envíos

Todas las actualizaciones siguen reglas predefinidas y se ejecutan automáticamente. Esto reduce el trabajo manual y mantiene su tienda y los marketplaces en sincronía.

Requisitos antes de comenzar #

Antes de conectar Shop Apotheke a M2E Cloud, asegúrese de que se cumplan todos los requisitos que se indican a continuación. Si falta alguno de ellos, se bloquearán las exportaciones o se detendrá la sincronía.

ℹ️ Asegúrese de que su tienda utilice una plataforma compatible, como Shopify, BigCommerce, PrestaShop, etc. Todas las aplicaciones de M2E están disponibles en los anuncios oficiales de aplicaciones. Por ejemplo, para utilizar la integración de Hygi.de para Shopify de M2E, es necesario instalar primero la aplicación de Shopify.

Debe tener:

• Una cuenta de vendedor aprobada en Shop Apotheke
• Credenciales válidas de la API de Mirakl
• Registro del IVA
• Precios de los productos disponibles en EUR
• Códigos EAN o GTIN válidos para todos los productos

También se aplican requisitos lingüísticos. El contenido del producto debe proporcionarse en alemán o italiano, dependiendo de la tienda en la que se venda.

En casos específicos pueden aplicarse requisitos adicionales:

• Los productos eléctricos y electrónicos requieren datos WEEE o EPR
• Los productos regulados y relacionados con la farmacia pueden requerir identificadores y aprobaciones adicionales

Conectar Shop Apotheke a M2E Cloud #

Shop Apotheke es un marketplace basado en Mirakl que se conecta a M2E Cloud a través de una API.

Para iniciar la conexión, necesitas acceso a tu panel de administración de vendedor de Mirakl y una clave API válida.

Pasos para la conexión:

1. En M2E Cloud, abre Conectar cuenta de Mirakl.
2. En la sección Seleccionar mercado, elige Shop Apotheke (utiliza el campo Buscar marketplaces para encontrarlo rápidamente).
3. Inicia sesión en tu panel de administración de vendedor de Mirakl y genera o copia tu clave API.
4. De vuelta en M2E Cloud, pega la clave en el campo Clave API.
5. Introduce tu ID de tienda si gestionas varias tiendas.
6. Haz clic en Conectar.

Tras el envío, M2E Cloud valida automáticamente las credenciales. Una vez que la validación se haya realizado con éxito, se podrán sincronizar los datos de los productos, las ofertas, los pedidos y los envíos.

ℹ️ Consulta las instrucciones completas para la configuración de M2E Mirakl en esta guía.

Entre los problemas de conexión más comunes se incluyen:

• Utilizar una clave API incorrecta o caducada
• Falta de permisos de API en Mirakl
• Intentar conectarse antes de que la cuenta de Shop Apotheke haya sido aprobada por completo

ℹ️ Si más adelante regeneras tu clave API en Mirakl, deberás actualizarla en M2E Cloud. De lo contrario, la sincronización se detendrá.

Una vez conectado: ¿qué ocurre a continuación? #

Una vez que la conexión está activa, se configura el comportamiento de Shop Apotheke dentro de M2E Cloud. En esta sección se describen los principales pasos operativos que se deben seguir para preparar los anuncios y gestionar la sincronización continua.

1. Listar nuevos productos en Shop Apotheke #

Seleccione los productos que desea vender y expórtelos a Shop Apotheke como nuevos anuncios de productos.

Durante la exportación, M2E Cloud puede enviar:

• Contenido del producto, como títulos, imágenes y atributos
• Ofertas de productos, como precio, IVA y disponibilidad

Este comportamiento se controla mediante el atributo Estrategia de exportación. A alto nivel, define si M2E Cloud exporta el contenido completo del producto o solo ofrece datos.

✅ Utilice Políticas de M2E Cloud para controlar qué datos se sincronizan.

2. Vincule los anuncios existentes en los marketplaces con los productos de la tienda #

Si sus productos ya existen en Shop Apotheke y utilizan los mismos SKU que su tienda, M2E Cloud puede vincularlos automáticamente.

Si los SKU no coinciden, puede vincular los anuncios manualmente utilizando un archivo CSV. La vinculación es necesaria para la sincronización. Le indica a M2E Cloud qué tienda controla el precio, el stock y el procesamiento de pedidos para cada anuncio del marketplace.

3. Categorías del mapa y atributos requeridos #

El mapa de categorías es obligatorio. Cada producto debe asignarse a una categoría de Shop Apotheke antes de poder exportarse.

Este paso abarca:

• Seleccionar la categoría correcta de Shop Apotheke
• Elegir los atributos de contenido, como las descripciones y características de los productos
• Crear un mapa de atributos, como los campos relacionados con el IVA y los precios

Una vez mapeados, M2E Cloud utiliza estos mapas para sincronizar los datos de acuerdo con las políticas activas.

✅ Para saber cómo se transfieren los datos entre sistemas, consulte la guía de la política de sincronización.

4. Configurar las reglas de precios y divisas #

Todos los precios enviados a Shop Apotheke deben estar en EUR. El IVA es obligatorio y debe definirse por producto.

El comportamiento de los precios se gestiona a través de las políticas de venta en M2E Cloud. Estas políticas controlan cómo se aplican los precios base, los descuentos y las reglas de cantidad.

Puede crear varias políticas de venta para gestionar diferentes grupos de productos, reglas de precios o mercados.

5. Configure los ajustes de los pedidos y el mapa de estados #

Las políticas de pedidos definen cómo se gestionan los pedidos de Shop Apotheke dentro de M2E Cloud y su tienda.

Esto incluye:

• Cuando se importan los pedidos
• Cómo Shop Apotheke asigna los estados de los pedidos a los estados de la tienda
• Cómo se envían las confirmaciones de envío a los marketplaces

Una asignación correcta evita conflictos de estado y mantiene la coherencia de los datos de los pedidos.

6. Configure las reglas de envío, la entrega y la gestión de facturas #

El comportamiento del envío se controla a través de las políticas de envío.

Para Shop Apotheke, debe proporcionar un código de seguimiento y una URL de seguimiento para todos los envíos. La asignación de transportistas es opcional, pero recomendable, ya que mejora la visibilidad del seguimiento en los marketplaces.

Aquí puede configurar:

• Transportistas y métodos de envío disponibles
• Cómo se confirman los envíos
• Cómo se sincronizan los números de seguimiento

7. Supervisar los anuncios y resolver problemas #

Tras la configuración, puede supervisar el comportamiento de los anuncios directamente en M2E Cloud.

En la página Anuncios, puede:

• Comprueba el estado de la exportación y la validación
• Revisa los comentarios y los errores de los marketplaces
• Soluciona los problemas de mapa, precios o contenido sin desactivar el canal

Esto le permite mantener los anuncios activos y resolver los problemas rápidamente.

💡 Consulte la documentación de M2E para comprender cómo funcionan la gestión de anuncios y pedidos.

¿Qué ocurre en el back-end del marketplace? #

Una vez exportados los productos y las ofertas desde M2E Cloud, toda la validación y el procesamiento finales se realizan por parte de Shop Apotheke. Estas reglas son aplicadas por el marketplace a través de Mirakl y no pueden modificarse en M2E Cloud.

Comprender estas limitaciones ayuda a evitar rechazos silenciosos y retrasos en la publicación de los anuncios.

Funciones del marketplace de Shop Apotheke #

Shop Apotheke admite un conjunto definido de funciones del marketplace Mirakl.

Compatible

• Contenido del producto
• Ofertas de productos
• Pedidos
• Cancelaciones del comerciante
• Devoluciones del comerciante
• Mapa de transportistas
• Formato HTML
• Varias ubicaciones de stock
• Paquetes
• Carga de facturas
• Liquidaciones

No compatible

• Relaciones automáticas
• Variantes de productos (tamaño o color)
• Productos reacondicionados
• Revisión de precios
• Cancelaciones en los marketplaces
• Devoluciones en los marketplaces
• Envíos
• Servicios de logística en los marketplaces
• Canales de venta

ℹ️ Todas las tiendas de cada país siguen las mismas características básicas, pero las normas de incorporación pueden variar.

Requisitos del producto y de la oferta #

Para publicar productos correctamente, todos los campos obligatorios deben cumplir las normas de validación de Shop Apotheke y Mirakl.

Contenido del producto (obligatorio)

Cada producto debe incluir los siguientes datos:

• EAN o GTIN. Se utiliza como identificador principal del producto. Los códigos no válidos o que faltan bloquean el anuncio.
• Título del producto
  • Solo texto sin formato
  • Longitud máxima: 100 caracteres
  • No se permiten cantidades ni etiquetas HTML.
• Imagen principal
  • Fondo blanco
  • Formato cuadrado
  • Formatos compatibles: JPG, PNG, WEBP
  • Resolución mínima: 450 × 450 px. Resolución recomendada: 1000 × 1000 px
  • Tamaño máximo del archivo: 5 MB.
• Marca. Debe coincidir con la marca real del producto.
• Cantidad y unidad
  • La unidad debe seleccionarse entre valores fijos, como g, ml o l
  • La cantidad admite hasta tres valores separados por una «x».
• Atributos específicos de la categoría. Los campos obligatorios dependen de la categoría seleccionada y deben asignarse correctamente.

Contenido del producto (opcional)

Puede mejorar la calidad del anuncio proporcionando datos adicionales:

• Imágenes adicionales
• Descripciones largas y cortas
• Características del producto e instrucciones de uso
• Variante utilizando un código de grupo
• Campos normativos como PZN o WEEE, cuando corresponda

Los campos opcionales también se validan. Los valores incorrectos pueden bloquear las exportaciones.

Ofertas, precios y normas sobre el IVA #

Los precios y los impuestos se rigen por las normas de Mirakl y deben configurarse correctamente.

• El IVA es obligatorio. Cada producto debe incluir un tipo de IVA válido.
• Moneda. Shop Apotheke solo acepta euros.

Descuentos y promociones

Shop Apotheke es compatible con la lógica de descuentos de Mirakl.

• La fijación de precios v1 utiliza el precio con descuento, la fecha de inicio del descuento y la fecha de finalización del descuento. El precio con descuento debe ser inferior al precio base.
• La fijación de precios v2 utiliza el precio de ejercicio como precio normal y el precio como valor con descuento. El precio y el precio de ejercicio no pueden ser iguales.
• Los descuentos por volumen requieren un umbral de cantidad superior a 1.
• El formato de fecha debe seguir el formato Mirakl:AAAA-MM-DD HH:MM:SS, en UTC.

Una configuración incorrecta de los precios impide que se publiquen las ofertas.

Envío, seguimiento y atributos específicos de Mirakl #

Los marketplaces de Mirakl se basan en muchos otros atributos. Debe asignar los necesarios para su categoría.

Algunos ejemplos típicos son:

• Plazo de entrega. Define cuántos días transcurren antes del envío.
• Clase logística. Controla la gestión de la entrega. Los códigos válidos de los marketplaces son: klein, mittel, groß, extragroß.
• Requisitos de seguimiento. Se requiere un código de seguimiento y una URL de seguimiento para todos los envíos. La asignación de transportistas es opcional, pero recomendable.
• Atributos ecológicos y EPR. Los atributos opcionales se aplican a los productos sujetos a normativas medioambientales. Entre ellos se incluyen las contribuciones ecológicas y los ID de registro de los productores.

FAQ #

¿Por qué no aparece mi producto? #

La mayoría de los problemas con los anuncios se deben a errores de validación del marketplace. Las causas más comunes son la falta de códigos EAN, imágenes no válidas, atributos obligatorios sin asignar, IVA faltante o precios incorrectos.

¿Dónde puedo ver los errores de validación del marketplace? #

Si no aparecen errores en M2E Cloud, comprueba el backend de Mirakl.

Ve a Catálogo → Importaciones de productos y descarga el informe de productos no integrados para obtener información detallada.

¿Shop Apotheke admite descuentos y promociones? #

Los descuentos se admiten a través de las reglas de precios de Mirakl. Se admiten tanto Pricing v1 como Pricing v2.

¿Se requieren facturas para los pedidos de Shop Apotheke? #

Los requisitos de facturación dependen de su configuración. En algunos casos, las facturas del comerciante son opcionales. En otros, se debe adjuntar una factura antes de la confirmación del envío.

✅ Si necesita ayuda con la configuración o tiene problemas con la validación, póngase en contacto con el equipo de asistencia de M2E Cloud.