PHP package for WeFact

This package provides a fluent interface to communicate with the WeFact API. For the full documentation of the WeFact API, please visit https://www.wefact.nl/api/.

Table of Contents

Minimum requirements
Installation
Usage
Available methods
Testing
Changelog
Contributing
Security Vulnerabilities
Credits
License

Minimum requirements

PHP 8.1 or higher
Guzzle 7.0 or higher

Installation

You can install the package via composer:

composer require vormkracht10/wefact-php

Usage

Then you can use the package like this:

$weFact = new \Vormkracht10\WeFact\WeFact('your-api-key');

$response = $weFact->invoices()->list();
// or use listAll to call the show method for each item
$response = $weFact->invoices()->listAll();

if (isset($response['invoices'])) {
  print_r($response['invoices']);
}

Available methods

Creditor

List creditors

$response = $weFact->creditors()->list();
// or use listAll to call the show method for each item
$response = $weFact->creditors()->listAll();

if (isset($response['creditors'])) {
  print_r($response['creditors']);
}

Create creditor

Required parameters: CompanyName or SurName.

$response = $weFact->creditors()->create([
    'CompanyName' => 'Your company name',
  ]);
if ($result['status'] == 'success') {
  print_r($response['company']);
}

Update creditor

Required parameter: Identifier or CreditorCode.

$result = $weFact->creditors()->edit([
    'Identifier' => $creditorId,
    'CompanyName' => 'Your company name',
  ]);

if ($result['status'] == 'error') {
  // Something went wrong
  print_r($result['errors']);
}

Show creditor

Required parameter: Identifier or CreditorCode.

$weFact->creditors()->show(['Identifier' => $creditorId]);
// or
$weFact->creditors()->show(['CreditorCode' => $creditorCode]);

Delete creditor

Required parameter: Identifier or CreditorCode.

$weFact->creditors()->delete(['Identifier' => $creditorId]);
// or
$weFact->creditors()->delete(['CreditorCode' => $creditorCode]);

Credit Invoice

List credit invoices

$weFact->creditInvoices()->list();
// or use listAll to call the show method for each item
$response = $weFact->creditInvoices()->listAll();

Create credit invoice

Required parameters: InvoiceCode, Creditor or CreditorCode and InvoiceLines.

$weFact->creditInvoices()->create([
    'InvoiceCode' => 'your-invoice-code',
    'CreditorCode' => 'CD10001'
    'InvoiceLines' => [
        [
            'Description' => 'Your description',
            'PriceExcl' => 10,
        ],
    ],
  ])

Update credit invoice

Required parameter: Identifier or CreditInvoiceCode.

$weFact->creditInvoices()->edit([
    'Identifier' => $creditInvoiceId,
    'Comment' => 'Your comment',
  ])

Show credit invoice

Required parameter: Identifier or CreditInvoiceCode.

$weFact->creditInvoices()->show(['Identifier' => $creditInvoiceId]);
// or
$weFact->creditInvoices()->show(['CreditInvoiceCode' => $creditInvoiceCode]);

Delete credit invoice

Required parameter: Identifier or CreditInvoiceCode.

$weFact->creditInvoices()->delete(['Identifier' => $creditInvoiceId]);
// or
$weFact->creditInvoices()->delete(['CreditInvoiceCode' => $creditInvoiceCode]);

Debtor

List debtors

$weFact->debtors()->list();
// or use listAll to call the show method for each item
$response = $weFact->debtors()->listAll();

You can also search for debtors:

$weFact->debtors()->list([
  'searchat' => 'EmailAddress',
  'searchfor' => 'example@example.com'
]);

Create debtor

Required parameters: CompanyName or SurName.

$weFact->debtors()->create([
    'CompanyName' => 'Your company name',
  ])

Update debtor

Required parameter: Identifier or DebtorCode, CompanyName or SurName.

$weFact->debtors()->edit([
    'Identifier' => $debtorId,
    'CompanyName' => 'Your company name',
  ])

Show debtor

Required parameter: Identifier or DebtorCode.

$weFact->debtors()->show(['Identifier' => $debtorId]);
// or
$weFact->debtors()->show(['DebtorCode' => $debtorCode]);

Group

List groups

Required parameter: Type.

$weFact->groups()->list([
    'type' => 'debtor',
]);

Create group

Required parameters: Type and GroupName.

$weFact->groups()->create([
    'Type' => 'debtor',
    'GroupName' => 'Your group name',
  ])

Update group

Required parameter: Identifier.

$weFact->groups()->edit([
    'Identifier' => $groupId,
    'GroupName' => 'Your group name',
  ])

Show group

Required parameter: Identifier.

$weFact->groups()->show(['Identifier' => $groupId]);

Delete group

Required parameter: Identifier.

$weFact->groups()->delete(['Identifier' => $groupId]);

Invoice

List invoices

$weFact->invoices()->list();
// or use listAll to call the show method for each item
$response = $weFact->invoices()->listAll();