Navigazione Docs

Inizia Subito (30 min)

Come iniziare con Fatturino in 30 minuti: da zero a una fattura inviata al SDI.

Tempo totale: 30 minuti
Requisiti: Docker installato, account OpenAPI (opzionale)

1. Installa Fatturino (5 min)

git clone https://codeberg.org/fatturino/fatturino.git
cd fatturino

cp .env.example .env
docker compose up -d

docker compose exec app php artisan migrate

Apri http://localhost nel browser.

2. Configura Azienda (5 min)

  1. Configurazione → Impostazioni Azienda (dalla barra laterale)
  2. Riempi:
    • Ragione sociale: Es. "Mario Rossi Srl"
    • P.IVA: Es. "04826950166"
    • Indirizzo completo
    • Email
  3. Salva

3. Crea un Cliente (3 min)

  1. Clienti & Fornitori (dalla barra laterale)
  2. Crea
  3. Riempi:
    • Nome azienda
    • P.IVA / Codice Fiscale
    • Indirizzo
    • Email
  4. Salva

4. Crea una Fattura (7 min)

  1. Fatturazione → Vendite (dalla barra laterale)
  2. Crea
  3. Scegli cliente dalla lista
  4. Data e scadenza (di default oggi + 30 gg)
  5. Aggiungi una linea:
    • Descrizione: "Consulenza"
    • Quantità: 1
    • Prezzo: 100
    • IVA: 22%
  6. Vedi totale calcolato automaticamente
  7. Salva (lo stato diventa Bozza)

5. Configura OpenAPI (5 min)

Solo se vuoi inviare subito, altrimenti skip.

  1. Registrati su openapi.it (2 min)
  2. Compra credito (minimo €5)
  3. Copia Username API e Password API
  4. In Fatturino: Configurazione → Impostazioni FE
  5. Incolla credenziali
  6. Salva

6. Invia Fattura (3 min)

  1. Vai su Fatturazione → Vendite, clicca sulla fattura
  2. Clicca Invia a SDI
  3. Scegli se Modalità Sandbox (test) o Produzione (invio reale)
  4. Conferma

Fatturino genera XML, lo valida e lo invia via OpenAPI.

Tracciamento dello Stato

Apri la fattura: vedrai lo stato aggiornato:

  • Bozza → Fattura creata, non ancora inviata
  • Inviata → Accettata da OpenAPI/SDI
  • Consegnata → Il cliente ha ricevuto la fattura

Boom! 🎉

Hai appena inviato una fattura conforme al SDI.

Prossimi Passi