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

ActiveLibrary

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 1mo ago

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

32

—

LowBetter than 72% of packages

Maintenance43

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

456d 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

[vormkracht10/laravel-mails

Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app.

24149.7k](/packages/vormkracht10-laravel-mails)[spatie/laravel-prometheus

Export Laravel metrics to Prometheus

2651.3M6](/packages/spatie-laravel-prometheus)[hydrat/filament-table-layout-toggle

Filament plugin adding a toggle button to tables, allowing user to switch between Grid and Table layouts.

6292.3k1](/packages/hydrat-filament-table-layout-toggle)[scalar/laravel

Render your OpenAPI-based API reference

6183.9k2](/packages/scalar-laravel)[ralphjsmit/laravel-helpers

A package containing handy helpers for your Laravel-application.

13704.6k2](/packages/ralphjsmit-laravel-helpers)[musahmusah/laravel-multipayment-gateways

A Laravel Package that makes implementation of multiple payment Gateways endpoints and webhooks seamless

852.2k1](/packages/musahmusah-laravel-multipayment-gateways)

PHPackages © 2026

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