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(3mo ago)1111.5k↑1225.3%7MITPHPPHP ^8.1CI passing

Since Aug 2Pushed 3mo 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 today

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

54

—

FairBetter than 96% of packages

Maintenance79

Regular maintenance activity

Popularity36

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity71

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

109d 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

[dedoc/scramble

Automatic generation of API documentation for Laravel applications.

2.1k11.2M100](/packages/dedoc-scramble)[spatie/laravel-pdf

Create PDFs in Laravel apps

1.0k4.8M47](/packages/spatie-laravel-pdf)[defstudio/telegraph

A laravel facade to interact with Telegram Bots

816333.8k3](/packages/defstudio-telegraph)[rawilk/profile-filament-plugin

Profile & MFA starter kit for filament.

3914.6k](/packages/rawilk-profile-filament-plugin)[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)[lettermint/lettermint-laravel

Official Lettermint driver for Laravel

1190.2k1](/packages/lettermint-lettermint-laravel)

PHPackages © 2026

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