PHPackages                             offline-agency/laravel-fatture-in-cloud-v2 - 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. offline-agency/laravel-fatture-in-cloud-v2

ActiveLibrary[API Development](/categories/api)

offline-agency/laravel-fatture-in-cloud-v2
==========================================

A wrapper plugin with Fatture in Cloud Api V2 written in Laravel PHP

3.0.1(3mo ago)33.0k↓44.3%8[12 PRs](https://github.com/offline-agency/laravel-fatture-in-cloud-v2/pulls)MITPHPPHP ^8.4CI passing

Since Jun 8Pushed 1w ago1 watchersCompare

[ Source](https://github.com/offline-agency/laravel-fatture-in-cloud-v2)[ Packagist](https://packagist.org/packages/offline-agency/laravel-fatture-in-cloud-v2)[ Docs](https://github.com/offline-agency/laravel-fatture-in-cloud-v2)[ GitHub Sponsors](https://github.com/offline-agency)[ RSS](/packages/offline-agency-laravel-fatture-in-cloud-v2/feed)WikiDiscussions main Synced yesterday

READMEChangelog (10)Dependencies (29)Versions (27)Used By (0)

Laravel Fatture in Cloud v2
===========================

[](#laravel-fatture-in-cloud-v2)

[![Latest Stable Version](https://camo.githubusercontent.com/229ba1a23ae024c42ab976396b9409bd6319393f94192a7dba1fadf02740e808/68747470733a2f2f706f7365722e707567782e6f72672f6f66666c696e652d6167656e63792f6c61726176656c2d666174747572652d696e2d636c6f75642d76322f762f737461626c65)](https://packagist.org/packages/offline-agency/laravel-fatture-in-cloud-v2)[![MIT Licensed](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![run-tests](https://github.com/offline-agency/laravel-fatture-in-cloud-v2/actions/workflows/main.yml/badge.svg)](https://github.com/offline-agency/laravel-fatture-in-cloud-v2/actions/workflows/main.yml)[![codecov](https://camo.githubusercontent.com/53842dbd3233ab038fe5649c1ac8f94bcaa02a30996facca81cf525b604b5368/68747470733a2f2f636f6465636f762e696f2f67682f6f66666c696e652d6167656e63792f6c61726176656c2d666174747572652d696e2d636c6f75642d76322f6272616e63682f6d61737465722f67726170682f62616467652e7376673f746f6b656e3d30324e50554276543969)](https://codecov.io/gh/offline-agency/laravel-fatture-in-cloud-v2)[![Laravel Pint](https://camo.githubusercontent.com/5d5dff25d50a7b3fa81d70d1154fa8f76c62388418ce0100fee6a31535c603a0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f64652532307374796c652d70696e742d6f72616e6765)](https://github.com/laravel/pint)[![PHPStan Level 6](https://camo.githubusercontent.com/bbb4b88ceed026f420c1d76bc64e1ce076ed7382a9f5bac1cd59d85d807e7af4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c253230362d627269676874677265656e)](https://phpstan.org/)[![Total Downloads](https://camo.githubusercontent.com/6d7b0b62873c3d987cb910b6cb4c5a2a9cb8d20571ce3b0a347163e41c1e56a6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f66666c696e652d6167656e63792f6c61726176656c2d666174747572652d696e2d636c6f75642d76322e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/offline-agency/laravel-fatture-in-cloud-v2)[![Laravel Fatture in Cloud v2](https://camo.githubusercontent.com/4a2f4e6b15e42487b5fea554eb0aa02965614acb637c7334327409ce565a7c75/68747470733a2f2f62616e6e6572732e6265796f6e64636f2e64652f4c61726176656c25323046617474757265253230696e253230436c6f756425323076322e706e673f7468656d653d6461726b267061636b6167654d616e616765723d636f6d706f7365722b72657175697265267061636b6167654e616d653d6f66666c696e652d6167656e63792532466c61726176656c2d666174747572652d696e2d636c6f75642d7632267061747465726e3d617574756d6e267374796c653d7374796c655f31266465736372697074696f6e3d412b73696d706c652b6c61726176656c2b696e746567726174696f6e2b776974682b466174747572652b696e2b436c6f75642b415049732b7632266d643d312673686f7757617465726d61726b3d3026666f6e7453697a653d313030707826696d616765733d63757272656e63792d6575726f267769647468733d323030)](https://camo.githubusercontent.com/4a2f4e6b15e42487b5fea554eb0aa02965614acb637c7334327409ce565a7c75/68747470733a2f2f62616e6e6572732e6265796f6e64636f2e64652f4c61726176656c25323046617474757265253230696e253230436c6f756425323076322e706e673f7468656d653d6461726b267061636b6167654d616e616765723d636f6d706f7365722b72657175697265267061636b6167654e616d653d6f66666c696e652d6167656e63792532466c61726176656c2d666174747572652d696e2d636c6f75642d7632267061747465726e3d617574756d6e267374796c653d7374796c655f31266465736372697074696f6e3d412b73696d706c652b6c61726176656c2b696e746567726174696f6e2b776974682b466174747572652b696e2b436c6f75642b415049732b7632266d643d312673686f7757617465726d61726b3d3026666f6e7453697a653d313030707826696d616765733d63757272656e63792d6575726f267769647468733d323030)

🔙 This is the documentation for the API v2. You can find the package for the API v1 [here](https://docs.offlineagency.com/laravel-fatture-in-cloud/#laravel-fatture-in-cloud).

### Warning for integrators

[](#warning-for-integrators)

- **Keep your copy up to date:** Check the [official laravel-fatture-in-cloud-v2](https://github.com/offline-agency/laravel-fatture-in-cloud-v2) package and update your local dependency (e.g. run `composer update offline-agency/laravel-fatture-in-cloud-v2` or pull the latest from the repository).
- **Response variables are camelCase:** Entity properties use **camelCase** (e.g. `amountGross`, `amountNet`, `amountVat`), not snake\_case (`amount_gross`, `amount_net`, `amount_vat`). If you have existing code that reads response data, update it to use the new property names. Use the entity classes in this package as the reference—for example, [`IssuedDocument`](src/Entities/IssuedDocument/IssuedDocument.php) for issued documents. Examples: `amount_gross` → `amountGross`, `amount_net` → `amountNet`, `created_at` → `createdAt`.
- **Config:** Check the package config [`config/fatture-in-cloud-v2.php`](config/fatture-in-cloud-v2.php) and update your project’s config to match, especially **`baseUrl`**. Use the root API URL only (no extra path segments).

Requirements
------------

[](#requirements)

- PHP ^8.4 (includes 8.5)
- Laravel ^11.0|^12.0|^13.0

PHPLaravel 11Laravel 12Laravel 138.4✅✅✅8.5✅✅✅### API Granularization (Breaking Changes)

[](#api-granularization-breaking-changes)

The monolithic `Settings` and `Setting` classes have been split into granular resources to improve maintainability and strictly follow the Single Responsibility Principle:

- `Settings` -> Split into `VatType`, `PaymentAccount`, and `PaymentMethod`.
- `ArchiveDocument` -> Renamed to `Archive`.
- `Cashbooks` -> Renamed to `Cashbook`.
- New classes added: `Email`, `Situation`, `PriceList`, and `Webhook`.

### Strictly Typed & Readonly Entities

[](#strictly-typed--readonly-entities)

All entities (e.g., `Client`, `IssuedDocument`, `PriceList`) have been refactored to be **readonly** classes with **strict types**.

- Properties are now immutable.
- Usage of `mixed` types has been minimized in favor of strict `string`, `int`, `float`, `bool`, etc.
- Constructors ensure safe data mapping from API responses.

### Modern testing suite

[](#modern-testing-suite)

- Switched from PHPUnit to **Pest PHP** for a more expressive and modern testing experience.
- Automated code styling with **Laravel Pint**.

### Architecture

[](#architecture)

- The package now utilizes a central `FattureInCloud` connector for better state management.
- API interactions are handled via the native Laravel `Http` client.

Documentation, Installation, and Usage Instructions
---------------------------------------------------

[](#documentation-installation-and-usage-instructions)

This package provides a simple Laravel integration with [Fatture in Cloud APIs v2](https://developers.fattureincloud.it/).

See the [documentation](https://docs.offlineagency.com/laravel-fatture-in-cloud-v2/) for detailed installation and usage instructions.

```
$issued_documents = new \OfflineAgency\LaravelFattureInCloudV2\Api\IssuedDocument();
$issued_document_list = $issued_document->list('invoice', [
    'per_page' => 50
]);

// return an array of invoices
$issued_document_list->getItems();

// return pagination fields like page, per_page...
$issued_document_list->getPagination();

// return single product's fields
$product = new \OfflineAgency\LaravelFattureInCloudV2\Api\Product();
$product_detail = $product->detail($product_id);
```

Features
--------

[](#features)

### All ![HOT](https://camo.githubusercontent.com/1d5fd67bc79feed60df50c243da7f51e7d0df73333f7b02814a28711d7c50b9f/68747470733a2f2f696d672e736869656c64732e696f2f7374617469632f76312e7376673f6c6162656c3d266d6573736167653d484f5426636f6c6f723d726564)

[](#all-)

This package provide `all()` method that allow you to get an array of all results without pagination. It's implemented for all endpoint that provide a list method with pagination. Let's see an example:

```
$issued_documents = new \OfflineAgency\LaravelFattureInCloudV2\Api\IssuedDocument();
$issued_document_list = $issued_documents->all('invoice');
```

### Pagination

[](#pagination)

This package provides a pagination system that allow you to move between pages using simple methods:

```
$issued_documents = new \OfflineAgency\LaravelFattureInCloudV2\Api\IssuedDocument();
$issued_document_list = $issued_documents->list('invoice');

// check if the response has more than one page
$issued_document_list->getPagination()->isSinglePage();

// check if the document has a next page
$issued_document_list->getPagination()->hasNextPage();

// check if the document has a previous page
$issued_document_list->getPagination()->hasPrevPage();

// return documents of the next page
$issued_document_list->getPagination()->goToNextPage();

// return documents of the previous page
$issued_document_list->getPagination()->goToPrevPage();

// return documents of the first page
$issued_document_list->getPagination()->goToFirstPage();

// return documents of the last page
$issued_document_list->getPagination()->goToLastPage();
```

### Bin ![HOT](https://camo.githubusercontent.com/1d5fd67bc79feed60df50c243da7f51e7d0df73333f7b02814a28711d7c50b9f/68747470733a2f2f696d672e736869656c64732e696f2f7374617469632f76312e7376673f6c6162656c3d266d6573736167653d484f5426636f6c6f723d726564)

[](#bin-)

This package provides bin() method for deleted issued documents that allow you to get its detail. This is very useful, for example, when you convert a proforma into an invoice (deleting the proforma) and you need old document's detail. Let's see an example:

```
$issued_documents = new \OfflineAgency\LaravelFattureInCloudV2\Api\IssuedDocument();
$response = $issued_documents->bin($document_id);
```

### Rate limit ![HOT](https://camo.githubusercontent.com/1d5fd67bc79feed60df50c243da7f51e7d0df73333f7b02814a28711d7c50b9f/68747470733a2f2f696d672e736869656c64732e696f2f7374617469632f76312e7376673f6c6162656c3d266d6573736167653d484f5426636f6c6f723d726564)

[](#rate-limit-)

This package provides a method to intercept throttle errors (403, 429) and automatically retry. You can specify limits on your config, remember to use milliseconds to indicate time:

```
'limits' => [
    'default' => 300000,
    '403' => 300000,
    '429' => 3600000,
],
```

API coverage
------------

[](#api-coverage)

We are currently work on this package to implement all endpoints. Enable notifications to be notified when new API are released.

✅ User

✅ Companies

✅ Clients

✅ Suppliers

✅ Products

✅ Issued Documents

✅ Issued e-invoices

✅ Received Documents

✅ Receipts

✅ Taxes

✅ Archive

✅ Cashbook

✅ Info

✅ Price Lists

✅ Webhooks

✅ Situation

✅ Emails

✅ Stock

✅ Payment Accounts

✅ Payment Methods

✅ VAT Types

Testing
-------

[](#testing)

```
composer test
```

Unit and Feature tests use mocked HTTP. To run **integration tests** (real HTTP calls to Fatture in Cloud), set in `.env`:

- `FCV2_DEFAULT_ID` – company ID
- `FCV2_DEFAULT_BEARER` – API bearer token

Then run:

```
php vendor/bin/pest tests/Integration
```

If these env vars are not set, integration tests are skipped.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security
--------

[](#security)

If you discover any security-related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Offline Agency](https://github.com/offline-agency)
- [Giacomo Fabbian](https://github.com/Giacomo92)
- [Nicolas Sanavia](https://github.com/SanaviaNicolas)
- [All Contributors](https://github.com/offline-agency/laravel-fatture-in-cloud-v2/graphs/contributors)

About us
--------

[](#about-us)

Offline Agency is a web design agency based in Padua, Italy. You'll find an overview of our projects [on our website](https://offlineagency.it/).

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

57

—

FairBetter than 98% of packages

Maintenance91

Actively maintained with recent releases

Popularity27

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity76

Established project with proven stability

 Bus Factor1

Top contributor holds 51.3% 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 ~116 days

Recently: every ~313 days

Total

13

Last Release

92d ago

Major Versions

1.2.0 → 2.0.02022-06-21

2.1.3 → 3.0.02026-03-27

PHP version history (3 changes)1.0.0PHP >=7.4

1.1.0PHP >=7.3

3.0.0PHP ^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/33f8b76656d71bddf83e5924863f37dea04f3f89196e7fb9cf25e30c3ee27093?d=identicon)[offlineagency](/maintainers/offlineagency)

---

Top Contributors

[![SanaviaNicolas](https://avatars.githubusercontent.com/u/56884198?v=4)](https://github.com/SanaviaNicolas "SanaviaNicolas (160 commits)")[![Giacomo92](https://avatars.githubusercontent.com/u/11694429?v=4)](https://github.com/Giacomo92 "Giacomo92 (75 commits)")[![ManuelRomanato](https://avatars.githubusercontent.com/u/85669332?v=4)](https://github.com/ManuelRomanato "ManuelRomanato (28 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (18 commits)")[![FazePino](https://avatars.githubusercontent.com/u/133657985?v=4)](https://github.com/FazePino "FazePino (12 commits)")[![fyreck](https://avatars.githubusercontent.com/u/80709922?v=4)](https://github.com/fyreck "fyreck (9 commits)")[![ZamboXVII](https://avatars.githubusercontent.com/u/136342519?v=4)](https://github.com/ZamboXVII "ZamboXVII (3 commits)")[![nanaNsNever](https://avatars.githubusercontent.com/u/170920922?v=4)](https://github.com/nanaNsNever "nanaNsNever (2 commits)")[![marcosimooo](https://avatars.githubusercontent.com/u/136339662?v=4)](https://github.com/marcosimooo "marcosimooo (2 commits)")[![petrealessio](https://avatars.githubusercontent.com/u/64196684?v=4)](https://github.com/petrealessio "petrealessio (1 commits)")[![hjeldin](https://avatars.githubusercontent.com/u/922567?v=4)](https://github.com/hjeldin "hjeldin (1 commits)")[![francescovarotto](https://avatars.githubusercontent.com/u/86966923?v=4)](https://github.com/francescovarotto "francescovarotto (1 commits)")

---

Tags

apifatturazione-elettronicafattureincloudhacktoberfesthacktoberfest-acceptedhacktoberfest2022laravellaravel-packagephpapilaravelintegrationfatture in cloud

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/offline-agency-laravel-fatture-in-cloud-v2/health.svg)

```
[![Health](https://phpackages.com/badges/offline-agency-laravel-fatture-in-cloud-v2/health.svg)](https://phpackages.com/packages/offline-agency-laravel-fatture-in-cloud-v2)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M345](/packages/psalm-plugin-laravel)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9762.4M131](/packages/roots-acorn)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

77022.3M151](/packages/laravel-mcp)[api-platform/laravel

API Platform support for Laravel

58171.4k14](/packages/api-platform-laravel)[simplestats-io/laravel-client

Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof.

5021.9k](/packages/simplestats-io-laravel-client)[defstudio/telegraph

A laravel facade to interact with Telegram Bots

816333.6k3](/packages/defstudio-telegraph)

PHPackages © 2026

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