PHPackages                             onesto-it/laravel-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. onesto-it/laravel-sdk

ActiveLibrary[API Development](/categories/api)

onesto-it/laravel-sdk
=====================

SDK Laravel per integrare le API di Onesto.it (fatturazione elettronica, SDI, F24).

v1.1.1(2w ago)011↓66.7%1MITPHPPHP >=8.1

Since May 20Pushed 2w agoCompare

[ Source](https://github.com/Onesto-it/laravel-sdk)[ Packagist](https://packagist.org/packages/onesto-it/laravel-sdk)[ Docs](https://onesto.it)[ RSS](/packages/onesto-it-laravel-sdk/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (5)Versions (4)Used By (1)

Onesto Laravel SDK
==================

[](#onesto-laravel-sdk)

[![Latest Version on Packagist](https://camo.githubusercontent.com/c067a841f260443931948ccc6232bb5d7af6a389c8107f650408910f766d35a7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6f6e6573746f2d69742f6c61726176656c2d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/onesto-it/laravel-sdk)[![Total Downloads](https://camo.githubusercontent.com/cd7de06e66cdeead1920ecb6afecbc6dddcc0fba938411ea463d2c4739c91e6b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f6e6573746f2d69742f6c61726176656c2d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/onesto-it/laravel-sdk)[![License](https://camo.githubusercontent.com/c0097549473993c5a435d5a8654c72f63275069cd6ae765d07b1c4628ba0e4bc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6f6e6573746f2d69742f6c61726176656c2d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/onesto-it/laravel-sdk)

SDK Laravel ufficiale per integrare le API di [Onesto.it](https://onesto.it) — fatturazione elettronica, invio SDI, gestione clienti e movimenti.

---

Requisiti
---------

[](#requisiti)

- PHP **8.1+**
- Laravel **9, 10, 11, 12**

---

Installazione
-------------

[](#installazione)

```
composer require onesto-it/laravel-sdk
```

Il service provider e l'alias `Onesto` vengono registrati automaticamente da Laravel package discovery.

(Opzionale) pubblica il file di configurazione:

```
php artisan vendor:publish --tag=onesto-config
```

---

Configurazione
--------------

[](#configurazione)

Nel file `.env`:

```
ONESTO_TOKEN=la_tua_api_key
# opzionale, default https://api.onesto.it
ONESTO_URL=https://api.onesto.it
# opzionale, default 30s
ONESTO_TIMEOUT=30
```

Il token si genera dal pannello Onesto → **Impostazioni → API**.

---

Utilizzo
--------

[](#utilizzo)

### Creare una fattura manuale

[](#creare-una-fattura-manuale)

```
use Onesto;

$result = Onesto::createInvoiceManually([
    'cliente'  => [
        'ragione_sociale' => 'Acme SRL',
        'piva'            => '01234567890',
        'indirizzo'       => 'Via Roma 1',
        'cap'             => '20121',
        'citta'           => 'Milano',
        'provincia'       => 'MI',
        'nazione'         => 'IT',
        'pec'             => 'acme@pec.it',
    ],
    'articoli' => [
        ['descrizione' => 'Consulenza', 'quantita' => 1, 'prezzo' => 1000, 'iva' => 22],
    ],
    'scadenze' => [
        ['data' => '2026-06-30', 'importo' => 1220],
    ],
    'numerazione'      => 'Standard',
    'issue_date'       => '2026-05-20',
    'tipo_documento'   => 'TD01',
    'metodo_pagamento' => 'Bonifico',
    'invia_sdi'        => true,
]);
```

### Creare una fattura da Partita IVA

[](#creare-una-fattura-da-partita-iva)

I dati anagrafici vengono recuperati automaticamente da Onesto:

```
Onesto::createInvoiceFromPIVA([
    'piva'             => '01234567890',
    'numerazione'      => 'Standard',
    'issue_date'       => '2026-05-20',
    'tipo_documento'   => 'TD01',
    'metodo_pagamento' => 'Bonifico',
    'articoli'         => [...],
    'scadenze'         => [...],
    'invia_sdi'        => true,
]);
```

### Riferimenti Pubblica Amministrazione (CIG, CUP, ordine, determina…)

[](#riferimenti-pubblica-amministrazione-cig-cup-ordine-determina)

Per progetti finanziati, appalti pubblici o PNRR puoi passare **due oggetti opzionali**:

- **`pa`** → solo i codici PA (`cig`, `cup`, `cups`).
- **`ordine`** → riferimenti all'ordine d'acquisto (`numero`, `data`, `impegno`, `determina`, `codice_commessa`). Validi anche fuori dalla PA (es. B2B con ordine d'acquisto interno).

Tutti i campi sono **opzionali**; quelli passati vengono inseriti nei `` della FatturaPA al momento dell'invio SDI.

```
Onesto::createInvoiceManually([
    // ... cliente, articoli, scadenze come sopra ...

    'pa' => [
        'cig'  => 'ZF3392A8B7',          // Codice Identificativo Gara
        'cups' => [                       // Codici Unico Progetto (più di uno OK)
            'J53D23000170006',
            'K12C24000050001',
        ],
    ],

    'ordine' => [
        'numero'          => 'ORD-2025-001',
        'data'            => '2025-04-15',
        'impegno'         => 'IMP-123',          // Impegno di spesa
        'determina'       => 'DET-456',          // Determina / commessa
        'codice_commessa' => 'COMM-789',         // Codice commessa / convenzione
    ],
]);
```

Funziona allo stesso modo anche con `Onesto::createInvoiceFromPIVA([...])`.

Vincoli sui campi:

CampoMax charsNote`pa.cig`15Alfanumerico`pa.cup`15Singolo. Per più CUP usa `pa.cups`.`pa.cups[*]`15Lista. Prevale su `pa.cup` se entrambi presenti.`ordine.numero`20Numero ordine`ordine.data`—Formato `YYYY-MM-DD``ordine.impegno`100Impegno di spesa`ordine.determina`100Determina / commessa`ordine.codice_commessa`100Codice commessa / convenzione### Senza Facade (dependency injection)

[](#senza-facade-dependency-injection)

```
use OnestoIt\Sdk\Onesto;

class FattureController
{
    public function __construct(private Onesto $onesto) {}

    public function store()
    {
        return $this->onesto->createInvoiceManually([...]);
    }
}
```

Per la struttura completa dei payload e tutte le risposte, vedi la [documentazione API Onesto](https://api.onesto.it).

---

Licenza
-------

[](#licenza)

MIT © True Solutions S.r.l.

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance96

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

20d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/45979126?v=4)[Alberto Pisaroni](/maintainers/albertopisaroni)[@albertopisaroni](https://github.com/albertopisaroni)

---

Top Contributors

[![albertopisaroni](https://avatars.githubusercontent.com/u/45979126?v=4)](https://github.com/albertopisaroni "albertopisaroni (1 commits)")

---

Tags

laravelsdkfattura elettronicaitaliasdifatturazioneonestoonesto.it

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/onesto-it-laravel-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/onesto-it-laravel-sdk/health.svg)](https://phpackages.com/packages/onesto-it-laravel-sdk)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3325.1M337](/packages/psalm-plugin-laravel)[defstudio/telegraph

A laravel facade to interact with Telegram Bots

815320.5k3](/packages/defstudio-telegraph)[simplestats-io/laravel-client

Analytics for Laravel. Track visitors, registrations, and payments. Discover which channels actually drive revenue, not just traffic. Server-side, GDPR compliant, ad-blocker proof.

5019.3k](/packages/simplestats-io-laravel-client)[resend/resend-laravel

Resend for Laravel

1212.2M8](/packages/resend-resend-laravel)[jasara/php-amzn-selling-partner-api

A fluent interface for Amazon's Selling Partner API in PHP

1348.1k1](/packages/jasara-php-amzn-selling-partner-api)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)