PHPackages                             darvis/mkg-client - 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. [API Development](/categories/api)
4. /
5. darvis/mkg-client

ActiveLibrary[API Development](/categories/api)

darvis/mkg-client
=================

Framework-agnostic MKG Software REST API client with optional Laravel integration

v1.0.3(1mo ago)013MITPHPPHP ^8.2

Since Mar 19Pushed 1mo agoCompare

[ Source](https://github.com/ArvidDeJong/mkg-client)[ Packagist](https://packagist.org/packages/darvis/mkg-client)[ Docs](https://darvis.nl)[ RSS](/packages/darvis-mkg-client/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (2)Dependencies (8)Versions (5)Used By (0)

darvis/mkg-client
=================

[](#darvismkg-client)

Framework-agnostic MKG REST API client with optional Laravel integration.

This API client is intended for MKG ERP:

It provides a typed service layer for common MKG documents:

- `arti` (articles)
- `debi` (debtors)
- `cprs` (contact persons)
- `vorh` (sales order headers)
- `vorr` (sales order lines)
- `vopa` (sales order line parameters)
- `adrs` (addresses)
- `rela` (relations)
- `gebr` (users)

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

[](#documentation)

- [Getting started](docs/GETTING_STARTED.md)
- [Configuration](docs/CONFIGURATION.md)
- [Verification (curl + Postman)](docs/VERIFICATION.md)
- [Usage examples](docs/USAGE.md)
- [Migration notes](docs/MIGRATION.md)
- [Troubleshooting](docs/TROUBLESHOOTING.md)
- [API reference](docs/API_REFERENCE.md)

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

[](#requirements)

- PHP 8.2+
- Valid MKG API credentials

For Laravel integration, use Laravel 11, 12, or 13.

Installation
------------

[](#installation)

### Packagist

[](#packagist)

```
composer require darvis/mkg-client
```

### Local path repository

[](#local-path-repository)

```
{
  "repositories": {
    "darvis-mkg-client": {
      "type": "path",
      "url": "../Packages/mkg-client"
    }
  },
  "require": {
    "darvis/mkg-client": "*"
  }
}
```

Then run:

```
composer update darvis/mkg-client
```

### Laravel: publish package assets

[](#laravel-publish-package-assets)

Publish config and CSV metadata:

```
php artisan vendor:publish --tag=mkg-client
```

Or publish separately:

```
php artisan vendor:publish --tag=mkg-config
php artisan vendor:publish --tag=mkg-csv
```

Quick start
-----------

[](#quick-start)

Add to your `.env`:

```
MKG_URL_AUTH=https://your-mkg-host/restapi/auth
MKG_URL_PROD=https://your-mkg-host/restapi
MKG_CUSTOMER=your-customer-code
MKG_USERNAME=your-api-username
MKG_PASSWORD=your-api-password
```

Laravel usage:

```
use Darvis\MkgClient\Services\DebtorsService;

$service = app(DebtorsService::class);
$rows = $service->findDebtorRowsByNumberNameOrEmail('10001');
```

Plain PHP usage:

```
use Darvis\MkgClient\Config\ArrayConfigProvider;
use Darvis\MkgClient\Services\DebtorsService;

$config = new ArrayConfigProvider([
  'mkg.url_auth' => 'https://your-mkg-host/restapi/auth',
  'mkg.url_prod' => 'https://your-mkg-host/restapi',
  'mkg.customer' => 'your-customer-code',
  'mkg.username' => 'your-api-username',
  'mkg.password' => 'your-api-password',
]);

$service = new DebtorsService(config: $config);
$rows = $service->findDebtorRowsByNumberNameOrEmail('10001');
```

Available services
------------------

[](#available-services)

- `Darvis\MkgClient\Services\ArticleService`
- `Darvis\MkgClient\Services\DebtorsService`
- `Darvis\MkgClient\Services\ContactpersonService`
- `Darvis\MkgClient\Services\OrdersService`
- `Darvis\MkgClient\Services\AddressesService`
- `Darvis\MkgClient\Services\RelationsService`
- `Darvis\MkgClient\Services\UserService`

Testing
-------

[](#testing)

This package uses Pest.

```
composer test
```

Official MKG resources
----------------------

[](#official-mkg-resources)

- [MKG API introduction](https://www.mkg.eu/nl-NL/mijn-mkg/support/kenniscentrum/id/4767/inleiding-tot-de-mkg-api)
- [MKG Getting Started](https://www.mkg.eu/nl-NL/mijn-mkg/support/kenniscentrum/id/6598/getting-started)
- [Official MKG API call guide](https://www.mkg.eu/nl-NL/mijn-mkg/support/kenniscentrum/id/10924/hoe-werken-mkg-api-aanroepen)
- [MKG Postman collection](https://www.mkg.eu/nl-NL/mijn-mkg/support/kenniscentrum/id/6032/api-postman-collectie)

Maintainer
----------

[](#maintainer)

This package is maintained by Arvid de Jong ().

License
-------

[](#license)

MIT

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance92

Actively maintained with recent releases

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 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.

###  Release Activity

Cadence

Every ~34 days

Total

4

Last Release

40d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/24c445b7580e09ff72b8340d1423886148c4c8a249d0a828c98285109e7e5663?d=identicon)[darvis](/maintainers/darvis)

---

Top Contributors

[![ArvidDeJong](https://avatars.githubusercontent.com/u/7394837?v=4)](https://github.com/ArvidDeJong "ArvidDeJong (6 commits)")

---

Tags

phplaravelapi clientERPdarvismkg

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/darvis-mkg-client/health.svg)

```
[![Health](https://phpackages.com/badges/darvis-mkg-client/health.svg)](https://phpackages.com/packages/darvis-mkg-client)
```

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.9k3.8M1.1k](/packages/statamic-cms)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3661.3M49](/packages/tencentcloud-tencentcloud-sdk-php)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

293.1k](/packages/eslazarev-wildberries-sdk)[resend/resend-php

Resend PHP library.

608.3M51](/packages/resend-resend-php)[scriptdevelop/whatsapp-manager

Paquete para manejo de WhatsApp Business API en Laravel

793.9k](/packages/scriptdevelop-whatsapp-manager)[files.com/files-php-sdk

Files.com PHP SDK

2482.9k](/packages/filescom-files-php-sdk)

PHPackages © 2026

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