PHPackages                             mostafax/erp-integration-hub - 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. mostafax/erp-integration-hub

ActiveLibrary

mostafax/erp-integration-hub
============================

Enterprise Integration Platform for ERP Systems — Visual Field Mapping, Multi-ERP Connectors (Dynamics 365, SAP, Oracle, Odoo, ERPNext), Real-Time Monitoring &amp; Sync Scheduler for Laravel

10PHPCI passing

Since Jun 9Pushed todayCompare

[ Source](https://github.com/mostafax2/ERP-Integration-Hub)[ Packagist](https://packagist.org/packages/mostafax/erp-integration-hub)[ RSS](/packages/mostafax-erp-integration-hub/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

[![ERP Integration Hub](https://raw.githubusercontent.com/mostafax2/ERP-Integration-Hub/main/docs/assets/logo.svg)](https://raw.githubusercontent.com/mostafax2/ERP-Integration-Hub/main/docs/assets/logo.svg)ERP Integration Hub
===================

[](#erp-integration-hub)

**Enterprise Integration Platform for ERP Systems**

[![Laravel](https://camo.githubusercontent.com/ace78b7964bd4b6c12bd86be664390a2bee70f8274d9cb154617fe51abe918b5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d3130253246313125324631322d4646324432303f6c6f676f3d6c61726176656c)](https://laravel.com)[![PHP](https://camo.githubusercontent.com/63866f34512ff2a9a7a1fbeaff3aee4cad6882b0ab1402cbd87e3a6e1c8e625b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253545382e322d3737374242343f6c6f676f3d706870)](https://php.net)[![License](https://camo.githubusercontent.com/5caa455d8debc46fb23abbadb45a733a937f3910a73fc875c2f7820468e1bb54/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e)](LICENSE)[![Packagist](https://camo.githubusercontent.com/ed8fedb18daad8b9661873fc84ecf6b57ba57370c00f4b9dd955bfdb1d70720d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5061636b61676973742d6d6f7374616661782532466572702d2d696e746567726174696f6e2d2d6875622d4632384431413f6c6f676f3d7061636b6167697374)](https://packagist.org/packages/mostafax/erp-integration-hub)

**[📖 Full Documentation →](https://mostafax2.github.io/ERP-Integration-Hub/index.html)** **[📖 التوثيق بالعربية →](https://mostafax2.github.io/ERP-Integration-Hub/ar/index.html)**

---

Overview
--------

[](#overview)

ERP Integration Hub is a Laravel package that connects your application to multiple ERP systems through a visual no-code interface — no manual API calls, no custom glue code.

```
ERP Integration Hub
├── Dynamics 365 Business Central  ✓
├── Dynamics 365 Finance            ✓
├── Supply Chain Management         ✓
├── SAP S/4HANA                     ✓
├── Odoo                            ✓
├── ERPNext                         ✓
└── Custom REST / API               ✓

```

Features
--------

[](#features)

- **Visual Field Mapping** — drag-and-drop builder with 9 built-in transformers and auto-map
- **6 Sync Modes** — manual, scheduled, real-time, incremental, full, event-driven
- **Sync Scheduler** — cron expressions, per-timezone, without overlapping
- **Real-Time Monitoring** — live dashboard with queue health and success rates
- **Retry Management** — per-record, per-profile, or bulk retry of failed jobs
- **Role-Based Security** — 10 granular permissions, 3 default roles
- **REST API** — full API layer with Sanctum authentication
- **Vue 3 SPA** — dark/light mode, Arabic RTL + English i18n
- **High Performance** — lazy collections + chunked processing, 1M–100M records

Requirements
------------

[](#requirements)

DependencyVersionPHP^8.2Laravel10 / 11 / 12Redisrecommended`mostafax/background-processing-engine`^1.0Installation
------------

[](#installation)

```
composer require mostafax/erp-integration-hub
```

Run the installer (publishes config, migrations, assets, and seeds default roles):

```
php artisan erp-integration-hub:install
```

Start the sync worker:

```
php artisan queue:work --queue=dynamics-sync
```

Open the dashboard:

```
https://your-app.com/erp-integration-hub

```

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

[](#configuration)

Publish the config file:

```
php artisan vendor:publish --tag=erp-integration-hub-config
```

Key settings in `config/erp-integration-hub.php`:

```
'drivers' => [
    'business_central' => [...],
    'dynamics_finance' => [...],
    'supply_chain'     => [...],
    'sap'              => [...],
    'odoo'             => [...],
    'erpnext'          => [...],
    'custom'           => [...],
],

'queue' => [
    'connection' => env('QUEUE_CONNECTION', 'redis'),
    'name'       => 'dynamics-sync',
    'workers'    => env('ERP_SYNC_WORKERS', 3),
],
```

REST API
--------

[](#rest-api)

All endpoints are prefixed with `/api/erp-integration-hub` and require Sanctum authentication.

MethodEndpointDescription`GET``/connections`List ERP connections`POST``/connections`Create a connection`POST``/connections/{id}/test`Test credentials`GET``/sync-profiles`List sync profiles`POST``/sync/run/{profileId}`Run a sync`GET``/monitoring/dashboard`Dashboard stats`GET``/logs`Sync logs`POST``/sync/retry-all`Retry all failed jobs> Full API reference in the [documentation](https://mostafax2.github.io/ERP-Integration-Hub/index.html).

Artisan Commands
----------------

[](#artisan-commands)

```
# Install the package (first-time setup)
php artisan erp-integration-hub:install

# Run a sync profile manually
php artisan erp-integration-hub:sync {profileId}

# Process due scheduled syncs
php artisan erp-integration-hub:schedule-run
```

Security &amp; Permissions
--------------------------

[](#security--permissions)

The package ships with `spatie/laravel-permission` integration and 3 default roles:

RolePermissions`erp_admin`Full access`erp_operator`Manage syncs and connections`erp_viewer`Read-only accessArchitecture
------------

[](#architecture)

```
src/
├── Actions/           # Single-responsibility business actions
├── Authentication/    # Microsoft OAuth client + token manager
├── Connections/
│   ├── Drivers/       # ERP-specific drivers (OData, JSON-RPC, REST)
│   └── ErpConnectionManager.php
├── Console/Commands/  # Artisan commands
├── Contracts/         # Interfaces
├── DTOs/              # Data Transfer Objects
├── Events/            # Sync lifecycle events
├── Exceptions/
├── Facades/           # ErpIntegrationHub facade
├── FieldMapping/      # Mapping engine + 9 transformers
├── Http/              # Controllers, Requests, Resources
├── Jobs/              # Queue jobs
├── Models/            # Eloquent models
├── Monitoring/        # Dashboard stats service
├── Notifications/     # Mail / Slack / database
├── Providers/         # Service provider
├── Repositories/
├── Scheduler/
├── Security/          # Policy + permission manager
└── Services/          # Sync orchestrator

```

Documentation
-------------

[](#documentation)

LanguageLinkEnglishالعربيةLicense
-------

[](#license)

MIT — © [Mostafa Elbayyar](mailto:mostafa.m.elbiar2@gmail.com)

###  Health Score

21

↑

LowBetter than 18% of packages

Maintenance65

Regular maintenance activity

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/146624906?v=4)[Mostafa Elbayyar](/maintainers/mostafax2)[@mostafax2](https://github.com/mostafax2)

---

Top Contributors

[![mostafax2](https://avatars.githubusercontent.com/u/146624906?v=4)](https://github.com/mostafax2 "mostafax2 (1 commits)")

### Embed Badge

![Health badge](/badges/mostafax-erp-integration-hub/health.svg)

```
[![Health](https://phpackages.com/badges/mostafax-erp-integration-hub/health.svg)](https://phpackages.com/packages/mostafax-erp-integration-hub)
```

PHPackages © 2026

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