Metti alla prova ogni dettaglio delle tue configurazioni prodotto, del packaging e dei flussi d’ordine usando l’API di GelatoConnect.
1. Prepararsi a fare un ordine di prova
Prima di fare un ordine di prova, assicurati di aver:
Configurazione prodotto cliente: crea il prodotto cliente con le caratteristiche e le varianti necessarie. Segui questi passaggi:
Vai alla sezione Prodotti personalizzati per i clienti in GelatoConnect.
Seleziona il modello di prodotto che ti interessa (ad esempio: Poster Product).
Definisci gli attributi di base e le varianti, assicurandoti che siano in linea con il formato dati preferito dal cliente. Collega i valori forniti dal cliente (ad esempio, colore o taglia) agli attributi interni di Gelato.
Salva la configurazione.
Accesso API: assicurati di avere credenziali API valide e i permessi necessari per effettuare ordini.
File di prova: assicurati di avere dei file di esempio pronti da caricare, come PDF già pronti per la stampa.
2. Come fare un ordine di prova usando l’API di GelatoConnect
Segui questi passaggi per fare un ordine di prova tramite l'API:
Endpoint API
POST https://order.ie.live.gelato.tech/api/v4/orders
Esempio di struttura di richiesta API
{
"clientId": "your-client-id",
"orderReferenceId": "test-order-ref",
"customerReferenceId": "test-customer-ref",
"orderType": "order",
"currency": "USD",
"retailCurrency": "USD",
"retailShippingPriceInclVat": 5.99,
"shippingAddress": {
"country": "US",
"firstName": "John",
"lastName": "Doe",
"addressLine1": "123 Test St",
"city": "Testville",
"postCode": "12345",
"state": "CA",
"email": "[email protected]",
"phone": "1234567890"
},
"items": [
{
"itemReferenceId": "test-item-ref",
"productName": "Sample Product",
"productVariant": {
"paper": "a1",
"color": "front"
},
"files": [
{
"type": "default",
"url": "https://example.com/test-file.pdf"
}
],
"quantity": 1,
"retailPriceInclVat": 19.99
}
]
}
Campi principali
productName: Deve corrispondere esattamente al nome del tuo prodotto personalizzato su GelatoConnect.
productVariant: scegli le opzioni come tipo di carta, formato o colore in base alle tue preferenze.
file: inserisci l'URL del file da usare per la produzione.
3. Convalida dell’ordine di prova
Dopo aver effettuato l’ordine di prova, controlla questi aspetti:
Conferma dell’ordine: Controlla la risposta dell’API per assicurarti che l’ordine sia stato creato correttamente. Prendi nota dell’ID ordine e dello stato di realizzazione.
Visualizzazione ordine in GNX: accedi a GelatoConnect (GNX) per vedere i dettagli dell’ordine di prova.
Controlla che tutti gli attributi e le varianti siano applicati correttamente.
Controlla che i file siano stati caricati correttamente e rispettino i requisiti di produzione.
Controllo del packaging:
Controlla i dettagli del packaging nella schermata GNX.
Assicurati che le opzioni scelte (ad esempio, confezione regalo) siano proprio come le desideri.
Crea controlli per packaging personalizzato (vedi la sezione 9 per riferimento)
Crea scaffali personalizzati (vedi la sezione 9 per riferimento)
Inserisci manualmente il codice a barre insieme al numero del lavoro di stampa per provare il flusso della stazione di imballaggio
4. Risoluzione dei problemi
Se l'ordine di prova non è come te lo aspettavi:
Controlla la configurazione del prodotto:
Controlla che i campi productName e productVariant nella richiesta API corrispondano alla configurazione del tuo prodotto personalizzato.
Assicurati che tutte le opzioni necessarie siano incluse e abbiano la corrispondenza giusta.
Controlla i file: assicurati che i file caricati rispettino le dimensioni e i formati richiesti dal prodotto personalizzato del cliente.
Controlla le credenziali API: assicurati che le credenziali utilizzate abbiano le autorizzazioni giuste per effettuare ordini di prova.
Contatta il supporto: se il problema continua, scrivi al supporto di GelatoConnect indicando l’ID dell’ordine e i dettagli del problema.
Prossimo passo: 🔗 [Inizia adesso - GCW] monitora la produzione e gestisci le eccezioni