| meta | gitName | |||||
|---|---|---|---|---|---|---|
|
laravel-fatture-in-cloud |
::: tip A new version of laravel-fatture-in-cloud is available, you can find the documentation here :::
This Laravel wrapper allows you to integrate a Laravel e-commerce platform with the invoicing program Fatture in Cloud using Api.
You can install this package via composer using:
composer require offline-agency/laravel-fatture-in-cloudThe package will automatically register its service provider.
To publish the config file to config/backup.php run:
php artisan vendor:publish --provider="OfflineAgency\FattureInCloud\FattureInCloudServiceProvider" --tag="config" - Go to Fatture in Cloud website.
- Create an account and a test environment. The new account has 15 trial days.
- Go to section and get API UID and API KEY
Create a new invoice on FC
$invoiceRequest = [
'id_cliente' => '0',
'id_fornitore' => '0',
'nome' => 'Mario Rossi',
'indirizzo_via' => 'Via delle Betulle, 123',
'indirizzo_cap' => '21012',
'indirizzo_citta' => 'Curno',
'indirizzo_provincia' => 'BG',
'indirizzo_extra' => '',
'paese' => 'Italia',
'paese_iso' => 'IT',
'lingua' => 'it',
'piva' => 'IT1234567890',
'cf' => 'ABCDEF12G34H567I',
'autocompila_anagrafica' => false,
'salva_anagrafica' => false,
'numero' => '1a',
'data' => '21/01/2021',
'valuta' => 'EUR',
'valuta_cambio' => 1,
'prezzi_ivati' => false,
'rivalsa' => 0,
'cassa' => 0,
'rit_acconto' => 0,
'imponibile_ritenuta' => 0,
'rit_altra' => 0,
'marca_bollo' => 0,
'oggetto_visibile' => '',
'oggetto_interno' => '',
'centro_ricavo' => '',
'centro_costo' => '',
'note' => '',
'nascondi_scadenza' => false,
'ddt' => false,
'ftacc' => false,
'id_template' => '0',
'ddt_id_template' => '0',
'ftacc_id_template' => '0',
'mostra_info_pagamento' => false,
'metodo_pagamento' => 'Bonifico',
'metodo_titoloN' => 'IBAN',
'metodo_descN' => 'IT01A2345678900000000001234',
'mostra_totali' => 'tutti',
'mostra_bottone_paypal' => false,
'mostra_bottone_bonifico' => false,
'mostra_bottone_notifica' => false,
'lista_articoli' =>
[
0 =>
[
'id' => '0',
'codice' => '',
'nome' => 'Articolo 1',
'um' => '',
'quantita' => 1,
'descrizione' => '',
'categoria' => '',
'prezzo_netto' => 0,
'prezzo_lordo' => 0,
'cod_iva' => 0,
'tassabile' => true,
'sconto' => 0,
'applica_ra_contributi' => true,
'ordine' => 0,
'sconto_rosso' => 0,
'in_ddt' => false,
'magazzino' => true,
],
],
'lista_pagamenti' =>
[
0 =>
[
'data_scadenza' => '21/01/2021',
'importo' => 0,
'metodo' => 'not',
'data_saldo' => '21/01/2021',
],
],
'ddt_numero' => '',
'ddt_data' => '21/01/2021',
'ddt_colli' => '',
'ddt_peso' => '',
'ddt_causale' => '',
'ddt_luogo' => '',
'ddt_trasportatore' => '',
'ddt_annotazioni' => '',
'PA' => false,
'PA_tipo_cliente' => 'PA',
'PA_tipo' => 'nessuno',
'PA_numero' => '',
'PA_data' => '21/01/2021',
'PA_cup' => '',
'PA_cig' => '',
'PA_codice' => '',
'PA_pec' => '',
'PA_esigibilita' => 'N',
'PA_modalita_pagamento' => 'MP01',
'PA_istituto_credito' => '',
'PA_iban' => '',
'PA_beneficiario' => '',
'extra_anagrafica' =>
[
'mail' => '[email protected]',
'tel' => '012345678',
'fax' => '012345678',
],
'split_payment' => true,
];
$invoice = new Fatture;
$invoiceResponse = $invoice->nuovo($invoiceRequest);
if ($invoiceResponse->success) {//Invoice created
$doc_id = $invoiceResponse->new_id;
} else {//Error
Log::error($invoiceResponse->error);
}$account = new Account;
$account->getInfo(['campi'=> ['key']])- getGenericInfo(): it checks api key and return info about api rate limit
- getInfo(): it returns info about (just pass the correct key instead of key see previous example ):
- Business name - nome
- Licence expiration : durata_licenza
- Licence type: tipo_licenza
- Currency list: lista_valute
- Vat list: lista_iva
- Country list: lista_paesi
- Template list: lista_template
- List of payment method for the sales: lista_conti
- List of payment method for the purchase: lista_metodi_pagamento
//Aliases
$customer = new Clienti;
$supplier = new Fornitori;- lista(): return a list of all customers/suppliers;
- nuovo(): it allows to create a new customer/supplier
- importa(): it allows to create a customer/supplier in batch
- modifica(): it allows to edit a specific customer/supplier
- elimina(): it allows to delete a specific customer/supplier
//Aliases
$invoice = new Fatture;
$receipt = new Ricevuta;
$quotation = new Preventivi;
$order = new Ordini;
$dealing = new Rapporti;
$credit_note = new Ndc;
$proforma_invoice = new Proforma;
$supplier_order = new OrdiniFornitori;
$delivery_note = new Ddt;The possible document are:
- invoice
- receipt
- quotation
- order
- credit note
- proforma invoice
- dealing
- order supplier
- transportation document
- lista(): return a list of all documents;
- nuovo(): it allows to create a new document
- importa(): it allows to create document in batch
- modifica(): it allows to edit a specific document
- elimina(): it allows to delete a specific document
Using Observer pattern to create an invoice on Fatture in Cloud after order creation in your E-commerce application.
Using Observer pattern when update a customer propagate the change also in Fatture in Cloud
Using a job you can publish a new product on your ecommerce from Fatture in Cloud
Using a job keep update a product avaiability on your ecommerce and also in Fatture in Cloud
- Demo: New repository with full examples and functionality. Synchronization from application and Fatture in Cloud and vice versa
- Tests: Add test to achieve 100% of test coverage
- More Validations: Add more validations before send request to the API.
- L8 Compatibility: Add Laravel 8 support
Find yourself stuck using the package? Found a bug? Do you have general questions or suggestions for improving the plugin? Feel free to create an issue on GitHub, we’ll try to address it as soon as possible.
If you’ve found a bug regarding security please mail [email protected] instead of using the issue tracker.
Offline Agency is an agency based in Padua, Italy.
Open source software is used in all projects we deliver. This is just a few of the free pieces of software we use every single day. For this, we are very grateful. When we feel we have solved a problem in a way that can help other developers, we release our code as open source software on GitHub.
This package was made by Giacomo Fabbian. There are many other contributors who devoted time and effort to make this package better.