PHPackages                             mijnkantoor/nmbrs - 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. mijnkantoor/nmbrs

ActiveLibrary[API Development](/categories/api)

mijnkantoor/nmbrs
=================

SDK to consume NMBRS API in PHP

v2.0.0(1y ago)29.5k↓42.5%4[1 issues](https://github.com/rensreinders/hellohi.connector.nmbrs/issues)[1 PRs](https://github.com/rensreinders/hellohi.connector.nmbrs/pulls)MITPHPPHP >=8.0

Since Nov 19Pushed 1y ago4 watchersCompare

[ Source](https://github.com/rensreinders/hellohi.connector.nmbrs)[ Packagist](https://packagist.org/packages/mijnkantoor/nmbrs)[ RSS](/packages/mijnkantoor-nmbrs/feed)WikiDiscussions production Synced 1mo ago

READMEChangelog (10)DependenciesVersions (18)Used By (0)

NMBRS SDK PHP
=============

[](#nmbrs-sdk-php)

Init the client
---------------

[](#init-the-client)

> Note: the user should have access to all the resource in nmbrs. You can manage this trough user templates.

```
use Mijnkantoor\NMBRS\NmbrsClient;
include(__DIR__ . "/vendor/autoload.php");
$client = new \Mijnkantoor\NMBRS\NmbrsClient("your-email-here", "your-token-here", "your-domai-here");
```

Create a company
================

[](#create-a-company)

> Note: every company belongs to a debtor, so we creat that object first

**First create a debtor**

```
$highestDebNumber = $highestDebNumber = $client->getHighestDebtorNumber();
$debtor = $client->createDebtor('Some debtor', $highestDebNumber + 1));
```

**Create a company for the debtor**

```
$highestDebNumber = $client->getHighestDebtorNumber();
$client->createDebtor('Some client', $highestDebNumber + 1);

$highestCompanyNumber = $client->getHighestCompanyNumber();
$company = $client->createCompanyForDeptor($debtor->Id, [
    'Number' => $highestCompanyNumber,
    'CompanyName' => 'Some Company',
    'PeriodType' => NmbrsClient::DeclarationPeriodMonth,
    'DefaultCompanyId' => -1,
    'LabourAgreementSettingsGroupGuid' => '00000000-0000-0000-0000-000000000000',
    'PayInAdvance' => false
]);
```

**Create an address for company**

```
$address = $client->createAddressForCompany($company->Id, [
    'Default' => true,
    'Street' => 'Some Street',
    'HouseNumber' => '123',
    'HouseNumberAddition' => 'A',
    'PostalCode' => '1234 AB',
    'City' => 'Some City',
    'StateProvince' => 'Some Province',
    'CountryISOCode' => 'nl',
]);
```

**Create a bank account**

```
$bankAccount = $client->createBankAccountForCompany($company->id, [
    'Description' => 'Test rekening',
    'IBAN' => 'GB33BUKB20201555555555',
    'BIC' => 'ABNANL2A',
    'City' => 'TestDorp',
    'Name' => 'Henk',
    'Type' => 'Standaard',
]);
```

Update a company
----------------

[](#update-a-company)

**First update debtor**

```
$client->updateDebtor($debtor->id, ['Name' => 'Other Debtor']);
```

**Update the company**

```
// oops, doesn't exist at nmbrs API
```

**Update an address for company**

> Note: the update is in fact a delete and insert, so there is a new addressId on every update

```
$currentAddress = $client->getCurrentAddressByCompanyId($company->id));

$client->updateAddressForCompany($company->id, $currentAddress->id, [
    'Default' => true,
    'Street' => 'Other Street',
    'HouseNumber' => '123',
    'HouseNumberAddition' => 'A',
    'PostalCode' => '1234 AB',
    'City' => 'Other City',
    'StateProvince' => 'Other Province',
    'CountryISOCode' => 'nl',
]);
```

**Update the default bankaccount for a company**

```
$currentBankAccount = $client->getDefaultBankAccountForCompany($company->id);

$client->updateBankAccountForCompany($company->id, $currentBankAccount->id, [
    'Description' => 'Test rekeninger',
    'IBAN' => 'NL70RABO4636681924',
    'Type' => 'Standaard',
]);
```

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance30

Infrequent updates — may be unmaintained

Popularity30

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 69.6% 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 ~107 days

Recently: every ~352 days

Total

15

Last Release

502d ago

Major Versions

1.3.1 → v2.0.02025-01-02

PHP version history (2 changes)v1.0PHP >=7.1

v2.0.0PHP >=8.0

### Community

Maintainers

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

---

Top Contributors

[![rensreinders](https://avatars.githubusercontent.com/u/34097615?v=4)](https://github.com/rensreinders "rensreinders (16 commits)")[![agneshoving](https://avatars.githubusercontent.com/u/12156883?v=4)](https://github.com/agneshoving "agneshoving (5 commits)")[![mfrankruijter](https://avatars.githubusercontent.com/u/8653925?v=4)](https://github.com/mfrankruijter "mfrankruijter (2 commits)")

### Embed Badge

![Health badge](/badges/mijnkantoor-nmbrs/health.svg)

```
[![Health](https://phpackages.com/badges/mijnkantoor-nmbrs/health.svg)](https://phpackages.com/packages/mijnkantoor-nmbrs)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[facebook/php-business-sdk

PHP SDK for Facebook Business

90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

74513.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

265103.1M454](/packages/google-gax)[google/common-protos

Google API Common Protos for PHP

173103.7M50](/packages/google-common-protos)

PHPackages © 2026

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