Panoramica del flusso degli ordini

Non importa come vengono inviati gli ordini, tutti seguono lo stesso percorso principale all'interno di GelatoConnect:

1. Invio dell'ordine

Gli ordini possono entrare nel sistema tramite diversi canali:

Invio tramite API: gli ordini vengono inviati con richieste POST; il sistema controlla il formato della richiesta e restituisce un ID ordine.
Invio vetrina: gli ordini effettuati tramite piattaforme e-commerce collegate vengono importati in automatico.
Invio FTP: i file degli ordini vengono caricati e controllati a intervalli regolari, poi trasformati in ordini.
Invio diretto dalla piattaforma: le integrazioni (ad esempio Cloudprinter, Redbubble) inviano gli ordini già formattati direttamente su GelatoConnect.

2. Prima verifica e gestione

Una volta ricevuti, gli ordini seguono questo percorso:

Convalida dei dati: controlla che tutto sia completo, il formato sia corretto, ci siano i riferimenti ai clienti e gli identificativi unici dei prodotti.
Convalida del file di stampa: gli URL dei file vengono verificati e i file vengono controllati per compatibilità, risoluzione, dimensioni e incorporamento dei font.
Validazione delle regole aziendali: comprende controlli su restrizioni di spedizione, disponibilità, quantità e requisiti per spedizioni internazionali.

Transizioni dello stato dell'ordine

Gli ordini in GelatoConnect passano attraverso diversi stati durante il loro ciclo di vita:

Stati iniziali

Bozza: l'ordine è stato salvato ma non ancora inviato.
Ricevuto: l’ordine è stato inviato a GelatoConnect.
Superato: l'ordine ha superato tutti i controlli.
Non riuscito: l'ordine non ha superato la validazione.
Creato: l’ordine ha superato la verifica ed è pronto per la produzione.

Stati di produzione

In produzione: l'ordine è in fase di produzione.
Stampato: la produzione dell'ordine è terminata.
Imballato: l'ordine è pronto per essere spedito.

Stati di spedizione

Spedito: l'ordine ha lasciato la struttura.
In transito: l'ordine è in viaggio.
Consegnato: L'ordine è arrivato al cliente.
Restituito: l'ordine è stato restituito.

Stati di errore

Errore: validazione o elaborazione non riuscita.
Annullato: l'ordine è stato annullato.

Eventi e notifiche

Eventi di sistema: tutte le modifiche di stato vengono registrate internamente.
Notifiche esterne: i clienti ricevono aggiornamenti tramite postback, email ed eventi Webhook.
Aggiornamenti sullo stato delle API: puoi controllare lo stato tramite le API Get Order e Search Orders.

Motivi comuni per cui un ordine può fallire e come risolverli

GelatoConnect ti mostra motivi precisi per ogni errore, così puoi risolvere i problemi più facilmente.

"Non connesso"

Cosa significa: il prodotto nei Storefronts non è collegato a una specifica di GelatoConnect.
Soluzione:

Vai su Storefronts, trova il prodotto e clicca su Collega prodotto.
Carica i file del design se necessario.
Completa la connessione e invia di nuovo l’ordine.

"Consegna non disponibile"

Cosa significa: Il corriere non può consegnare all'indirizzo indicato.
Soluzione:

Verifica l'indirizzo e il paese supportato.
Valuta metodi di spedizione alternativi.
Negli ordini API, usa i metodi di spedizione separati da virgole in shipmentMethodUid.

Errori durante il download dei file

Cosa significa: non è possibile accedere agli URL dei file di stampa.
Soluzione:

Assicurati che gli URL siano pubblici e validi.
Formatta correttamente gli URL per servizi come Dropbox, Google Drive o OneDrive.

Problemi di formato e qualità dei file

Cosa vuol dire: I file non rispettano le specifiche di produzione.
Soluzione:

Usa la risoluzione corretta (di solito 300 DPI).
Includi il bordo di abbondanza (di solito 3 mm).
Usa il colore CMYK e incorpora tutti i font.

Identificazione prodotto non valida

Cosa significa: UID del prodotto o prodotto personalizzato del cliente non valido o non riconosciuto.
Soluzione:

Verifica che productUid, productName e productVariant siano esatti.
Usa le ricerche per abbinare i codici prodotto.

Prezzi al dettaglio mancanti (ordini internazionali)

Cosa significa: i dati sui prezzi personalizzati non sono disponibili.
Soluzione:

Includi retailCurrency, retailShippingPriceInclVat e items[i].retailPriceInclVat nella richiesta API.

Errori di autenticazione API

Cosa significa: le credenziali API non sono valide.
Soluzione:

Verifica la tua chiave e il tuo segreto.
Assicurati che i titoli siano nel formato corretto.
Usa HTTPS.

Come risolvere i problemi degli ordini non andati a buon fine

Controlla lo stato e il motivo dell'errore
Vai su Workflow > Order Intake > Gestisci ordini, apri l'ordine non riuscito e guarda il motivo del problema.
Controlla le richieste API (se necessario)
In Workflow > Order Intake > Requests, controlla i dettagli della richiesta e della risposta dell’ordine.
Applica la soluzione giusta
Segui le indicazioni qui sopra per risolvere il problema.
Invia di nuovo l’ordine
Dopo aver corretto, puoi inviare di nuovo l’ordine oppure crearne uno nuovo.
Monitora con Postback
Imposta i postback per ricevere aggiornamenti di stato in tempo reale e ridurre i tempi di risoluzione dei problemi.

Monitorare e gestire gli ordini

GelatoConnect ti offre diversi strumenti per gestire al meglio i tuoi ordini:

Pagina richieste: guarda gli ordini in arrivo e filtra per stato.
Gestione ordini: cerca gli ordini e scegli cosa fare, come annullare o riprocessare.
Analisi degli ordini: tieni d'occhio i volumi, le percentuali di errore e le tendenze degli ordini.

Vuoi saperne di più?

Per aiutarti a capire meglio e lavorare senza intoppi:

Dai un'occhiata alla documentazione sul flusso degli ordini per scoprire ogni passaggio nel dettaglio.
Scopri gli Order API Endpoints per integrare facilmente tramite API.
Usa i Template Mappers se i tuoi dati hanno bisogno di essere trasformati.

[Acquisizione ordini - GCW] Flussi e stati degli ordini: come funziona