La pagina Boutique : paiement et transport (Negozio: pagamento e trasporto) della Console (dominio Offres et prix, Offerte e prezzi) è riservata all'editore di SheepOS. Collega il pagamento (Stripe Connect) e il trasporto (Boxtal) di tutti i negozi. Le chiavi inserite vengono cifrate al salvataggio e non vengono mai mostrate di nuovo. Ogni riquadro comprimibile della pagina riprende i passaggi qui sotto, con gli indirizzi da copiare. Vedi anche il negozio online.
Operazioni frequenti
Preparare il server
- Genera la chiave di cifratura sul server con il comando
openssl rand -base64 32. - Inserisci il risultato nella variabile d'ambiente INTEGRATIONS_TOKEN_KEY dell'API, mai in un file versionato né in un messaggio. Senza di essa, la pagina mostra un avviso e nessuna chiave può essere salvata.
- Per rinnovare la chiave senza perdere nulla, tieni la vecchia in INTEGRATIONS_TOKEN_KEY_PREVIOUS durante la rotazione.
Collegare Stripe Connect
- Nella dashboard di Stripe, attiva Connect con account Standard: ogni commerciante apre il proprio account e SheepOS non conserva alcun documento d'identità.
- In Sviluppatori, poi Chiavi API, copia la chiave segreta di test (sk_test_…) e, per la produzione, la chiave segreta sk_live_… (oppure una chiave limitata rk_live_…). Incollale nel campo «Clé secrète» (Chiave segreta) della modalità corrispondente.
- In Sviluppatori, poi Webhook, aggiungi un endpoint di tipo Connect. L'indirizzo è mostrato nella pagina, con un pulsante Copier (Copia): termina con /public/shop-payments/webhooks/stripe.
- Spunta gli eventi: checkout.session.completed, payment_intent.succeeded, payment_intent.payment_failed, charge.refunded, charge.dispute.created, charge.dispute.closed, account.updated, account.application.deauthorized, payout.created, payout.updated, payout.paid, payout.failed e payout.canceled.
- Copia il segreto di firma dell'endpoint (whsec_…) in «Secret de signature du webhook» (Segreto di firma del webhook). Crea un endpoint per modalità: ognuno ha il suo segreto.
- Salva, poi avvia Tester la connexion (Testa la connessione) in ogni modalità.
Collegare Boxtal
- Nel tuo account Boxtal, apri l'area sviluppatore e crea una chiave API: ottieni una chiave di accesso e una chiave segreta.
- Incollale nei campi della modalità corrispondente (chiavi della sandbox in test, chiavi di produzione in reale).
- Dichiara nei webhook di Boxtal l'indirizzo mostrato nella pagina (termina con /public/shop-carriers/webhooks/boxtal) e copia il segreto di firma nel campo previsto.
- Salva e testa la connessione in ogni modalità.
Impostare la commissione e il margine di trasporto
La commissione viene prelevata su ogni vendita (una percentuale con un massimale per ordine) e può variare in base all'offerta del commerciante. Il margine di trasporto si aggiunge al prezzo d'acquisto dell'etichetta (una percentuale con un minimo per collo). Le somme dovute a SheepOS vengono raggruppate ogni mese in una bozza di fattura, da rileggere prima dell'emissione.
Aprire la modalità reale
- Verifica che le chiavi di produzione siano salvate e che il test di connessione di produzione riesca.
- Premi Ouvrir le mode réel (Apri la modalità reale) poi conferma.
- I commercianti che avevano collegato un account in modalità test non possono più incassare finché non hanno rifatto la loro iscrizione a Stripe in produzione, dalla scheda Pagamento del loro negozio. Chiudere la modalità reale li rimette in prova.
Seguire tutti i negozi
Il dominio Offres et prix della Console propone anche la vista Boutiques (Negozi): tutti i negozi di tutte le organizzazioni clienti, solo in forma aggregata, senza alcun dato sugli acquirenti.
- Apri Offres et prix → Boutiques. In alto, dei contatori indicano il numero di negozi, tra cui quelli online, in bozza e sospesi.
- Cerca per negozio, organizzazione o indirizzo, filtra per stato (Brouillon (Bozza), En ligne (Online), Suspendue (Sospeso)) e per modalità di pagamento (Essai (Prova) o Réel (Reale)), poi ordina (organizzazione, nome, stato, prodotti, ordini o fatturato a 30 giorni, data di creazione).
- La tabella indica, per ogni negozio, l'organizzazione, lo stato, la modalità di pagamento, lo stato della connessione Stripe, il numero di prodotti, gli ordini e il fatturato a 30 giorni, la creazione e l'indirizzo della vetrina pubblica (pulsante Copier). Exporter en CSV (Esporta in CSV) scarica l'elenco.
- Apri un negozio per il suo Tableau de bord de la boutique (Dashboard del negozio): periodo (7 jours, 30 jours, 12 mois o Personnalisée, cioè Personalizzato), fatturato incassato, ordini pagati, carrello medio, tasso di conversione, ripartizione per canale (privati o professionisti), per modalità di consegna e per mezzo di pagamento, prodotti, resi, controversie e commissioni percepite, poi lo stato di configurazione (Fait (Fatto), À faire (Da fare), Conseillé (Consigliato)).
Lista di controllo finale
- INTEGRATIONS_TOKEN_KEY è definita sul server.
- Connect è attivato con account Standard, la chiave di produzione e il segreto del webhook Connect sono salvati, il test di produzione riesce.
- Il webhook Connect di produzione punta all'indirizzo mostrato e riceve gli eventi elencati.
- Boxtal: chiavi di produzione, segreto di tracciamento e webhook di tracciamento al loro posto.
- Commissione e margine impostati per ogni offerta.
- Il regime IVA, l'aliquota predefinita, il SIRET, il numero di IVA e l'indirizzo dell'organizzazione editrice sono compilati.
- Un commerciante ha concluso l'iscrizione a Stripe in produzione e ha ricevuto un pagamento end-to-end.
- La modalità reale viene aperta solo dopo tutti questi punti.
Da sapere
L'IVA delle fatture di commissione e di trasporto dipende dal regime dell'organizzazione editrice, quella indicata dalla variabile PLATFORM_ORGANIZATION_ID: senza regime IVA né numero, le sue bozze di fattura non possono essere emesse. SheepOS non dà alcuna consulenza legale né fiscale: fai convalidare queste impostazioni dal tuo commercialista.
