Loading Optiviera...

Documentazione

Documentazione Optiviera

Tutto ciò di cui hai bisogno per gestire la tua azienda in un'unica piattaforma

Optiviera è una piattaforma cloud all-in-one ERP + CRM + HelpDesk. Questa pagina copre tutti i moduli, i ruoli utente, i concetti chiave e le risorse per sviluppatori.

Navigazione rapida

Vai direttamente alla sezione desiderata

IniziaModuliRuoliConcetti chiaveStack tecnologicoRiferimento APIFAQ

Guida introduttiva

Operativo in pochi minuti

1

Crea il tuo account

Registrati su /register per creare la tua organizzazione. Il primo utente riceve automaticamente il ruolo Admin.

2

Configura il tuo tenant

Vai in Impostazioni → Tenant per impostare il nome dell'azienda, la valuta, il fuso orario, le informazioni fiscali e la lingua preferita.

3

Configura i reparti

Crea la gerarchia organizzativa in Impostazioni → Reparti. Assegna posizioni e collega i permessi a ciascuna posizione.

4

Invita il tuo team

Aggiungi dipendenti nel modulo HR. Assegnali a reparti e posizioni per controllare automaticamente l'accesso ai moduli.

5

Inizia a lavorare

Crea il tuo primo ticket, cliente o ordine di vendita. Tutti i dati sono completamente isolati nel tuo tenant fin dal primo giorno.

Moduli della piattaforma

12 moduli integrati che coprono ogni aspetto del tuo business

Helpdesk & Ticket

Helpdesk IT end-to-end con monitoraggio SLA, gestione priorità e thread di commenti.

  • Creazione & assegnazione ticket
  • Monitoraggio SLA & workflow stati
  • Livelli di priorità
  • Commenti & allegati
  • Collegamento ordini di lavoro
  • Esportazione PDF/Excel
Visualizza documentazione

CRM

Gestione completa della pipeline di vendita, dall'acquisizione lead alla chiusura delle opportunità.

  • Database clienti
  • Monitoraggio lead
  • Pipeline opportunità
  • Metriche prestazioni CRM
  • Collegamento vendite & fatturazione
Visualizza documentazione

Risorse umane

Gestisci personale, reparti, posizioni, ferie e valutazioni delle prestazioni.

  • Dati & profili dipendenti
  • Gerarchia reparti
  • Richieste & approvazioni ferie
  • Valutazioni prestazioni
  • Integrazione paghe
Visualizza documentazione

Paghe

Calcolo automatizzato degli stipendi con regole di paghe specifiche per paese, configurazione fiscale e blocco periodo.

  • Calcolo automatizzato paghe
  • Set di regole configurabili
  • Gestione tasse & festività
  • Blocco periodo
  • Esportazione paghe

Finanza & Contabilità

Contabilità in partita doppia completa: fatture, pagamenti, scritture contabili, riconciliazione bancaria e chiusura periodo.

  • Fatturazione AR & AP
  • Scritture & libro mastro
  • Riconciliazione bancaria
  • Report fiscali & IVA
  • Chiusura periodo
  • Fattura elettronica (DE/TR)
Visualizza documentazione

Vendite

Gestisci il ciclo di vendita completo: preventivi → ordini → consegne → fatture.

  • Generatore preventivi
  • Ordini di vendita
  • Monitoraggio consegne
  • Documenti di consegna (PDF)
  • Fatturazione automatica
Visualizza documentazione

Acquisti

Richieste di acquisto, ordini, ricevute merci e abbinamento OA con fornitori.

  • Richieste di acquisto
  • Ordini di acquisto
  • Gestione fornitori
  • Monitoraggio ricevute merci
  • Abbinamento OA
Visualizza documentazione

Magazzino

Catalogo prodotti, storico movimenti di magazzino e avvisi scorte minime.

  • Catalogo articoli & SKU
  • Registro movimenti magazzino
  • Avvisi scorte minime
  • Report magazzino
  • Collegamento vendite & acquisti
Visualizza documentazione

Ordini di lavoro

Crea e monitora ordini di lavoro sul campo o interni, collegati direttamente ai ticket helpdesk.

  • Creazione ordini di lavoro
  • Gestione voci
  • Monitoraggio stato
  • Assegnazione dipendenti
  • Flusso Ticket → Ordine di lavoro
Visualizza documentazione

Report & Analisi

Report finanziari, operativi e metriche aziendali integrati con esportazione PDF/Excel.

  • Report finanziari (P&L, bilancio)
  • Analisi ticket & HR
  • Report vendite & acquisti
  • Dashboard KPI
  • Esportazione PDF/Excel
Visualizza documentazione

Utenti & Permessi

Controllo degli accessi basato sui ruoli con gestione dei permessi a livello di posizione.

  • Ruoli Admin & Dipendente
  • Permessi basati sulla posizione
  • Granularità per modulo
  • Supporto multilingue
  • Gestione avatar & profilo
Visualizza documentazione

Operazioni (SuperAdmin)

Gestione tenant a livello di piattaforma, salute del sistema, log di audit e monitoraggio. Limitato agli account @optiviera.com.

  • CRUD tenant
  • Log di audit piattaforma
  • Dashboard salute sistema
  • Metriche Prometheus/Grafana
  • Ticket supporto piattaforma

Ruoli utente & Permessi

Controllo degli accessi granulare su ogni modulo

Admin

Livello tenant

Accesso completo a tutti i moduli del tenant. Può gestire utenti, impostazioni, fatturazione, reparti e posizioni.

  • Accesso a tutti i moduli (visualizza, crea, aggiorna, elimina, esporta)
  • Gestione utenti & permessi
  • Impostazioni tenant & fatturazione
  • Gerarchia reparti & posizioni
  • Accesso ai log di audit

Dipendente

Livello tenant

Ruolo predefinito per tutti i membri del personale. L'accesso è determinato dai permessi associati alla loro posizione.

  • Accesso ai moduli in base alla posizione assegnata
  • Creare & visualizzare i propri ticket
  • Aggiungere & modificare i propri commenti
  • Visualizzare il profilo & aggiornare le preferenze
  • Nessun accesso a fatturazione o impostazioni per default

SuperAdmin

Livello piattaforma

Solo personale Optiviera (@optiviera.com / @optiviera.de). Accesso cross-tenant per amministrazione e monitoraggio della piattaforma.

  • Tutti i dati tenant (cross-tenant)
  • Creare / sospendere / eliminare tenant
  • Metriche piattaforma & salute sistema
  • Eliminazione forzata record protetti
  • Gestione ticket supporto piattaforma

Ogni modulo supporta permessi granulari: visualizza, crea, aggiorna, elimina, gestisci, esporta. Finance supporta inoltre postJournalEntry, approveInvoice, closePeriod. Payroll supporta calculate, approve, lock. I permessi sono assegnati per posizione in Impostazioni → Posizioni.

Concetti chiave

Principi architetturali fondamentali della piattaforma

Multi-tenant

Ogni record contiene un TenantId. I dati sono completamente isolati tra le organizzazioni a livello di database — nessun tenant può mai accedere ai dati di un altro.

Autenticazione JWT

Il login restituisce un JWT firmato (HS256). Il token contiene userId e tenantId. Tutte le chiamate API sono automaticamente limitate al tuo tenant.

Permessi basati sulla posizione

I permessi sono associati alle posizioni (es. 'Contabile', 'Agente supporto'). Assegnare un dipendente a una posizione gli garantisce immediatamente l'accesso corretto.

Audit logging

Ogni creazione, aggiornamento ed eliminazione è registrata con snapshot JSON prima/dopo, identità utente, timestamp e tipo di entità.

i18n in 8 lingue

L'intera interfaccia è disponibile in inglese, tedesco, francese, italiano, spagnolo, polacco, olandese e turco. Gli utenti impostano la lingua preferita nel profilo.

Blocco periodo

I periodi contabili e di paghe possono essere bloccati per evitare modifiche retroattive. I periodi bloccati richiedono SuperAdmin o un'autorizzazione di sblocco esplicita.

Stack tecnologico

Moderno, scalabile e sicuro fin dalla progettazione

Backend

  • ASP.NET Core 8Framework Web API
  • Entity Framework CoreORM con provider Pomelo MySQL
  • MySQL 8Database relazionale principale
  • JWT BearerAutenticazione (HS256)
  • HangfireElaborazione job in background
  • Swagger / OpenAPIDocumentazione API auto-generata

Frontend

  • Nuxt 3 / Vue 3Framework app SSR
  • PrimeVue 4Libreria componenti UI (tema Aura)
  • PiniaGestione dello stato
  • TypeScriptTipizzazione rigorosa
  • @nuxtjs/i18nInternazionalizzazione 8 lingue
  • SCSSTemi personalizzati & design token

Osservabilità

  • PrometheusRaccolta metriche
  • GrafanaDashboard & alerting
  • PostHogAnalisi prodotto
  • Audit LogsMonitoraggio modifiche integrato

Integrazioni

  • StripeAbbonamento & fatturazione
  • SEPABonifici UE (SEPA)
  • e-InvoiceConformità e-Fattura DE/TR
  • PDF / ExcelEsportazione in tutti i moduli

Riferimento API

API RESTful con documentazione Swagger/OpenAPI completa

Autenticazione

  • POST /auth/register
  • POST /auth/login
  • GET /auth/me

Ticket

  • GET /tickets
  • POST /tickets
  • PUT /tickets/{id}
  • DELETE /tickets/{id}
  • GET /tickets/{id}/comments
  • POST /tickets/{id}/comments

Finanza

  • GET /invoices
  • POST /invoices
  • GET /journal-entries
  • POST /journal-entries
  • GET /bank-accounts
  • POST /bank-reconciliation

HR & Paghe

  • GET /employees
  • POST /employees
  • GET /departments
  • POST /payroll/calculate
  • GET /leaves
  • POST /leaves

Vendite

  • GET /sales-orders
  • POST /sales-orders
  • GET /quotations
  • POST /quotations
  • GET /deliveries
  • GET /customers

Acquisti

  • GET /purchase-orders
  • POST /purchase-orders
  • GET /suppliers
  • POST /goods-receipts
  • GET /purchase-requests

Magazzino

  • GET /items
  • POST /items
  • GET /stock-movements
  • GET /items/low-stock

Impostazioni

  • GET /tenant
  • PUT /tenant
  • GET /permissions
  • GET /positions
  • GET /priorities
  • GET /users
URL base: https://optiviera.com/api
Autenticazione: token JWT Bearer — includi Authorization: Bearer [token] in ogni richiesta. Tutti gli endpoint sono limitati al tenant; il token trasporta automaticamente il contesto.

Domande frequenti

Risposte alle domande più comuni

Più organizzazioni possono usare la stessa piattaforma?
Come vengono assegnati i permessi ai dipendenti?
Quali lingue supporta la piattaforma?
Come funziona il monitoraggio SLA dei ticket?
Posso esportare dati in Excel o PDF?
Cos'è un ordine di lavoro e come si relaziona a un ticket?
Come funziona il blocco del periodo contabile?
L'API è disponibile per integrazioni esterne?

Hai bisogno di ulteriore assistenza?

Il nostro team è pronto ad aiutarti per qualsiasi domanda sulla piattaforma.