Files
Khaemhat/docs/wiki/Canali-e-commerce.md
T
Alby96andClaude Opus 5.5 88de272b3e docs: avoid ambiguous Unicode and record Gitea planning in STATUS
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>
2026-11-10 22:44:14 +01:00

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

070 · Ordini dai canali 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

  1. Gli ordini arrivano dal canale (API o file) o con Importa adesso.
  2. Khaemhat cerca il cliente (abbinamento all'anagrafica o cliente cassa) e gli articoli del canale.
  3. Se tutto è abbinato crea l'ordine cliente nel sezionale del canale (Vendite).
  4. 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