Esportazione dei dati
Registro delle strutture e dei formati dei dati esportabili, ai sensi dell’art. 26 del Regolamento (UE) 2023/2854 (Data Act)
Aggiornato al 19 ottobre 2026
In breve
- Dal Servizio puoi esportare in qualsiasi momento movimenti, fatture con i loro file XML, controparti, scadenze, dati di cassa, prima nota e fascicoli.
- Su richiesta, entro 30 giorni, Artifex ti consegna l’esportazione completa dei dati della tua azienda: un archivio ZIP con un file CSV per ogni tabella, una descrizione delle tabelle in JSON e i file originali.
- L’esportazione e il passaggio a un altro fornitore non costano nulla.
- Questa pagina elenca, tabella per tabella, che cosa contiene l’archivio e in quale formato, e che cosa resta fuori.
1. Come chiedere l’esportazione o il passaggio
Scrivi a support@contifex.com (art. 19 dei Termini), indicando l’azienda e che cosa ti serve: l’esportazione completa, il passaggio a un altro fornitore o a un tuo sistema, oppure la cessazione del Servizio con la cancellazione dei dati. Artifex consegna l’esportazione completa entro 30 giorni dalla richiesta. Il passaggio segue l’art. 15.2 dei Termini di Servizio: comincia dalla data che indichi, al più tardi due mesi dopo la richiesta, e ha un periodo transitorio di 30 giorni in cui il Servizio continua a funzionare e Artifex ti assiste, anche insieme al nuovo fornitore se lo autorizzi.
Limiti tecnici che conosciamo
- Il collegamento dei conti non si trasferisce. L’accesso ai conti l’hai autorizzato tu presso la banca, tramite Yapily, per Contifex: con un altro fornitore dai un nuovo consenso. I movimenti già importati sono nell’archivio.
- La ricezione delle fatture passa col codice destinatario. Contifex riceve le fatture dallo SdI perché hai registrato il suo codice destinatario sul portale Fatture e Corrispettivi dell’Agenzia delle Entrate. Per riceverle altrove registri il codice del nuovo fornitore; le fatture già ricevute, con i loro file originali, sono nell’archivio.
- Gli accessi restano tuoi. Password, app di autenticazione e codici di recupero non si esportano: nel nuovo servizio ogni utente crea i propri.
- Regole, categorie e previsioni sono dati, non funzioni. L’archivio contiene le regole di classificazione, le categorie, il budget e le ricorrenze come tabelle: come un altro gestionale le usi dipende da lui.
2. Com’è fatto l’archivio
Un file ZIP, di nome contifex-esportazione-<partita IVA>-<AAAA-MM-GG>.zip, che contiene:
LEGGIMI.txt: che cosa c’è nell’archivio, a quale data è stato preparato e per quale azienda;datapackage.json: la descrizione di tutte le tabelle, con colonne, tipi, chiavi e rimandi fra tabelle, nella forma pubblicata in fondo a questa pagina;dati/: un file CSV per ogni tabella della sezione 4;fatture-elettroniche/: il file della fattura elettronica, originale: XML FatturaPA o XML firmato (.xml.p7m), con il nome che ha presso lo SdI. Vuota per le fatture senza file, come quelle inserite a mano.distinte-pagamento/: il file XML della distinta, così come è stato preparato per la banca.file/: i file caricati nel Servizio o arrivati per email, in una cartella per contenitore, con il percorso che le tabelle indicano (sezione 5).
3. Formati e standard
| Che cosa | Formato | Standard o specifica |
|---|---|---|
| Tabelle | CSV con codifica UTF-8, separatore virgola, testo fra virgolette doppie quando serve (le virgolette interne raddoppiate), righe che finiscono con CR LF, prima riga con i nomi delle colonne | RFC 4180 |
| Descrizione delle tabelle | JSON | Data Package e Table Schema di Frictionless Data, versione 1 (specifica aperta) |
| Date e ore | AAAA-MM-GG; data e ora con il fuso orario, per esempio 2026-10-19T14:30:00+00:00 | ISO 8601 |
| Numeri | Punto per i decimali, nessun separatore delle migliaia; importi in euro salvo diversa valuta indicata nella riga | — |
| Sì/no | true o false | — |
| Dati strutturati | Testo JSON nella cella (per esempio indirizzi o impostazioni) | RFC 8259 |
| Cella vuota | Valore assente | — |
| Fatture elettroniche | XML, oppure XML firmato digitalmente (.xml.p7m), come arrivano dallo SdI o come sono state trasmesse | FatturaPA, specifiche tecniche dell’Agenzia delle Entrate; firma CAdES |
| Distinte di bonifico | XML | CBIPaymentRequest.00.04.01 (ISO 20022 pain.001.001.09) |
| Documenti e immagini caricati | Come sono stati caricati: PDF, PNG, JPEG, ZIP | — |
I valori sono quelli registrati nel Servizio, senza conversioni. Gli identificativi (UUID) collegano le righe fra le tabelle: per esempio la colonna invoice_id di una scadenza è l’id della fattura in dati/invoices.csv. Le colonne che indicano un utente possono riferirsi a una persona che non ha più accesso all’azienda, e che quindi non è in dati/users.csv.
4. Le tabelle
Per ogni tabella: il file CSV, che cosa contiene e le sue colonne, nell’ordine in cui compaiono nel file. Apri una tabella per vederne le colonne.
Azienda, utenti e impostazioni
L'azienda — dati/organizations.csv
Una riga: dati anagrafici e fiscali, indirizzo, impostazioni di fatturazione e dei solleciti, stato dell'abbonamento, accettazione dei Termini e approvazione delle clausole.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
name | testo | no | |
vat_number | testo | sì | |
fiscal_code | testo | sì | |
sdi_code | testo | sì | |
address | dati strutturati (JSON) | sì | |
invoicing_defaults | dati strutturati (JSON) | sì | |
created_at | data e ora (ISO 8601, con fuso) | sì | |
updated_at | data e ora (ISO 8601, con fuso) | sì | |
subscription_status | testo | sì | |
subscription_plan | testo | sì | |
trial_ends_at | data e ora (ISO 8601, con fuso) | sì | |
subscription_current_period_end | data e ora (ISO 8601, con fuso) | sì | |
onboarding_completed | sì/no (true/false) | sì | |
setup_checklist_dismissed | sì/no (true/false) | sì | |
custom_line_columns | dati strutturati (JSON) | sì | |
reminder_settings | dati strutturati (JSON) | sì | |
fiscal_regime | testo | no | |
commercialista_email | testo | sì | |
ateco_code | testo | sì | |
size_bucket | testo | sì | |
sdi_regime_fiscale | testo | sì | |
ingresso | testo | no | |
ingresso_nota | testo | sì | |
ingresso_aggiornato_il | data e ora (ISO 8601, con fuso) | sì | |
pec | testo | sì | |
referente_nome | testo | sì | |
referente_telefono | testo | sì | |
termini_accettati_il | data e ora (ISO 8601, con fuso) | sì | |
termini_versione | testo | sì | |
termini_accettati_da | identificativo (UUID) | sì | |
clausole_approvate_il | data e ora (ISO 8601, con fuso) | sì | |
clausole_approvate_versione | testo | sì | |
clausole_approvate_da | identificativo (UUID) | sì | |
clausole_approvate_email | testo | sì | |
clausole_approvate_ip | testo | sì | |
clausole_approvate_browser | testo | sì | |
chiusura_invio_automatico | sì/no (true/false) | no | |
chiusura_frequenza_mesi | numero intero | no |
Non si esportano: stripe_customer_id, identificativo del cliente presso Stripe: codice del collegamento con il servizio di pagamento; stripe_subscription_id, identificativo dell'abbonamento presso Stripe: codice del collegamento con il servizio di pagamento; clausole_codice, codice di approvazione delle clausole in attesa di conferma: dato di sicurezza.
Accettazioni dei Termini — dati/accettazioni_termini.csv
Una riga per ogni accettazione dei Termini e approvazione delle clausole: l'atto, la versione, l'elenco delle clausole approvate con la sua impronta, l'email del codice, IP e browser, la data.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
azienda_id | identificativo (UUID) | no | |
utente_id | identificativo (UUID) | sì | |
atto | testo | no | |
versione | testo | no | |
clausole | dati strutturati (JSON) | sì | |
clausole_impronta | testo | sì | |
codice_inviato_a | testo | sì | |
ip | testo | sì | |
browser | testo | sì | |
avvenuta_il | data e ora (ISO 8601, con fuso) | no | |
registrata_il | data e ora (ISO 8601, con fuso) | no | |
copiata_dalla_riga | sì/no (true/false) | no |
Contratto a prezzo di lancio — dati/contratti_lancio.csv
Se l'azienda ha un contratto a prezzo di lancio: la data di sottoscrizione ed eventualmente quella e il motivo dell'annullo.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | |
sottoscritto_il | data (AAAA-MM-GG) | no | |
segnato_il | data e ora (ISO 8601, con fuso) | no | |
annullato_il | data e ora (ISO 8601, con fuso) | sì | |
annullato_motivo | testo | sì |
Non si esportano: segnato_da, identificativo della persona di Artifex che ha registrato il contratto nel pannello: dato interno del fornitore; annullato_da, identificativo della persona di Artifex che ha registrato l'annullo nel pannello: dato interno del fornitore.
Utenti — dati/users.csv
Le persone che hanno accesso all'azienda: nome, email, data di creazione. Password, app di autenticazione e codici di recupero non si esportano.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | sì | Rimanda a dati/organizations.csv |
full_name | testo | no | |
email | testo | no | |
role | testo | sì | |
permissions | dati strutturati (JSON) | sì | |
avatar_url | testo | sì | |
created_at | data e ora (ISO 8601, con fuso) | sì | |
updated_at | data e ora (ISO 8601, con fuso) | sì |
Accessi degli utenti all'azienda — dati/appartenenze.csv
Chi ha accesso all'azienda, con quale ruolo e permessi, chi l'ha invitato e le preferenze del riepilogo.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
user_id | identificativo (UUID) | no | Rimanda a dati/users.csv |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
ruolo | testo | no | |
stato | testo | no | |
invitata_da | identificativo (UUID) | sì | Rimanda a dati/users.csv |
attivata_il | data e ora (ISO 8601, con fuso) | sì | |
created_at | data e ora (ISO 8601, con fuso) | no | |
updated_at | data e ora (ISO 8601, con fuso) | no | |
permessi | dati strutturati (JSON) | no | |
preferenze_riepilogo | dati strutturati (JSON) | no | |
ultimo_riepilogo_il | data (AAAA-MM-GG) | sì |
Modalità di pagamento — dati/payment_methods.csv
Le modalità di pagamento usate nelle fatture emesse: codice SdI, termini, IBAN.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
name | testo | no | |
sdi_code | testo | no | |
payment_terms | testo | no | |
days | numero intero | sì | |
iban | testo | sì | |
is_default | sì/no (true/false) | no | |
created_at | data e ora (ISO 8601, con fuso) | no | |
updated_at | data e ora (ISO 8601, con fuso) | no | |
attivo | sì/no (true/false) | no | |
fine_mese | sì/no (true/false) | no |
Numerazioni e sezionali — dati/invoice_sequences.csv
I sezionali delle fatture e l'ultimo numero usato per anno e tipo di documento.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
document_type | testo | no | |
prefix | testo | no | |
year | numero intero | no | |
last_number | numero intero | no | |
format | testo | no | |
created_at | data e ora (ISO 8601, con fuso) | no | |
sezionale | testo | no | |
nome | testo | sì | |
modo | testo | no | |
partenza | numero intero | no |
Indirizzi di ricezione dei documenti — dati/caselle_documenti.csv
Gli indirizzi email a cui l'azienda riceve i documenti, con le date di apertura e chiusura.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
creata_il | data e ora (ISO 8601, con fuso) | no | |
creata_da | identificativo (UUID) | sì | Rimanda a dati/users.csv |
chiusa_il | data e ora (ISO 8601, con fuso) | sì |
Non si esportano: segreto, la parte segreta dell'indirizzo, che permette di mandarvi documenti: chiave del collegamento.
Filtri salvati — dati/filtri_salvati.csv
I filtri che gli utenti hanno salvato nelle pagine, con il loro nome.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
user_id | identificativo (UUID) | no | Rimanda a dati/users.csv |
pagina | testo | no | |
nome | testo | no | |
filtri | dati strutturati (JSON) | no | |
posto | numero intero | no | |
creato_il | data e ora (ISO 8601, con fuso) | no | |
aggiornato_il | data e ora (ISO 8601, con fuso) | no |
Box della lavagna — dati/lavagna_box.csv
I box della lavagna in dashboard: la richiesta scritta e la ricetta con cui il box si calcola.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
ricetta | dati strutturati (JSON) | no | |
richiesta | testo | sì | |
posizione | numero intero | no | |
creato_da | identificativo (UUID) | sì | Rimanda a dati/users.csv |
creato_il | data e ora (ISO 8601, con fuso) | no |
Avvisi — dati/alerts.csv
Gli avvisi mostrati nel Servizio (conti scollegati, fatture scadute, esiti SdI...), letti o no.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
alert_type | testo, uno dei valori ammessi | no | Valori: bank_disconnected, negative_cashflow, overdue_invoice, uncategorized, reconciliation_proposal, sync_error, fiscal_deadline_risk, sdi_rejected, sdi_undeliverable, f24_pubblicata, closure_ready, studio_question, messaggio_studio |
severity | testo, uno dei valori ammessi | sì | Valori: info, warning, critical |
title | testo | no | |
message | testo | sì | |
related_entity_type | testo | sì | |
related_entity_id | identificativo (UUID) | sì | |
is_read | sì/no (true/false) | sì | |
is_dismissed | sì/no (true/false) | sì | |
created_at | data e ora (ISO 8601, con fuso) | sì | |
push_inviato_il | data e ora (ISO 8601, con fuso) | sì |
Conti, movimenti e categorie
Conti — dati/bank_accounts.csv
I conti bancari collegati, manuali e di cassa: nome, banca, IBAN, saldo, stato del collegamento.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
name | testo | no | |
bank_name | testo | sì | |
iban | testo | sì | |
account_type | testo, uno dei valori ammessi | sì | Valori: bank, cash, credit_card, manual |
status | testo, uno dei valori ammessi | sì | Valori: active, disconnected, syncing, error |
balance | numero decimale | sì | |
currency | testo | sì | |
last_sync_at | data e ora (ISO 8601, con fuso) | sì | |
connection_expires_at | data e ora (ISO 8601, con fuso) | sì | |
is_visible | sì/no (true/false) | no | |
color | testo | sì | |
created_at | data e ora (ISO 8601, con fuso) | sì | |
updated_at | data e ora (ISO 8601, con fuso) | sì | |
saldo_ignorato | sì/no (true/false) | no | |
cuc_cbi | testo | sì | |
accantonamento_imposte | sì/no (true/false) | no |
Non si esportano: provider_id, riferimenti tecnici del collegamento presso Yapily (codici del collegamento, art. 15.1 dei Termini); provider_data, riferimenti tecnici del collegamento presso Yapily (codici del collegamento, art. 15.1 dei Termini).
Movimenti — dati/transactions.csv
I movimenti dei conti: data, importo, verso, descrizione originale e pulita, controparte, IBAN, dati della banca, classificazione, verifica, movimenti nascosti.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
account_id | identificativo (UUID) | no | Rimanda a dati/bank_accounts.csv |
date | data (AAAA-MM-GG) | no | |
amount | numero decimale | no | |
direction | testo, uno dei valori ammessi | no | Valori: inflow, outflow |
description | testo | sì | |
counterpart | testo | sì | |
status | testo, uno dei valori ammessi | sì | Valori: pending, confirmed, reconciled |
is_verified | sì/no (true/false) | sì | |
is_transfer | sì/no (true/false) | sì | |
transfer_linked_id | identificativo (UUID) | sì | Rimanda a dati/transactions.csv |
notes | testo | sì | |
provider_transaction_id | testo | sì | |
created_at | data e ora (ISO 8601, con fuso) | sì | |
updated_at | data e ora (ISO 8601, con fuso) | sì | |
currency | testo | sì | |
reference | testo | sì | |
booking_date | data (AAAA-MM-GG) | sì | |
value_date | data (AAAA-MM-GG) | sì | |
payee_name | testo | sì | |
payee_iban | testo | sì | |
payer_name | testo | sì | |
payer_iban | testo | sì | |
balance_after | numero decimale | sì | |
transaction_type | testo | sì | |
bank_category | testo | sì | |
raw_description | testo | sì | |
classification_source | testo | no | |
classification_confidence | numero decimale | sì | |
verified_by | identificativo (UUID) | sì | Rimanda a dati/users.csv |
verified_at | data e ora (ISO 8601, con fuso) | sì | |
dati_banca | dati strutturati (JSON) | sì | |
lettura | dati strutturati (JSON) | sì | |
giroconto_fonte | testo | sì | |
regola_id | identificativo (UUID) | sì | Rimanda a dati/categorization_rules.csv |
nascosto | sì/no (true/false) | no | |
nascosto_fonte | testo | sì | |
nascosto_il | data e ora (ISO 8601, con fuso) | sì | |
nascosto_da | identificativo (UUID) | sì | Rimanda a dati/users.csv |
nascosto_motivo | testo | sì | |
verifica_fonte | testo | sì |
Categorie dei movimenti — dati/transaction_categories.csv
La categoria di ciascun movimento e, per i movimenti divisi, la parte di importo di ogni categoria.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
transaction_id | identificativo (UUID) | no | Rimanda a dati/transactions.csv |
category_id | identificativo (UUID) | no | Rimanda a dati/categories.csv |
amount | numero decimale | sì | |
percentage | numero decimale | sì | |
created_at | data e ora (ISO 8601, con fuso) | sì |
Giustificativi dei movimenti — dati/allegati_movimenti.csv
I file allegati ai movimenti: nome, tipo, dimensione e percorso del file nell'archivio.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
transaction_id | identificativo (UUID) | no | Rimanda a dati/transactions.csv |
percorso | testo | no | |
nome | testo | no | |
tipo | testo | no | |
byte | numero intero | no | |
caricato_da | identificativo (UUID) | sì | Rimanda a dati/users.csv |
caricato_il | data e ora (ISO 8601, con fuso) | no |
Categorie — dati/categories.csv
Il piano delle categorie e sottocategorie, con verso, natura e ordine.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
parent_id | identificativo (UUID) | sì | Rimanda a dati/categories.csv |
name | testo | no | |
direction | testo, uno dei valori ammessi | sì | Valori: inflow, outflow, both |
icon | testo | sì | |
color | testo | sì | |
sort_order | numero intero | sì | |
is_system | sì/no (true/false) | sì | |
created_at | data e ora (ISO 8601, con fuso) | sì | |
updated_at | data e ora (ISO 8601, con fuso) | sì | |
natura | testo | sì | |
comportamento | testo | sì | |
natura_fonte | testo | sì | |
natura_motivo | testo | sì |
Regole di classificazione — dati/categorization_rules.csv
Le regole che assegnano una categoria ai movimenti: parole, condizioni, importi, conto, priorità.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
category_id | identificativo (UUID) | no | Rimanda a dati/categories.csv |
keyword | testo | no | |
direction | testo, uno dei valori ammessi | sì | Valori: inflow, outflow, both |
is_active | sì/no (true/false) | sì | |
match_count | numero intero | sì | |
priority | numero intero | sì | |
created_at | data e ora (ISO 8601, con fuso) | sì | |
updated_at | data e ora (ISO 8601, con fuso) | sì | |
parent_rule_id | identificativo (UUID) | sì | Rimanda a dati/categorization_rules.csv |
cerca_in | testo | no | |
condizioni | dati strutturati (JSON) | no | |
conto_id | identificativo (UUID) | sì | Rimanda a dati/bank_accounts.csv |
importo_min | numero decimale | sì | |
importo_max | numero decimale | sì | |
anche_su_ai | sì/no (true/false) | no | |
tipi_movimento | elenco di testi (JSON) | sì | |
verifica | sì/no (true/false) | no | |
nascondi | sì/no (true/false) | no |
Regole proposte e rifiutate — dati/proposte_regole_rifiutate.csv
Le parole per cui l'azienda ha rifiutato la proposta di una regola.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
parola | testo | no | |
rifiutata_da | identificativo (UUID) | sì | Rimanda a dati/users.csv |
rifiutata_il | data e ora (ISO 8601, con fuso) | no |
Proposte di categoria — dati/classification_proposals.csv
Le categorie proposte per movimenti e fatture, con l'affidabilità e la decisione presa.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
transaction_id | identificativo (UUID) | sì | Rimanda a dati/transactions.csv |
suggested_category_id | identificativo (UUID) | no | Rimanda a dati/categories.csv |
confidence | numero decimale | no | |
reasoning | testo | sì | |
status | testo | no | |
created_at | data e ora (ISO 8601, con fuso) | no | |
decided_at | data e ora (ISO 8601, con fuso) | sì | |
decided_by | identificativo (UUID) | sì | Rimanda a dati/users.csv |
invoice_id | identificativo (UUID) | sì | Rimanda a dati/invoices.csv |
Fatture, DDT, preventivi e documenti
Fatture — dati/invoices.csv
Fatture emesse e ricevute, note di credito, autofatture: numero, date, importi, IVA, ritenute, cassa, stato SdI, categoria, allegati.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
counterpart_id | identificativo (UUID) | sì | Rimanda a dati/counterparts.csv |
invoice_type | testo, uno dei valori ammessi | no | Valori: received, issued |
status | testo, uno dei valori ammessi | sì | Valori: draft, sent, error, to_collect, to_pay, paid, overdue |
number | testo | sì | |
date | data (AAAA-MM-GG) | sì | |
due_date | data (AAAA-MM-GG) | sì | |
amount_net | numero decimale | sì | |
amount_vat | numero decimale | sì | |
amount_gross | numero decimale | sì | |
amount_ritenuta | numero decimale | sì | |
currency | testo | sì | |
sdi_id | testo | sì | |
file_fattura_elettronica | percorso del file nell'archivio | sì | Il file della fattura elettronica, originale: XML FatturaPA o XML firmato (.xml.p7m), con il nome che ha presso lo SdI. Vuota per le fatture senza file, come quelle inserite a mano. |
category_id | identificativo (UUID) | sì | Rimanda a dati/categories.csv |
notes | testo | sì | |
metadata | dati strutturati (JSON) | sì | |
created_at | data e ora (ISO 8601, con fuso) | sì | |
updated_at | data e ora (ISO 8601, con fuso) | sì | |
sdi_status | testo | sì | |
amount_paid | numero decimale | sì | |
document_type | testo | sì | |
linked_invoice_id | identificativo (UUID) | sì | Rimanda a dati/invoices.csv |
payment_method_id | identificativo (UUID) | sì | Rimanda a dati/payment_methods.csv |
stamp_duty | numero decimale | sì | |
stamp_duty_virtual | sì/no (true/false) | sì | |
rounding | numero decimale | sì | |
causale | testo | sì | |
vat_collectability | testo | sì | |
withholding_rate | numero decimale | sì | |
withholding_type | testo | sì | |
cassa_type | testo | sì | |
cassa_rate | numero decimale | sì | |
cassa_amount | numero decimale | sì | |
related_documents | dati strutturati (JSON) | sì | |
attachments | dati strutturati (JSON) | sì | |
art73 | sì/no (true/false) | sì | |
classification_source | testo | no | |
classification_confidence | numero decimale | sì | |
integra_invoice_id | identificativo (UUID) | sì | Rimanda a dati/invoices.csv |
sezionale | testo | no | |
numero_progressivo | numero intero | sì | |
ritenute | dati strutturati (JSON) | sì | |
riferimenti_normativi | dati strutturati (JSON) | sì |
Righe delle fatture — dati/invoice_lines.csv
Le righe delle fatture create in Contifex: descrizione, quantità, prezzo, sconti, IVA, periodo.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
invoice_id | identificativo (UUID) | no | Rimanda a dati/invoices.csv |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
product_id | identificativo (UUID) | sì | Rimanda a dati/products.csv |
line_number | numero intero | no | |
description | testo | no | |
quantity | numero decimale | no | |
unit_of_measure | testo | no | |
unit_price | numero decimale | no | |
discount_percent | numero decimale | sì | |
discount_amount | numero decimale | sì | |
total_price | numero decimale | no | |
vat_rate | numero decimale | no | |
vat_nature | testo | sì | |
vat_amount | numero decimale | no | |
created_at | data e ora (ISO 8601, con fuso) | no | |
period_start | data (AAAA-MM-GG) | sì | |
period_end | data (AAAA-MM-GG) | sì | |
article_code_type | testo | sì | |
article_code_value | testo | sì | |
line_notes | testo | sì | |
custom_values | dati strutturati (JSON) | sì | |
altri_dati | dati strutturati (JSON) | sì |
Righe delle fatture ricevute — dati/righe_fatture_ricevute.csv
Le righe lette dal file delle fatture ricevute, con i codici articolo e gli altri dati gestionali.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
invoice_id | identificativo (UUID) | no | Rimanda a dati/invoices.csv |
posizione | numero intero | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
numero_linea | numero intero | sì | |
tipo_cessione_prestazione | testo | sì | |
descrizione | testo | no | |
codici_articolo | dati strutturati (JSON) | no | |
quantita | numero decimale | sì | |
unita_misura | testo | sì | |
data_inizio_periodo | data (AAAA-MM-GG) | sì | |
data_fine_periodo | data (AAAA-MM-GG) | sì | |
prezzo_unitario | numero decimale | sì | |
sconti_maggiorazioni | dati strutturati (JSON) | no | |
prezzo_totale | numero decimale | sì | |
aliquota_iva | numero decimale | sì | |
natura | testo | sì | |
ritenuta | sì/no (true/false) | no | |
riferimento_amministrazione | testo | sì | |
altri_dati_gestionali | dati strutturati (JSON) | no | |
testi_non_letti | dati strutturati (JSON) | no |
Notifiche del Sistema di Interscambio — dati/sdi_events.csv
Lo storico delle notifiche SdI di ogni fattura: invio, consegna, scarto, esito.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
invoice_id | identificativo (UUID) | sì | Rimanda a dati/invoices.csv |
event_type | testo | no | |
sdi_status | testo | sì | |
details | dati strutturati (JSON) | sì | |
created_at | data e ora (ISO 8601, con fuso) | sì | |
provider_update_id | numero intero | sì |
Documenti arrivati per email — dati/documenti_in_arrivo.csv
I documenti ricevuti all'indirizzo di ricezione: mittente, oggetto, file, lettura, fattura o movimento a cui sono stati abbinati.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
ricevuto_il | data e ora (ISO 8601, con fuso) | no | |
email_id | testo | no | |
allegato_id | testo | no | |
mittente | testo | sì | |
oggetto | testo | sì | |
nome_file | testo | sì | |
percorso | testo | sì | |
byte | numero intero | sì | |
link_ricevuta | testo | sì | |
stato | testo | no | |
lettura | dati strutturati (JSON) | sì | |
tentativi | numero intero | no | |
lettura_iniziata_il | data e ora (ISO 8601, con fuso) | sì | |
letto_il | data e ora (ISO 8601, con fuso) | sì | |
invoice_id | identificativo (UUID) | sì | Rimanda a dati/invoices.csv |
transaction_id | identificativo (UUID) | sì | Rimanda a dati/transactions.csv |
chiuso_il | data e ora (ISO 8601, con fuso) | sì | |
chiuso_da | identificativo (UUID) | sì | Rimanda a dati/users.csv |
Documenti di trasporto — dati/ddts.csv
I DDT: numero, data, destinatario, causale, trasporto, vettore, colli, pesi, importi.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
number | testo | no | |
series | testo | sì | |
date | data (AAAA-MM-GG) | no | |
counterpart_id | identificativo (UUID) | sì | Rimanda a dati/counterparts.csv |
destination_name | testo | sì | |
destination_address | dati strutturati (JSON) | sì | |
causale_trasporto | testo | sì | |
aspetto_esteriore | testo | sì | |
porto | testo | sì | |
trasporto_a_cura | testo | sì | |
mezzo_trasporto | testo | sì | |
numero_colli | numero intero | sì | |
peso_lordo | numero decimale | sì | |
peso_netto | numero decimale | sì | |
unita_misura_peso | testo | sì | |
data_inizio_trasporto | data e ora (ISO 8601, con fuso) | sì | |
data_ora_ritiro | data e ora (ISO 8601, con fuso) | sì | |
data_ora_consegna | data e ora (ISO 8601, con fuso) | sì | |
vettore_nome | testo | sì | |
vettore_piva | testo | sì | |
vettore_cf | testo | sì | |
vettore_licenza_guida | testo | sì | |
tipo_resa | testo | sì | |
indirizzo_resa | dati strutturati (JSON) | sì | |
status | testo | no | |
notes | testo | sì | |
causale_documento | testo | sì | |
amount_net | numero decimale | sì | |
amount_vat | numero decimale | sì | |
amount_gross | numero decimale | sì | |
created_at | data e ora (ISO 8601, con fuso) | sì | |
updated_at | data e ora (ISO 8601, con fuso) | sì |
Righe dei DDT — dati/ddt_lines.csv
Le righe dei DDT, con le quantità già fatturate.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
ddt_id | identificativo (UUID) | no | Rimanda a dati/ddts.csv |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
product_id | identificativo (UUID) | sì | Rimanda a dati/products.csv |
line_number | numero intero | no | |
description | testo | no | |
quantity | numero decimale | no | |
unit_of_measure | testo | sì | |
unit_price | numero decimale | sì | |
discount_percent | numero decimale | sì | |
total_price | numero decimale | sì | |
vat_rate | numero decimale | sì | |
vat_nature | testo | sì | |
vat_amount | numero decimale | sì | |
quantity_invoiced | numero decimale | sì | |
lotto | testo | sì | |
peso_netto_riga | numero decimale | sì | |
article_code_type | testo | sì | |
article_code_value | testo | sì | |
line_notes | testo | sì | |
created_at | data e ora (ISO 8601, con fuso) | sì |
DDT fatturati — dati/ddt_invoice_links.csv
Il legame fra righe dei DDT e fatture, con la quantità fatturata.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
ddt_id | identificativo (UUID) | no | Rimanda a dati/ddts.csv |
ddt_line_id | identificativo (UUID) | sì | Rimanda a dati/ddt_lines.csv |
invoice_id | identificativo (UUID) | no | Rimanda a dati/invoices.csv |
invoice_line_number | numero intero | sì | |
quantity_invoiced | numero decimale | sì | |
created_at | data e ora (ISO 8601, con fuso) | sì |
Preventivi — dati/preventivi.csv
I preventivi: numero, data, cliente, condizioni, importi, esito, fattura o DDT che ne sono nati.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
anno | numero intero | no | |
progressivo | numero intero | no | |
data | data (AAAA-MM-GG) | no | |
valido_fino | data (AAAA-MM-GG) | sì | |
counterpart_id | identificativo (UUID) | no | Rimanda a dati/counterparts.csv |
oggetto | testo | sì | |
condizioni | testo | sì | |
payment_method_id | identificativo (UUID) | sì | Rimanda a dati/payment_methods.csv |
stato | testo | no | |
esito_il | data e ora (ISO 8601, con fuso) | sì | |
imponibile | numero decimale | no | |
iva | numero decimale | no | |
totale | numero decimale | no | |
fattura_id | identificativo (UUID) | sì | Rimanda a dati/invoices.csv |
ddt_id | identificativo (UUID) | sì | Rimanda a dati/ddts.csv |
creato_il | data e ora (ISO 8601, con fuso) | no |
Righe dei preventivi — dati/righe_preventivo.csv
Le righe dei preventivi.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
preventivo_id | identificativo (UUID) | no | Rimanda a dati/preventivi.csv |
line_number | numero intero | no | |
product_id | identificativo (UUID) | sì | Rimanda a dati/products.csv |
description | testo | no | |
quantity | numero decimale | no | |
unit_of_measure | testo | sì | |
unit_price | numero decimale | no | |
discount_percent | numero decimale | sì | |
total_price | numero decimale | no | |
vat_rate | numero decimale | no | |
vat_nature | testo | sì | |
vat_amount | numero decimale | no |
Documenti inviati per email — dati/invii_documenti.csv
Lo storico degli invii di fatture, DDT e preventivi per email: destinatario, oggetto, esito.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
invoice_id | identificativo (UUID) | sì | Rimanda a dati/invoices.csv |
ddt_id | identificativo (UUID) | sì | Rimanda a dati/ddts.csv |
destinatario | testo | no | |
oggetto | testo | no | |
risposta_a | testo | sì | |
allegato | testo | no | |
esito | testo | no | |
errore | testo | sì | |
id_messaggio | testo | sì | |
inviato_da | identificativo (UUID) | sì | Rimanda a dati/users.csv |
inviato_il | data e ora (ISO 8601, con fuso) | no | |
preventivo_id | identificativo (UUID) | sì | Rimanda a dati/preventivi.csv |
Collegamento al cassetto fiscale — dati/collegamenti_cassetto.csv
Lo stato del collegamento al cassetto fiscale, quando la funzione è disponibile e l'azienda l'ha attivata.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
fonte | testo | no | |
stato | testo | no | |
pagate_fino_al | data (AAAA-MM-GG) | sì | |
incassate_fino_al | data (AAAA-MM-GG) | sì | |
delega_fatta_il | data e ora (ISO 8601, con fuso) | sì | |
storico_chiesto_il | data e ora (ISO 8601, con fuso) | sì | |
storico_finito_il | data e ora (ISO 8601, con fuso) | sì | |
giro_in_corso_dal | data e ora (ISO 8601, con fuso) | sì | |
ultimo_giro_il | data e ora (ISO 8601, con fuso) | sì | |
ultimo_giro_ok_il | data e ora (ISO 8601, con fuso) | sì | |
giri_falliti | numero intero | no | |
ultimo_errore | testo | sì | |
creato_il | data e ora (ISO 8601, con fuso) | no | |
aggiornato_il | data e ora (ISO 8601, con fuso) | no |
Non si esportano: riferimento_esterno, identificativo dell'azienda presso l'intermediario: codice del collegamento; cursore, posizione interna dello scarico presso l'intermediario: codice del collegamento.
Scarichi dal cassetto fiscale — dati/scarichi_cassetto.csv
Lo storico degli scarichi delle fatture dal cassetto fiscale, con i conteggi e gli scarti.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
collegamento_id | identificativo (UUID) | no | Rimanda a dati/collegamenti_cassetto.csv |
iniziato_il | data e ora (ISO 8601, con fuso) | no | |
finito_il | data e ora (ISO 8601, con fuso) | sì | |
esito | testo | sì | |
pagine | numero intero | no | |
ricevute_nuove | numero intero | no | |
ricevute_gia_presenti | numero intero | no | |
emesse_nuove | numero intero | no | |
emesse_gia_presenti | numero intero | no | |
scarti | dati strutturati (JSON) | no | |
scarti_totali | numero intero | no | |
errore | testo | sì |
Clienti, fornitori, prodotti e solleciti
Clienti e fornitori — dati/counterparts.csv
L'anagrafica di clienti e fornitori: nome, partita IVA, codice fiscale, indirizzo, contatti, IBAN, codice SdI, impostazioni predefinite.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
name | testo | no | |
vat_number | testo | sì | |
fiscal_code | testo | sì | |
type | testo | sì | |
default_category_id | identificativo (UUID) | sì | Rimanda a dati/categories.csv |
default_payment_terms_days | numero intero | sì | |
email | testo | sì | |
phone | testo | sì | |
address | dati strutturati (JSON) | sì | |
notes | testo | sì | |
created_at | data e ora (ISO 8601, con fuso) | sì | |
updated_at | data e ora (ISO 8601, con fuso) | sì | |
iban | testo | sì | |
default_payment_method | testo, uno dei valori ammessi | sì | Valori: bonifico, sepa, contanti, assegno, carta, altro |
sdi_code | testo | sì | |
sdi_pec | testo | sì | |
referente | testo | sì | |
default_account_id | identificativo (UUID) | sì | Rimanda a dati/bank_accounts.csv |
Impostazioni per cliente — dati/counterpart_settings.csv
Per ogni cliente: solleciti sì o no, email dei solleciti, pausa, note.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
counterpart_id | identificativo (UUID) | no | Rimanda a dati/counterparts.csv |
reminder_opt_out | sì/no (true/false) | no | |
reminder_email_override | testo | sì | |
notes | testo | sì | |
created_at | data e ora (ISO 8601, con fuso) | no | |
updated_at | data e ora (ISO 8601, con fuso) | no | |
profilo_forzato | testo | sì | |
pausa_fino_al | data (AAAA-MM-GG) | sì |
Clienti e fornitori uniti — dati/controparti_unite.csv
Le anagrafiche unite in un'altra, con i dati di prima, per poterle separare di nuovo.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
controparte_id | identificativo (UUID) | no | |
principale_id | identificativo (UUID) | no | |
anagrafica | dati strutturati (JSON) | no | |
impostazioni | dati strutturati (JSON) | sì | |
principale_prima | dati strutturati (JSON) | no | |
riferimenti | dati strutturati (JSON) | no | |
unita_da | identificativo (UUID) | sì | |
unita_il | data e ora (ISO 8601, con fuso) | no |
Puntualità dei clienti — dati/client_payment_stats.csv
Quanto tempo ciascun cliente impiega di solito a pagare, calcolato sulle fatture dell'azienda.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
client_id | identificativo (UUID) | no | Rimanda a dati/counterparts.csv |
sample_size | numero intero | no | |
median_days | numero decimale | sì | |
p90_days | numero decimale | sì | |
mean_days | numero decimale | sì | |
median_days_late | numero decimale | sì | |
last_calculated | data e ora (ISO 8601, con fuso) | no |
Prodotti e servizi — dati/products.csv
Il catalogo: codice, descrizione, unità di misura, prezzo e IVA predefiniti.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
code | testo | sì | |
description | testo | no | |
unit_of_measure | testo | no | |
default_price | numero decimale | no | |
default_vat_rate | numero decimale | no | |
default_vat_nature | testo | sì | |
is_active | sì/no (true/false) | no | |
created_at | data e ora (ISO 8601, con fuso) | no | |
updated_at | data e ora (ISO 8601, con fuso) | no | |
code_type | testo | sì | |
code_value | testo | sì |
Solleciti — dati/payment_reminders.csv
I solleciti mandati ai clienti: fattura, livello, destinatario, oggetto, anteprima del testo, esito della consegna.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
invoice_id | identificativo (UUID) | no | Rimanda a dati/invoices.csv |
counterpart_id | identificativo (UUID) | no | Rimanda a dati/counterparts.csv |
reminder_number | numero intero | no | |
status | testo | no | |
email_to | testo | no | |
email_subject | testo | no | |
email_body_preview | testo | sì | |
sent_at | data e ora (ISO 8601, con fuso) | no | |
created_at | data e ora (ISO 8601, con fuso) | no | |
level | testo | no | |
tone_profile | testo | no | |
delivery_status | testo | no | |
resend_message_id | testo | sì | |
last_error | testo | sì | |
retry_count | numero intero | no | |
origine | testo | no | |
invio_id | identificativo (UUID) | sì |
Scadenze, pagamenti, riconciliazioni e cassa
Scadenze — dati/deadlines.csv
Lo scadenzario: incassi e pagamenti da fatture, ricorrenze, imposte e scadenze a mano, con rate, stato e pagamento.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
source | testo, uno dei valori ammessi | no | Valori: invoice, recurrence, manual, fiscal, sdi |
invoice_id | identificativo (UUID) | sì | Rimanda a dati/invoices.csv |
recurrence_id | identificativo (UUID) | sì | Rimanda a dati/recurrences.csv |
account_id | identificativo (UUID) | sì | Rimanda a dati/bank_accounts.csv |
counterpart_id | identificativo (UUID) | sì | Rimanda a dati/counterparts.csv |
description | testo | no | |
amount | numero decimale | no | |
direction | testo, uno dei valori ammessi | no | Valori: inflow, outflow |
due_date | data (AAAA-MM-GG) | no | |
status | testo, uno dei valori ammessi | sì | Valori: pending, paid, overdue, cancelled |
paid_at | data e ora (ISO 8601, con fuso) | sì | |
paid_transaction_id | identificativo (UUID) | sì | Rimanda a dati/transactions.csv |
category_id | identificativo (UUID) | sì | Rimanda a dati/categories.csv |
notes | testo | sì | |
created_at | data e ora (ISO 8601, con fuso) | sì | |
updated_at | data e ora (ISO 8601, con fuso) | sì | |
installment_group_id | identificativo (UUID) | sì | |
installment_label | testo | sì | |
fiscal_type | testo | sì | |
fiscal_period | testo | sì | |
published_by | identificativo (UUID) | sì | Rimanda a dati/users.csv |
attachment_path | testo | sì | |
data_scelta_a_mano | sì/no (true/false) | no | |
data_ricorrenza | data (AAAA-MM-GG) | sì | |
pubblicata_dal_collegamento | identificativo (UUID) | sì | Rimanda a dati/accountant_links.csv |
divisa_da | identificativo (UUID) | sì | |
rata | numero intero | sì | |
importo_rata | numero decimale | sì | |
modalita_pagamento | testo | sì | |
iban_pagamento | testo | sì | |
termine_giorni | numero intero | sì | |
verificata_il | data e ora (ISO 8601, con fuso) | sì | |
verificata_da | identificativo (UUID) | sì |
Ricorrenze — dati/recurrences.csv
Le voci che si ripetono: importo, frequenza, date, conto, controparte e categoria.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
description | testo | no | |
amount | numero decimale | no | |
direction | testo, uno dei valori ammessi | no | Valori: inflow, outflow |
frequency | testo, uno dei valori ammessi | no | Valori: weekly, monthly, quarterly, yearly |
start_date | data (AAAA-MM-GG) | no | |
end_date | data (AAAA-MM-GG) | sì | |
next_due_date | data (AAAA-MM-GG) | sì | |
account_id | identificativo (UUID) | sì | Rimanda a dati/bank_accounts.csv |
counterpart_id | identificativo (UUID) | sì | Rimanda a dati/counterparts.csv |
category_id | identificativo (UUID) | sì | Rimanda a dati/categories.csv |
is_active | sì/no (true/false) | sì | |
created_at | data e ora (ISO 8601, con fuso) | sì | |
updated_at | data e ora (ISO 8601, con fuso) | sì |
Pagamenti — dati/payments.csv
I pagamenti registrati: importo, beneficiario, IBAN, stato, scadenza, fattura e movimento collegati, compensazioni.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
from_account_id | identificativo (UUID) | sì | Rimanda a dati/bank_accounts.csv |
deadline_id | identificativo (UUID) | sì | Rimanda a dati/deadlines.csv |
counterpart_name | testo | sì | |
iban | testo | sì | |
amount | numero decimale | no | |
description | testo | sì | |
status | testo, uno dei valori ammessi | sì | Valori: draft, submitted, processing, completed, failed |
executed_at | data e ora (ISO 8601, con fuso) | sì | |
transaction_id | identificativo (UUID) | sì | Rimanda a dati/transactions.csv |
created_at | data e ora (ISO 8601, con fuso) | sì | |
updated_at | data e ora (ISO 8601, con fuso) | sì | |
payment_method | testo, uno dei valori ammessi | sì | Valori: bonifico, sepa, contanti, assegno, carta, altro |
invoice_id | identificativo (UUID) | sì | Rimanda a dati/invoices.csv |
notes | testo | sì | |
compensazione | identificativo (UUID) | sì |
Distinte di bonifico — dati/distinte_pagamento.csv
Le distinte di bonifici preparate per la banca: conto di addebito, data, numero di bonifici, totale, stato.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
account_id | identificativo (UUID) | sì | Rimanda a dati/bank_accounts.csv |
iban_addebito | testo | no | |
data_esecuzione | data (AAAA-MM-GG) | no | |
origine | testo | no | |
stato | testo | no | |
numero_bonifici | numero intero | no | |
totale | numero decimale | no | |
file_distinta | percorso del file nell'archivio | sì | Il file XML della distinta, così come è stato preparato per la banca. |
creata_il | data e ora (ISO 8601, con fuso) | no | |
creata_da | identificativo (UUID) | sì | Rimanda a dati/users.csv |
annullata_il | data e ora (ISO 8601, con fuso) | sì |
Bonifici delle distinte — dati/distinte_pagamento_righe.csv
I singoli bonifici di ogni distinta: beneficiario, IBAN, importo, causale, scadenza.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
distinta_id | identificativo (UUID) | no | Rimanda a dati/distinte_pagamento.csv |
deadline_id | identificativo (UUID) | sì | Rimanda a dati/deadlines.csv |
controparte_id | identificativo (UUID) | sì | |
bonifico | numero intero | no | |
beneficiario | testo | no | |
iban | testo | no | |
importo | numero decimale | no | |
causale | testo | no | |
attiva | sì/no (true/false) | no | |
creata_il | data e ora (ISO 8601, con fuso) | no |
Riconciliazioni — dati/reconciliations.csv
I movimenti abbinati a fatture e scadenze, con l'importo abbinato e il modo dell'abbinamento.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
transaction_id | identificativo (UUID) | no | Rimanda a dati/transactions.csv |
invoice_id | identificativo (UUID) | sì | Rimanda a dati/invoices.csv |
deadline_id | identificativo (UUID) | sì | Rimanda a dati/deadlines.csv |
method | testo, uno dei valori ammessi | no | Valori: automatic, proposal, manual, partial |
amount_matched | numero decimale | sì | |
confidence | numero decimale | sì | |
is_confirmed | sì/no (true/false) | sì | |
created_at | data e ora (ISO 8601, con fuso) | sì |
Abbinamenti proposti — dati/match_proposals.csv
Gli abbinamenti fra movimenti e fatture o scadenze proposti dal Servizio, con punteggio, motivi ed esito.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
invoice_id | identificativo (UUID) | sì | Rimanda a dati/invoices.csv |
transaction_id | identificativo (UUID) | no | Rimanda a dati/transactions.csv |
score | numero decimale | no | |
reasons | dati strutturati (JSON) | no | |
status | testo | no | |
created_at | data e ora (ISO 8601, con fuso) | no | |
expires_at | data e ora (ISO 8601, con fuso) | no | |
accepted_at | data e ora (ISO 8601, con fuso) | sì | |
accepted_by | identificativo (UUID) | sì | Rimanda a dati/users.csv |
reconciliation_id | identificativo (UUID) | sì | Rimanda a dati/reconciliations.csv |
deadline_id | identificativo (UUID) | sì | Rimanda a dati/deadlines.csv |
Abbinamenti rifiutati — dati/match_rejections.csv
Gli abbinamenti che l'azienda ha rifiutato, per non riproporli.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
invoice_id | identificativo (UUID) | sì | Rimanda a dati/invoices.csv |
transaction_id | identificativo (UUID) | no | Rimanda a dati/transactions.csv |
fingerprint | testo | no | |
rejected_at | data e ora (ISO 8601, con fuso) | no | |
rejected_by | identificativo (UUID) | sì | Rimanda a dati/users.csv |
deadline_id | identificativo (UUID) | sì | Rimanda a dati/deadlines.csv |
Voci della previsione di cassa — dati/cashflow_entries.csv
Le voci di cassa, realizzate e previste, da movimenti, scadenze, ricorrenze e previsioni.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
source | testo, uno dei valori ammessi | no | Valori: transaction, deadline, recurrence, forecast |
transaction_id | identificativo (UUID) | sì | Rimanda a dati/transactions.csv |
deadline_id | identificativo (UUID) | sì | Rimanda a dati/deadlines.csv |
recurrence_id | identificativo (UUID) | sì | Rimanda a dati/recurrences.csv |
account_id | identificativo (UUID) | sì | Rimanda a dati/bank_accounts.csv |
date | data (AAAA-MM-GG) | no | |
amount | numero decimale | no | |
direction | testo, uno dei valori ammessi | no | Valori: inflow, outflow |
category_id | identificativo (UUID) | sì | Rimanda a dati/categories.csv |
description | testo | sì | |
is_realized | sì/no (true/false) | sì | |
created_at | data e ora (ISO 8601, con fuso) | sì | |
updated_at | data e ora (ISO 8601, con fuso) | sì | |
serie_id | identificativo (UUID) | sì |
Chiusure, bilancio, budget e imposte
Chiusure del mese — dati/monthly_closures.csv
Le chiusure mensili: riepilogo, cose da sistemare, file del fascicolo, invio al commercialista e ricevuta.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
year | numero intero | no | |
month | numero intero | no | |
generated_at | data e ora (ISO 8601, con fuso) | no | |
generated_by | identificativo (UUID) | sì | |
summary | dati strutturati (JSON) | no | |
pdf_url | testo | sì | |
zip_url | testo | sì | |
email_sent_at | data e ora (ISO 8601, con fuso) | sì | |
email_to | testo | sì | |
email_error | testo | sì | |
created_at | data e ora (ISO 8601, con fuso) | no | |
updated_at | data e ora (ISO 8601, con fuso) | no | |
preparata_il | data e ora (ISO 8601, con fuso) | sì | |
da_sistemare | dati strutturati (JSON) | sì | |
inviata_automaticamente | sì/no (true/false) | no | |
ricevuta_il | data e ora (ISO 8601, con fuso) | sì | |
ricevuta_da | identificativo (UUID) | sì | Rimanda a dati/accountant_links.csv |
invio_fermato_il | data e ora (ISO 8601, con fuso) | sì |
Categorie nelle voci di bilancio — dati/bilancio_mappings.csv
In quale voce del bilancio va ogni categoria.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
category_id | identificativo (UUID) | sì | Rimanda a dati/categories.csv |
special_key | testo | sì | |
voce_code | testo | no | |
created_at | data e ora (ISO 8601, con fuso) | no | |
updated_at | data e ora (ISO 8601, con fuso) | no |
Bozze di bilancio — dati/bilancio_drafts.csv
Le bozze di bilancio per anno, con il prospetto calcolato.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
fiscal_year | numero intero | no | |
status | testo | no | |
schema_version | numero intero | no | |
prospectus | dati strutturati (JSON) | no | |
source_fingerprint | dati strutturati (JSON) | sì | |
opening_equity | dati strutturati (JSON) | sì | |
generated_by | identificativo (UUID) | sì | |
generated_at | data e ora (ISO 8601, con fuso) | no | |
created_at | data e ora (ISO 8601, con fuso) | no | |
updated_at | data e ora (ISO 8601, con fuso) | no |
Rettifiche di bilancio — dati/bilancio_adjustments.csv
Le rettifiche inserite a mano nelle bozze di bilancio.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
draft_id | identificativo (UUID) | no | Rimanda a dati/bilancio_drafts.csv |
kind | testo | no | |
description | testo | no | |
amount | numero decimale | no | |
voce_ce | testo | sì | |
voce_sp | testo | sì | |
created_by | identificativo (UUID) | sì | |
created_at | data e ora (ISO 8601, con fuso) | no | |
updated_at | data e ora (ISO 8601, con fuso) | no |
Budget per categoria — dati/budget_categorie.csv
Il budget di ogni categoria, mese per mese.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
category_id | identificativo (UUID) | no | Rimanda a dati/categories.csv |
verso | testo, uno dei valori ammessi | no | Valori: inflow, outflow |
mese | data (AAAA-MM-GG) | no | |
importo | numero decimale | no | |
fonte | testo | no | |
aggiornato_da | identificativo (UUID) | sì | Rimanda a dati/users.csv |
aggiornato_il | data e ora (ISO 8601, con fuso) | no | |
creato_il | data e ora (ISO 8601, con fuso) | no |
Dati per le imposte — dati/dati_imposte.csv
Per anno: forma giuridica, regime IVA, imposte dell'anno prima, acconti versati, aliquote, saldo.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
anno | numero intero | no | |
forma_giuridica | testo | no | |
ires_anno_prima | numero decimale | sì | |
irap_anno_prima | numero decimale | sì | |
acconti_versati | numero decimale | sì | |
soggetto_isa | sì/no (true/false) | no | |
aliquota_irap | numero decimale | no | |
aggiornata_da | identificativo (UUID) | sì | Rimanda a dati/users.csv |
aggiornata_dal_collegamento | identificativo (UUID) | sì | Rimanda a dati/accountant_links.csv |
aggiornata_il | data e ora (ISO 8601, con fuso) | no | |
iva_agricola_ordinaria | sì/no (true/false) | sì | |
iva_trimestrale_speciale | sì/no (true/false) | no | |
rinvio_sotto_soglia | sì/no (true/false) | no | |
reddito_agrario | sì/no (true/false) | no | |
scadenza_saldo | data (AAAA-MM-GG) | sì | |
rate_saldo | numero intero | no |
Dati per gli adeguati assetti — dati/dati_assetti.csv
I dati inseriti per i segnali di crisi: retribuzioni, debiti scaduti, esposizioni verso banche ed enti.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
retribuzioni_mensili | numero decimale | sì | |
retribuzioni_scadute | numero decimale | sì | |
esposizioni_banche | numero decimale | sì | |
esposizioni_scadute | numero decimale | sì | |
fidi_accordati | numero decimale | sì | |
con_dipendenti | sì/no (true/false) | sì | |
inps_scaduti | numero decimale | sì | |
inps_anno_precedente | numero decimale | sì | |
inail_scaduti | numero decimale | sì | |
iva_scaduta | numero decimale | sì | |
volume_affari | numero decimale | sì | |
riscossione_scaduti | numero decimale | sì | |
aggiornati_da | identificativo (UUID) | sì | Rimanda a dati/users.csv |
aggiornati_il | data e ora (ISO 8601, con fuso) | no |
Commercialista
Commercialisti collegati — dati/accountant_links.csv
Gli inviti e i collegamenti con lo studio del commercialista: email, stato, date, permessi.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
accountant_user_id | identificativo (UUID) | sì | |
invited_email | testo | no | |
status | testo | no | |
invited_by | identificativo (UUID) | sì | |
accepted_at | data e ora (ISO 8601, con fuso) | sì | |
revoked_at | data e ora (ISO 8601, con fuso) | sì | |
revoked_by | identificativo (UUID) | sì | |
created_at | data e ora (ISO 8601, con fuso) | no | |
updated_at | data e ora (ISO 8601, con fuso) | no | |
puo_pubblicare_f24 | sì/no (true/false) | no | |
email_messaggi_il | data e ora (ISO 8601, con fuso) | sì |
Domande del commercialista — dati/domande_studio.csv
Le domande del commercialista sui movimenti, con le risposte.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
transaction_id | identificativo (UUID) | no | Rimanda a dati/transactions.csv |
collegamento_id | identificativo (UUID) | sì | Rimanda a dati/accountant_links.csv |
testo | testo | no | |
stato | testo | no | |
risposta | testo | sì | |
risposta_da | identificativo (UUID) | sì | Rimanda a dati/users.csv |
creata_il | data e ora (ISO 8601, con fuso) | no | |
risposta_il | data e ora (ISO 8601, con fuso) | sì |
Messaggi con il commercialista — dati/messaggi_studio.csv
I messaggi scambiati con lo studio.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
accountant_link_id | identificativo (UUID) | sì | Rimanda a dati/accountant_links.csv |
lato | testo | no | |
autore_user_id | identificativo (UUID) | no | |
testo | testo | no | |
creato_il | data e ora (ISO 8601, con fuso) | no |
Documenti scambiati con il commercialista — dati/documenti_studio.csv
I documenti caricati dall'azienda o dallo studio: nome, tipo, dimensione, percorso del file nell'archivio.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
id | identificativo (UUID) | no | |
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
accountant_link_id | identificativo (UUID) | sì | Rimanda a dati/accountant_links.csv |
lato | testo | no | |
caricato_da | identificativo (UUID) | no | |
tipo | testo | no | |
nome | testo | no | |
percorso | testo | no | |
byte | numero intero | no | |
creato_il | data e ora (ISO 8601, con fuso) | no | |
tolto_il | data e ora (ISO 8601, con fuso) | sì | |
tolto_da | identificativo (UUID) | sì |
Letture dei messaggi — dati/letture_studio.csv
Fin dove ciascun utente ha letto i messaggi con lo studio.
| Colonna | Tipo | Può essere vuota | Note |
|---|---|---|---|
organization_id | identificativo (UUID) | no | Rimanda a dati/organizations.csv |
user_id | identificativo (UUID) | no | |
lato | testo | no | |
letto_fino | data e ora (ISO 8601, con fuso) | no |
5. I file
I file stanno in file/<contenitore>/<percorso>, dove il percorso è quello scritto nella colonna della tabella, e comincia con l’identificativo dell’azienda.
| Contenitore | Che cosa contiene | Dove sono indicati |
|---|---|---|
file/invoice-attachments/ | PDF delle fatture senza file elettronico (fatture estere, scontrini, ricevute), PDF allegati dentro le fatture emesse e PDF arrivati all'indirizzo di ricezione | invoices.attachments, documenti_in_arrivo.percorso |
file/transaction-attachments/ | Giustificativi dei movimenti (PDF e immagini) | allegati_movimenti.percorso |
file/fiscal-attachments/ | Allegati delle scadenze fiscali, come gli F24 | deadlines.attachment_path |
file/closure-attachments/ | PDF e ZIP dei fascicoli della chiusura del mese | monthly_closures.pdf_url, monthly_closures.zip_url |
file/documenti-studio/ | Documenti scambiati con il commercialista | documenti_studio.percorso |
file/company-logos/ | Logo dell'azienda (PNG o JPEG) | il file <id azienda>/logo |
6. Che cosa non si esporta
Come prevede l’art. 15.1 dei Termini, restano fuori solo i dati che servono al funzionamento interno del Servizio: registri tecnici e di sicurezza, contatori dei limiti, codici e chiavi dei collegamenti. Oltre alle colonne indicate tabella per tabella, non si esportano:
| Dati | Perché |
|---|---|
admin_audit_log | Registro delle operazioni del pannello di amministrazione di Artifex: registro di sicurezza. |
ai_query_log | Registro tecnico delle operazioni eseguite dall'assistente. |
ai_usage | Contatore mensile dell'uso delle funzioni che il piano limita. |
azioni_ai_in_attesa | Operazioni proposte dall'assistente in attesa di conferma, che scadono da sole: servono al funzionamento interno. |
bank_connection_secrets | Chiavi cifrate dei collegamenti bancari. |
codici_recupero | Impronte dei codici di recupero dell'accesso: dati di sicurezza. |
cron_escalations | Registro tecnico dei controlli automatici, non riferito a un'azienda. |
estrazioni_righe_ricevute | Registro tecnico della lettura delle righe delle fatture ricevute; le righe lette sono in righe_fatture_ricevute.csv. |
industry_benchmarks | Statistiche di settore che Artifex calcola su più aziende: non sono dati di una singola azienda. |
invoicetronic_processed_events | Registro tecnico delle notifiche ricevute dall'intermediario delle fatture. |
limitatore_contatori | Contatori dei limiti di frequenza. |
push_iscrizioni | Indirizzi e chiavi che il browser crea per ricevere le notifiche: chiavi di un collegamento. |
richieste_accesso | Richieste d'accesso alla demo arrivate dal sito prima del contratto: non sono Dati del Cliente (le tratta Artifex come titolare, secondo l'informativa privacy). |
richieste_pannello | Registro tecnico delle operazioni chieste al pannello di amministrazione. |
stripe_processed_events | Registro tecnico delle notifiche ricevute dal servizio di pagamento. |
I dati personali che Artifex tratta come titolare, per esempio la prova dell’accettazione dei Termini, sono descritti nell’informativa privacy, che dice anche come averne copia.
7. Per i programmi
La stessa descrizione, in forma leggibile da un programma, è in /docs/esportazione/datapackage.json: è il file datapackage.json che trovi in ogni archivio, e con gli strumenti di Frictionless Data permette di controllare e caricare i CSV in un altro sistema.
Il registro si aggiorna quando il Servizio aggiunge o cambia dati: la data in alto è quella dell’ultima modifica. Dove sono conservati i dati, e quali misure li proteggono dall’accesso di autorità di Paesi fuori dall’Unione europea, è nella pagina Dove sono i dati.