Headless commerce · importación commercetools

commercetools como fuente headless de productos para Photopilot

Importar productos, variantes y características de un proyecto de commercetools.

Importación + exportación por API o FTP
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

commercetools

Así es el recorrido

Creas un cliente de API en commercetools.
Photopilot lee productos con SKU, key y atributos.
Las imágenes y los textos se asignan a los productos y variantes correctos.
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 commercetools

En un entorno de commercetools, el contenido de producto está repartido entre product types, variantes, assets y un ERP o DAM adicional. Photopilot lee los productos publicados de tu proyecto y se encarga del trabajo de imagen y texto por variante. El resultado queda disponible como una entrega ordenada y previsible para los servicios que alimentan tu proyecto.

Qué obtiene Photopilot de tu proyecto de commercetools

Photopilot lee a través de las product projections de tu proyecto, es decir, exactamente lo publicado. Por cada producto se importan la key, el nombre y la descripción por idioma, además de la master variant y las variantes con SKU y atributos como EAN, color y material. Tomamos las images y assets existentes como punto de partida. Cada ronda filtra por lastModifiedAt, de modo que solo se descargan los productos modificados.

Variantes, colores y tipos de producto

Como commercetools suele guardar el color y la talla como atributos de variante dentro de un product type, Photopilot empareja las imágenes por SKU, product key y EAN. Usamos un código de color de tus atributos para agrupar las imágenes por color, de modo que cada color tenga su propio set y las tallas compartan las mismas imágenes. Si trabajas con varios product types, por ejemplo para ropa, calzado y accesorios, cada tipo tendrá sus propias reglas de imagen. Así la integración seguirá siendo correcta aunque el modelo de datos crezca más adelante.

Qué produce Photopilot

Las imágenes de proveedor y las fotos de estudio reciben automáticamente el fondo, el recorte y la proporción correctos para tus vistas frontales. Cuando faltan imágenes, Photopilot crea imágenes de maniquí invisible, imágenes con modelo IA o, con Iris como AI creative director, imágenes de campaña completas. Se reconocen materiales y símbolos de lavado, que sirven de base para textos de producto y textos SEO en todos los idiomas de tu proyecto. El equipo de contenidos lo aprueba todo antes de publicarlo.

Entrega a tu stack composable

Tu capa de integración recoge las imágenes y los textos aprobados mediante la API de Photopilot, o los encuentra listos en FTP/SFTP o en el Excel para la tienda online. Por cada variante, las imágenes se entregan en un orden fijo, con textos alt y textos localizados que encajan directamente en campos LocalizedString. Después, tu propio servicio los coloca como images o assets en commercetools o en el DAM. Así, un único lugar sigue siendo el propietario de lo que se escribe en el proyecto.

Lo que el equipo ve a diario

Para cada variante, Photopilot muestra si hay suficientes imágenes, qué textos siguen pendientes de aprobación y qué se ha entregado ya. Los productos nuevos del proyecto aparecen automáticamente en la lista de trabajo, así nadie tiene que controlar a mano qué se ha añadido. Con autopilot, los pasos recurrentes, como eliminar el fondo y recortar, pueden ejecutarse sin trabajo manual. Los informes muestran por marca o categoría el grado de completitud del contenido.

Configuración en pocos pasos

Creas en Merchant Center un API-client con permisos de lectura sobre productos y compartes la project key, la API-URL, la auth-URL, el client-ID y el secret. Después definimos juntos qué atributos contienen EAN, color y material, y cómo recoge el output tu capa de integración. Ejecutamos la primera ronda contra tu propio proyecto, para que el mapping quede correcto desde el principio. Para eso no hace falta un proceso de development.

commercetools en resumen

Qué se intercambia: Desde tu proyecto de commercetools, Photopilot lee los productos con sus variantes, SKU, key y atributos. Photopilot no escribe en commercetools.
Frecuencia: Por defecto, cada dos horas. Photopilot solo obtiene los productos que se hayan modificado en el proyecto desde la ronda anterior.
Qué debes proporcionar: La project key y un cliente de API con client-ID, secret y permisos de lectura sobre productos.
Conviene saberlo: La integración está creada sobre la API oficial de commercetools. Primero la probamos contigo en tu proyecto.

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 commercetools con Photopilot?

Crea en el Merchant Center un API-client con permisos de lectura sobre productos y comparte la project key, API-URL, auth-URL, client-ID y secret. Después, Photopilot lee los productos publicados y ejecuta una primera ronda en tu proyecto.

¿Photopilot lee productos publicados o en staging desde commercetools?

Photopilot lee las product projections publicadas. Así trabajas con los datos que también se muestran en la parte pública, no con cambios incompletos que todavía están en staged.

¿Photopilot funciona con variantes y atributos de color en commercetools?

Sí. Photopilot lee la variante maestra y las variantes con SKU y atributos, y agrupa las imágenes por color. Así, las tallas del mismo color comparten un único conjunto de imágenes.

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

Tu capa de integración recoge las imágenes y los textos aprobados a través de la Photopilot-API o desde FTP/SFTP, y los coloca como images o assets en la variante correcta. Los nombres de archivo y el orden son fijos por variante, así que el procesamiento sigue siendo predecible.

¿Crea Photopilot textos de producto en varios idiomas para commercetools?

Sí, Photopilot crea textos de producto, textos SEO y textos alt para cada idioma que use tu proyecto. Se entregan por locale para que encajen directamente en los campos localizados.

¿Nuestro equipo de desarrollo tiene que crear algo para Photopilot y commercetools?

Para la importación no: basta con un cliente de API con permisos de lectura. Para devolver los datos, tu importación o servicio de integración existente utiliza la entrega de Photopilot, lo que normalmente supone un pequeño ajuste en un paso que ya tienes.

¿Puedo aprobar el contenido antes de que se envíe a commercetools?

Sí. Las imágenes y los textos quedan primero pendientes de revisión en Photopilot y solo se incluyen en la entrega después de aprobarlos. En cada variante ves qué hay nuevo o qué se ha modificado.

¿Qué pasa si un producto de commercetools aún no tiene imágenes?

Entonces aparece en el resumen de imágenes faltantes. A partir de una foto de producto sencilla, Photopilot puede crear imágenes con modelo IA, un maniquí invisible o un packshot, que después apruebas tú mismo.

¿Con qué frecuencia sincroniza Photopilot con commercetools?

Por defecto, cada dos horas, filtrado por lastModifiedAt, es decir, solo productos modificados. Así, incluso los catálogos grandes se mantienen fáciles de actualizar.

¿Con qué frecuencia lee Photopilot desde commercetools?

Por defecto, cada dos horas, solo con los productos modificados en el proyecto.

¿Qué necesita Photopilot para conectar commercetools?

La project key y un cliente de API con client-ID, secret y permisos de lectura sobre productos.

¿A dónde va la salida de Photopilot?

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

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.