PHPackages                             ashraam/evoliz-php - 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. ashraam/evoliz-php

ActiveLibrary[API Development](/categories/api)

ashraam/evoliz-php
==================

Evoliz API PHP wrapper (Laravel compatible)

v0.6.1(7mo ago)0211MITPHPPHP ^8.2

Since Feb 17Pushed 7mo ago2 watchersCompare

[ Source](https://github.com/Ashraam/evoliz-php)[ Packagist](https://packagist.org/packages/ashraam/evoliz-php)[ Docs](https://github.com/ashraam/evoliz-php)[ RSS](/packages/ashraam-evoliz-php/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (4)Versions (10)Used By (0)

PHP Wrapper for Evoliz API
==========================

[](#php-wrapper-for-evoliz-api)

[![Latest Version on Packagist](https://camo.githubusercontent.com/181ebd0db473fe9d6f1c7c32191bd8c7e953794733c1409d879e9b2fad07d8b3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6173687261616d2f65766f6c697a2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ashraam/evoliz-php)[![Total Downloads](https://camo.githubusercontent.com/99a36e137516af2bbae5113b2e8a490e7ba9b94f4f1cf68b97b5f40df5723657/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6173687261616d2f65766f6c697a2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ashraam/evoliz-php)

All the query, body parameters can be found on the official [API documentation](https://www.evoliz.io/documentation)

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

[](#installation)

You can install the package via composer:

```
composer require ashraam/evoliz-php
```

If your are using `Laravel` you can follow this [integration guide](LARAVEL-INTEGRATION.md).

Example
-------

[](#example)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Clients\Client;

$evoliz = new Evoliz($companyId, $publicKey, $secretKey, $endpoint);

$client_repository = new Client($evoliz);

// Create a new client
$client = $client_repository->create([
    'name' => 'IT Consulting',
    'type' => 'Professionnel',
    'address' => [
        'postcode' => 20000,
        'town' => 'Ajaccio',
        'country' => 'France',
        'iso2' => 'FR'
    ]
]);

// Get the list of the clients of this company
$clients = $client_repository->list();
```

Evoliz client
-------------

[](#evoliz-client)

The client will be required for every sub classes.

It accepts 4 parameters

- `companyId` Int required
- `publicKey` String required
- `secretKey` String required
- `endpoint` String optional (default: `https://www.evoliz.io/api/v1/`)

```
$evoliz = new Evoliz(12544, 'my_public_key', 'my_secret_key', 'https://my-custom-endpoint.com');
```

Banks\\BankAccount
------------------

[](#banksbankaccount)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Banks\BankAccount;

$banks_repository = new BankAccount(new Evoliz(...));

// Return a list of banks visible by the current user, according to visibility restriction set in user profile
$banks_repository->list();

// Return a bank details by its specific id, according to visibility restriction set in user profile
$banks_repository->get($contactId);
```

Banks\\BankItem
---------------

[](#banksbankitem)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Banks\BankItem;

$bank_items_repository = new BankItem(new Evoliz(...));

// Return a list of bank items visible by the current User, according to visibility restriction set in user profile
$bank_items_repository->list();

// Return a bank item by its speficied id
$bank_items_repository->get($bankItemId);

// Lock a bank item
$bank_items_repository->lock($bankItemId);

// Unlock a bank item
$bank_items_repository->unlock($bankItemId);
```

Sales\\Invoice
--------------

[](#salesinvoice)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Sales\Invoice;

$invoices_repository = new Invoice(new Evoliz(...));

// Return a list of invoices visible by the current User, according to visibility restriction set in user profile
$invoices_repository->list();

// Create a new draft invoice with given data. Totals, margins, retention, included VAT fields are automatically calculated.
$draft = $invoices_repository->create([
    'external_document_number' => 'my-custom-id',
    'documentdate' => '2022-02-14',
    'clientid' => 3045161,
    'term' => [
        'paytermid' => 1,
        'recovery_indemnity' => true
    ],
    'items' => [
        [
            'designation' => 'Item 1',
            'quantity' => 4,
            'unit_price_vat_exclude' => 5.73
        ]
    ]
]);

// Return an invoice by its speficied id
$invoices_repository->get($invoiceId);

// Save the invoice with a definitive document number. The status must be “filled” and will be changed to “created”
$invoices_repository->save($invoiceId);

// Send an email with a link to the invoice
$invoices_repository->send($invoiceId, [
    'to' => ['romain@itconsulting-solutions.com']
]);

// Create a new payement with given data
$invoices_repository->payment($invoiceId, [
    'paydate' => '2022-02-14',
    'label' => 'Test paiement',
    'paytypeid' => 1,
    'amount' => 2
]);

// List all payments of the given invoice
$invoices_repository->payments($invoiceId);
```

Sales\\Quote
------------

[](#salesquote)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Sales\Quote;

$quote_repository = new Quote(new Evoliz(...));

// Return a list of quotes visible by the current User, according to visibility restriction set in user profile
$quote_repository->list();

// Create a new draft quote with given data. Totals, margins, retention, included VAT fields are automatically calculated.
$draft = $quote_repository->create([
    'external_document_number' => 'my-custom-id',
    'documentdate' => '2022-02-14',
    'clientid' => 3045161,
    'term' => [
        'paytermid' => 1,
        'recovery_indemnity' => true
    ],
    'items' => [
        [
            'designation' => 'Item 1',
            'quantity' => 4,
            'unit_price_vat_exclude' => 5.73
        ]
    ]
]);

// Return a quote by its speficied id
$quote_repository->get($quoteId);

// Create a new invoice from the given quote
$quote_repository->invoice($quoteId);

// Send an email with a link to the quote
$quote_repository->send($quoteId, [
    'to' => ['user@gmail.com'],
    'subject' => 'The email subject'
]);
```

Sales\\SaleOrder
----------------

[](#salessaleorder)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Sales\SaleOrder;

$sale_order_repository = new SaleOrder(new Evoliz(...));

// Return a list of sale orders visible by the current User, according to visibility restriction set in user profile
$sale_order_repository->list();

// Create a new sale order with given data. Totals, margins, included VAT fields are automatically calculated.
$sale_order_repository->create([
    'external_document_number' => uniqid(),
    'documentdate' => '2022-02-15',
    'clientid' => 3045161,
    'term' => [
        'paytermid' => 1
    ],
    'items' => [
        [
            'designation' => 'Item 1',
            'quantity' => 2,
            'unit_price_vat_exclude' => 10,
            'vat_rate' => 20
        ]
    ]
]);

// Return a sale order by its speficied id
$sale_order_repository->get($orderId);

// Create a new invoice from the given sale order
$sale_order_repository->invoice($orderId);
```

Sales\\Delivery
---------------

[](#salesdelivery)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Sales\Delivery;

$delivery_repository = new Delivery(new Evoliz(...));

// Return a list of deliveries visible by the current User, according to visibility restriction set in user profile
$delivery_repository->list();

// Return a delivery by its speficied id
$delivery_repository->get($deliveryId);
```

Sales\\Payment
--------------

[](#salespayment)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Sales\Payment;

$payments_repository = new Payment(new Evoliz(...));

// Return a list of payments visible by the current User, according to visibility restriction set in user profile
$payments_repository->list();

// Return a payment by its speficied id
$payments_repository->get($paymentId);
```

Sales\\Credit
-------------

[](#salescredit)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Sales\Credit;

$credit_repository = new Credit(new Evoliz(...));

// Return a list of credits visible by the current User, according to visibility restriction set in user profile
$credit_repository->list();

// Return a credit by its speficied id
$credit_repository->get($creditId);
```

Sales\\Advance
--------------

[](#salesadvance)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Sales\Advance;

$advance_repository = new Advance(new Evoliz(...));

// Return a list of advances visible by the current User, according to visibility restriction set in user profile
$advance_repository->list();

// List all payments of the given advance
$advance_repository->payments($advanceId);

// Create a new payment with given data
$advance_repository->payment($advanceId, [
    'paydate' => '2022-02-10',
    'label' => 'My label',
    'paytypeid' => 1,
    'amount' => 100,
    'comment' => 'My comment'
]);

// Return an advance by its speficied id
$advance_repository->get($advanceId);
```

Sales\\DocumentLink
-------------------

[](#salesdocumentlink)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Sales\DocumentLink;

$documents_repository = new DocumentLink(new Evoliz(...));

// Return a list of documents links associated to the requested document
$documents_repository->get($documentType, $documentId);
```

Purchases\\Buy
--------------

[](#purchasesbuy)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Purchases\Buy;

$buys = new Buy(new Evoliz(...));

// Return a list of buys visible by the current User, according to visibility restriction set in user profile
$buys->list();

// Return a buy by its speficied id
$buys->get($buyId);

// Update buy state to locked
$buys->lock($buyId);

// Update buy state to unlocked
$buys->unlock($buyId);
```

Purchases\\SupplierCredit
-------------------------

[](#purchasessuppliercredit)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Purchases\SupplierCredit;

$credits = new Buy(new Evoliz(...));

// Return a list of Supplier credits visible by the current User, according to visibility restriction set in user profile
$credits->list();

// Return a supplier credit by its speficied id
$credits->get($supplierCreditId);

// Update supplier credit state to locked
$credits->lock($supplierCreditId);

// Update supplier credit state to unlocked
$credits->unlock($supplierCreditId);
```

Reports\\Reports
----------------

[](#reportsreports)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Reports\Reports;

$reports = new Reports(new Evoliz(...));

// Get amount of overdue payments by period categories
$reports->payments();

// Get amount of overdue settlements by period categories
$reports->settlements();

// Get turnover report data
$reports->turnover();
```

Journals\\Journals
------------------

[](#journalsjournals)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Journals\Journals;

$Journals = new Journals(new Evoliz(...));

// Get trial balance data
$journal->trial_balance();

// Get general ledger data
$journal->general_ledger();

// Get FEC journal entries
$journal->fec();

// Get banks journal entries
$journal->banks();

// Get Cashes journal entries
$journal->cash();

// Get sales journal entries
$journal->sales();

// Get purchases journal data
$journal->purchases();

// Get miscellaneous operations journal entries
$journal->miscellaneous();

// Get opening balance journal entries
$journal->opening_balance();
```

Clients\\Client
---------------

[](#clientsclient)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Clients\Client;

$clients_repository = new Client(new Evoliz(...));

// Return the client list of the specified or current user company
$clients_repository->list();

// Create a new client with given data
$client = $clients_repository->create([
    'name' => "IT Consulting",
    'type' => "Professionnel",
    'address' => [
        'postcode' => 20000,
        'town' => 'Ajaccio',
        'country' => 'France',
        'iso2' => 'FR'
    ],
    'vat_number' => 'N/C'
]);

// Return a client by its speficied id
$clients_repository->get($clientId);
```

Client\\ContactClient
---------------------

[](#clientcontactclient)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Clients\ContactClient;

$contacts_repository = new ContactClient(new Evoliz(...));

// Return a client contact list
$contacts_repository->list();

// Create a new client contact with given data
$client = $contacts_repository->create([
    'clientid' => 3045161,
    'firstname' => 'Romain',
    'lastname' => 'Bertolucci',
    'email' => 'romain@itconsulting-solutions.com'
]);

// Return a client contact by it's id
$contacts_repository->get($contactId);
```

Client\\Prospect
----------------

[](#clientprospect)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Clients\Prospect;

$prospects_repository = new Prospect(new Evoliz(...));

// Return the prospect list of the specified or current user company
$prospects_repository->list();

// Return a prospect by it's id
$prospects_repository->get($prospectId);
```

Client\\ContactProspect
-----------------------

[](#clientcontactprospect)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Clients\ContactProspect;

$contacts_repository = new ContactProspect(new Evoliz(...));

// Return a prospect contact list
$contacts_repository->list();

// Return a prospect contact by it's id
$contacts_repository->get($contactId);
```

Catalog\\Article
----------------

[](#catalogarticle)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Clients\Article;

$articles_repository = new Article(new Evoliz(...));

// Return a list of articles
$articles_repository->list();

// Return article by it's id
$articles_repository->get($articleId);

// Create a new article
$articles_repository->create([
    'reference' => 'ref-001',
    'designation' => 'Article 001',
    'nature' => 'product',
    'unit_price' => 12
]);
```

Files\\File
-----------

[](#filesfile)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Files\File;

$files_repository = new File(new Evoliz(...));

// Return file content encoded in base64
$files_repository->get($documentType, $documentId);
```

Settings\\PurchaseClassification
--------------------------------

[](#settingspurchaseclassification)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Settings\PurchaseClassification;

$classifications = new PurchaseClassification(new Evoliz(...));

// Return a list of Purchases classifications
$classifications->list();

// Return a purchase classification by its specified Id
$classifications->get($classificationId);
```

Settings\\SaleClassification
----------------------------

[](#settingssaleclassification)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Settings\SaleClassification;

$classifications = new SaleClassification(new Evoliz(...));

// Return a list of sales classifications
$classifications->list();

// Return a sale classification by its specified Id
$classifications->get($classificationId);
```

Settings\\PurchaseAffectation
-----------------------------

[](#settingspurchaseaffectation)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Settings\PurchaseAffectation;

$affectations = new PurchaseAffectation(new Evoliz(...));

// Return a list of purchases affectations
$affectations->list();

// Return a purchase affectation by its specified Id
$affectations->get($affectationId);
```

Settings\\SaleAffectation
-------------------------

[](#settingssaleaffectation)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Settings\SaleAffectation;

$affectations = new SaleAffectation(new Evoliz(...));

// Return a list of sales affectations
$affectations->list();

// Return a sale affectation by its specified Id
$affectations->get($affectationId);
```

Settings\\Analytics
-------------------

[](#settingsanalytics)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Settings\Analytics;

$analytics = new Analytics(new Evoliz(...));

// Return a list of analytics axis
$analytics->list();

// Return an analytic axis by its specified Id
$analytics->get($analyticId);
```

Settings\\Accounts
------------------

[](#settingsaccounts)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Settings\Accounts;

$accounts = new Accounts(new Evoliz(...));

// Return a list of accounting classification visible by the current user.
$accounts->list();

// Create a new accounting classification with given data
$accounts->create([
    'code' => '0001',
    'label' => 'Test'
]);

// Return an accounting account by its specified Id.
$accounts->get($accountId);
```

Settings\\PaymentTypes
----------------------

[](#settingspaymenttypes)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Settings\PaymentTypes;

$payment_types = new PaymentTypes(new Evoliz(...));

// Return a list of payment types
$payment_types->list();

// Return a payment type by its specified id
$payment_types->get($payTypeId);
```

Settings\\PaymentTerms
----------------------

[](#settingspaymentterms)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Settings\PaymentTerms;

$payment_terms = new PaymentTerms(new Evoliz(...));

// Return a list of payment types
$payment_terms->list();

// Return a payment type by its specified id
$payment_terms->get($payTermId);
```

Settings\\UnitCodes
-------------------

[](#settingsunitcodes)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Settings\UnitCodes;

$units = new UnitCodes(new Evoliz(...));

// Return a list of units codes, used in various endpoints
$units->list();

// Return a unit code by its specified Id
$units->get($unitCodeId);
```

Settings\\VatRates
------------------

[](#settingsvatrates)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Settings\VatRates;

$rates = new VatRates(new Evoliz(...));

// Return a list of vat rates visible by the current user
$rates->list();

// Return a vat rate by its specified Id
$rates->get($vatRateId);
```

Apps\\MyUnisoft
---------------

[](#appsmyunisoft)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Apps\MyUnisoft;

$unisoft = new File(new Evoliz(...));

// Connect MyUnisoft application in company with api key
$unisoft->connect($myunisoft_api_key);
```

Administration\\User
--------------------

[](#administrationuser)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Administration\User;

$users_repository = new User(new Evoliz(...));

// Return a list of users visible by the current User, according to visibility restriction set in user profile.
$users_repository->list();

// Get the detail of a user by it's id
$users_repository->get($userId);
```

Administration\\Subscription
----------------------------

[](#administrationsubscription)

```
use Ashraam\Evoliz\Evoliz;
use Ashraam\Evoliz\Administration\Subscription;

$subscriptions_repository = new USubscriptionser(new Evoliz(...));

// Return the list of the company's subscriptions.
$subscriptions_repository->list();
```

### Changelog

[](#changelog)

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

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)

- [Romain Bertolucci (IT Consulting)](https://github.com/ashraam)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance63

Regular maintenance activity

Popularity11

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity57

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 ~189 days

Recently: every ~200 days

Total

8

Last Release

229d ago

PHP version history (3 changes)v0.1.0PHP ^7.4|^8.0

v0.3.0PHP ^8.0

v0.4.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/f4ae559aed0680b10f170eb8ce9a186ef2333ff59c0c80970d3e0fec23b02561?d=identicon)[Ashraam](/maintainers/Ashraam)

---

Top Contributors

[![Ashraam](https://avatars.githubusercontent.com/u/4686383?v=4)](https://github.com/Ashraam "Ashraam (15 commits)")

---

Tags

phpapilaravelwrapperevoliz

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/ashraam-evoliz-php/health.svg)

```
[![Health](https://phpackages.com/badges/ashraam-evoliz-php/health.svg)](https://phpackages.com/packages/ashraam-evoliz-php)
```

###  Alternatives

[dariusiii/tmdb-laravel

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

1821.1k](/packages/dariusiii-tmdb-laravel)[php-tmdb/laravel

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

16553.3k1](/packages/php-tmdb-laravel)[aerni/laravel-spotify

A Laravel wrapper for the Spotify Web API

209145.6k](/packages/aerni-laravel-spotify)[gufy/whmcs

WHMCS API for Laravel 5

201.7k](/packages/gufy-whmcs)

PHPackages © 2026

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