abdellahchatioui/erp-connector

Bagisto Erp Connector Package

Maintainers

Package info

github.com/abdellahchatioui/erp-connector

pkg:composer/abdellahchatioui/erp-connector

Transparency log

Statistics

Installs: 10

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 1

Security

Advisories: 0

Aikido package health analysis

v3.0.0 2026-05-26 11:34 UTC

Requires

  • php: ^8.0

MIT d1294de459f8f1ba089f545f4d79bb23f06575c8

  • Your Name <your.email.woop@example.com>

Published on Packagist.org on 2026-05-26 11:37 UTC

This package is auto-updated.

Last update: 2026-07-15 21:57:19 UTC

README

A powerful, secure integration package for Bagisto that enables seamless synchronization between your e-commerce store and an external ERP system.

Features

  • Admin UI Configuration: Configure your ERP connection directly from the Bagisto Admin Panel.
  • Secure Token Storage: API tokens are securely encrypted before being stored in the database.
  • Connectivity Testing: Built-in "Test Connection" tool to verify your ERP backend is reachable.
  • Product Synchronization: Receive product updates from your ERP via secure webhooks.
  • Order Synchronization: Automatically push order details to your ERP via event listeners when an order is placed.
  • Secure Webhooks: Built-in middleware to verify API tokens for all incoming requests.

Requirements

  • Server: Apache 2 or NGINX
  • Node.js: 23.10.0 LTS or higher
  • PHP: 8.3 or higher
  • Composer: 2.5 or higher
  • MySQL: Version 8.0.32 or higher
  • Keycloak: Running and accessible for JWT authentication

Installation

1. Install via Composer

In your Bagisto project root, run:

composer require abdellahchatioui/erp-connector:dev-main

2. Clear Cache

Clear the application cache so Bagisto auto-discovers the package and loads the new configuration UI:

php artisan optimize:clear
php artisan config:cache

Configuration

We have removed the need for .env variables! All configuration is now securely managed via the Admin Panel.

  1. Log into your Bagisto Admin Panel.
  2. Navigate to Settings > Configuration > ERP Connector.
  3. Enter your ERP Backend URL (e.g., http://localhost:8080).
  4. Enter your ERP Token.
  5. Click Save Settings.
  6. Click Test Connection to immediately verify that Bagisto can communicate with your ERP system.

API Endpoints

The package exposes the following webhook endpoints in Bagisto (prefixed with /api/erp):

Method Endpoint Description
POST /api/erp/webhook/product Sync product data from ERP
POST /api/erp/webhook/order Sync order data from ERP

Note: All requests sent to Bagisto must include the X-ERP-TOKEN header matching the token saved in your Admin settings.

License

The MIT License (MIT). Please see License File for more information.