Download the PHP package mantix/eboekhouden-rest-api without Composer

On this page you can find all versions of the php package mantix/eboekhouden-rest-api. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package eboekhouden-rest-api

e-Boekhouden REST API Client voor PHP

Een moderne PHP client voor de nieuwe REST API van e-Boekhouden.

Installatie

Je kunt dit package installeren via Composer:

Configuratie

API-token aanmaken

Voordat je deze package kunt gebruiken, moet je eerst een API-token aanmaken in je e-Boekhouden account:

  1. Log in op je e-Boekhouden account
  2. Ga naar Beheer > API-tokens
  3. Klik op "Nieuw API-token toevoegen"
  4. Geef het token een naam en klik op "Aanmaken"
  5. Sla het token goed op, want het wordt maar één keer getoond

Basis gebruik

Filters gebruiken

Gebruik de Filter class om geavanceerde filters toe te passen op je API verzoeken:

Beschikbare filters

Deze library ondersteunt alle filters die beschikbaar zijn in de API. Hieronder een overzicht:

Tekst filters

Filter Methode Voorbeeld
Gelijk aan Filter::eq('waarde') 'code' => Filter::eq('REL001')
Niet gelijk aan Filter::notEq('waarde') 'type' => Filter::notEq('B')
Bevat Filter::like('%waarde%') 'name' => Filter::like('%Bedrijf%')
Begint met Filter::like('waarde%') 'name' => Filter::like('Bedrijf%')
Eindigt met Filter::like('%waarde') 'name' => Filter::like('%BV')
Bevat niet Filter::notLike('%waarde%') 'name' => Filter::notLike('%test%')

Numerieke filters

Filter Methode Voorbeeld
Gelijk aan Filter::eq(123) 'id' => Filter::eq(123)
Niet gelijk aan Filter::notEq(123) 'id' => Filter::notEq(123)
Groter dan Filter::gt(123) 'amount' => Filter::gt(100)
Groter dan of gelijk aan Filter::gte(123) 'amount' => Filter::gte(100)
Kleiner dan Filter::lt(123) 'amount' => Filter::lt(500)
Kleiner dan of gelijk aan Filter::lte(123) 'amount' => Filter::lte(500)
Bereik Filter::range(min, max) 'amount' => Filter::range(100, 500)

Datum filters

Filter Methode Voorbeeld
Gelijk aan Filter::eq('2023-01-01') 'date' => Filter::eq('2023-01-01')
Niet gelijk aan Filter::notEq('2023-01-01') 'date' => Filter::notEq('2023-01-01')
Na Filter::gt('2023-01-01') 'date' => Filter::gt('2023-01-01')
Op of na Filter::gte('2023-01-01') 'date' => Filter::gte('2023-01-01')
Voor Filter::lt('2023-01-01') 'date' => Filter::lt('2023-01-01')
Op of voor Filter::lte('2023-01-01') 'date' => Filter::lte('2023-01-01')
Bereik Filter::dateRange(start, eind) 'date' => Filter::dateRange('2023-01-01', '2023-12-31')

Beschikbare API methodes

Sessie beheer

Administratie

Kostenplaatsen

E-mail sjablonen

Facturen

Factuur sjablonen

Grootboekrekeningen

Mutaties

Producten

Relaties

Eenheden

Voorbeelden

Facturen aanmaken

Relaties aanmaken

Mutaties aanmaken

Paginering gebruiken

De meeste endpoints ondersteunen paginering met de limit en offset parameters:

Foutafhandeling

Gebruik try/catch blokken om API fouten af te handelen:

Error response verwerken

Wanneer er een fout optreedt, bevat het EBoekhoudenException object nuttige informatie:

Veelvoorkomende foutcodes

Hier zijn enkele veelvoorkomende foutcodes die je kunt tegenkomen:

Algemeen

Beveiliging

Relaties

Facturen

Mutaties

Grootboekrekeningen

Geavanceerd gebruik

Automatische herverbinding

Als je langlopende processen hebt waarbij de sessie kan verlopen, kun je automatische herverbinding implementeren:

Helper classes

Je kunt helper classes maken om complexe API-structuren eenvoudiger te maken:

Facturen downloaden als PDF

Je kunt de URL van de PDF-factuur ophalen en gebruiken om deze te downloaden:

Tips en best practices

Caching voor referentiedata

Cache gegevens zoals grootboeknummers en kostenplaatsen om herhaalde API-verzoeken te verminderen:

Batch-verwerking

Verwerk grote hoeveelheden gegevens in batches om binnen de API-limieten te blijven:

BTW-codes

Overzicht van beschikbare BTW-codes (Nederland):

Code Omschrijving Tarief Type
HOOG_VERK_21 BTW 21% 21% Verkoop
LAAG_VERK_9 BTW 9% 9% Verkoop
VERL_VERK Verlegd 21% 21% Verkoop
LAAG_INK_9 BTW 9% 9% Inkoop
HOOG_INK_21 BTW 21% 21% Inkoop
VERL_INK Verlegd 21% 21% Inkoop
GEEN Geen BTW 0% -

Mutatie types

Overzicht van beschikbare mutatie types:

Waarde Omschrijving
1 Inkoopfactuur
2 Verkoopfactuur
3 Inkoopfactuur betaling
4 Verkoopfactuur betaling
5 Geld ontvangen
6 Geld uitgegeven
7 Memoriaal boeking

Grootboekrekening categorieën

Overzicht van grootboekrekening categorieën:

Waarde Omschrijving
BAL Balans
VW Winst en verlies
AF6 Omzetbelasting laag tarief
AF19 Omzetbelasting hoog tarief
DEB Debiteuren
CRED Crediteuren

Bijdragen

Bijdragen aan dit package zijn altijd welkom! Of het nu gaat om bug reports, feature requests, of pull requests.

  1. Fork de repository
  2. Maak een feature branch (git checkout -b feature/amazing-feature)
  3. Commit je wijzigingen (git commit -m 'Add some amazing feature')
  4. Push naar de branch (git push origin feature/amazing-feature)
  5. Open een Pull Request

Tests

Dit package gebruikt PHPUnit voor tests. Je kunt de tests als volgt uitvoeren:

Licentie

Dit package is beschikbaar onder de MIT-licentie. Zie het LICENSE bestand voor meer informatie.


All versions of eboekhouden-rest-api with dependencies

PHP Build Version
Package Version
Requires php Version ^7.4|^8.0
guzzlehttp/guzzle Version ^7.0
ext-json Version *
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package mantix/eboekhouden-rest-api contains the following files

Loading the files please wait ...