Download the PHP package davidakis/fattura24-sdk without Composer
On this page you can find all versions of the php package davidakis/fattura24-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download davidakis/fattura24-sdk
More information about davidakis/fattura24-sdk
Files in davidakis/fattura24-sdk
Package fattura24-sdk
Short Description PHP SDK for Fattura24.com API - Italian electronic invoicing
License MIT
Informations about the package fattura24-sdk
Fattura24 PHP SDK
PHP SDK tipizzato e testato per l'integrazione con le API di Fattura24.
Progettato per applicazioni personalizzate, plugin WordPress, moduli e-commerce e sistemi gestionali - senza accoppiamento a framework o piattaforme specifiche.
v2.1 Miglioramenti
InvoiceBuilder: interfaccia elastica opzionale per codice più conciso Documentazione: aggiunta esempi di uso
v2.0 Cambiamenti di rottura
v2.0 è una riscrittura completa con oggetti di risposta tipizzati
Stai aggiornando da v1.x? Leggi UPGRADE.md
Caratteristiche
✅ PHP 8.1+ con proprietà nominate ✅ Oggetti di risposta tipizzati
✅ Validazione automatica dati fiscali italiani (CF, P.IVA, PEC, SDI)
✅ Generazione XML automatica conforme alle specifiche Fattura24
✅ Framework-agnostic — nessun accoppiamento a WordPress, Laravel, Symfony, etc.
✅ 100% copertura di test con PHPUnit
✅ PHPStan Level 6 — analisi staticacompleta
Requisiti
| Minimo | |
|---|---|
| PHP | 8.1 |
| ext-curl | qualsiasi |
| ext-dom | qualsiasi |
| ext-simplexml | qualsiasi |
| account Fattura24 on chiave API |
Installazione
Con Composer (consigliato)
Senza Composer
- Scarica l'ultima versione dal repository GitHub
- Estrai la cartella
src/all'interno del tuo progetto - Includi un semplice autoloader PSR-4 oppure utilizza il tuo autoloader esistente
Esempio di autoloader minimale:
Assicurati che le estensioni richieste (ext-curl, ext-dom, ext-simplexml) siano abilitate nel tuo php.ini.
🚀 Guida rapida
Uso di InvoiceBuilder
Documentazione
- Guida Upgrade v1→v2
- Changelog Completo
Esempi
Uso: copia config.php.example in config.php e inserisci la tua chiave API di Fattura24; per eseguire gli esempi apri una finestra di terminale e vai nella cartella examples. Poi digita (esempio):
php 01-basic-invoice.php
- 01-basic-invoice.php - Fattura semplice
- 02-invoice-exempt-vat.php - Fattura con alquota 0% e codice natura
- 03-invoice-multiple-vat-rates.php - Fattura con diverse aliquote IVA
- 04-invoice-with-discount.php - Fattura con sconto
- 05-download-pdf.php - Gestione del file PDF
- 06-get-templates.php - Modelli di documento e numeratori
- 07-bulk-invoicing.php - Creazione massiva
- 08-error-handling.php - Gestione degli errori
Caratteristiche
Oggetti di risposta tipizzati
Validazione Automatica (solo Italia)
Campi validati (solo per customerCountry = 'IT'):
customerFiscalCode— 16 caratteri alfanumericicustomerVatCode— 11 cifre numerichefeCustomerPec— formato email validofeDestinationCode— 6 o 7 caratteri alfanumerici
Sanitizzazione automatica:
Gestione PDF flessibile
Salva su file:
Trasmissione al browser:
Link temporaneo (framework-agnostic):
Parametri nominati(PHP 8.1)
Interfaccia elastica
Esempi Completi
Fattura con IVA 0% (esente)
Fattura con sconto
Fattura con prodotti multipli e IVA miste
Test connessione
Aggiornamento da v1.x
Cambiamento di rottura: risposta tipizzata
v1.x (array):
v2.0 (oggetti tipizzati):
Migrazione
Guida completa: UPGRADE.md
Test manuale
La SDK include uno script per testare con API reale di Fattura24.
Setup
Cosa testa
Lo script esegue test end-to-end:
- ✅ Verifica API key
- ✅ Crea fattura di test (REALE!)
- ✅ Testa validazione dati
- ✅ Download PDF
- ✅ Lista modelli
- ✅ Lista numeratori
- ✅ Lista piano dei conti
Importante
- Lo script crea fatture REALI nel tuo account Fattura24
- Ricordati di cancellare le fatture di test dal cruscotto di Fattura24
- Il file
test-manual.phpè nel.gitignore(non verrà committato)
🧪 Sviluppo
🎯 Perché PHP 8.1+?
Questa SDK sfrutta le moderne caratteristiche di PHP per una migliore developer experience:
| Feature | Beneficio |
|---|---|
| Parametri nominati | Codice auto-documentante, niente errori di posizione |
| Proprietà in sola lettura | Dati immutabili, codice più sicuro |
| Enums | Costanti sicure (DocumentType, etc.) |
💖 Supporta il progetto
Se questa SDK ti fa risparmiare tempo e semplifica il tuo lavoro:
Il tuo supporto aiuta a mantenere e migliorare questo progetto. Grazie! ❤️
Licenza
MIT License. Vedi LICENSE per dettagli.
Credits
- Fattura24 per le API
- Sviluppatore: Simply IT
- Contributori: Tutti i contributors
Supporto
Avviso
Non affiliato a Fattura24.
Questa è una SDK mantenuta dalla community per le API di Fattura24.
Per supporto ufficiale Fattura24, visita www.fattura24.com
Maintenuto da Simply IT
L'informatica, semplicemente
All versions of fattura24-sdk with dependencies
ext-curl Version *
ext-simplexml Version *
