Headless commerce · importazione commercetools

commercetools come sorgente prodotti headless per Photopilot

Importare prodotti, varianti e caratteristiche da un progetto commercetools.

Importazione + export via API o FTP
Export tramite FTP, Excel o API

Prenota una demo Provalo tu stesso

Conforme al GDPR, dati nell’UE
SLA e un referente dedicato
Si collega a Shopware, Shopify e al tuo ERP
13 retailer e brand in produzione

commercetools

Ecco il percorso

Crei un client API in commercetools.
Photopilot legge prodotti con SKU, key e caratteristiche.
Immagini e testi vengono associati ai prodotti e alle varianti corretti.
L'output viene inviato tramite FTP, Webshop-Excel o API al tuo livello di pubblicazione.

Vedi cosa arriva e viene abbinato I conflitti restano visibili al tuo team.

Spiegazione

Come funziona Photopilot con commercetools

In un ambiente commercetools, i contenuti di prodotto sono distribuiti tra product types, varianti, assets e un ERP o DAM collegato. Photopilot legge i prodotti pubblicati dal tuo progetto e gestisce il lavoro su immagini e testi per variante. Il risultato viene reso disponibile come consegna ordinata e prevedibile per i servizi che alimentano il tuo progetto.

Cosa Photopilot recupera dal tuo progetto commercetools

Photopilot legge tramite le product projections del tuo progetto, quindi esattamente ciò che è pubblicato. Per ogni prodotto importa key, nome e descrizione per lingua, oltre alla master variant e alle varianti con SKU e attributi come EAN, colore e materiale. Usiamo images e assets esistenti come punto di partenza. Ogni ciclo filtra su lastModifiedAt, così vengono importati solo i prodotti modificati.

Varianti, colori e tipi di prodotto

Poiché commercetools di solito registra colore e taglia come attributi di variante in un product type, Photopilot abbina le immagini a SKU, product key ed EAN. Usiamo un codice colore dai tuoi attributi per raggruppare le immagini per colore, così ogni colore riceve il proprio set e le taglie condividono le stesse immagini. Se usi più product types, per esempio per abbigliamento, scarpe e accessori, ogni tipo riceve le proprie regole per le immagini. In questo modo l'integrazione resta corretta anche se il modello dati cresce in seguito.

Cosa produce Photopilot

Le immagini dei fornitori e le foto di studio ricevono automaticamente lo sfondo, il ritaglio e il rapporto corretti per i tuoi fronti. Dove mancano immagini, Photopilot crea immagini con manichino invisibile, immagini con modello AI oppure, con Iris come AI creative director, immagini di campagna complete. Materiali e simboli di lavaggio vengono riconosciuti e diventano la base per testi prodotto e testi SEO in ogni lingua del tuo progetto. Il team contenuti approva tutto prima della pubblicazione.

Consegna al tuo composable stack

Il tuo layer di integrazione recupera le immagini e i testi approvati tramite l'API di Photopilot, oppure li trova pronti su FTP/SFTP o nel Webshop-Excel. Per ogni variante, le immagini vengono consegnate in un ordine fisso, con alt text e testi localizzati già adatti ai campi LocalizedString. Il tuo servizio li inserisce poi come images o assets in commercetools o nel DAM. In questo modo un solo punto resta responsabile di ciò che viene scritto nel progetto.

Cosa vede il team ogni giorno

Per ogni variante, Photopilot mostra se ci sono abbastanza immagini, quali testi sono ancora in attesa di approvazione e cosa è già stato consegnato. I nuovi prodotti del progetto compaiono automaticamente nella lista di lavoro, così nessuno deve tenere traccia manualmente delle aggiunte. Con autopilot, passaggi ricorrenti come scontorno e ritaglio possono procedere senza interventi manuali. I report mostrano per brand o categoria quanto è completa la content.

Configurazione in pochi passaggi

Crei nel Merchant Center un API-client con permessi di lettura sui prodotti e condividi la project key, gli URL API e auth, il client-ID e il secret. Poi definiamo insieme quali attributi contengono EAN, colore e materiale, e come il tuo livello di integrazione recupera l'output. Eseguiamo la prima elaborazione sul tuo progetto, così la mappatura è corretta fin da subito. Non serve avviare un percorso di sviluppo.

commercetools in breve

Cosa viene scambiato: Dal tuo progetto commercetools, Photopilot legge i prodotti con le relative varianti, SKU, key e caratteristiche. Photopilot non scrive in commercetools.
Con che frequenza: Per impostazione predefinita ogni due ore. Photopilot recupera solo i prodotti modificati nel progetto dal ciclo precedente.
Cosa devi fornire: La project key e un API-client con client-ID, secret e permessi di lettura sui prodotti.
Da sapere: L'integrazione è basata sull'API ufficiale di commercetools. La testiamo prima insieme sul tuo progetto.

Poi in Photopilot

Collegato in modo affidabile

Trasforma i dati sorgente in pagine prodotto pronte per la vendita

300.000+ articoli elaborati

9,5M+ immagini dei fornitori indicizzate

~3.200 foto al giorno ritoccate automaticamente

FAQ

Domande frequenti

Come collego commercetools a Photopilot?

Crea nel Merchant Center un client API con permessi di lettura sui prodotti e condividi project key, API-URL, auth-URL, client-ID e secret. Photopilot legge poi i prodotti pubblicati ed esegue un primo giro sul tuo progetto.

Photopilot legge da commercetools i prodotti pubblicati o staged?

Photopilot legge le product projections pubblicate. Così lavori con i dati visibili anche sul frontend, non con modifiche parziali ancora in staged.

Photopilot funziona con varianti e attributi colore in commercetools?

Sì. Photopilot legge la master variant e le varianti con SKU e attributi, e raggruppa le immagini per colore. Le taglie dello stesso colore condividono così un unico set di immagini.

Come arrivano le immagini di Photopilot in commercetools?

Il tuo livello di integrazione recupera le immagini e i testi approvati tramite la Photopilot-API o da FTP/SFTP e li inserisce come images o assets sulla variante corretta. Nomi file e ordine sono fissi per variante, quindi l'elaborazione resta prevedibile.

Photopilot crea testi prodotto in più lingue per commercetools?

Sì, per ogni lingua usata dal tuo progetto Photopilot crea testi prodotto, testi SEO e testi alt. Vengono consegnati per locale, così si adattano direttamente ai campi localizzati.

Il nostro team di sviluppo deve creare qualcosa per Photopilot e commercetools?

Per l'importazione no: basta un API-client con permessi di lettura. Per il reinserimento, la tua importazione o il tuo servizio di integrazione esistente usa la consegna di Photopilot; di solito è una piccola modifica a un passaggio che hai già.

Posso approvare i contenuti prima che vengano inviati a commercetools?

Sì. Immagini e testi vengono prima sottoposti a revisione in Photopilot e vengono inclusi nella consegna solo dopo l’approvazione. Per ogni variante vedi cosa è nuovo o modificato.

Cosa succede se un prodotto commercetools non ha ancora immagini?

Compare quindi nella panoramica delle immagini mancanti. Da una semplice foto prodotto, Photopilot può creare foto con modello AI, un manichino invisibile o un packshot, che poi approvi tu.

Con quale frequenza Photopilot si sincronizza con commercetools?

Per impostazione predefinita ogni due ore, con filtro su lastModifiedAt, quindi solo i prodotti modificati. In questo modo anche i cataloghi grandi restano leggeri da gestire.

Con che frequenza Photopilot legge da commercetools?

Per impostazione predefinita ogni due ore, solo con i prodotti modificati nel progetto.

Di cosa ha bisogno Photopilot per collegare commercetools?

La project key e un API-client con client-ID, secret e permessi di lettura sui prodotti.

Dove va l’output di Photopilot?

Via FTP/SFTP, l’Excel dell’e-commerce o l’API verso il tuo ERP, DAM o livello di pubblicazione. Photopilot non scrive direttamente in commercetools.

Knowledge base

Prima il percorso di prova, poi la parte tecnica

L’integrazione è il punto di partenza. Da lì Photopilot mantiene insieme collegamento, modifica, scrittura, controllo e pubblicazione.