PHPackages                             veiliglanceren/maakeenfactuur-laravel - 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. veiliglanceren/maakeenfactuur-laravel

ActiveLibrary[API Development](/categories/api)

veiliglanceren/maakeenfactuur-laravel
=====================================

Laravel package for easily connecting with MaakEenFactuur.nl

1.2.0(1y ago)235[2 PRs](https://github.com/VeiligLanceren-nl/maakeenfactuur-laravel/pulls)MITPHPPHP ^8.2CI passing

Since Jun 8Pushed 1y agoCompare

[ Source](https://github.com/VeiligLanceren-nl/maakeenfactuur-laravel)[ Packagist](https://packagist.org/packages/veiliglanceren/maakeenfactuur-laravel)[ Docs](https://github.com/VeiligLanceren-nl/maakeenfactuur-laravel)[ GitHub Sponsors](https://github.com/:vendor_name)[ RSS](/packages/veiliglanceren-maakeenfactuur-laravel/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (14)Versions (5)Used By (0)

MaakEenFactuur.nl Laravel package
=================================

[](#maakeenfactuurnl-laravel-package)

[![Maak Een Factuur Laravel API](/favicon.png)](/favicon.png)

📜 **Overview**
This Laravel package is a PHP library that provides simplified interfaces for managing customers and invoices via our API. It includes two primary facades: `Customer` and `Invoice`, which are backed by powerful service classes handling all interactions with the API.

- **Website**: [MaakEenFactuur.nl](https://maakeenfactuur.nl)
- **Documentatie**: [API documentatie](https://api.maakeenfactuur.nl/)
- **Supported Laravel versions**: 10, 11
- **Supported PHP versions**: > 8.2

Features
--------

[](#features)

- **Customer management**: Retrieve, create, and manage customer information.
- **Invoice processing**: Create, update, and fetch invoices.
- **Exception handling**: Error management to handle API responses.

[![Veilig Lanceren](/veilig-lanceren-logo.png)](/veilig-lanceren-logo.png)

This package is maintained by VeiligLanceren.nl, your partner in website development and everything else to power up your online company. More information available on [our website](https://veiliglanceren.nl).

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

[](#installation)

To use the Laravel package of MaakEenFactuur.nl in your project, require it via Composer in your terminal:

```
composer require veiliglanceren/maakeenfactuur-laravel
```

Configuration
-------------

[](#configuration)

The API key is handled by the `ApiService` of the package. Set up your API key to authenticate requests.

By default this will be loaded from the config file `config/maakeenfactuur.php` which can be exported by running:

```
php artisan vendor:publish --tag="maakeenfactuur-config"
```

This will add the default `.env` variable `MAAKEENFACTUUR_API_KEY` which can be set:

```
MAAKEENFACTUUR_API_KEY="YOUR_API_KEY"

```

Usage
-----

[](#usage)

### Managing Customers

[](#managing-customers)

```
use VeiligLanceren\MaakEenFactuur\Facades\Customer;

// Fetch all customers
$customers = Customer::all();

// Create a new customer
$newCustomer = Customer::create(['name' => 'John Doe', 'email' => 'john@example.com']);

// Find a specific customer
$customer = Customer::find(1);
```

### Handling Invoices

[](#handling-invoices)

```
use VeiligLanceren\MaakEenFactuur\Facades\Invoice;

// Create an invoice
$newInvoice = Invoice::create(['customer_id' => 1, 'amount' => 100.00]);

// Update an existing invoice
$updatedInvoice = Invoice::update(1, ['amount' => 150.00]);

// Fetch all invoices
$invoices = Invoice::all();

// Find a specific invoice
$invoice = Invoice::find(1);
```

Handling API Errors
-------------------

[](#handling-api-errors)

Both `Customer` and `Invoice` services throw an `ApiErrorException` if an API request fails, allowing you to handle errors gracefully in your application.

```
try {
    $invoice = Invoice::find(1);
} catch (VeiligLanceren\MaakEenFactuur\Exception\ApiErrorException $e) {
    // TODO: Handle error
    echo 'Error: ' . $e->getMessage();
}
```

Contributing
------------

[](#contributing)

Contributions are welcome! Please feel free to submit a pull request or create an issue if you have any suggestions or find any bugs.

License
-------

[](#license)

This project is licensed under the MIT License - see the [LICENSE.md](LICENSE) file for details.

This README is structured to provide a comprehensive introduction and guide on how to use the library, complete with installation instructions, usage examples, and basic error handling. Adjust the details according to your actual project structure and requirements.

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance40

Moderate activity, may be stable

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 54.9% 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 ~247 days

Total

2

Last Release

509d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/22b99c08291f57985d16a87bcd5f1a3f4ae2e6332b5e04736b5bf4f0f91c3d19?d=identicon)[VeiligLanceren](/maintainers/VeiligLanceren)

---

Top Contributors

[![NielsHamelink-web](https://avatars.githubusercontent.com/u/67690385?v=4)](https://github.com/NielsHamelink-web "NielsHamelink-web (50 commits)")[![Shadow48402](https://avatars.githubusercontent.com/u/4586181?v=4)](https://github.com/Shadow48402 "Shadow48402 (41 commits)")

---

Tags

laravelfactuurmaakeenfactuur-laravelveiliglancerenveiliglancerenfacturatie api

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/veiliglanceren-maakeenfactuur-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/veiliglanceren-maakeenfactuur-laravel/health.svg)](https://phpackages.com/packages/veiliglanceren-maakeenfactuur-laravel)
```

###  Alternatives

[dedoc/scramble

Automatic generation of API documentation for Laravel applications.

2.1k11.2M101](/packages/dedoc-scramble)[spatie/laravel-pdf

Create PDFs in Laravel apps

1.0k4.8M47](/packages/spatie-laravel-pdf)[defstudio/telegraph

A laravel facade to interact with Telegram Bots

816333.9k3](/packages/defstudio-telegraph)[rawilk/profile-filament-plugin

Profile & MFA starter kit for filament.

3914.6k](/packages/rawilk-profile-filament-plugin)[simplestats-io/laravel-client

Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof.

5022.0k](/packages/simplestats-io-laravel-client)[harris21/laravel-fuse

Circuit breaker for Laravel queue jobs. Protect your workers from cascading failures.

44855.7k](/packages/harris21-laravel-fuse)

PHPackages © 2026

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