Navigazione Docs

Quick Start (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. Settings (⚙️ top-right)
  2. Company tab
  3. Riempi:
    • Ragione sociale: Es. "Mario Rossi Srl"
    • P.IVA: Es. "04826950166"
    • Indirizzo completo
    • Email
  4. Save

3. Crea un Cliente (3 min)

  1. Customers (dalla navbar)
  2. Add Customer
  3. Riempi:
    • Nome azienda
    • P.IVA / Codice Fiscale
    • Indirizzo
    • Email
  4. Save

4. Crea una Fattura (7 min)

  1. Invoices
  2. New Invoice
  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. Save (status diventa Draft)

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: Settings → Integrations → OpenAPI
  5. Incolla credenziali
  6. Save

6. Invia Fattura (3 min)

  1. Vai su Invoices, clicca sulla fattura
  2. Clicca Send to SDI
  3. Scegli se Sandbox Mode (test) o Production (vero)
  4. Conferma

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

Status Tracciamento

Apri la fattura: vedrai status aggiornato:

  • Pending → In elaborazione
  • Sent → Accettato da OpenAPI/SDI
  • Delivered → Cliente ha ricevuto

Boom! 🎉

Hai appena inviato una fattura conforme al SDI.

Prossimi Passi