Formato dei dati esportati

Ultimo aggiornamento: 8 ottobre 2026 — ricavato dallo schema del database

Il registro richiamato dall’articolo 12.8 dei Termini. Si genera dalla struttura del database con lo stesso programma che prepara l’archivio, quindi descrive esattamente quello che si scarica.

Formato quotello-esportazione/1, ricavato dallo schema del database il 2026-10-08.

Come si ottiene

L'amministratore dell'azienda prepara e scarica l'archivio da Impostazioni → Abbonamento, anche con l'abbonamento sospeso e per tutto il periodo di recupero dopo la cessazione. L'archivio resta scaricabile 7 giorni, poi si cancella. Non costa niente.

Chi non può più entrare scrive a ciao@quotello.it: l'archivio è lo stesso, e prima di consegnarlo si verifica che a chiederlo sia davvero l'azienda.

Cosa c'è dentro

Un file .tar.gz con una cartella che contiene:

Percorso	Contenuto
`LEGGIMI.txt`	Spiegazione in breve e conteggio delle righe
`MANIFEST.json`	Tutti i file con peso e impronta SHA-256; per ogni archivio i campi, i tipi e i riferimenti
`clienti.csv`	I clienti, con le stesse colonne dell'esportazione dell'app
`dati/azienda.json`	Nome e stato dell'azienda in Quotello
`dati/<archivio>.json`	Un file per ogni archivio elencato sotto, con tutte le righe dell'azienda
`file/`	Foto, loghi e documenti caricati, nei formati originali

Regole comuni

Codifica: UTF-8 per tutti i file di testo.
JSON: ogni file di dati/ è un elenco di oggetti, uno per riga dell'archivio.
CSV: separatore punto e virgola, prima riga con i nomi delle colonne, BOM UTF-8 in testa perché Excel lo apra correttamente.
Date e ore: ISO 8601 in UTC (2026-10-08T08:00:00.000Z); le date senza ora come giorno (2026-10-08).
Importi: i campi che finiscono in _cent sono in centesimi di euro; gli altri importi sono in euro con i decimali.
Riferimenti: ogni riga ha un id numerico; un campo <nome>_id contiene l'id di una riga di un altro archivio. I riferimenti dichiarati nel database sono elencati sotto ogni archivio.
Campi con struttura: i campi di tipo json o longtext con contenuto strutturato sono testo JSON dentro il valore.
File: il percorso registrato nei dati (per esempio /uploads/misure/foto.jpg) corrisponde, senza il prefisso /uploads/, al file dentro file/.

Cosa resta fuori, e perché

Segreti: password (anche cifrate o ridotte a impronta), token e chiavi di collegamento a servizi esterni. Servono solo a entrare in Quotello o in un altro servizio, e consegnarli li esporrebbe. Il MANIFEST elenca, archivio per archivio, i campi tolti.
Stato tecnico delle sincronizzazioni: code e impronte usate per allineare le rubriche dei telefoni e la mailing list, le sessioni di accesso e le iscrizioni alle notifiche del telefono. Fuori da Quotello non hanno significato.

Interfacce

Il passaggio a un altro fornitore avviene con questo archivio, in formati aperti e leggibili da qualunque programma. Quotello oggi non offre un'interfaccia di programmazione (API) pubblica per leggere i dati da fuori; riceve i contatti dai siti dell'azienda attraverso un collegamento dedicato.

Le colonne di clienti.csv

denominazione, tipo_cliente, email, telefono, telefono_2, whatsapp, indirizzo, comune, cap, provincia, note_indirizzo, referente, piva, codice_fiscale, pec, codice_sdi, note

Gli archivi

abbonamento_disdette

Disdette dell'abbonamento a Quotello, con data di effetto e importi

File: dati/abbonamento_disdette.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`tipo`	varchar(20)
`formula`	varchar(20)
`effetto_al`	date
`penale_cent`	int(11)
`rate_residue`	int(11)
`prezzo_rata_cent`	int(11)
`percentuale`	int(11)
`stripe_invoice_id`	varchar(64)
`penale_pagata`	tinyint(1)
`url_penale`	varchar(500)
`stato`	varchar(20)
`errore`	text
`utente_id`	int(10) unsigned
`ip`	varchar(64)
`user_agent`	varchar(300)
`richiesta_at`	datetime
`annullata_at`	datetime

abbonamento_fatture

Fatture dell'abbonamento a Quotello

File: dati/abbonamento_fatture.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`stripe_invoice_id`	varchar(64)
`stripe_numero`	varchar(64)
`origine`	varchar(20)
`righe`	text
`imponibile_cent`	int(11)
`totale_cent`	int(11)
`periodo_dal`	date
`periodo_al`	date
`pagata_at`	datetime
`fattura_ref`	text
`fattura_errore`	varchar(500)
`fattura_at`	datetime
`created_at`	datetime

activity_log

Registro delle attività degli utenti (chi ha fatto cosa, e quando)

File: dati/activity_log.json. Legato all'azienda da: utente_id → utenti.id.

Campo	Tipo
`id`	int(10) unsigned
`utente_id`	int(10) unsigned
`azione`	varchar(100)
`entita_tipo`	varchar(50)
`entita_id`	int(11)
`descrizione`	text
`cambiamenti`	longtext
`ip_address`	varchar(45)
`user_agent`	varchar(500)
`created_at`	datetime

aziende

Schede dell'azienda: ragione sociale, dati fiscali, recapiti e marchio usati nei documenti

File: dati/aziende.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`ragione_sociale`	varchar(255)
`tipo_azienda`	varchar(50)
`denominazione_commerciale`	varchar(255)
`slogan`	varchar(255)
`piva`	varchar(20)
`codice_fiscale`	varchar(16)
`codice_ateco`	varchar(10)
`sede_legale_indirizzo`	varchar(255)
`sede_legale_comune`	varchar(255)
`sede_legale_cap`	varchar(10)
`sede_legale_provincia`	varchar(5)
`showroom_indirizzo`	varchar(255)
`showroom_comune`	varchar(255)
`showroom_cap`	varchar(10)
`showroom_provincia`	varchar(5)
`telefono`	varchar(50)
`telefono_2`	varchar(50)
`email`	varchar(255)
`pec`	varchar(255)
`website`	varchar(255)
`iban`	varchar(34)
`banca`	varchar(255)
`logo_path`	varchar(500)
`logo_small_path`	varchar(500)
`colore_primario`	varchar(7)
`colore_secondario`	varchar(7)
`attiva`	tinyint(4)
`is_default`	tinyint(4)
`created_at`	datetime
`updated_at`	datetime
`iva_modalita`	varchar(20)
`iva_aliquota`	decimal(5,2)
`preventivo_numero_corrente`	int(11)
`fic_company_id`	int(11)
`fatt_regime`	enum('forfettario','ordinario')
`fatt_aliquota`	decimal(5,2)
`tenant_id`	int(10) unsigned
`codice_sdi`	varchar(7)
`regime_fiscale`	varchar(4)

Campi esclusi: fic_token, fic_refresh_token, fic_token_scadenza.

clienti

Anagrafiche dei clienti e dei contatti, con fase della trattativa, provenienza e consensi

File: dati/clienti.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`denominazione`	varchar(255)
`tipo_cliente`	enum('privato','azienda','condominio','ente')
`fase_id`	int(10) unsigned
`indirizzo`	varchar(255)
`comune`	varchar(255)
`cap`	varchar(10)
`provincia`	varchar(5)
`note_indirizzo`	text
`paese`	varchar(255)
`latitudine`	decimal(10,7)
`longitudine`	decimal(10,7)
`email`	varchar(255)
`referente`	varchar(255)
`telefono`	varchar(50)
`telefono_2`	varchar(50)
`whatsapp`	varchar(50)
`piva`	varchar(20)
`codice_fiscale`	varchar(16)
`pec`	varchar(255)
`codice_sdi`	varchar(7)
`termini_pagamento`	text
`iban`	varchar(34)
`sconto_predefinito`	decimal(5,2)
`origine`	varchar(100)
`origine_dettaglio`	varchar(255)
`campagna`	varchar(255)
`note`	text
`tags`	longtext
`budget_stimato`	decimal(10,2)
`interesse_categorie`	longtext
`decisori_noti`	text
`personalita_note`	text
`ai_sintesi`	text
`ai_sintesi_updated_at`	datetime
`assegnato_a`	int(10) unsigned
`created_by`	int(10) unsigned
`created_at`	datetime
`updated_at`	datetime
`consenso_marketing`	tinyint(4)
`consenso_marketing_at`	datetime
`consenso_marketing_origine`	varchar(30)
`eliminato_at`	datetime
`eliminato_da`	int(10) unsigned
`brevo_contact_id`	bigint(20) unsigned
`brevo_sync_at`	datetime
`brevo_sync_errore`	varchar(255)
`tenant_id`	int(10) unsigned
`dal_sito_visto_at`	datetime

Riferimenti: assegnato_a → utenti, fase_id → fasi_pipeline.

commessa_assegnatari

Chi lavora a ciascuna commessa

File: dati/commessa_assegnatari.json. Legato all'azienda da: commessa_id → commesse.id.

Campo	Tipo
`id`	int(10) unsigned
`commessa_id`	int(10) unsigned
`utente_id`	int(10) unsigned
`created_at`	datetime

Riferimenti: commessa_id → commesse, utente_id → utenti.

commesse

Commesse: i lavori, ciascuno con la sua fase (un cliente può averne più d'uno)

File: dati/commesse.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`cliente_id`	int(10) unsigned
`numero`	int(10) unsigned
`titolo`	varchar(160)
`fase_id`	int(10) unsigned
`note`	text
`chiusa_at`	datetime
`eliminato_at`	datetime
`created_by`	int(10) unsigned
`created_at`	datetime
`updated_at`	datetime
`motivo_perdita_id`	int(10) unsigned
`motivo_perdita_nota`	text
`persa_at`	datetime
`tenant_id`	int(10) unsigned
`avviso_misure_ignorato_at`	datetime

Riferimenti: cliente_id → clienti, fase_id → fasi_pipeline, motivo_perdita_id → motivi_perdita.

contratti

Contratti e ordini

File: dati/contratti.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`cliente_id`	int(10) unsigned
`azienda_id`	int(10) unsigned
`preventivo_id`	int(10) unsigned
`anno`	int(11)
`numero`	int(11)
`data`	date
`luogo`	varchar(100)
`oggetto`	text
`prezzo_totale`	decimal(10,2)
`acconto`	decimal(10,2)
`saldo`	decimal(10,2)
`consegna_giorni`	int(11)
`garanzia_mesi`	int(11)
`stato`	varchar(20)
`note`	text
`created_by`	int(10) unsigned
`created_at`	datetime
`updated_at`	datetime
`fattura_ref`	longtext
`commessa_id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`oggetto_dati`	longtext
`voci_extra`	longtext
`rate`	longtext
`iva_modalita`	varchar(20)
`iva_aliquota`	decimal(5,2)

Riferimenti: azienda_id → aziende, cliente_id → clienti.

documenti

Documenti allegati ai clienti

File: dati/documenti.json. Legato all'azienda da: cliente_id → clienti.id.

Campo	Tipo
`id`	int(10) unsigned
`cliente_id`	int(10) unsigned
`riferimento_tipo`	varchar(50)
`riferimento_id`	int(11)
`nome_file`	varchar(255)
`percorso_file`	varchar(500)
`tipo_mime`	varchar(100)
`dimensione`	bigint(20)
`descrizione`	text
`tags`	longtext
`caricato_da`	int(10) unsigned
`created_at`	datetime

documento_pagine

Copertine e schede prodotto in PDF da allegare ai preventivi

File: dati/documento_pagine.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`nome`	varchar(255)
`ruolo`	enum('copertina','scheda')
`tipo`	varchar(20)
`file_path`	varchar(500)
`ordine`	int(11)
`attiva`	tinyint(4)
`created_at`	datetime
`tenant_id`	int(10) unsigned

eventi

Appuntamenti in calendario: sopralluoghi, montaggi, altri impegni

File: dati/eventi.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`cliente_id`	int(10) unsigned
`tipo`	varchar(50)
`categoria`	varchar(100)
`data_ora`	datetime
`durata_minuti`	int(11)
`direzione`	enum('in_entrata','in_uscita')
`note`	text
`note_ai_pulite`	text
`esito`	varchar(100)
`obiettivo_cliente`	text
`obiezioni_emerse`	text
`budget_discusso`	decimal(10,2)
`decisori_presenti`	text
`prossimo_step`	text
`ai_followup_generato`	text
`ai_followup_inviato`	tinyint(4)
`recall_generato_id`	int(11)
`gcal_event_id`	varchar(255)
`allegati`	longtext
`created_by`	int(10) unsigned
`created_at`	datetime
`updated_at`	datetime
`promemoria_inviato_at`	datetime
`promemoria_canale`	varchar(20)
`commessa_id`	int(10) unsigned
`montaggio_completato_at`	datetime
`montaggio_completato_da`	int(10) unsigned
`montaggio_nota`	text
`montaggio_foto`	longtext
`tenant_id`	int(10) unsigned
`chiave_client`	varchar(64)
`fornitore_id`	int(10) unsigned
`argomento`	varchar(255)

Riferimenti: cliente_id → clienti, created_by → utenti, fornitore_id → fornitori.

evento_assegnatari

Chi partecipa a ciascun appuntamento

File: dati/evento_assegnatari.json. Legato all'azienda da: evento_id → eventi.id.

Campo	Tipo
`id`	int(10) unsigned
`evento_id`	int(10) unsigned
`utente_id`	int(10) unsigned
`created_at`	datetime

Riferimenti: evento_id → eventi, utente_id → utenti.

fasi_pipeline

Le fasi della trattativa configurate dall'azienda

File: dati/fasi_pipeline.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`nome`	varchar(50)
`etichetta`	varchar(100)
`colore`	varchar(7)
`ordine`	int(11)
`descrizione`	varchar(255)
`icona`	varchar(50)
`attiva`	tinyint(4)
`is_default`	tinyint(4)
`is_finale`	tinyint(4)
`trigger_automatico`	varchar(30)
`is_persa`	tinyint(1)
`tenant_id`	int(10) unsigned

fattura_righe

Righe delle fatture emesse ai propri clienti

File: dati/fattura_righe.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`fattura_id`	int(10) unsigned
`ordine`	int(11)
`nome`	varchar(255)
`descrizione`	text
`quantita`	decimal(10,2)
`prezzo_cent`	int(11)
`imponibile_cent`	int(11)
`imposta_cent`	int(11)
`aliquota`	decimal(5,2)
`natura`	varchar(4)

Riferimenti: fattura_id → fatture.

fatture

Fatture emesse ai propri clienti

File: dati/fatture.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`azienda_id`	int(10) unsigned
`cliente_id`	int(10) unsigned
`contratto_id`	int(10) unsigned
`anno`	int(11)
`numero`	int(11)
`numero_definitivo`	varchar(20)
`data`	date
`tipo_documento`	varchar(4)
`rata_indice`	int(11)
`imponibile_cent`	int(11)
`imposta_cent`	int(11)
`bollo_cent`	int(11)
`totale_cent`	int(11)
`modalita_pagamento`	varchar(4)
`iban`	varchar(34)
`scadenza`	date
`pagamenti`	longtext
`cedente`	longtext
`cessionario`	longtext
`riepilogo`	longtext
`causale`	text
`note`	text
`stato`	varchar(20)
`esportata_at`	datetime
`created_by`	int(10) unsigned
`created_at`	datetime
`updated_at`	datetime

Riferimenti: azienda_id → aziende, cliente_id → clienti.

fornitori

Fornitori

File: dati/fornitori.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`denominazione`	varchar(255)
`referente`	varchar(255)
`categoria`	varchar(150)
`telefono`	varchar(50)
`email`	varchar(255)
`piva`	varchar(20)
`codice_fiscale`	varchar(20)
`indirizzo`	varchar(255)
`cap`	varchar(10)
`comune`	varchar(100)
`provincia`	varchar(5)
`sito`	varchar(255)
`portale_ordini`	varchar(255)
`codice_cliente`	varchar(100)
`termini_pagamento`	varchar(150)
`sconto`	decimal(5,2)
`ordine_minimo`	varchar(150)
`tempi_consegna`	varchar(150)
`condizioni_note`	text
`note`	text
`created_by`	int(10) unsigned
`eliminato_at`	datetime
`created_at`	datetime
`updated_at`	datetime

impostazioni

Impostazioni dell'azienda (senza le chiavi di servizi esterni)

File: dati/impostazioni.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`chiave`	varchar(100)
`valore`	longtext
`tipo`	varchar(20)
`gruppo`	varchar(50)
`descrizione`	varchar(255)
`tenant_id`	int(10) unsigned

iscrizioni

Iscrizione a Quotello: piano scelto, accettazione dei Termini e dell'accordo sui dati

File: dati/iscrizioni.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`nome_azienda`	varchar(160)
`email`	varchar(190)
`telefono`	varchar(40)
`piano_id`	int(10) unsigned
`periodo`	varchar(20)
`stato`	enum('in_attesa','in_elaborazione','completata','annullata')
`stripe_session_id`	varchar(100)
`tenant_id`	int(10) unsigned
`errore`	text
`created_at`	datetime
`completata_at`	datetime
`termini_versione`	varchar(40)
`termini_impronta`	varchar(64)
`termini_accettati_at`	datetime
`clausole_approvate_at`	datetime
`termini_ip`	varchar(64)
`termini_user_agent`	varchar(300)
`piva`	varchar(20)
`b2b_dichiarato_at`	datetime
`dpa_versione`	varchar(40)
`dpa_accettato_at`	datetime

Riferimenti: piano_id → piani.

Campi esclusi: password_hash.

misure

Misure rilevate: tende, pergole, zanzariere e gli altri prodotti

File: dati/misure.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`cliente_id`	int(10) unsigned
`tipo`	enum('bracci','caduta','pergole','interno','zanzariere','cambio_telo','capottina','copertura_telo')
`titolo`	varchar(255)
`riepilogo`	varchar(255)
`dati`	longtext
`foto`	longtext
`created_by`	int(10) unsigned
`created_at`	datetime
`commessa_id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`origine_misura_id`	int(10) unsigned
`chiave_client`	varchar(64)

Riferimenti: cliente_id → clienti, created_by → utenti.

modelli_alias

Nomi commerciali dei modelli di prodotto

File: dati/modelli_alias.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tipo`	varchar(20)
`nome_produttore`	varchar(120)
`nome_commerciale`	varchar(120)
`created_at`	datetime
`tenant_id`	int(10) unsigned

moduli_richieste

Moduli inviati ai clienti (per esempio Ecobonus) e le loro risposte

File: dati/moduli_richieste.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`cliente_id`	int(10) unsigned
`template_id`	int(10) unsigned
`stato`	enum('inviato','bozza','compilato','revocato')
`scadenza`	datetime
`risposte`	text
`consenso_at`	datetime
`compilato_at`	datetime
`verifica_tentativi`	int(11)
`verifica_blocco_fino`	datetime
`created_by`	int(10) unsigned
`created_at`	datetime
`updated_at`	datetime
`tenant_id`	int(10) unsigned
`revisione_motivo`	text
`revisione_at`	datetime
`revisioni`	int(11)
`verifica_blocchi`	int(11)

Riferimenti: cliente_id → clienti, template_id → moduli_template.

Campi esclusi: token.

moduli_template

Modelli dei moduli

File: dati/moduli_template.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`slug`	varchar(50)
`nome`	varchar(255)
`descrizione`	text
`campi`	longtext
`attivo`	tinyint(4)
`created_at`	datetime
`updated_at`	datetime
`tenant_id`	int(10) unsigned

motivi_perdita

Motivi di trattativa persa configurati dall'azienda

File: dati/motivi_perdita.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`etichetta`	varchar(120)
`ordine`	int(11)
`attivo`	tinyint(1)
`created_at`	timestamp
`updated_at`	timestamp
`tenant_id`	int(10) unsigned

notifiche

Notifiche ricevute dagli utenti nell'app

File: dati/notifiche.json. Legato all'azienda da: utente_id → utenti.id.

Campo	Tipo
`id`	int(10) unsigned
`utente_id`	int(10) unsigned
`tipo`	varchar(40)
`titolo`	varchar(200)
`corpo`	text
`url`	varchar(300)
`letta_at`	datetime
`created_at`	timestamp

Riferimenti: utente_id → utenti.

notifiche_preferenze

Quali notifiche ogni utente vuole ricevere

File: dati/notifiche_preferenze.json. Legato all'azienda da: utente_id → utenti.id.

Campo	Tipo
`id`	int(10) unsigned
`utente_id`	int(10) unsigned
`tipo`	varchar(40)
`abilitata`	tinyint(1)

Riferimenti: utente_id → utenti.

preventivi

Preventivi: intestazione, condizioni, totali

File: dati/preventivi.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`cliente_id`	int(10) unsigned
`azienda_id`	int(10) unsigned
`anno`	int(11)
`numero`	int(11)
`data`	date
`validita_giorni`	int(11)
`stato`	varchar(20)
`nascondi_misure`	tinyint(4)
`montaggio`	decimal(10,2)
`extra`	longtext
`sconto_tipo`	varchar(10)
`sconto_valore`	decimal(10,2)
`totale`	decimal(10,2)
`note`	text
`created_by`	int(10) unsigned
`created_at`	datetime
`updated_at`	datetime
`montaggio_barrato`	tinyint(4)
`pagine`	longtext
`commessa_id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`pdf_scaricato_at`	datetime
`note_in_pdf`	tinyint(4)
`pagamento`	text
`iva_modalita`	varchar(20)
`iva_aliquota`	decimal(5,2)

Riferimenti: azienda_id → aziende, cliente_id → clienti.

preventivo_righe

Righe dei preventivi: prodotti, misure collegate, voci e prezzi

File: dati/preventivo_righe.json. Legato all'azienda da: preventivo_id → preventivi.id.

Campo	Tipo
`id`	int(10) unsigned
`preventivo_id`	int(10) unsigned
`misura_id`	int(10) unsigned
`tipo`	varchar(20)
`titolo`	varchar(255)
`dati`	longtext
`costo`	decimal(10,2)
`voci`	longtext
`ordine`	int(11)
`descrizione`	text

Riferimenti: preventivo_id → preventivi.

recall

Richiami e ricontatti programmati

File: dati/recall.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`cliente_id`	int(10) unsigned
`tipo`	enum('telefonata','appuntamento','follow_up_preventivo','follow_up_pagamento','scadenza_garanzia','generico')
`data_prevista`	datetime
`data_completata`	datetime
`stato`	enum('attivo','completato','posticipato','annullato')
`priorita`	enum('bassa','normale','alta','urgente')
`riferimento_tipo`	varchar(50)
`riferimento_id`	int(11)
`note`	text
`esito`	text
`gcal_event_id`	varchar(255)
`telegram_notified`	tinyint(4)
`push_notified`	tinyint(4)
`assegnato_a`	int(10) unsigned
`created_by`	int(10) unsigned
`created_at`	datetime
`updated_at`	datetime
`tenant_id`	int(10) unsigned
`chiave_client`	varchar(64)

Riferimenti: assegnato_a → utenti, cliente_id → clienti.

rete_accettazioni

Rete PuntoTende: accettazioni del contratto di rete

File: dati/rete_accettazioni.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`documento_versione`	varchar(40)
`documento_impronta`	varchar(64)
`accettato_at`	datetime
`clausole_accettate_at`	datetime
`clausole`	text
`utente_id`	int(10) unsigned
`ip`	varchar(64)
`user_agent`	varchar(300)
`richiesta_id`	int(10) unsigned
`contratto_id`	int(10) unsigned

rete_addebiti

Rete PuntoTende: addebiti mensili

File: dati/rete_addebiti.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`data_addebito`	date
`periodo_dal`	date
`periodo_al`	date
`totale_cent`	int(10) unsigned
`righe`	text
`stato`	varchar(20)
`stripe_invoice_id`	varchar(64)
`stripe_customer_id`	varchar(64)
`errore`	text
`creato_da`	int(10) unsigned
`created_at`	datetime
`emesso_at`	datetime
`esito_at`	datetime
`avvisato_at`	datetime
`sollecitato_at`	datetime
`sospeso_at`	datetime
`risolto_at`	datetime
`risolto_come`	varchar(40)
`tipo`	enum('canone','consumi','completo')
`fattura_ref`	text
`fattura_errore`	text
`fattura_at`	datetime
`iva_cent`	int(11)
`aliquota`	decimal(5,2)

rete_contratti

Rete PuntoTende: il contratto di rete

File: dati/rete_contratti.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`livello`	varchar(20)
`dal`	date
`al`	date
`incasso`	varchar(20)
`genere`	varchar(20)
`note`	varchar(255)
`created_at`	datetime
`impegno`	varchar(20)
`penale_percentuale`	int(10) unsigned
`rinnovo_avvisato_per`	date
`rinnovo_sollecitato_per`	date

rete_coupon_usi

Rete PuntoTende: coupon usati

File: dati/rete_coupon_usi.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`coupon_id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`contratto_id`	int(10) unsigned
`dal`	date
`al`	date
`usato_da`	int(10) unsigned
`usato_at`	datetime

Riferimenti: coupon_id → rete_coupon.

rete_disdette

Rete PuntoTende: disdette dal contratto di rete

File: dati/rete_disdette.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`contratto_id`	int(10) unsigned
`tipo`	varchar(20)
`livello_nuovo`	varchar(20)
`efficace_dal`	date
`stato`	varchar(20)
`note`	text
`chiesta_da`	int(10) unsigned
`chiesta_at`	datetime
`applicata_at`	datetime
`annullata_at`	datetime

rete_disponibilita

Rete PuntoTende: disponibilità per gli appuntamenti

File: dati/rete_disponibilita.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`giorno_settimana`	tinyint(3) unsigned
`ora_inizio`	time
`ora_fine`	time
`attiva`	tinyint(1)
`created_at`	datetime

rete_disponibilita_regole

Rete PuntoTende: regole settimanali di disponibilità

File: dati/rete_disponibilita_regole.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`tenant_id`	int(10) unsigned
`durata_minuti`	int(10) unsigned
`preavviso_ore`	int(10) unsigned
`orizzonte_giorni`	int(10) unsigned

rete_giudizi

Rete PuntoTende: giudizi dei clienti dopo l'appuntamento

File: dati/rete_giudizi.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`rete_lead_id`	int(10) unsigned
`evento_id`	int(10) unsigned
`chiesto_at`	datetime
`risposto_at`	datetime
`stelle`	tinyint(3) unsigned
`non_presentato`	tinyint(1)
`in_ritardo`	tinyint(1)
`impreparato`	tinyint(1)
`sbrigativo`	tinyint(1)
`preventivo_mai_arrivato`	tinyint(1)
`commento`	text

Riferimenti: rete_lead_id → rete_lead.

Campi esclusi: token.

rete_incarichi

Rete PuntoTende: incarichi

File: dati/rete_incarichi.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`dal`	date
`al`	date
`note`	varchar(255)
`created_at`	datetime

rete_lead

Rete PuntoTende: contatti ricevuti dalla rete

File: dati/rete_lead.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`chiave_id`	int(10) unsigned
`ricevuto_at`	datetime
`cap`	varchar(10)
`comune`	varchar(80)
`zona_id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`stato`	enum('da_lavorare','in_lavorazione','appuntamento','scartato','consegnato')
`motivo`	varchar(40)
`operatore_id`	int(10) unsigned
`denominazione`	varchar(160)
`email`	varchar(160)
`telefono`	varchar(40)
`indirizzo`	varchar(200)
`oggetto`	varchar(160)
`messaggio`	text
`consenso_marketing`	tinyint(1)
`utm_campaign`	varchar(120)
`utm_source`	varchar(80)
`utm_medium`	varchar(80)
`cliente_id`	int(10) unsigned
`evento_id`	int(10) unsigned
`duplicato_di`	int(10) unsigned
`esito`	varchar(255)
`chiuso_at`	datetime
`fissato_at`	datetime
`appuntamento_at`	datetime
`fuori_zona`	tinyint(1)
`consegnato_at`	datetime
`annullato_at`	datetime
`richiamare_il`	datetime
`consenso_at`	datetime
`consenso_origine`	varchar(40)

Riferimenti: chiave_id → lead_chiavi, zona_id → zone.

rete_mandati

Rete PuntoTende: mandati di addebito

File: dati/rete_mandati.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`stripe_customer_id`	varchar(64)
`stripe_payment_method_id`	varchar(64)
`tipo`	varchar(20)
`ultime4`	varchar(4)
`banca`	varchar(80)
`stato`	varchar(20)
`raccolto_at`	datetime
`aggiornato_at`	datetime
`created_at`	datetime

rete_messaggi

Rete PuntoTende: messaggi inviati ai clienti

File: dati/rete_messaggi.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`rete_lead_id`	int(10) unsigned
`evento_id`	int(10) unsigned
`tipo`	enum('conferma','spostamento','annullamento','questionario')
`canale`	enum('sms','email','whatsapp')
`destinatario`	varchar(160)
`inviato_at`	datetime
`esito`	varchar(255)

Riferimenti: rete_lead_id → rete_lead.

rete_operatori_aziende

Rete PuntoTende: operatori del centralino assegnati

File: dati/rete_operatori_aziende.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`utente_id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`created_at`	datetime

Riferimenti: utente_id → utenti.

rete_posti_mensili

Rete PuntoTende: quante persone usano il gestionale, mese per mese

File: dati/rete_posti_mensili.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`mese`	date
`amministratori`	int(10) unsigned
`venditori`	int(10) unsigned
`tecnici`	int(10) unsigned
`montatori`	int(10) unsigned
`totale`	int(10) unsigned
`livello`	varchar(20)
`rilevato_at`	datetime

rete_pratiche

Rete PuntoTende: pratiche (per esempio Ecobonus)

File: dati/rete_pratiche.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`tipo`	varchar(40)
`modulo_richiesta_id`	int(10) unsigned
`cliente_id`	int(10) unsigned
`stato`	varchar(20)
`lavori_fine`	date
`scadenza`	date
`affidata_at`	datetime
`affidata_da`	int(10) unsigned
`presa_at`	datetime
`presa_da`	int(10) unsigned
`inviata_at`	datetime
`protocollo`	varchar(60)
`annullata_at`	datetime
`note`	text
`created_at`	timestamp
`updated_at`	timestamp

rete_prezzi

Rete PuntoTende: listino applicato

File: dati/rete_prezzi.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`voce`	varchar(40)
`tenant_id`	int(10) unsigned
`prezzo_cent`	int(10) unsigned
`dal`	date
`al`	date
`nota`	varchar(160)
`created_at`	datetime
`impegno`	varchar(20)

rete_proposte

Rete PuntoTende: appuntamenti fuori zona proposti

File: dati/rete_proposte.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tipo`	enum('zona','lead')
`tenant_id`	int(10) unsigned
`zona_id`	int(10) unsigned
`rete_lead_id`	int(10) unsigned
`stato`	enum('proposta','accettata','rifiutata','revocata','assegnata_ad_altri','scaduta')
`autorizzata_da`	int(10) unsigned
`autorizzata_at`	datetime
`decisa_da`	int(10) unsigned
`decisa_at`	datetime
`note`	varchar(255)
`created_at`	datetime
`scade_at`	datetime
`posizione`	int(10) unsigned

Riferimenti: rete_lead_id → rete_lead, zona_id → zone.

rete_rettifiche

Rete PuntoTende: crediti e storni

File: dati/rete_rettifiche.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`descrizione`	varchar(200)
`importo_cent`	int(11)
`motivo`	varchar(30)
`riferimento`	varchar(60)
`addebito_id`	int(10) unsigned
`applicata_at`	datetime
`creata_da`	int(10) unsigned
`created_at`	datetime

rete_richieste

Rete PuntoTende: richieste di adesione

File: dati/rete_richieste.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`livello`	varchar(20)
`impegno`	varchar(20)
`zona_id`	int(10) unsigned
`zona_chiesta`	varchar(120)
`origine`	varchar(20)
`stato`	varchar(20)
`note`	text
`risposta`	text
`chiesta_da`	int(10) unsigned
`chiesta_at`	datetime
`decisa_da`	int(10) unsigned
`decisa_at`	datetime
`contratto_id`	int(10) unsigned

rete_servizi

Rete PuntoTende: servizi acquistati

File: dati/rete_servizi.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`servizio`	varchar(40)
`attivo`	tinyint(1)
`attivato_at`	datetime
`attivato_da`	int(10) unsigned
`created_at`	timestamp
`updated_at`	timestamp

rete_spese_limiti

Rete PuntoTende: tetti di spesa a consumo

File: dati/rete_spese_limiti.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`blocco`	tinyint(1)
`tetto_cent`	int(10) unsigned
`avvisato_at`	datetime
`aggiornato_da`	int(10) unsigned
`created_at`	timestamp
`updated_at`	timestamp

rete_upsell_invii

Rete PuntoTende: proposte di servizi aggiuntivi inviate

File: dati/rete_upsell_invii.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`richieste`	int(10) unsigned
`zona_codice`	varchar(80)
`testo`	text
`inviato_da`	int(10) unsigned
`inviato_at`	datetime

rubriche

Rubriche sincronizzate con i telefoni

File: dati/rubriche.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`utente_id`	int(10) unsigned
`nome_utente`	varchar(100)
`attiva`	tinyint(1)
`created_at`	datetime
`updated_at`	datetime

Riferimenti: utente_id → utenti.

tipi_appuntamento

Tipi di appuntamento configurati dall'azienda

File: dati/tipi_appuntamento.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`chiave`	varchar(50)
`etichetta`	varchar(100)
`colore`	varchar(20)
`is_montaggio`	tinyint(1)
`ordine`	int(11)
`attivo`	tinyint(1)
`created_at`	timestamp
`updated_at`	timestamp
`tenant_id`	int(10) unsigned

utenti

Utenti e ruoli (senza password)

File: dati/utenti.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`email`	varchar(255)
`nome`	varchar(100)
`cognome`	varchar(100)
`telefono`	varchar(50)
`ruolo`	enum('admin','editor','tecnico','montatore','venditore')
`azienda_default_id`	int(10) unsigned
`telegram_chat_id`	varchar(50)
`push_subscription`	longtext
`ai_preferenze`	longtext
`attivo`	tinyint(4)
`ultimo_accesso`	datetime
`created_at`	datetime
`updated_at`	datetime
`tenant_id`	int(10) unsigned
`superadmin`	tinyint(1)
`operatore_rete`	tinyint(1)
`in_servizio`	tinyint(1)
`smista_lead`	tinyint(1)

Riferimenti: azienda_default_id → aziende.

Campi esclusi: password_hash, reset_token_hash, reset_token_scadenza.

zone_assegnazioni

Rete PuntoTende: zone assegnate

File: dati/zone_assegnazioni.json. Legato all'azienda da: tenant_id.

Campo	Tipo
`id`	int(10) unsigned
`zona_id`	int(10) unsigned
`tenant_id`	int(10) unsigned
`dal`	date
`al`	date
`note`	varchar(255)
`created_at`	datetime
`tipo`	enum('esclusiva','provvisoria')

Riferimenti: zona_id → zone.