Catalogo

Crea il catalogo prodotti: moduli (versioni/rilasci), componenti aggiuntivi (funzionalità della piattaforma) e bundle (piani che i clienti acquistano).

Percorsi di amministrazione:

• Admin → Moduli
• Admin → Componenti aggiuntivi
• Admin → Pacchetti

Moduli (dal modulo al rilascio)

Un modulo è un’estensione di NexoPOS che la piattaforma può installare su installazioni autorizzate. Ogni modulo ha una o più versioni (rilasci).

Crea un modulo

1. Admin → Moduli → Crea.
2. Imposta nome, slug, descrizione.
3. Opzionale: repository GitHub predefinito + visibilità per le versioni.
4. Stato: disponibile / non disponibile; consenti aggiornamenti quando non disponibile determina se le installazioni esistenti possono ancora aggiornarsi.

Pubblica una versione (rilascio)

Apri il modulo → aggiungi versione:

Contrassegna la versione pubblicata in modo che possa essere selezionata per installazioni/aggiornamenti.

Flusso di lavoro:

Create module
  → Add version (GitHub ref or ZIP)
  → Publish version
  → Attach module to one or more bundles
  → Customer installs/updates from entitled bundle

Segnaposto screenshot: pagina di visualizzazione del modulo con elenco delle versioni e azione Pubblica

Consigli

• Preferisci tag semver come github_ref per la riproducibilità.
• I repository di moduli privati richiedono un PAT GitHub valido da Admin.
• Il canale Core NexoPOS (latest/pinned) è separato in Impostazioni → GitHub.

Componenti aggiuntivi

I componenti aggiuntivi sono diritti a pagamento opzionali su un’installazione (non a livello di organizzazione). Oggi sono collegate solo due chiavi di funzionalità della piattaforma:

Crea un componente aggiuntivo

1. Admin → Componenti aggiuntivi → Crea.
2. Caratteristica — seleziona dal menu a discesa (non testo libero). Scegliere la chiave sbagliata significa che l’interfaccia non si sbloccherà mai.
3. Nome, descrizione, prezzo (centesimi), valuta, intervallo di fatturazione (mensile / annuale / una tantum).
4. Disponibilità — ad es. pubblicata (acquistabile), nascosta, ecc.
5. Salva.

Interazione in modalità dominio

Interazione dei backup

• Richiede l’add-on di backup pubblicato + un diritto attivo durante l’installazione.
• Archiviazione e pianificazione provengono da Impostazioni → S3 / Backup, non solo dal prezzo dell’add-on.

Pacchetti (piani)

Un pacchetto è ciò a cui i clienti si abbonano per ogni installazione. Include:

• Prezzi (prova / introduttivo / ricorrente)
• Limiti delle risorse (disco, etichetta/condivisione CPU)
• Moduli inclusi
• Funzionalità di marketing / badge
• Disponibilità (pubblicata, ecc.)

Campi di prezzo spiegati

Verifica crea le righe dell’ordine in base a queste regole all’interno di BillingService (indipendente dal gateway).

Come interagiscono le versioni di prova, introduttive e ricorrenti

Pensa a tre leve:

1. Solo prova — il cliente inizia senza pagare l’intero importo ricorrente; l’abbonamento è in prova finché la prova non termina, dopodiché si applica la normale riscossione / periodo di tolleranza. Esempio (seed Professional): trial_days = 14, intro 0, ricorrente $49.
2. Prezzo di ingresso senza prova — la prima tariffa usa i centesimi di ingresso; ricorrente è il prezzo di listino successivamente / nei rinnovi. Esempio (seed Starter): ingresso $1 (100 centesimi), ricorrente $19, prova 0.
3. Né — la prima addebito utilizza immediatamente il prezzo ricorrente.

Importante:

• La prova è per il checkout di una nuova installazione, non un posto gratuito a tempo indeterminato.
• Gli acquisti aggiuntivi a metà ciclo di vita sono voci separate / elementi del gateway.
• I coupon (se configurati) si applicano al momento del checkout quando sono validi.

Esempi svolti

Stile da principiante

Il cliente paga l’importo di introduzione al primo checkout riuscito (secondo le regole del gateway), quindi in modo ricorrente successivamente.

Stile professionale

Il cliente può iniziare senza una fattura completa pagata durante la prova; dopo la prova si applicano le regole di riscossione del pagamento e di tolleranza/sospensione.

Allega moduli

Nel modulo di bundle, seleziona quali moduli sono inclusi. Solo i moduli per i quali hai i diritti di accesso vengono visualizzati per l’installazione/aggiornamento sulle installazioni del cliente.

Pubblica il bundle

Imposta disponibilità su pubblicato e ordine di visualizzazione / badge in evidenza per la pagina Prezzi marketing.

Ordine consigliato di configurazione del catalogo

1. Configura le impostazioni di GitHub.
2. Crea moduli + pubblica almeno una versione ciascuno.
3. Crea componenti aggiuntivi (custom_domain, backup) se li vendi.
4. Crea bundle, collega moduli, imposta prova/introduzione/ricorrente.
5. Pubblica bundle e apri il pricing come cliente.
6. Configura la modalità Domain e S3 affinché i componenti aggiuntivi funzionino davvero end-to-end.