🔌 Integrazioni

Si collega a tutto quello
che già usi.

Banche, e-commerce, marketplace, sistemi di pagamento, altri gestionali. FattureNet importa i dati nei formati standard e offre API REST per chi vuole automatizzare. Niente isole, tutto connesso.

CSVCBIMT940OFXXML SDIXLSXPDFJSONREST API
Cosa colleghi

Un ecosistema, non un'isola.

🏦

Banche

Importi gli estratti conto in CSV, CBI, MT940, OFX o PDF. L'AI li legge e riconcilia con le fatture.

🛒

E-commerce e pagamenti

Incassi da Stripe, PayPal e marketplace riconciliati automaticamente, con gestione OSS per le vendite UE.

📡

SDI / Agenzia Entrate

Canale accreditato per invio e ricezione fatture, webhook automatici, conservazione via Cassetto Fiscale.

🔄

Altri gestionali

Migri da TS Digital, Profis, Zucchetti, Aruba: import XML massivo, anagrafiche CSV/XLSX, cespiti.

⚙️

API REST

Per gli sviluppatori: API documentate per integrare FattureNet con i tuoi sistemi e automatizzare i flussi.

📧

Email e SMTP

Invio fatture e solleciti col tuo dominio, con deliverability curata (SPF/DKIM/DMARC).

Banche italiane

I principali istituti bancari italiani.

Tutte le banche italiane producono estratti conto compatibili con almeno uno dei formati standard supportati. Ecco quelle per cui abbiamo testato e ottimizzato il flusso d'import.

IS
Intesa SanpaoloCSV · CBI · OFX
UC
UniCreditCSV · MT940
BS
Banca SellaCSV · OFX
BP
BPER BancaCSV · CBI
FN
FinecoCSV · OFX
BB
Banco BPMCSV · CBI
CA
Crédit AgricoleCSV · MT940
MD
MediolanumCSV · PDF
BPS
Banca Popolare di SondrioCSV · CBI
MPS
Monte dei PaschiCSV · MT940
PI
Poste Italiane / BancoPostaCSV · PDF
ING
ING ItaliaCSV · OFX
CR
Crédit Agricole FriulAdriaCSV · CBI
BR
Banca di RomagnaCSV
RV
Revolut BusinessCSV · OFX
N26
N26 BusinessCSV · PDF

Non vedi la tua banca? Il formato CSV standard è leggibile da qualsiasi istituto. Chiedici.

E-commerce

Le piattaforme e-commerce più usate.

Sincronizzazione automatica di ordini, clienti e prodotti. Ogni vendita diventa una fattura corretta, con la gestione OSS per le vendite UE B2C oltre soglia €10.000 annui.

SH
Shopifyapp ufficiale
WC
WooCommerceplugin WP
PS
PrestaShopmodulo
MG
Magento / Adobe Commerceextension
BC
BigCommerceapp
SQ
Squarespace Commercevia Zapier
WX
Wix Storesvia API
ST
Storedenconnettore IT
Marketplace

I marketplace dove vendi.

Per i marketplace, FattureNet importa gli ordini, gestisce le commissioni della piattaforma come costi separati, distingue B2C nazionale, B2C UE (OSS) e B2C extra-UE.

AZ
Amazon SellerAPI SP-API
EB
eBayTrading API
ET
EtsyAPI v3
MM
ManoManoseller portal
SU
Subito.it / Proexport CSV
VN
Vinted ProCSV ordini
CR
Carousellvia Zapier
EP
ePrice MarketplaceCSV
API REST

API moderne, ben documentate.

Endpoint REST, autenticazione Bearer token, rate limit configurabile, sandbox per test. Documentazione OpenAPI 3.1 completa, con esempi in più linguaggi.

Esempio: registrare una fattura via API

# Crea una nuova fattura emessa POST https://api.fatturenet.it/v1/fatture Authorization: Bearer fnt_live_a1b2c3d4e5f6... Content-Type: application/json { "cliente_id": 12847, "tipo_documento": "TD01", "data": "2026-05-28", "valuta": "EUR", "righe": [ { "descrizione": "Consulenza SEO marzo", "quantita": 1, "prezzo_unitario": 1500.00, "aliquota_iva": 22 } ], "invio_sdi": true } # Risposta — 201 Created { "id": 98472, "numero": "2026/00128", "stato_sdi": "in_invio", "importo_totale": 1830.00, "url_pdf": "https://api.fatturenet.it/v1/fatture/98472/pdf" }

Webhook firmati HMAC-SHA256

# Ricevi notifica quando il SDI consegna o scarta una fattura POST https://tuosito.it/webhook/fatturenet X-FattureNet-Event: fattura.consegnata X-FattureNet-Signature: sha256=8f3b... X-FattureNet-Timestamp: 1748448000 { "event": "fattura.consegnata", "data": { "fattura_id": 98472, "numero": "2026/00128", "consegnata_il": "2026-05-28T14:22:18Z", "identificativo_sdi": "IT00128_p3X4Z" } } # Verifica della firma (esempio PHP) $signature = hash_hmac('sha256', $timestamp.'.'.$payload, $secret); if (!hash_equals($signature, $received)) throw new Exception('invalid signature');
SDK ufficiali

Librerie per i linguaggi più usati.

SDK open-source pubblicati su GitHub, installabili dai package manager nativi. Tipizzati, ben documentati, con esempi pronti.

PHP
composer require fatturenet/sdk-php
PHP 8.1+ · v2.4.0
Node.js
npm i @fatturenet/sdk
Node 18+ · v1.8.2
Python
pip install fatturenet
Python 3.10+ · v1.5.1
Go
go get github.com/fatturenet/sdk-go
Go 1.21+ · v0.9.4
Ruby
gem install fatturenet
Ruby 3.0+ · v1.2.0
.NET
dotnet add FattureNet.Sdk
.NET 7+ · v1.1.3
Domande frequenti

FAQ tecniche.

Le API sono incluse in tutti i piani o solo nei superiori?

L'accesso alle API REST è incluso dai piani Business in su, con rate limit di 60 richieste/minuto per token e burst fino a 200. I piani Enterprise hanno rate limit più alti (600/min sostenuto) e endpoint dedicati. Il sandbox per i test è disponibile per tutti gli account, anche in trial.

Come autenticarsi all'API: OAuth, API key o JWT?

Tre opzioni: (1) API key statica (fnt_live_* o fnt_test_*) — la più semplice, per integrazioni server-to-server; (2) OAuth 2.0 con flow Authorization Code — per app di terzi che accedono ai dati di clienti finali; (3) JWT firmati con chiave asimmetrica RS256 — per integrazioni enterprise dove non si vuole gestire un secret condiviso.

Come sono firmati i webhook? Devo verificare la firma?

Sì, devi verificare: i webhook sono firmati HMAC-SHA256 col secret del tuo endpoint. La firma viene calcolata su timestamp.payload_body e inviata nell'header X-FattureNet-Signature: sha256=.... Verifica anche che il timestamp non sia più vecchio di 5 minuti (anti-replay). Esempi in PHP, Node, Python e Go nella documentazione.

Quali eventi posso ricevere via webhook?

Oltre 30 eventi disponibili. I principali: fattura.creata, fattura.inviata_sdi, fattura.consegnata, fattura.scartata, fattura.pagata, fattura.sollecitata, preventivo.accettato, cliente.creato, banca.movimento_riconciliato, scadenza.in_scadenza. Sottoscrivi solo quelli che ti servono per ridurre il traffico.

Il rate limit è per account, per utente o per API key?

Per API key. Puoi generare più chiavi nello stesso account e distribuire il carico tra esse (es: una per il sito, una per il sistema di magazzino, una per gli script di reporting). Le risposte HTTP includono header X-RateLimit-Remaining e X-RateLimit-Reset per gestire il backoff. Errore 429 Too Many Requests in caso di superamento.

Esiste un ambiente sandbox per i test?

Sì, sandbox completo raggiungibile a https://sandbox.api.fatturenet.it. Le API key di test (fnt_test_*) lavorano sul sandbox; non producono fatture reali, non inviano nulla al SDI vero (usano l'ambiente di test dell'Agenzia delle Entrate). Tutti i webhook funzionano e puoi simulare eventi specifici. Dati ripristinabili a stato pulito su richiesta.

Connetti FattureNet ai tuoi strumenti.

7 giorni gratis, nessuna carta richiesta.