Panoramica
Questo articolo spiega come creare prodotti personalizzati per i clienti su Gelato e come utilizzarli quando effettui ordini tramite l’API di Gelato. I prodotti personalizzati ti permettono di adattare le configurazioni dei prodotti alle esigenze di ogni cliente, collegando i loro formati dati specifici a un modello di prodotto standard.
Un modello di prodotto definisce il tuo prodotto internamente (ad esempio: le sue parti, le sue caratteristiche e le caratteristiche derivate), mentre un prodotto cliente ti permette di personalizzare il modo in cui i clienti inviano i dati e interagiscono con il tuo prodotto quando fanno un ordine.
Passaggi per creare prodotti personalizzati per i clienti
1. Imposta il modello del prodotto
Prima di creare un prodotto personalizzato per il cliente, assicurati di avere già impostato un modello di prodotto. Ad esempio, immaginiamo che il modello di prodotto si chiami Poster Product e abbia 9 attributi e diversi attributi derivati. (Per maggiori dettagli, consulta la guida "Creare un modello di prodotto".)
2. Creare il prodotto personalizzato per il cliente
Un prodotto cliente è una versione personalizzata del tuo modello di prodotto che rispecchia le preferenze del cliente su come inviare i dati (ad esempio: dimensione, colore, ecc.). Ecco come configurare un prodotto cliente:
Passo 1: vai alla sezione Prodotti personalizzati per i clienti.
Passaggio 2: scegli il modello di prodotto (ad esempio, Poster Product) e dai un nome al prodotto personalizzato per il tuo cliente. Questo nome è importante perché verrà usato quando effettui un ordine tramite l'API.
Per esempio, chiamiamo questo prodotto Poster SP per il cliente Sandbox Customer.
Nota: puoi usare direttamente il nome del prodotto del cliente nelle richieste d’ordine inviate tramite l’API di Gelato.
Passaggio 3: imposta le attributi base e le varianti:
Attributi di base sono attributi fissi che restano uguali per tutte le varianti di prodotto.
Le varianti sono le opzioni personalizzabili, come la dimensione, il colore o il tipo di carta, tra cui puoi scegliere.
3. Impostazione degli attributi di base
Gli attributi di base hanno un solo valore fisso per tutte le varianti. Ad esempio:
Orientamento: sempre verticale
Finitura: nessun rivestimento
Questi attributi di base non cambiano da una variante di prodotto all'altra.
4. Impostazione delle varianti
Le varianti sono le opzioni di prodotto che chi acquista può scegliere, come la misura o il colore. Ecco come puoi configurarle:
Passaggio 1: aggiungi le opzioni del cliente (ad esempio, formato e colore) e collegale agli attributi del modello di prodotto.
Esempio: il cliente vuole inviare attributi chiamati Dimensione, Tipo di carta e Colore.
Passaggio 2: associa i valori forniti dal cliente agli attributi interni del modello di prodotto:
Colore: il cliente potrebbe chiamare la sua opzione colore "Black White" per le stampe in bianco e nero e "Full Color" per le stampe a colori. Puoi associare queste opzioni ai valori interni di Gelato: "1/1" per il bianco e nero e "4/4" per il colore.
Dimensioni: il cliente potrebbe inviare le misure in pollici, mentre tu dovrai convertirle nel sistema metrico interno (ad esempio, 20x28 pollici = 508x711 mm).
Passaggio 3: imposta un valore predefinito per gli attributi, se necessario. Ad esempio:
Se il cliente non indica una preferenza per il colore, puoi impostare come predefinita l’opzione Full Color (4/4).
Passaggio 4: configura più valori di opzione:
Puoi associare più valori dei clienti a un unico valore interno. Ad esempio, un cliente potrebbe usare "Black White" o "BW" per indicare la stessa stampa in bianco e nero; puoi collegare entrambi al tuo valore interno "1/1".
5. Salvataggio del prodotto del cliente
Quando hai impostato tutti gli attributi e le varianti, salva il prodotto cliente. Ora hai un prodotto cliente collegato al modello di prodotto interno, così puoi ricevere e gestire gli ordini nel formato preferito dal cliente.
Come fare un ordine tramite API usando i prodotti dei clienti
Una volta che il prodotto del cliente è pronto, il cliente può effettuare ordini tramite l'API di Gelato. Ecco come funziona:
1. La struttura della richiesta API
Quando effettui un ordine, il nome del prodotto cliente (ad esempio, Poster SP) verrà utilizzato nella richiesta API insieme alle opzioni selezionate. Ecco un esempio di richiesta API:
{ "items": [ { "productName": "Poster SP", "productVariant": { "color": "bianco-nero", "paper-size": "20x28 pollici" } } ]}
In questo esempio:
Il productName è impostato su Poster SP.
La productVariant include i valori delle opzioni selezionate, come ad esempio "nero-bianco" per il colore e "20x28 pollici" per il formato della carta.
2. Gestire più prodotti per i clienti
Puoi creare prodotti personalizzati per clienti diversi, tutti collegati allo stesso modello di prodotto ma con configurazioni differenti. Ad esempio:
Cliente A potrebbe inviare "formato carta" e "colore" come opzioni.
Il cliente B potrebbe invece inviare "tipo di carta" e "formato".
Nonostante queste differenze, entrambi i prodotti per i clienti faranno riferimento allo stesso Product UID interno nel sistema di Gelato, garantendo processi di produzione sempre coerenti dietro le quinte.
3. Compatibilità con le versioni precedenti
Il sistema di Gelato garantisce la compatibilità con i flussi di lavoro già esistenti; puoi continuare a usare i UID dei prodotti delle vecchie configurazioni, anche mentre adotti nuovi setup personalizzati dei prodotti nel flow configurator.