PHPackages                             sivehost/openemr-medilinksa - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. sivehost/openemr-medilinksa

ActiveOpenemr-module[Utility &amp; Helpers](/categories/utility)

sivehost/openemr-medilinksa
===========================

OpenEMR Custom Module MedilinkSA switch connector

00PHP

Since Mar 9Pushed 1y ago1 watchersCompare

[ Source](https://github.com/sivehost/openemr-medilinksa)[ Packagist](https://packagist.org/packages/sivehost/openemr-medilinksa)[ RSS](/packages/sivehost-openemr-medilinksa/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

**📌 MedilinkSA Module for OpenEMR**
===================================

[](#-medilinksa-module-for-openemr)

**Seamlessly integrate MedilinkSA with OpenEMR for medical aid verification and claims processing.**

[![Claim Status Graph](https://github.com/sivehost/openemr-medilinksa/raw/main/Graphs1.png?raw=true)](https://github.com/sivehost/openemr-medilinksa/blob/main/Graphs1.png?raw=true)

[![Invoice PDF Export](https://github.com/sivehost/openemr-medilinksa/raw/main/invoicePDF.png?raw=true)](https://github.com/sivehost/openemr-medilinksa/blob/main/invoicePDF.png?raw=true)

[![Invoice Status Graph](https://github.com/sivehost/openemr-medilinksa/raw/main/Graphs2.png?raw=true)](https://github.com/sivehost/openemr-medilinksa/blob/main/Graphs2.png?raw=true)

[![Claims page](https://github.com/sivehost/openemr-medilinksa/raw/main/claims.png?raw=true)](https://github.com/sivehost/openemr-medilinksa/blob/main/claims.png?raw=true)

[![Invoices page](https://github.com/sivehost/openemr-medilinksa/raw/main/invoices.png?raw=true)](https://github.com/sivehost/openemr-medilinksa/blob/main/invoices.png?raw=true)

[![Config page](https://github.com/sivehost/openemr-medilinksa/raw/main/config.png?raw=true)](https://github.com/sivehost/openemr-medilinksa/blob/main/config.png?raw=true)

This module connects OpenEMR to the **MedilinkSA switch**, enabling healthcare providers to:
✔ **Submit medical claims**
✔ **Trace claim statuses**
✔ **Reverse claims**
✔ **Check real-time medical aid membership status**

### **📡 Supported Features**

[](#-supported-features)

✅ **Real-time membership verification**
✅ **Automatic claims submission**
✅ **Claim tracing &amp; reversals**
✅ **Seamless background service integration**

---

**🚀 Getting Started**
---------------------

[](#-getting-started)

### **Step 1: Obtain API Credentials**

[](#step-1-obtain-api-credentials)

To use this module, **register at [MedilinkSA.co.za](https://medilinksa.co.za)** to obtain:

- **Client ID**
- **Username**
- **Password**
- **Production API URLs**

Once set up, you can **check membership status, submit claims, trace, reverse, and more.**

---

**⚙️ How It Works**
-------------------

[](#️-how-it-works)

This module integrates **background services** to automate claim processing and medical aid status checks.

### **🏥 Medical Aid Status Checks**

[](#-medical-aid-status-checks)

🔹 **Manual Check:**

- Go to the **Membership tab**
- Enter the **Medical Aid Number**
- Click **Check**

🔹 **Automatic Check:**

- **During patient creation**, the module **automatically verifies membership**.

### **📨 Claims Processing**

[](#-claims-processing)

✔ **Auto-send claims to MedilinkSA**
✔ **Trace claim statuses**
✔ **Reverse claims when necessary**
✔ **Store claim responses in OpenEMR for easy tracking**

---

**📄 Database Changes**
----------------------

[](#-database-changes)

This module **creates new tables** to store:

- **Claim data**
- **Response JSONs**
- **Trace logs**
- **Membership verification details**

Additionally, it registers **entries in `background_services`** to enable:
✅ **Automatic claim submission**
✅ **Claim tracing**
✅ **Real-time medical aid status checks**

---

**📥 Installation**
------------------

[](#-installation)

### **Method 1: Manual Upload**

[](#method-1-manual-upload)

1. **Download the latest release** from [GitHub Releases](https://github.com/sivehost/openemr-medilinksa). Or inside the \*\*interface/modules/custom-modules/ \*\* directory, do git clone  then mv openemr-medilinksa to MedilinkSA, then skip #3 below.
2. Go to \*\*interface/modules/custom-modules/ \*\* in OpenEMR directory, create a new folder MedilinkSA.
3. Then **Upload openemr-medilinksa Zip file contents into the MedilinkSA directory** and select the ZIP file called openemr-medilinksa, extract its contents into MedilinkSA directory.
4. Login to the OpenEMR system, In OpenEMR go to **Modules -&gt; Manage Modules -&gt; Unregistered tab** and click install on the MedilinkSA row, then go to registered and click Install and then Enable, select. It should now appear under Modules menu.

### **Method 2: Composer Installation (Packagist)**

[](#method-2-composer-installation-packagist)

The module is published on **Packagist**, install via Composer:

```
composer require sivehost/openemr-medilinksa
```

Then register, install and enable the module in OpenEMR.

---

**🔧 Configuration**
-------------------

[](#-configuration)

1. Navigate to **Admin → Globals → MedilinkSA Settings**.
2. Enter your **API credentials**.
3. Configure settings for:
    - **Automatic claims processing**
    - **Membership verification**
    - **Background claim submission**

Once configured, the module **automates medical aid validation and claim submissions**.

---

**🤝 Contributing**
------------------

[](#-contributing)

We welcome contributions! 🚀

- **Found a bug?** Open an issue in GitHub.
- **Want to improve the module?** Submit a pull request.

To contribute:

```
git clone https://github.com/sivehost/openemr-medilinksa.git
cd openemr-medilinksa
git checkout -b feature-branch
```

Make your changes, commit, and submit a pull request.

---

**📜 License**
-------------

[](#-license)

This module is licensed under the **GNU General Public License v3.0**.
See [LICENSE](https://github.com/sivehost/openemr-medilinksa/blob/main/LICENSE) for details.

---

**📞 Support**
-------------

[](#-support)

For help, visit:

- **OpenEMR Community Forum**:
- **Official Documentation**:
- **Sive.Host Support**: [https://Sive.Host/](https://sive.host/)

---

### **📢 Ready to Automate Your Medical Billing?**

[](#-ready-to-automate-your-medical-billing)

➡ **[Download the latest version](https://github.com/sivehost/openemr-medilinksa/releases)** and streamline your workflow today! 🚀

###  Health Score

14

—

LowBetter than 2% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity15

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://www.gravatar.com/avatar/08613b5d0468ff69d13a23b50614e16f022ec2b2afb116a53e404096865f0f39?d=identicon)[sivehost](/maintainers/sivehost)

---

Top Contributors

[![sivehost](https://avatars.githubusercontent.com/u/66014725?v=4)](https://github.com/sivehost "sivehost (11 commits)")

### Embed Badge

![Health badge](/badges/sivehost-openemr-medilinksa/health.svg)

```
[![Health](https://phpackages.com/badges/sivehost-openemr-medilinksa/health.svg)](https://phpackages.com/packages/sivehost-openemr-medilinksa)
```

###  Alternatives

[praetorius/vite-asset-collector

Use AssetCollector to embed frontend assets generated by vite

52255.0k1](/packages/praetorius-vite-asset-collector)

PHPackages © 2026

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