Gitea flags en dash, multiplication sign, minus sign and single angle quotes as confusable characters, which put a warning on most pages; use plain equivalents (docs/SPEC.md stays untouched). STATUS.md now lists the issue numbers per milestone, the items waiting for the owner and the open specification questions tracked by issue #114. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
4.1 KiB
Canali e-commerce
Stato: bozza · Ultima revisione: 2026-11-10 · Versione software: non ancora rilasciata (fase 2, milestone M14) Modulo di licenza: CHAN · Permessi principali:
channels.channel.manage,channels.order.import,channels.sync.run· Specifica: SPEC §11.11, §15, §20
Questo modulo appartiene alla fase 2 (milestone M14, versioni 1.1 e successive): non sarà presente nella versione 1.0. La pagina descrive ciò che prevede la specifica.
A cosa serve
Il modulo collega Khaemhat ai canali di vendita online (negozio web, marketplace): importa gli ordini web come ordini cliente, abbina clienti e articoli e sincronizza in uscita giacenze e prezzi. La prima versione fornisce un connettore generico; i connettori dedicati ai singoli marketplace o piattaforme arriveranno come implementazioni successive.
Dove si trova
Menu laterale Canali e-commerce → Ordini web e l'elenco dei canali configurati nella stessa pagina.
Schermate
Mockup 070 — ordini web importati con canale, acquirente, righe, totale, pagamento, spedizione e stato dell'importazione; sotto, i canali configurati con cliente cassa, sezionale, deposito, frequenza di sincronizzazione e ultimo import (anteprima ridotta)
Canali
Ogni canale ha:
| Campo | Significato |
|---|---|
| Codice e tipo | generico oppure connettore dedicato |
| Credenziali | conservate cifrate |
| Cliente cassa | anagrafica usata per gli acquirenti occasionali (es. "Clienti web") |
| Sezionale | sezionale degli ordini e dei documenti del canale |
| Pagamento, deposito | condizioni predefinite e deposito da cui scaricare |
| Mappature | corrispondenza fra metodi di pagamento e spedizione del canale e quelli di Khaemhat |
| Sincronizzazione | frequenza dell'invio di giacenze e prezzi |
Gli articoli pubblicati sul canale e i clienti del canale hanno tabelle di corrispondenza proprie (articolo del canale ↔ articolo Khaemhat, cliente del canale ↔ anagrafica).
Connettore generico
Il connettore generico accetta ordini in JSON o CSV:
- via API:
POST /api/v1/channels/{code}/orders, dove{code}è il codice del canale; richiede una chiave API del modulo API (vedi API e API e MCP); - via file: caricamento di un file JSON o CSV con Importa adesso.
Il contenuto ricevuto è conservato così com'è (payload JSON) insieme allo stato dell'importazione. Il formato preciso
del messaggio sarà pubblicato nella documentazione OpenAPI (/api/v1/openapi.json).
Importare e gestire gli ordini
- Gli ordini arrivano dal canale (API o file) o con Importa adesso.
- Khaemhat cerca il cliente (abbinamento all'anagrafica o cliente cassa) e gli articoli del canale.
- Se tutto è abbinato crea l'ordine cliente nel sezionale del canale (Vendite).
- Le righe con problemi restano in attesa con uno stato esplicito.
| Stato dell'importazione (esempi del mockup) | Cosa fare |
|---|---|
| Ordine creato (con numero dell'ordine) | nulla: prosegue in Vendite |
| Cliente abbinato | ordine pronto da creare |
| Articolo non mappato | Abbina articolo e riprova |
| Errore (es. dati IVA non coerenti) | correggi la mappatura o il canale e riprova |
Sincronizzazione di giacenze e prezzi
Sincronizza giacenze e prezzi invia al canale le disponibilità del deposito collegato e i prezzi del listino; la stessa operazione gira in automatico con la frequenza impostata sul canale (es. ogni 15 o 30 minuti). La sincronizzazione è in uscita: Khaemhat è la fonte delle giacenze.
Permessi e licenza
Serve il modulo CHAN; per ricevere ordini via API serve anche il modulo API. I codici dei permessi in testa
sono indicativi (convenzione modulo.entità.azione, SPEC §7.2) e saranno fissati in sviluppo.
Pagine correlate
Vendite · Magazzino · Articoli e listini · API · API e MCP · Automazioni · Roadmap