Factum · Pyragogy

Parsing che capisce.
Contabilità che non rompe.

Factum API per dare intelligenza documentale ai tuoi agenti AI. factum-fic per liberare i forfettari dalla burocrazia delle fatture estere.

AFactum API

AI Document Parser

FatturaPA · PDF · F24 · fatture SaaS

41 ms
fast-path
POST /v1/parsebash
curl -X POST 300 underline decoration-factum-500/30">https://factum.pyragogy.org/v1/parse \
  -H "X-API-Key: ${FACTUM_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Fattura n. INV-001 del 15/08/2026",
    "doc_type": "fattura"
  }'
httpx asyncpython
import httpx

async def parse_invoice(text: str, api_key: str):
    async with httpx.AsyncClient() as client:
        resp = await client.post(
            "300 underline decoration-factum-500/30">https://factum.pyragogy.org/v1/parse",
            headers={"X-API-Key": api_key},
            json={"text": text, "doc_type": "fattura"},
        )
        data = resp.json()
    return data["result"]  # supplier, importo, IVA, data, ...
Envelope v2json
{
  "status": "done",
  "document_type": "fattura",
  "confidence": 0.97,
  "result": {
    "supplier_name": "Hetzner GmbH",
    "supplier_vat": "DE812345678",
    "supplier_country": "DE",
    "invoice_number": "INV-2026-007",
    "invoice_date": "15/08/2026",
    "total": 49.79,
    "currency": "EUR",
    "raw": {
      "amount_net": 41,
      "amount_vat": 8.79,
      "amount_gross": 49.79
    }
  }
}
Ffactum-fic

CLI Contabile Forfettari

Open Source · AGPL-3.0 · 208 test

€0
10 PDF/mese
$ factum-fic --helpbash
$ factum-fic --help

🇮🇹  Factum-FIC — Registrazione automatica fatture su Fatture in Cloud

Alias italiani: configura=setup, stato=status,
elabora=sync, auto=watch, ricarica=buy-credits

Comandi:
  setup            Configurazione guidata (una volta sola)
  sync  [elabora]  Elabora tutti i file in da_elaborare/
  watch [auto]     Resta in esecuzione, elabora in automatico
  status [stato]   Dashboard operativo
  ricarica         Acquista 100 PDF extra (€9,90)
  riprova-autofatture  Recupera autofatture fallite
  check            Verifica connettività API
Quickstartbash
# 1. Installa (una volta)
$ pipx install git+300 underline decoration-factum-500/30">https://github.com/FTG-003/factum-fic

# 2. Configura (una volta)
$ factum-fic setup

# 3. Lascia le fatture in da_elaborare/
$ cp ~/Downloads/fattura_*.pdf ./da_elaborare/

# 4. Un comando e hai finito
$ factum-fic elabora

✅ Spese registrate su Fatture in Cloud
✅ Autofatture TD17/TD18/TD19 in bozza pronte
FatturaPA XMLxml
<?xml version="1.0" encoding="UTF-8"?>
<p:FatturaElettronica ...>
  <FatturaElettronicaHeader>
    <CedentePrestatore>
      <DatiAnagrafici>
        <IdFiscaleIVA>
          <IdPaese>DE</IdPaese>
          <IdCodice>812345678</IdCodice>
        </IdFiscaleIVA>
      </DatiAnagrafici>
    </CedentePrestatore>
  </FatturaElettronicaHeader>
</p:FatturaElettronica>

# Factum lo parsa in 41ms — zero LLM, zero costo, 100% locale
GitHub →
/workflow

Dal file al risultato

Due pipeline indipendenti. Una logica comune. Scegli il flusso che ti interessa.

⚡ Fast-path XML: Detect → Envelope. 41 ms · €0 · confidence 1.0

1classifica documento

Detect

Sniff MIME + SHA-256 dedup

2≤ 12s

Extract

PyMuPDF · 12s timeout · fail-open

3🔒 ZDR

PII Sidecar

Rizzo 0.3B · pseudonimizza prima dell'LLM

4€0 provider

LLM Cascade

DeepSeek Flash→Claude Sonnet · cost guard

597%+

Quality Gate

Confidence score · HITL triage soglia

6JSON

Envelope

v2 strutturato · schema_version · payload

41 ms
Fast-path P50
fastpath.py
342+
Test API
README.md
0,16 ms
In-process P50
main.py
97%+
Confidence avg
envelope_v2
$ factum-fic setup → configura → elabora → fatto
📥1

Drop

Trascini PDF/XML in da_elaborare/

SHA-256 dedup · watchdog
🔍2

Extract

Testo estratto in locale (pypdf)

XML: 100% locale · PDF: solo testo
⚙️3

Parse

Factum Parse API analizza

Fast-path XML 41ms · LLM per PDF
🗺️4

Map

Mapper fiscale · conversione valuta

Categorie FIC · reverse charge
☁️5

FIC

Registrazione su Fatture in Cloud

Create expense + PDF allegato
📄6

SDI

Autofattura in bozza (se estera)

TD17 · TD18 · TD19 automatico
factum-fic syncbash

$ factum-fic sync --dir ./da_elaborare/

INV-001.pdf → estratto (2.3s)

INV-002-US.pdf → mappato USD→EUR (1.18)

Hetzner-2026-08.xml → fast-path (41ms)

───

3 spese registrate su Fatture in Cloud

📄 1 autofattura TD18 in bozza (Hetzner GmbH, DE)

File spostati in archiviate/2026/08/

Comandi (tutti in 🇮🇹)

factum-fic configura
Configurazione guidata
alias: setup
factum-fic elabora
Elabora tutti i file
alias: sync
factum-fic auto
Elaborazione automatica
alias: watch
factum-fic stato
Dashboard operativo
alias: status
factum-fic ricarica
Acquista 100 PDF
alias: buy-credits
factum-fic riprova-autofatture
Recupera fallite
alias: retry
🔒

Zero Data Retention

Il mapping PII vive in RAM per-request. Droppato subito dopo la risposta. Mai sul DB. Direttiva A1: nessun risultato LLM persistito.

🧠

Sidecar Rizzo 0.3B

Pseudonimizza nomi, P.IVA, indirizzi prima che i dati tocchino DeepSeek o Claude. Solo placeholder [PERSONA_001].

🛡️

Fail-closed

Sidecar giù → 503. Senza auth → 401. Immagini bloccate a 422.

📁 factum-fic: XML elaborato 100% in locale. PDF invia solo testo via HTTPS. Mai memorizzato. Credenziali in .env.

503
Sidecar down
422
Immagine
401
No auth
/pricing

Paghi solo quello che usi

Niente abbonamenti nascosti. Niente sales call. Prezzi reali, uguali per tutti.

A

Factum API

AI Document Parser
Inizia ora

Free

Per provare

€0/mese

Rate-limiting generoso per test e integrazione.

  • 60 richieste/minuto
  • Fast-path XML (41 ms)
  • FatturaPA, PDF, F24, generico
  • Envelope v2 con confidence score
  • Documentazione OpenAPI
Ottieni chiave gratuita
Più scelto

Pro

Per produzione

€29/mese

Uso professionale continuativo. Fatturabile.

  • 300 richieste/minuto
  • Cache documenti 30 giorni
  • Priorità coda LLM
  • Webhook callback (async mode)
  • Supporto email
Attiva Pro

Custom

Per volumi alti

Da €99/mese

SLA dedicato, tier personalizzato, fatturazione enterprise.

  • Rate limit personalizzato
  • LLM cascade dedicata
  • S3 bucket privato (archiviazione documenti)
  • Sentry monitoraggio
  • Contratto e fattura
Contattaci
F

factum-fic

CLI Contabile Forfettari
Sempre gratis

Gratuito

Sempre gratis

€0

Per il 90% dei forfettari italiani.

  • 10 fatture PDF estere / mese
  • XML FatturaPA: illimitate e gratis
  • Elaborazione 100% locale (XML)
  • Coda persistente SQLite
  • Autofatture SDI automatiche
Installa CLI
Più venduto

Crediti Extra

Una tantum, mai scadono

€9,90per 100 PDF

Per chi supera le 10 fatture estere al mese.

  • 100 PDF aggiuntivi
  • Nessuna scadenza
  • Nessun abbonamento
  • Attivazione immediata via Lemon Squeezy
  • Accumulabili mese su mese
Acquista crediti

Open Source

AGPL-3.0

€0contribuisci

Il codice è pubblico. Ognuno può controllare, modificare, migliorare.

  • Codice sorgente pubblico su GitHub
  • 208 test, CI verde
  • Contribuzioni accolte
  • Security policy attiva
  • No vendor lock-in
GitHub →

💡 XML FatturaPA: €0 — illimitate· Elaborazione 100% sul tuo computer

Hai una Partita IVA? Inseriscila nel checkout Lemon Squeezy per ricevere la fattura elettronica.

Provare costa zero secondi

Chiave API gratuita subito. CLI installata in 30 secondi. Se non funziona, non hai perso niente. Se funziona, ti cambia la giornata.

Ottieni API Key gratuita

AGPL-3.0 ·GitHub·Documentazione