Headless commerce · importación Medusa

Complementar Medusa Commerce con Photopilot

Importar productos, variantes e imágenes de Medusa.

Importación mediante Medusa-API + exportación
Exportación mediante FTP, Excel o API

Reserva una demo Pruébalo tú mismo

Cumple el RGPD, datos en la UE
SLA y una persona de contacto fija
Se conecta con Shopware, Shopify y tu ERP
13 retailers y marcas en producción

Medusa

Así es el recorrido

Creas un token de API en Medusa.
Photopilot lee productos, variantes, metadatos e imágenes.
Las imágenes y los textos se vinculan al artículo correcto mediante SKU o handle.
La salida se envía por FTP, el Excel de tienda online o la API a tu capa de publicación.

Ve qué entra y qué coincide Los conflictos siguen siendo visibles para tu equipo.

Explicación

Así funciona Photopilot con Medusa

Con Medusa, un equipo crea su propio commerce-stack, y el contenido de producto no debería depender de las releases. Photopilot lee productos, variantes, metadatos e imágenes desde Medusa, se encarga del trabajo de imagen y texto, y entrega el resultado para que tu propio módulo o importación lo procese. Así, el equipo de contenido trabaja con un ritmo fijo, al margen de la planificación de sprints.

Qué obtiene Photopilot de Medusa

A través de la Admin API, Photopilot lee productos con título, handle, estado, metadata, thumbnail e imágenes. Por variante se incluyen SKU, título, stock y metadata propios. Si prefieres usar la Store API, también puedes conectar con una publishable API key. En cada ciclo solo se solicitan los productos actualizados desde la vez anterior.

Matching por SKU, handle y EAN

Photopilot vincula las imágenes a los productos de Medusa mediante SKU, handle y un EAN de los metadatos de la variante o del producto. Si en los metadatos hay un número de producto propio, lo usamos como clave principal. Así, las imágenes de proveedores que entran por EAN o número de artículo llegan automáticamente al producto correcto. Las variantes con el mismo color comparten el mismo conjunto de imágenes.

Imagen y texto en Photopilot

Las imágenes de proveedor y los packshots se corrigen en Photopilot: se siluetean, se recortan y se colocan sobre el fondo que utiliza tu storefront. Cuando falta una foto con modelo, Photopilot crea fotos con modelo IA o un maniquí invisible, y con Iris como directora creativa de IA se generan imágenes de campaña con la identidad visual de la marca. Los materiales y símbolos de lavado se reconocen y se incorporan a los textos de producto y textos SEO. El equipo de contenido revisa y aprueba cada producto.

De vuelta en Medusa mediante tu propio módulo

Un subscriber, scheduled job o módulo propio recoge las imágenes y los textos aprobados a través de la API de Photopilot, o bien quedan disponibles en FTP/SFTP y en el Excel de la tienda online. El orden de imágenes queda definido por producto, incluida la imagen que será la thumbnail, y cada imagen tiene un texto alternativo. Los textos y campos SEO se entregan por producto e idioma. Como el formato de entrega no cambia, el procesamiento solo hay que construirlo una vez.

Contenido independiente de las versiones de desarrollo

En muchos proyectos de Medusa, el contenido de producto está en el mismo backlog que las funcionalidades, por lo que una nueva colección espera a una release. Con Photopilot, ese trabajo pasa al equipo de contenidos: los productos nuevos aparecen automáticamente en la lista de trabajo y el resumen de imágenes faltantes muestra dónde hace falta actuar. Con autopilot, pasos fijos como quitar el fondo y recortar se ejecutan sin trabajo manual. Los informes muestran el grado de completitud del catálogo.

Configuración rápida, sin proyecto de IT

Nos facilitas la URL del Medusa-backend y un API-token con permisos de lectura sobre productos, o una publishable API key para la Store API. Juntos definimos qué claves de metadata contienen EAN, color y material, y cómo recoge el output tu módulo. La primera ronda se ejecuta directamente sobre tus propios productos. Después, Photopilot lee las actualizaciones cada dos horas por defecto.

Medusa en resumen

Qué se intercambia: A través de la API de Medusa, Photopilot lee productos, variantes con SKU, metadatos e imágenes. Photopilot no escribe en Medusa.
Frecuencia: Por defecto, cada dos horas. Photopilot solo lee los productos que se hayan actualizado en Medusa desde la ronda anterior.
Qué debes proporcionar: La URL de la API de Medusa y un token de API con permisos de lectura sobre productos.
Conviene saberlo: La integración se ha probado con una instalación real de Medusa en nuestro laboratorio de pruebas.

Después en Photopilot

Vinculado de forma fiable

Convierte los datos de origen en páginas de producto listas para vender

300.000+ artículos procesados

9,5M+ imágenes de proveedores indexadas

~3.200 fotos editadas automáticamente al día

FAQ

Preguntas frecuentes

¿Cómo conecto Medusa con Photopilot?

Comparte la URL de tu backend de Medusa y un API-token con permisos de lectura sobre productos. Después, Photopilot lee productos, variantes, metadatos e imágenes mediante la Admin API.

¿Puede Photopilot leer también a través de la Store API de Medusa?

Sí, con una publishable API key, Photopilot lee los productos mediante la Store API. Es útil si no quieres emitir un Admin-token.

¿Cómo llegan las imágenes de producto de Photopilot a Medusa?

Un módulo propio, un subscriber o un scheduled job recoge las imágenes aprobadas mediante la API de Photopilot o desde FTP/SFTP. El orden y la thumbnail están definidos por producto, así que el procesamiento es sencillo.

¿Con qué campos empareja Photopilot los productos de Medusa?

Por SKU, handle y un EAN de los metadatos de la variante o del producto. Un número de producto propio en los metadatos puede servir como clave principal.

¿Photopilot funciona con variantes de color y talla en Medusa?

Sí. Photopilot lee todas las variantes con SKU y stock, y agrupa las imágenes por color, para que las tallas del mismo color compartan un único conjunto de imágenes.

¿Tengo que instalar un plugin de Medusa para Photopilot?

Para la importación no; basta con un token de API. Para devolver los datos, tu propio módulo procesa la entrega estándar de Photopilot.

¿Puedo aprobar imágenes y textos antes de que lleguen a Medusa?

Sí. Todo queda primero pendiente de revisión en Photopilot y solo el contenido aprobado se incluye en la entrega. En cada producto ves qué hay nuevo o qué se ha modificado.

¿Qué pasa si un producto de Medusa no tiene foto del proveedor?

Entonces aparece en el resumen de imágenes faltantes. Con una foto de producto sencilla, Photopilot crea un packshot, un maniquí invisible o imágenes con modelo IA, que tú revisas primero.

¿Cuánto cuestan las fotos con modelo IA para una tienda online en Medusa?

Las fotos con IA cuestan entre 0,05 € y 0,21 € por foto con precio de cola y suelen estar listas en menos de una hora. Un modelo IA propio con rostro fijo cuesta 1,37 €.

¿Con qué frecuencia lee Photopilot desde Medusa?

Por defecto, cada dos horas, siempre solo con los productos actualizados en Medusa.

¿Qué necesita Photopilot para conectar Medusa?

La URL de la API de Medusa y un token de API con permisos de lectura sobre productos.

¿A dónde va la salida de Photopilot?

Mediante FTP/SFTP, el Excel de la tienda online o la API hacia tu capa de publicación. Photopilot no escribe directamente de vuelta en Medusa.

Base de conocimiento

Lee también

Así empiezas

Primero la ruta de prueba, después la técnica

La integración es el punto de partida. Después, Photopilot mantiene unidos la vinculación, la edición, la redacción, la revisión y la publicación.