(Ultimo aggiornamento documentazione – 28/10/2021 – Versione modulo 6.5.4)
Gestione ordini eBay con Fastbay
In questa sezione puoi importare gli ordini eBay relativi ai prodotti sincronizzati e controllare eventuali errori o ordini incompleti.
Il modulo permette di scaricare gli ordini in due modalità:
- Manuale – puoi avviare una ricerca e selezionare gli ordini che desideri importare in Prestashop;
- Automatica (cronjob) – puoi impostare un’attività pianificata sul tuo server per scaricare in automatico tutti gli ordini completi e conformi.
Il riconoscimento degli ordini avviene grazie al controllo dell’etichetta personalizzata eBay, che Fastbay compila automaticamente in fase di invio prodotti.
Se un ordine eBay non contiene questa etichetta, oppure l’etichetta non è riconducibile a un prodotto del tuo sito, l’ordine non sarà importato.
Scaricamento manuale degli ordini
Il procedimento è semplice:
- Clicca su per interrogare eBay;
- Verrà mostrata una tabella con tutti gli ordini in attesa di scaricamento;
Di default, vengono mostrati solo gli ordini con stato Complete (ovvero quelli in cui l’acquirente ha già completato il pagamento su eBay).
Seleziona uno o più ordini e clicca SCARICA GLI ORDINI SELEZIONATI.
Al termine dell’operazione vedrai un messaggio verde di conferma con l’ID ordine Prestashop.
Se un ordine non può essere scaricato, comparirà un avviso rosso con il motivo dell’errore:
In caso di errori lato server, verrà mostrato un messaggio con i dettagli tecnici:
Se ottieni errori ricorrenti, puoi escludere temporaneamente altri moduli collegati all’hook validateOrder dal tab Debug di Fastbay.
In alternativa, attiva la modalità Debug di Prestashop (Parametri Avanzati) per ottenere log più dettagliati.
Scaricamento automatico con CRON
Per automatizzare l’importazione puoi impostare un cron sul tuo server, utilizzando il link disponibile nella sezione Importazione ordini del modulo.
L’operazione di cron esegue le stesse azioni della ricerca manuale, ma in automatico.
Ricorda che ogni marketplace ha il suo link dedicato: se hai più paesi configurati, dovrai impostare più cron.
Al termine, il cron restituirà un report in formato JSON con i dettagli degli ordini importati ed eventuali errori:
Errori più comuni
Ecco un elenco di errori che possono comparire durante lo scaricamento ordini e come interpretarli:
- Ordine già importato: non è un errore, significa semplicemente che l’ordine è già presente in Prestashop.
- Ordine non completo: l’acquirente non ha terminato il pagamento su eBay. Per sicurezza, Fastbay non importa di default ordini incompleti.
- Email cliente non valida: eBay nasconde l’email dopo 15 giorni, quindi imposta un range di scaricamento più breve.
- Corriere non configurato: devi mappare i corrieri eBay ai corrieri Prestashop. Consulta la sezione “Spedizioni”.
- Paese non valido: l’ordine proviene da un paese non attivo o senza codice ISO corretto in Prestashop.
- Prodotto non trovato: il prodotto collegato non esiste più o è stato disattivato. Devi riattivarlo o risincronizzarlo.
- Variante mancante: la combinazione è stata cancellata o ricreata in Prestashop dopo l’invio a eBay.
- Nessuna corrispondenza etichetta: l’etichetta personalizzata eBay non corrisponde a nessun prodotto Prestashop.
- Stock insufficiente: la quantità su Prestashop è inferiore rispetto a quanto venduto su eBay.
- Marketplace errato: l’ordine proviene da un marketplace non configurato in Fastbay.
- Eccezione Prestashop: un errore interno di Prestashop ha interrotto l’importazione. Verrà mostrato il messaggio tecnico ricevuto.
Se incontri errori non elencati, consulta la sezione FAQ – Sincronizzazione / Ordini prima di contattare il supporto.
Esportazione ordini verso eBay
Fastbay aggiorna automaticamente lo stato “spedito” e “pagato” e invia i codici di tracciabilità quando lo stato ordine cambia in Prestashop.
Questo avviene tramite il sistema di Hook nativo di Prestashop: non è necessario impostare cron se gestisci gli ordini normalmente dal back office.
Se usi strumenti esterni che non sfruttano gli hook, puoi attivare l’esportazione via cron dalla sezione Esportazione ordini.
In questo caso, imposta una frequenza di esecuzione ogni 24 ore.
- Codici tracciabilità via CRON: indica quanti ordini con tracking sono stati inviati a eBay sul totale degli ordini.
- Report CSV ordini senza codice: puoi scaricare un file CSV con la lista di ordini che non hanno ancora un codice di tracking.
Impostazioni principali
Filtro ordini – comportamento standard
Di default, Fastbay utilizza come etichetta personalizzata eBay la stringa prestashop-ID_prodotto
(esempio: prestashop-34
).
Per i prodotti con combinazioni, viene aggiunto anche l’ID della variante (es. prestashop-34-1
).
Personalizzazione del filtro ordini
Puoi modificare il prefisso del filtro ordini (di default “prestashop”).
Se lo cambi, ricordati di risincronizzare subito tutti i prodotti, altrimenti gli ordini precedenti non verranno più riconosciuti.
Con configurazioni multi-marketplace, puoi usare filtri diversi per distinguere gli ordini dei vari paesi.
Opzioni di configurazione
- Scarica ordini ultimi N giorni: imposta il numero di giorni da considerare per la ricerca ordini.
- Scarica ordini anche senza stock: consente di importare ordini anche se il prodotto non ha disponibilità.
- Usa email fittizia: sostituisce l’email reale dell’acquirente con un indirizzo generato automaticamente, evitando invii dal tuo e-commerce.
- Usa codice fiscale fittizio: inserisce “00000” se eBay non fornisce il dato, utile quando il campo è obbligatorio in Prestashop.
- Scarica messaggi clienti: importa i messaggi lasciati dagli acquirenti su eBay (su Prestashop 1.7 potrebbero non essere visibili per un bug noto – vedi qui).
- Usa regole tasse Prestashop: applica le percentuali IVA configurate in Prestashop in base al paese dell’ordine eBay.
- Abilita ordini incompleti: permette di importare ordini senza pagamento completato.
Gli ordini incompleti avranno uno status dedicato e, in caso manchi l’indirizzo, verrà creato un cliente/indirizzo temporaneo. - Importa ID ordine eBay nel pagamento Prestashop:
- Usa riferimento prodotto come etichetta eBay: imposta il riferimento Prestashop come etichetta personalizzata al posto del filtro standard.
Nota Tutti i prodotti devono avere un riferimento valido e univoco.
Nella sezione Utility trovi uno strumento per identificare riferimenti duplicati o mancanti.
Stato ordini in arrivo
In questa sezione puoi mappare lo stato Prestashop corrispondente agli stati di pagamento ricevuti da eBay.
Aggiornamento stato ordini eBay
Qui puoi mappare lo stato ordine Prestashop che verrà inviato a eBay quando l’ordine cambia stato nel tuo sito.