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

[illuminate/conditionable

The Illuminate Conditionable package.

9043.1M32](/packages/illuminate-conditionable)[codingfreaks/cf-cookiemanager

Manage cookies, scripts, and GDPR compliance on your Typo3 website with CodingFreaks Typo3 Cookie Manager. Customize cookie banners, streamline workflow, and enhance user experience. Ensure GDPR compliance and take control of cookie management with our Typo3 cookie management extension. Visit the official Typo3 Documentation page to learn more.

1625.8k](/packages/codingfreaks-cf-cookiemanager)

PHPackages © 2026

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