Benvenuto nella guida per integrare Gelato Connect con Cloudprinter. Questa integrazione ti permette di far dialogare le due piattaforme senza intoppi, così puoi ricevere ordini da Cloudprinter e gestirli in modo efficiente tramite GelatoConnect. Segui questi semplici passaggi per configurare l’integrazione e iniziare a gestire gli ordini Cloudprinter in pochi minuti o al massimo in poche ore (altro che mesi).
Ci sono 3 passaggi per ricevere e gestire gli ordini Cloudprinter con GelatoConnect:
Configura l'integrazione API per permettere la comunicazione.
Aggiungi il catalogo prodotti di Cloudprinter a GelatoConnect.
Configura i flussi di lavoro di produzione per gestire tutto senza intoppi.
Passo 1: integrazione API
Il primo passo è collegare i sistemi tramite API. In questo modo, ordini e aggiornamenti possono passare facilmente tra GelatoConnect Workflow e Cloudprinter.
Crea le interfacce Produzione e Segnali in Cloudprinter:
Nel tuo account Cloudprinter, crea un'interfaccia di produzione chiamata "GelatoConnect API - Dev": seleziona il modello "La tua API personale". Nel campo Host, inserisci semplicemente "www.gelato.com", e nel campo degli indirizzi IP, inserisci "184.169.223.162". Configura il resto seguendo le istruzioni di supporto di Cloudprinter. Imposta questa configurazione in "modalità test" e con priorità bassa, così gli ordini reali non passeranno da questa connessione.
Nel tuo account Cloudprinter, crea un’interfaccia Signals chiamata "GelatoConnect Signals - Dev". Impostala come priorità bassa, visto che serve solo per fare delle prove.
Crea il cliente "Cloudprinter" su GelatoConnect:
Accedi a GelatoConnect.
Vai alla sezione Clienti nel menu a sinistra.
Fai clic su Crea cliente e dai al cliente il nome Cloudprinter.
Seleziona Applica preset per Cloudprinter per caricare automaticamente le impostazioni.
Nella finestra che si apre, copia e incolla le chiavi API dalle interfacce Production e Signals che hai creato su Cloudprinter al passaggio 1.
Autorizza la comunicazione:
GelatoConnect creerà un host endpoint quando inserisci le chiavi API nel pop-up.
Copia questo endpoint e incollalo nel campo "Host" della interfaccia di produzione, sostituendo il nome host di esempio "www.gelato.com" che hai inserito al punto 1.
Crea la mappatura dei metodi di spedizione:
Crea una ricerca in GelatoConnect per associare i metodi di spedizione Cloudprinter ai metodi di spedizione Gelato. Segui le istruzioni che trovi qui e usa il file Excel allegato per completare l’associazione.
All'interno del tuo modello di invio ordine potresti dover sostituire la seguente riga in fondo al modello:
"shipmentMethodUid": ##{{ order.shipping.method|js }},con:
"shipmentMethodUid": ##{{ lookups({"alias": order.shipping.method}, strict=False, default="")|js }},dove "alias" rimanda al campo del template impostato come ##{{alias}} all'interno della tua ricerca.
Una volta completato, i sistemi sono sincronizzati. Gli endpoint API necessari per attività come inviare e aggiornare ordini sono già configurati, così la comunicazione avviene in automatico.
Passo 2: configurazione dei prodotti Cloudprinter
Ora importerai il catalogo prodotti di Cloudprinter in GelatoConnect.
1. Accedi ai modelli di prodotto:
Vai alla sezione Prodotti nel menu a sinistra e clicca su Modelli di prodotto.
Fai clic su Aggiungi dal catalogo > Aggiungi dal cliente e seleziona Cloudprinter.
2. Scarica i file di riferimento da Cloudprinter:
In una nuova scheda, accedi al tuo account Cloudprinter.
Vai su Product Catalog > Download References.
Scarica i due file necessari: Products Reference e Options Reference.
3. Carica i file di riferimento su GelatoConnect:
Trascina e rilascia i file scaricati nell'area di caricamento su GelatoConnect.
GelatoConnect mostrerà tutti i prodotti per cui il tuo account Cloudprinter è configurato.
4. Seleziona le categorie di prodotto:
Controlla l'elenco dei prodotti (può cambiare in base al tuo account Cloudprinter).
Scegli le categorie che vuoi produrre, come carta intestata, brochure e altro ancora.
5. Mappa i tipi di carta:
Scegli i tipi di carta più adatti per ogni prodotto.
Se hai accordi speciali con Cloudprinter per stock personalizzato, puoi modificare la mappatura qui.
Altrimenti, ti consigliamo di usare le impostazioni predefinite.
6. Genera prodotti e varianti:
Fai clic su Continua per generare i modelli di prodotto selezionati.
GelatoConnect creerà automaticamente prodotti con attributi associati e UIDs interni per la produzione.
Una volta terminato, puoi vedere il prodotto creato e controllare dettagli come la mappatura della carta, le opzioni di finitura e gli UID del prodotto.
Passaggio 3: configurare i flussi di lavoro di produzione
Infine, imposta o aggiorna i flussi di lavoro in base alle tue capacità produttive.
Accedi alla configurazione della produzione:
Usa lo strumento di configurazione della produzione in GelatoConnect per impostare le fasi di produzione (ad esempio: stampa, laminazione, rilegatura) per ogni categoria di prodotto (ad esempio: biglietti da visita, libri con punto metallico).
Assicurati che tutti i formati Cloudprinter abbiano una configurazione di produzione definita e attiva
Per una guida dettagliata e un video su come configurare la produzione, dai un'occhiata al passaggio dedicato nella guida introduttiva qui.
Passaggio 4: attiva gli ordini in tempo reale da Cloudprinter
Crea ordini di prova tramite il Test Center di Cloudprinter oppure coordinandoti direttamente con il team di Cloudprinter. Verifica la ricezione dell’ordine e del file per assicurarti che sia tutto pronto per la produzione.
Invia i biglietti delle tariffe di spedizione a Cloudprinter
Chiedi al tuo Implementation Manager di GelatoConnect il file modificabile del listino prezzi Cloudprinter
Compila il modulo e invia le tue tariffe di spedizione aggiornate a Cloudprinter all'inizio dell'onboarding (e ogni anno dopo eventuali cambiamenti delle tariffe dei corrieri).
Informa il team di Cloudprinter sul processo di test e chiedi il loro consenso per passare gli ordini reali su GelatoConnect.
Passa a ricevere ordini in tempo reale su GelatoConnect:
Crea una nuova interfaccia di produzione chiamata "GelatoConnect API - Prod". Usa gli stessi parametri della connessione "GelatoConnect API - Dev" creata in precedenza, ma imposta la priorità più alta e la "modalità Live" per ricevere gli ordini in tempo reale.
Imposta tutte le vecchie interfacce di produzione su "Modalità test" così gli ordini non ci finiranno più.
Crea una nuova interfaccia Signals chiamata "GelatoConnect Signals - Prod". Usa gli stessi parametri della connessione "GelatoConnect Signals - Dev" creata in precedenza, ma imposta la priorità più alta per utilizzarla con gli ordini live.