Download the PHP package banelsems/lara-sgmef-qr without Composer

LaraSgmefQR

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

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

• 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

Publier les vues est optionnel :

Configuration

Ajoutez les variables utiles dans .env :

En production, protegez toujours l'interface web :

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

Creer et confirmer une facture de vente

Multi-paiement

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

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

Avoir FA/EA avec reference obligatoire

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

Taxe specifique et modification de prix

Multi-IFU

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

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

Vous pouvez ensuite injecter le resolver pour construire vos DTOs :

Jobs Laravel

Planification recommandee du nettoyage :

Commandes

Generer un export STAT CSV :

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

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

Cycle de vie et statuts

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

Statuts disponibles :

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

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

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

• 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

• Repository : https://github.com/Banelsems/laraSgmefQR
• Issues : https://github.com/Banelsems/laraSgmefQR/issues
• API developpeur DGI : https://developper.impots.bj/sygmef-emcf/swagger/v1/swagger.json
• Portail e-MECeF : https://e-mecef.impots.bj/

Licence

MIT. Voir LICENSE.