Introduzione
Questa guida spiega la terminologia e i concetti fondamentali che incontrerai utilizzando i sistemi di acquisizione ordini di GelatoConnect. Comprendere questi termini ti aiuterà a muoverti sulla piattaforma in modo più efficace e a comunicare con maggiore chiarezza sui processi di gestione degli ordini.
Concetti fondamentali sugli ordini
Ordina
Una richiesta per produrre e spedire uno o più prodotti a un indirizzo specifico. Un ordine è l'elemento base del lavoro su GelatoConnect.
ID di riferimento ordine
Il tuo identificatore unico per un ordine. Questo dovrebbe corrispondere a un ID ordine nel tuo sistema e ti permette di tenere traccia della relazione tra gli ordini GelatoConnect e i tuoi sistemi interni.
ID di riferimento del cliente
Il tuo identificatore unico per il cliente che effettua l’ordine. Questo ti aiuta a collegare gli ordini a clienti specifici nel tuo sistema.
Tipo di ordine
Definisce come deve essere gestito un ordine. I due tipi principali sono:
Ordine: un ordine standard che verrà elaborato subito
Bozza: un ordine salvato per essere modificato e inviato in un secondo momento
Stato dell'ordine
Indica la fase attuale di un ordine nel processo di realizzazione. Gli stati principali sono:
Bozza: ordine creato ma non ancora inviato per l'elaborazione
Ricevuto: ordine inviato e in fase di prima verifica
Confermato: l'ordine ha superato i controlli di validazione
Errore: l’ordine non ha superato i controlli di validazione
Creato: ordine convalidato e pronto per la produzione
In produzione: l'ordine è in lavorazione
Stampato: la produzione è terminata
Imballato: l'ordine è pronto per la spedizione
Spedito: l'ordine è stato consegnato al corriere
Consegnato: l'ordine è stato recapitato al destinatario
Annullato: l'ordine è stato annullato su richiesta o dal sistema
Articolo ordinato
Un prodotto singolo all'interno di un ordine. Ogni articolo ha le sue specifiche, quantità e file. Puoi inserire più articoli in un unico ordine.
ID di riferimento dell'articolo
Il tuo identificatore unico per un articolo specifico all'interno di un ordine. Ti aiuta a tenere traccia dei singoli prodotti in un ordine più grande.
Metodi per identificare i prodotti
UID del prodotto
Un identificatore unico per una configurazione specifica di prodotto nel sistema GelatoConnect. I UID dei prodotti seguono un formato strutturato che racchiude le caratteristiche del prodotto.
Esempio:flat_product_pf_a4_pt_200-g/mq-non patinato_cl_4-0_ct_none_prt_none_sft_none_set_none_hor
Questo identificatore contiene informazioni codificate su:
Tipo di prodotto (
flat_product)Formato carta (
pf_a4)Tipo di carta (
pt_200-g/mq-non patinato)Configurazione dei colori (
cl_4-0significa 4 colori sul fronte, 0 colori sul retro)Altre specifiche (taglio, stampa, ecc.)
Orientamento (
horper orizzontale)
Prodotto personalizzato
Un modo semplice per identificare i prodotti usando il nome del prodotto e la struttura delle varianti; questo metodo è più intuitivo e facile da gestire, soprattutto quando il catalogo prodotti è complesso.
Esempio:
{"productName": "Biglietto da visita","productVariant": {"Size": "Standard","Paper": "Premium opaco","Colore": "Stampa a colori su entrambi i lati"}}Gestione dei file
File di stampa
Il file sorgente che contiene l'opera d'arte da stampare. Di solito è un file PDF, PNG o JPEG, a seconda delle esigenze del prodotto.
URL del file
Il luogo dove è possibile accedere al file di stampa. Deve essere un URL accessibile pubblicamente da cui GelatoConnect può scaricare il file.
Tipo di file
Definisce il ruolo del file nel prodotto. I tipi più comuni sono:
predefinito: il file di stampa principale per il prodotto
fronte: Il file per il fronte di un prodotto
retro: il file per il retro di un prodotto
copertina: Il file per la copertina di un libro
interno: il file per le pagine interne di un libro
File elaborato
La versione pronta per la produzione del file di stampa dopo che GelatoConnect ha applicato tutte le trasformazioni necessarie.
Anteprima
Una rappresentazione visiva di come apparirà il prodotto finale in base ai file di stampa forniti.
Informazioni sulla spedizione
Indirizzo di spedizione
L'indirizzo di destinazione dove l'ordine deve essere consegnato, inclusi i dettagli della persona che lo riceve.
UID metodo di spedizione
Un identificatore per il metodo di spedizione da usare per l’ordine; può essere specifico (fed_ex_2_day) o generico (express).
Indirizzo di reso
L'indirizzo che useremo come mittente sul pacco e per eventuali resi.
Codice di tracciamento
Un identificatore unico fornito dal corriere per seguire il percorso di consegna del pacco.
URL di tracciamento
Un indirizzo web dove il cliente può controllare lo stato attuale della sua spedizione.
Concetti di integrazione
API
Application Programming Interface: il modo per interagire in modo programmato con GelatoConnect. Usa i metodi HTTP standard (GET, POST, PUT, ecc.) per gestire gli ordini.
Chiave API e segreto
Credenziali di sicurezza utilizzate per autenticare le richieste all'API di GelatoConnect. Sono composte da una coppia di chiave e segreto, che deve essere inserita nell'intestazione X-API-KEY nel formato "chiave:segret".
Webhook
Un callback HTTP che invia notifiche sugli eventi di GelatoConnect direttamente al tuo sistema, in tempo reale.
Postback
Una notifica inviata da GelatoConnect al tuo sistema (o ai tuoi clienti) quando lo stato di un ordine cambia.
Mappatore di template
Uno strumento che ti permette di trasformare i dati dal tuo formato a quello di GelatoConnect, usando il linguaggio di template Jinja2.
Cerca
Una tabella di conversione che trasforma i valori del tuo sistema (ad esempio i codici SKU dei prodotti) nei valori di GelatoConnect (come gli UID dei prodotti).
Vetrina online
Una piattaforma e-commerce (come Shopify, Etsy o WooCommerce) che puoi collegare a GelatoConnect per importare automaticamente gli ordini.
FTP
File Transfer Protocol: un modo semplice per caricare i file degli ordini su GelatoConnect e gestirli tutti insieme.
Termini finanziari e di fatturazione
Valuta
L'unità monetaria in cui verranno addebitati gli ordini. Deve essere specificata per ogni ordine utilizzando i codici valuta ISO (ad esempio, USD, EUR, GBP).
Prezzo al dettaglio
Il prezzo che chiedi al cliente finale per un prodotto, di solito usato per le dichiarazioni doganali nelle spedizioni internazionali.
Concetti avanzati
Richiesta d'ordine
La presentazione iniziale di un ordine prima che venga completamente elaborato e convalidato.
Metadati
Informazioni aggiuntive collegate a un ordine come coppie chiave-valore, utili per il monitoraggio, l’analisi o l’integrazione. I metadati possono essere applicati ai singoli articoli dell’ordine o all’intero ordine.
Controllo prima del via
Validazione automatica dei file di stampa per assicurarsi che rispettino i requisiti di produzione.
Workflow Builder
Uno strumento per definire le fasi di produzione di ogni tipo di prodotto.
Glossario delle abbreviazioni
Abbreviazione | Definizione |
PSP | Fornitore di servizi di stampa |
API | Interfaccia di programmazione delle App |
FTP | Protocollo di trasferimento file |
UID | Identificatore univoco |
Interfaccia utente | Interfaccia utente |
SLA | Accordo sul livello di servizio |
EDI | Scambio elettronico di dati |
B2B | Da business a business |
B2C | Da chi crea a chi acquista |
CSV | Valori separati da virgola |
JSON | Notazione a oggetti JavaScript |
XML | Linguaggio di marcatura estensibile |
Vuoi saperne di più?
Ora che conosci i termini e i concetti più usati nei sistemi di gestione ordini di GelatoConnect, sei prontə per:
Comprendi la documentazione e i messaggi di errore
Muoviti sulla piattaforma con più sicurezza
Per informazioni più dettagliate su aspetti specifici della ricezione degli ordini, dai un'occhiata alle sezioni dedicate nel nostro Centro di assistenza.