PHPackages                             datomatic/laravel-fatture-in-cloud - 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. datomatic/laravel-fatture-in-cloud

ActiveLibrary[API Development](/categories/api)

datomatic/laravel-fatture-in-cloud
==================================

Laravel wrapper for Fatture in Cloud API v2

v1.7.1(2mo ago)104.1k↑53.3%7MITPHPPHP ^8.1CI passing

Since Aug 2Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/datomatic/laravel-fatture-in-cloud)[ Packagist](https://packagist.org/packages/datomatic/laravel-fatture-in-cloud)[ Docs](https://github.com/nocodelab/laravel-fatture-in-cloud)[ GitHub Sponsors](https://github.com/Datomatic)[ RSS](/packages/datomatic-laravel-fatture-in-cloud/feed)WikiDiscussions main Synced 1mo ago

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

[![Laravel-Fatture-in-Cloud-Dark](branding/dark.png#gh-dark-mode-only)](branding/dark.png#gh-dark-mode-only)[![Laravel-Fatture-in-Cloud-Light](branding/light.png#gh-light-mode-only)](branding/light.png#gh-light-mode-only)

Laravel wrapper for Fatture in Cloud API v2
===========================================

[](#laravel-wrapper-for-fatture-in-cloud-api-v2)

[![Latest Version on Packagist](https://camo.githubusercontent.com/8112538fc488a4ba6329760b4d054a584d7e6a9ae5daec5ea5b35b3d9495eae1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6461746f6d617469632f6c61726176656c2d666174747572652d696e2d636c6f75642e7376673f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/datomatic/laravel-fatture-in-cloud)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/eabd8baaf07e4971f32e25bdffc57068c79aa16d23da7f40640988afbfc1347f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6461746f6d617469632f6c61726176656c2d666174747572652d696e2d636c6f75642f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f7374796c653d666f722d7468652d6261646765266c6162656c3d636f64652532307374796c65)](https://github.com/datomatic/laravel-fatture-in-cloud/actions?query=workflow%3A%22Check+%26+fix+styling%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/1c0f51928a4316b3c13a9a0c42a436fd44e45e9f1a676e7e0f382208776a0d21/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6461746f6d617469632f6c61726176656c2d666174747572652d696e2d636c6f75642e7376673f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/datomatic/laravel-fatture-in-cloud)

---

This Laravel wrapper allows you to integrate [Fatture in Cloud](https://fattureincloud.it) using Api v2.

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

[](#requirements)

- Laravel >= 8.37
- PHP >= 8.1
- ext-json

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require datomatic/laravel-fatture-in-cloud
```

Optionally, you can publish the config file with:

```
php artisan vendor:publish --provider="Datomatic\FattureInCloud\FattureInCloudServiceProvider" --tag="fatture-in-cloud-config"
```

This is the contents of the published config file:

```
return [
    'access_token'  => env('FATTURE_IN_CLOUD_ACCESS_TOKEN'),
    'company_id'  => env('FATTURE_IN_CLOUD_COMPANY_ID'),
    'endpoint' => env('FATTURE_IN_CLOUD_ENDPOINT','https://api-v2.fattureincloud.it/'),
];
```

PS: to obtain company\_id please see [this article](https://developers.fattureincloud.it/docs/basics/company-scoped-methods/#microscope-where-can-i-find-my-company_id).

Usage
-----

[](#usage)

Get FattureInCloud class from service container or using `FattureInCloud` Facade.

```
use Datomatic\FattureInCloud\Facades\FattureInCloud;
//Facade
FattureInCloud::invoices()->...

use Datomatic\FattureInCloud\FattureInCloud;

//Automatic Injection
public function __construct(FattureInCloud $fic){}

//Resolve
$fic = App::make(FattureInCloud::class);
$fic = app(Datomatic\FattureInCloud\FattureInCloud::class);
```

Use the Fatture In Cloud utilities classes

`$fic->clients()->create([... user array...]);`

Please see the functionalities and the array to pass on [Official Documentation](https://developers.fattureincloud.it/api-reference).

The resources covered are:

- user()
- info()
- products()
- clients()
- suppliers()
- invoices()
- quotes()
- proformas()
- receipts()
- deliveryNotes()
- creditNotes()
- orders()
- selfOwnInvoices()
- selfSupplierInvoices()
- invoices()
- work\_reports()
- supplierOrders()
- expenses()
- passiveCreditNotes()
- passiveDeliveryNotes()
- paymentAccounts()
- paymentMethods()

Each resource has the same methods available:

- `all(array $data = [])`
- `create(array $data)`
- `edit(int $id, array $data)`
- `delete(int $id, array $data = [])`
- `getById(int $id, array $data = [])`

The methods will return an array with the response from Fatture in Cloud API (except for the delete method that may return null).

For example, to fetch all clients (according to [Official Documentation](https://developers.fattureincloud.it/api-reference/#get-/c/-company_id-/entities/clients)) you should call:

```
$fic->clients()->all(['fieldset' => 'detailed'])
```

### Enums

[](#enums)

To improve the use of api usage is included a comfortable list of utilities enums:

- DocumentStatus
- EntityType
- IssuedDocumentType
- ReceivedDocumentType
- PaymentStatus

### Utilities

[](#utilities)

The Fatture in CLoud API accept only a fullname on country field 🤦‍♂️ so i add a `Datomatic\FattureInCloud\Utilities\CountryConverter` utility class with `fromAlpha2` and `fromName` methods.

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

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

[](#contributing)

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

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Alberto Peripolli](https://github.com/trippo)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

55

—

FairBetter than 98% of packages

Maintenance87

Actively maintained with recent releases

Popularity33

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 89% 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 ~67 days

Recently: every ~172 days

Total

26

Last Release

62d ago

Major Versions

0.1.5 → v1.0.02022-11-04

PHP version history (2 changes)0.1.0PHP ^8.0

v1.0.0PHP ^8.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/497169?v=4)[Alberto Peripolli](/maintainers/trippo)[@trippo](https://github.com/trippo)

---

Top Contributors

[![trippo](https://avatars.githubusercontent.com/u/497169?v=4)](https://github.com/trippo "trippo (73 commits)")[![tfrazzet](https://avatars.githubusercontent.com/u/47104749?v=4)](https://github.com/tfrazzet "tfrazzet (2 commits)")[![nocodelab](https://avatars.githubusercontent.com/u/4540118?v=4)](https://github.com/nocodelab "nocodelab (2 commits)")[![kalizi](https://avatars.githubusercontent.com/u/13708517?v=4)](https://github.com/kalizi "kalizi (2 commits)")[![Rattone](https://avatars.githubusercontent.com/u/7362607?v=4)](https://github.com/Rattone "Rattone (1 commits)")[![giagara](https://avatars.githubusercontent.com/u/79515022?v=4)](https://github.com/giagara "giagara (1 commits)")[![ToshiZL](https://avatars.githubusercontent.com/u/12396954?v=4)](https://github.com/ToshiZL "ToshiZL (1 commits)")

---

Tags

laravelfatture in cloudDatomaticlaravel-fatture-in-cloud

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

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

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

###  Alternatives

[scalar/laravel

Render your OpenAPI-based API reference

6183.9k2](/packages/scalar-laravel)[ryangjchandler/bearer

Minimalistic token-based authentication for Laravel API endpoints.

8129.8k](/packages/ryangjchandler-bearer)[combindma/laravel-facebook-pixel

Meta pixel integration for Laravel

4956.9k](/packages/combindma-laravel-facebook-pixel)[stechstudio/laravel-hubspot

A Laravel SDK for the HubSpot CRM Api

2971.0k](/packages/stechstudio-laravel-hubspot)[njoguamos/laravel-plausible

A laravel package for interacting with plausible analytics api.

208.8k](/packages/njoguamos-laravel-plausible)[likeabas/filament-chatgpt-agent

Integrate with OpenAI ChatGPT

235.3k](/packages/likeabas-filament-chatgpt-agent)

PHPackages © 2026

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