Documentazione
Ordini verso Business Central
Il flusso ordini replica il modo in cui il tuo gestionale registra già gli ordini e-commerce: ordine di vendita intestato a un cliente di appoggio, dati reali dell’acquirente sul documento, spese di trasporto come riga conto, riferimento del negozio sul documento. Tutto configurabile da Impostazioni → Flussi → Ordini.
Il ciclo di vita di un ordine
- 1Il cliente ordina sul negozio: il modulo notifica la piattaforma in tempo reale (ordine visibile in dashboard con tutti i dati).
- 2Quando l’ordine entra nello stato trigger che hai scelto (es. “Pagamento accettato”), viene marcato pronto e inviato a Business Central come ordine di vendita.
- 3Il magazzino/gestionale lavora l’ordine; con la verifica di evadibilità la piattaforma rileva righe ridotte o rimosse.
- 4Se mancano righe e la gestione è attiva: l’ordine sul negozio viene riallineato, il cliente riceve un buono di compensazione del valore pagato e (se Klaviyo è collegato) un evento per la notifica.
Configurazione
| Impostazione | Cosa fa |
|---|---|
| Stato trigger | lo stato PrestaShop che fa partire l’invio (oppure “alla creazione”) |
| Cliente BC ordini web | il No. cliente di appoggio su cui vengono creati gli ordini (es. il conto “corrispettivi e-commerce” già usato dall’amministrazione) |
| Ordini con richiesta fattura | se l’ordine ha P.IVA/CF/SDI, la piattaforma cerca il cliente reale su BC (per P.IVA, poi email) e se non esiste lo crea con i dati fiscali |
| Conto CoGe trasporto | le spese di spedizione arrivano come riga conto CoGe (imponibile) |
| Conto CoGe sconti | gli sconti ordine come riga negativa (opzionale) |
| Dimensioni globali 1/2 | valori dimensione impostati su ogni ordine creato (es. il canale e-commerce) |
| Causali fattura/scontrino | il tipo operazione della localizzazione italiana; inviato quando il partner BC espone il campo via estensione |
| Campi da trasferire | quali dei campi dello snapshot ordine trasferire (indirizzi, righe, totali, pagamento, vettore…) |
Regole sui prezzi
- I prezzi li governa il negozio: le righe arrivano con il prezzo PrestaShop (imponibile) e gli sconti automatici dei listini/accordi commerciali BC vengono azzerati.
- Il documento è creato a prezzi IVA esclusa anche se il cliente BC ha “Prezzi IVA inclusa” attivo, così i totali coincidono con il negozio.
- Il riferimento PrestaShop finisce nel Nr. documento esterno.
Verifica di evadibilità
La verifica confronta le righe dell’ordine su Business Central con lo snapshot originale e classifica l’ordine: evadibile (tutte le righe intatte), parzialmente evadibile (righe ridotte/rimosse) o non evadibile. Non è mai a intervalli di tempo — parte in due modi, a tua scelta:
- Manuale: pulsante “Verifica su BC” sulla pagina dell’ordine.
- Webhook: Business Central (o il processo del magazzino) chiama l’URL dedicato quando l’ordine è stato lavorato — la verifica scatta in quell’istante.
Righe non disponibili e buono
Con la gestione attiva, alla prima transizione a “parzialmente/non evadibile” la piattaforma comanda al modulo di:
- riallineare le quantità dell’ordine sul negozio a quelle rimaste su BC (lo stock non viene toccato: lo governa il sync);
- generare un buono monouso intestato al cliente, del valore pagato (IVA inclusa) delle righe mancanti, con scadenza configurabile (1–12 mesi);
- aggiungere una nota di tracciabilità sull’ordine;
- inviare l’evento
iConnect Order Modifieda Klaviyo (se collegato) con righe rimosse, importo e codice buono.
Requisito
La gestione delle righe non disponibili richiede il modulo v0.4 o successivo; le righe conto CoGe (trasporto/sconti) richiedono la v0.4.1+.