Negozio online (e-commerce)

Puoi collegare il tuo negozio online (ad esempio ExoShop) a EXOfattura: il negozio crea clienti, preventivi e fatture, incassa con RoxPay e tiene allineati articoli e giacenze con il tuo magazzino.

Cosa serve

1. Un piano con le API REST esterne (Medio o Avanzato) e, per i pagamenti, RoxPay collegato (vedi Pagamenti RoxPay).
2. Una API key dedicata al negozio: Sistema → Impostazioni, scheda Generale, riquadro API Key — Integrazioni esterne, «Genera API key» (solo proprietario o legale rappresentante). Copiala subito e consegnala a chi configura il negozio: non sarà più visibile.
3. Nella riga della chiave, campo Domini autorizzati: scrivi l'indirizzo del negozio (es. negozio.it, vale anche per www.negozio.it) e clicca «Salva». Solo verso questi siti il cliente può essere riportato dopo il pagamento.

Attenzione

Se il dominio non è tra quelli autorizzati il negozio riceve un errore e non può creare il link di pagamento con il ritorno al sito.

Cosa succede con un ordine pagato con carta

1. Il negozio crea il cliente (senza doppioni: lo ritrova dal suo codice, dalla partita IVA o dal codice fiscale) e il preventivo dell'ordine.
2. Il cliente paga sulla pagina di pagamento con il logo della tua azienda. Se ci ripensa può usare «Annulla e torna al negozio».
3. A pagamento riuscito il cliente torna al negozio; in EXOfattura il preventivo diventa fattura già incassata.
4. Se il negozio lo ha chiesto, la fattura parte da sola verso lo SDI subito dopo il pagamento; il negozio vede poi se è stata consegnata, non consegnata o scartata.
5. Il magazzino viene scaricato con il riferimento dell'ordine.

Il link di pagamento può avere una scadenza (es. 30 minuti): dopo, la pagina mostra «Link scaduto» e il negozio libera la merce che aveva tenuto da parte per il cliente.

Articoli e giacenze

• Ogni articolo ha uno SKU (codice) unico: se provi a usare un codice già presente ricevi un avviso. Le varianti (taglia, colore) sono articoli separati, ognuno con il proprio codice e la propria giacenza, collegati all'articolo principale.
• Quando modifichi un articolo o la giacenza in EXOfattura (carico, DDT, inventario, trasferimento, reso), il negozio viene avvisato e si aggiorna da solo.
• Il negozio può prenotare la merce durante il pagamento: la giacenza non cambia, ma la quantità disponibile cala finché l'ordine non viene confermato o la prenotazione scade.
• L'immagine dell'articolo caricata dal negozio compare anche in EXOfattura.

Resi e rimborsi

Quando il negozio rimborsa un ordine pagato con RoxPay, in un solo passaggio:

• il pagamento viene stornato al cliente;
• viene creata la nota di credito (totale o solo per le righe rese);
• se richiesto, la merce resa viene caricata a magazzino.

Trovi la nota di credito in Vendite → Note di credito; se non è stata inviata allo SDI in automatico, inviala da lì (vedi Note di credito).

Domande frequenti

Il negozio può vedere tutti i miei dati? La API key dà accesso completo all'azienda: usane una per ogni negozio o software e revocala quando non serve più («Revoca» nella riga della chiave).

Ho cambiato dominio al negozio. Aggiorna Domini autorizzati nella riga della chiave e clicca «Salva».

Il cliente ha pagato dopo la scadenza del link. Succede di rado (ad esempio se il pagamento era già in corso): il pagamento viene comunque registrato e la fattura emessa, e il negozio ne viene avvisato.