PHPackages                             banelsems/lara-sgmef-qr - 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. banelsems/lara-sgmef-qr

ActiveLibrary[API Development](/categories/api)

banelsems/lara-sgmef-qr
=======================

Universal Laravel package for Benin electronic invoicing (SGMEF API) - Works immediately without authentication dependencies. Clean Code architecture with modern web interface.

v3.0.3(2d ago)121MITBladePHP ^8.1|^8.2|^8.3

Since Aug 2Pushed 2d ago1 watchersCompare

[ Source](https://github.com/Banelsems/laraSgmefQR)[ Packagist](https://packagist.org/packages/banelsems/lara-sgmef-qr)[ Docs](https://github.com/banelsems/lara-sgmef-qr)[ RSS](/packages/banelsems-lara-sgmef-qr/feed)WikiDiscussions master Synced today

READMEChangelog (3)Dependencies (20)Versions (16)Used By (0)

LaraSgmefQR
===========

[](#larasgmefqr)

Package Laravel pour intégrer l'API e-MECeF / SyGM-eMCF de la Direction Générale des Impôts du Bénin.

[![Latest Version](https://camo.githubusercontent.com/3205e04bddc9044e715ab33603b6467b7a7dc535cef065c9db3df90acce8e89d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f62616e656c73656d732f6c61726153676d65665152)](https://github.com/Banelsems/laraSgmefQR/releases)[![License](https://camo.githubusercontent.com/e3248d36b94ce2e0a2227c8c59af3096f24a26138c9304ab83eba8d19986b29e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f62616e656c73656d732f6c61726153676d65665152)](LICENSE)[![PHP Version](https://camo.githubusercontent.com/51d228d478068c008f14a2a0229aeb34597b3163165f290cbd536382b5c0176c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e31253230253743253230253545382e32253230253743253230253545382e332d626c7565)](https://php.net)[![Laravel Version](https://camo.githubusercontent.com/9bae2d9be2f5ba784143b82eae0b083e86e830cdaa9e751e8205adb30d882814/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c61726176656c2d3130253230253743253230313125323025374325323031322d726564)](https://laravel.com)

LaraSgmefQR v3.0.3 fournit un client API, des DTOs, une interface web, des jobs Laravel et des outils de conformité pour créer, confirmer, annuler, exporter et documenter des factures e-MECeF.

Fonctionnalites v3
------------------

[](#fonctionnalites-v3)

- Client API aligne sur les endpoints officiels DGI : groupes de taxe, types de facture, types de paiement, creation, lecture, confirmation et annulation de facture.
- Types de facture `FV`, `FA`, `EV`, `EA`, avec `reference` obligatoire pour les avoirs `FA/EA`.
- Paiements officiels : `ESPECES`, `VIREMENT`, `CARTEBANCAIRE`, `MOBILEMONEY`, `CHEQUES`, `CREDIT`, `AUTRE`.
- Articles avec groupes de taxe `A-F`, taxe specifique `taxSpecific`, prix original `originalPrice` et modification `priceModification`.
- Validation locale : IFU a 13 chiffres, paiements egaux au total, coherence des avoirs et erreurs API `errorCode/errorDesc`.
- Support multi-IFU via `IfuResolverInterface`.
- Jobs Laravel pour creation, confirmation et expiration locale des factures en attente apres 2 minutes.
- Export STAT CSV et generation du dossier d'auto-declaration e-MECeF.
- Dashboard avec KPI, filtres, recherche, mode sombre et polling configurable.

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

[](#installation)

```
composer require banelsems/lara-sgmef-qr

php artisan vendor:publish --tag=lara-sgmef-qr-config
php artisan vendor:publish --tag=lara-sgmef-qr-migrations
php artisan migrate
```

Publier les vues est optionnel :

```
php artisan vendor:publish --tag=lara-sgmef-qr-views
```

Configuration
-------------

[](#configuration)

Ajoutez les variables utiles dans `.env` :

```
SGMEF_API_URL=https://developper.impots.bj/sygmef-emcf/api
SGMEF_TOKEN=your_jwt_token_here
SGMEF_DEFAULT_IFU=1234567890123

SGMEF_DEFAULT_OPERATOR_NAME="Operateur Principal"
SGMEF_DEFAULT_OPERATOR_ID=1

SGMEF_HTTP_TIMEOUT=30
SGMEF_CONNECT_TIMEOUT=10
SGMEF_VERIFY_SSL=true

SGMEF_WEB_INTERFACE_ENABLED=true
SGMEF_ROUTE_PREFIX=sgmef
SGMEF_POLLING_SECONDS=30

SGMEF_QUEUE_ENABLED=false
SGMEF_QUEUE_CONNECTION=sync

SGMEF_COMPANY_NAME="Votre entreprise"
SGMEF_RCCM="RCCM/XXXX/XX/XXXX"
SGMEF_PHONE="XX XX XX XX"
SGMEF_EMAIL="contact@example.com"
```

En production, protegez toujours l'interface web :

```
// config/lara_sgmef_qr.php
'web_interface' => [
    'enabled' => env('SGMEF_WEB_INTERFACE_ENABLED', true),
    'middleware' => ['web', 'auth'],
    'route_prefix' => env('SGMEF_ROUTE_PREFIX', 'sgmef'),
    'polling_seconds' => (int) env('SGMEF_POLLING_SECONDS', 30),
],
```

L'interface est disponible sur `/sgmef` par defaut :

- `/sgmef` : dashboard
- `/sgmef/invoices` : liste et filtres
- `/sgmef/invoices/create` : creation de facture
- `/sgmef/config` : configuration

Utilisation PHP
---------------

[](#utilisation-php)

### Creer et confirmer une facture de vente

[](#creer-et-confirmer-une-facture-de-vente)

```
use Banelsems\LaraSgmefQr\Contracts\InvoiceManagerInterface;
use Banelsems\LaraSgmefQr\DTOs\InvoiceRequestDto;

$manager = app(InvoiceManagerInterface::class);

$data = InvoiceRequestDto::fromArray([
    'ifu' => config('lara_sgmef_qr.default_ifu'),
    'type' => 'FV',
    'client' => [
        'ifu' => '9876543210123',
        'name' => 'Client Exemple',
        'contact' => '+229 01 00 00 00',
        'address' => 'Cotonou',
    ],
    'operator' => [
        'id' => '1',
        'name' => 'Operateur Principal',
    ],
    'items' => [
        [
            'name' => 'Prestation de service',
            'price' => 10000,
            'quantity' => 1,
            'taxGroup' => 'B',
            'code' => 'SERV-001',
        ],
    ],
    'payment' => [
        ['name' => 'ESPECES', 'amount' => 10000],
    ],
]);

$invoice = $manager->createInvoice($data);
$confirmedInvoice = $manager->confirmInvoice($invoice->uid);

echo $confirmedInvoice->mecf_code;
echo $confirmedInvoice->qr_code_data;
```

### Multi-paiement

[](#multi-paiement)

Le total des paiements doit etre egal au total des lignes.

```
$data = InvoiceRequestDto::fromArray([
    'ifu' => '1234567890123',
    'type' => 'FV',
    'client' => ['name' => 'Client multi-paiement'],
    'operator' => ['id' => '1', 'name' => 'Caisse 1'],
    'items' => [
        ['name' => 'Article A', 'price' => 7000, 'quantity' => 1, 'taxGroup' => 'B'],
        ['name' => 'Article B', 'price' => 3000, 'quantity' => 1, 'taxGroup' => 'A'],
    ],
    'payment' => [
        ['name' => 'ESPECES', 'amount' => 4000],
        ['name' => 'MOBILEMONEY', 'amount' => 6000],
    ],
]);
```

Types acceptes : `ESPECES`, `VIREMENT`, `CARTEBANCAIRE`, `MOBILEMONEY`, `CHEQUES`, `CREDIT`, `AUTRE`.

### Avoir FA/EA avec reference obligatoire

[](#avoir-faea-avec-reference-obligatoire)

Pour une facture d'avoir, `reference` doit contenir l'UID de la facture originale.

```
$refundData = InvoiceRequestDto::fromArray([
    'ifu' => '1234567890123',
    'type' => 'FA',
    'reference' => $originalInvoice->uid,
    'client' => ['name' => 'Client Exemple'],
    'operator' => ['id' => '1', 'name' => 'Operateur Principal'],
    'items' => [
        ['name' => 'Avoir partiel', 'price' => 2500, 'quantity' => 1, 'taxGroup' => 'B'],
    ],
    'payment' => [
        ['name' => 'ESPECES', 'amount' => 2500],
    ],
]);

$refund = $manager->createInvoice($refundData);
$manager->confirmInvoice($refund->uid);
```

### Taxe specifique et modification de prix

[](#taxe-specifique-et-modification-de-prix)

```
$data = InvoiceRequestDto::fromArray([
    'ifu' => '1234567890123',
    'type' => 'FV',
    'client' => ['name' => 'Client Exemple'],
    'operator' => ['id' => '1', 'name' => 'Operateur Principal'],
    'items' => [
        [
            'name' => 'Produit avec remise',
            'price' => 9000,
            'quantity' => 1,
            'taxGroup' => 'B',
            'taxSpecific' => 150,
            'originalPrice' => 10000,
            'priceModification' => 'REMISE_COMMERCIALE',
        ],
    ],
    'payment' => [
        ['name' => 'CARTEBANCAIRE', 'amount' => 9000],
    ],
]);
```

### Multi-IFU

[](#multi-ifu)

Par defaut, le package lit `SGMEF_DEFAULT_IFU`. Pour une application multi-etablissements, fournissez votre propre resolver :

```
namespace App\Sgmef;

use Banelsems\LaraSgmefQr\Contracts\IfuResolverInterface;

class TenantIfuResolver implements IfuResolverInterface
{
    public function resolve(?string $context = null): string
    {
        return tenant($context)->ifu;
    }
}
```

Puis liez-le dans un service provider de l'application :

```
use App\Sgmef\TenantIfuResolver;
use Banelsems\LaraSgmefQr\Contracts\IfuResolverInterface;

$this->app->bind(IfuResolverInterface::class, TenantIfuResolver::class);
```

Vous pouvez ensuite injecter le resolver pour construire vos DTOs :

```
$ifu = app(IfuResolverInterface::class)->resolve('boutique-cotonou');
```

### Jobs Laravel

[](#jobs-laravel)

```
use Banelsems\LaraSgmefQr\Jobs\CreateInvoiceJob;
use Banelsems\LaraSgmefQr\Jobs\ConfirmInvoiceJob;
use Banelsems\LaraSgmefQr\Jobs\CleanupExpiredPendingInvoicesJob;

CreateInvoiceJob::dispatch($data)->onQueue('sgmef');
ConfirmInvoiceJob::dispatch($invoice->uid)->onQueue('sgmef');
CleanupExpiredPendingInvoicesJob::dispatch()->onQueue('sgmef');
```

Planification recommandee du nettoyage :

```
// app/Console/Kernel.php
use Banelsems\LaraSgmefQr\Jobs\CleanupExpiredPendingInvoicesJob;

$schedule->job(new CleanupExpiredPendingInvoicesJob())->everyMinute();
```

Commandes
---------

[](#commandes)

Generer un export STAT CSV :

```
php artisan emecef:export-stat --from=2026-07-01 --to=2026-07-31
php artisan emecef:export-stat --from=2026-07-01 --to=2026-07-31 --path=storage/app/stat_juillet.csv
```

Generer le dossier d'auto-declaration e-MECeF :

```
php artisan emecef:generate-declaration
```

La configuration `emecef_test_cases` contient 20 cas de test DGI automatisables. Les appels reseau restent mockables dans les tests; les appels reels exigent un token et un IFU valides fournis par l'application hote.

Services utiles
---------------

[](#services-utiles)

```
use Banelsems\LaraSgmefQr\Services\TaxCalculatorService;
use Banelsems\LaraSgmefQr\Services\QrCodeService;
use Banelsems\LaraSgmefQr\Services\StatExportService;

$taxes = app(TaxCalculatorService::class)->calculateInvoice($data->items);
$verificationUrl = app(QrCodeService::class)->verificationUrl($confirmedInvoice);
$csvPath = app(StatExportService::class)->exportCsv(now()->startOfMonth(), now()->endOfMonth());
```

Cycle de vie et statuts
-----------------------

[](#cycle-de-vie-et-statuts)

Le modele `Banelsems\LaraSgmefQr\Models\Invoice` stocke les factures locales et l'audit API.

Statuts disponibles :

```
use Banelsems\LaraSgmefQr\Enums\InvoiceStatusEnum;

InvoiceStatusEnum::PENDING;
InvoiceStatusEnum::CONFIRMED;
InvoiceStatusEnum::CANCELLED;
InvoiceStatusEnum::ERROR;
```

Champs importants :

- `uid` : UID retourne par l'API e-MECeF.
- `ifu` et `customer_ifu` : IFU emetteur/client.
- `type` : `FV`, `FA`, `EV`, `EA`.
- `reference` : facture originale pour `FA/EA`.
- `security_elements`, `qr_code_data`, `mecf_code` : elements de confirmation.
- `error_code`, `error_description` : erreurs locales ou API.
- `expires_at` : date limite locale de confirmation.

Gestion des erreurs
-------------------

[](#gestion-des-erreurs)

```
use Banelsems\LaraSgmefQr\Exceptions\InvoiceException;
use Banelsems\LaraSgmefQr\Exceptions\SgmefApiException;

try {
    $invoice = $manager->createInvoice($data);
} catch (InvoiceException $e) {
    report($e);
} catch (SgmefApiException $e) {
    report($e);
}
```

Les logs du client API evitent de persister les tokens et payloads complets. En production, gardez les logs applicatifs dans un canal protege.

Tests et qualite
----------------

[](#tests-et-qualite)

```
composer validate --no-check-publish
composer run-script cs-check
php vendor/bin/phpunit
composer run-script analyse
```

Remarques :

- PHPUnit peut signaler `No code coverage driver available` si Xdebug/PCOV n'est pas installe.
- PHPStan est conserve dans le workflow, mais certaines bases Laravel/Eloquent peuvent necessiter des annotations ou une configuration dediee.

Compatibilite
-------------

[](#compatibilite)

- PHP `^8.1|^8.2|^8.3`
- Laravel `^10.0|^11.0|^12.0`
- Extensions PHP : `curl`, `json`
- Base de donnees compatible Laravel migrations

Ressources
----------

[](#ressources)

- Repository :
- Issues :
- API developpeur DGI :
- Portail e-MECeF :

Licence
-------

[](#licence)

MIT. Voir [LICENSE](LICENSE).

###  Health Score

49

—

FairBetter than 94% of packages

Maintenance100

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity67

Established project with proven stability

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

Recently: every ~64 days

Total

15

Last Release

2d ago

Major Versions

V1.0.0.2 → v2.0.02025-10-08

v2.3.3 → v3.0.02025-10-19

PHP version history (3 changes)V1.0.0.1PHP >=7.2

v2.0.0PHP ^8.1

v2.1.0PHP ^8.1|^8.2|^8.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/73084052?v=4)[SEMASSOUSSI Banel](/maintainers/Banelsems)[@Banelsems](https://github.com/Banelsems)

---

Top Contributors

[![Banelsems](https://avatars.githubusercontent.com/u/73084052?v=4)](https://github.com/Banelsems "Banelsems (45 commits)")

---

Tags

qrcodelaravelclean codesolidafricataxationelectronic-invoicingplug-and-playbeninsgmefauth-independentuniversal-compatibility

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/banelsems-lara-sgmef-qr/health.svg)

```
[![Health](https://phpackages.com/badges/banelsems-lara-sgmef-qr/health.svg)](https://phpackages.com/packages/banelsems-lara-sgmef-qr)
```

###  Alternatives

[unopim/unopim

UnoPim Laravel PIM

10.5k2.4k](/packages/unopim-unopim)[statamic/cms

The Statamic CMS Core Package

4.8k3.6M984](/packages/statamic-cms)[bagisto/bagisto

Bagisto Laravel E-Commerce

27.6k172.1k9](/packages/bagisto-bagisto)[backpack/crud

Quickly build admin interfaces using Laravel, Bootstrap and JavaScript.

3.4k3.7M223](/packages/backpack-crud)[moe-mizrak/laravel-openrouter

Laravel package for OpenRouter (A unified interface for LLMs)

154177.9k2](/packages/moe-mizrak-laravel-openrouter)[scriptdevelop/whatsapp-manager

Paquete para manejo de WhatsApp Business API en Laravel

783.8k](/packages/scriptdevelop-whatsapp-manager)

PHPackages © 2026

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