Passa al contenuto principale

Introduzione

Questa sezione fornisce una guida rapida alla struttura delle entità di Webround Commerce, illustrandone la funzione e la logica sottostante. L'obiettivo non è approfondire i dettagli tecnici delle API o dei tipi di dati specifici, ma fornire una panoramica descrittiva del loro ruolo e di come siano strategicamente posizionate all'interno del flusso di business. Comprendere queste entità permette di avere una visione chiara di come viene gestito l'intero ciclo operativo, dal catalogo alla vendita.

Il Cuore del Catalogo

In Webround Commerce, la gestione del catalogo segue una gerarchia precisa che riflette le logiche di vendita e di magazzino. La struttura si basa su due livelli: Prodotto e Variante.

La gerarchia segue questo flusso: Prodotto (Template) → Variante (Unità di acquisto)

Prodotto: Il Template Generale​

Il Prodotto funge da modello generale. Identifica la merce in modo generalizzato (ad es. "T-shirt Icon") e ne definisce le caratteristiche comuni. È a questo livello (insieme alla variante) che vengono gestiti peso e dimensioni per la spedizione.

Le Opzioni (ad es. "Taglia") sono definite sul Prodotto. Queste opzioni specificano le scelte d'acquisto disponibili per quel prodotto. Definendo un'opzione "Taglia" con i valori "S, M, L, XL", stabiliamo gli assi su cui una Variante può essere posizionata. È possibile collegare più opzioni in parallelo per ricostruire matrici di scelta complesse.

Variante: L'Unità di Acquisto​

La Variante è l'unità di acquisto completa e autonoma in Webround Commerce.

Ogni Variante porta con sé:

  • Identità: nome, slug, codici commerciali (stringa SKU, EAN, MPN, UPC, GTIN, ISBN, ASIN, codice fornitore, codice HS).
  • Inventario: quantità in stock, regole per il backorder, quantità massima d'ordine.
  • Prezzi: uno o più oggetti Price che coprono valute, cadenze, prezzi di confronto e prezzi a scaglioni basati sulla quantità.
  • Opzioni: una mappa dei valori delle opzioni selezionate (ad es. {"ID_OPZIONE_TAGLIA": "ID_VALORE_XL"}), che definisce la posizione di questa variante nella matrice delle opzioni del prodotto.
  • Asset, Attributi, Tag, Spedizioni, Tasse: tutti posseduti direttamente o ereditati dal Prodotto padre.

Pensa a una vetrina di un negozio: ciò che vedi esposto — il modello in un colore e in una taglia specifica — è la Variante. Non esiste alcun livello intermedio tra ciò che vedi e ciò che puoi aggiungere al carrello.

In Sintesi: L'Esempio della T-shirt​

  1. Prodotto: Il template "T-shirt" dove definiamo l'opzione "Taglia" (S, M, L, XL) e l'opzione "Colore" (Bianco, Nero, Verde).
  2. Variante: Per ogni specifica combinazione pronta per l'acquisto — ad es. "T-shirt Bianca – XL" — creiamo una Variante. Essa possiede il prezzo, il livello di stock, l'EAN e la mappa dei valori delle opzioni che la identifica all'interno della matrice.

Questa struttura semplifica sia il modello dei dati che la superficie delle API: esiste esattamente un'unica entità da creare, prezzare e stoccare. Non è richiesto alcun livello di raggruppamento intermedio.

Flessibilità Illimitata​

La forza di questa architettura risiede nella sua adattabilità. I cataloghi di Webround Commerce si estendono virtualmente a qualsiasi tipo di attività: che tu gestisca un negozio di abbigliamento, una profumeria, un'enoteca, un ristorante, una concessionaria o offra servizi di consulenza online, la struttura Prodotto → Variante è in grado di plasmarsi sulle tue esigenze.

Per i prodotti senza opzioni significative (ad es. un articolo a configurazione singola), è sufficiente una sola Variante. Per matrici complesse (colore × taglia × peso), ogni combinazione mappa su una distinta Variante, ognuna con prezzo e stock indipendenti.

Grazie a questa gerarchia altamente specializzabile e flessibile, Webround Commerce non impone un modello rigido, ma fornisce gli strumenti per mappare con precisione ogni flusso operativo, assicurando che ogni singola entità rifletta esattamente la realtà del tuo catalogo fisico o digitale.

Estensibilità

Grazie a API, Webhook e altre entità presenti nel sistema gestionale, è semplice adattare Webround Commerce per la gestione generalizzata di clienti, prodotti in vendita e gestione del magazzino, anche se non crei un sito web o non effettui vendite online tramite esso.

Puoi estendere questo strumento come desideri, creando integrazioni di ogni tipo. Risparmia sui costi di gestione della tua attività grazie a Webround Commerce.