HostFact API versie 3.1
Crediteuren
Crediteuren zijn te beheren via de controller 'creditor'.
add
Middels deze functie is het mogelijk een crediteur toe te voegen.
Voorbeeldbestand: /voorbeelden/creditor/creditor.add.php
Invoerparameters:
Veldnaam | Waarde | Omschrijving |
---|---|---|
CreditorCode | string | Eigen/intern crediteurnummer Geef deze parameter niet mee wanneer het crediteurnummer automatisch bepaald mag worden. |
MyCustomerCode | string | Klantnummer toegewezen door de crediteur |
CompanyName | string | Bedrijfsnaam |
CompanyNumber | string | KvK-nummer |
TaxNumber | string | BTW-nummer |
Sex | 'm' of 'f' | Geslacht, standaard: 'm' |
Initials | string | Voorletters |
SurName | string | Achternaam |
Address | string | Adres |
ZipCode | string | Postcode |
City | string | Plaats |
Country | string | Land, zie variabelen-lijst |
EmailAddress | string | E-mailadres |
PhoneNumber | string | Telefoonnummer |
MobileNumber | string | Mobielnummer |
FaxNumber | string | Fax nummer |
Comment | text | Opmerking / commentaar |
Authorisation | 'yes' of 'no' | Betalen via automatisch incasso, standaard: 'no' |
AccountNumber | string | Bankrekeningnummer (IBAN) |
AccountName | string | Rekeninghouder |
AccountBank | string | Naam van de bank |
AccountCity | string | Vestigingsplaats bank |
AccountBIC | string | BIC Code |
Term | int | Betaaltermijn |
groups | array | array met ID's van crediteurgroepen of lege string voor geen crediteurgroepen |
Voorbeeld invoer:
<?php require_once("../hostfact_api.php"); $api = new HostFactAPI(); $creditorParams = array( 'CompanyName' => 'Supplier 1', 'Initials' => 'Curtis', 'SurName' => 'Johnson', 'Sex' => 'm', 'Address' => 'Adalbertstrasse 1', 'ZipCode' => '10999', 'City' => 'Berlin', 'Country' => 'DE', 'EmailAddress' => 'billing@supplier.de' ); $response = $api->sendRequest('creditor', 'add', $creditorParams); print_r_pre($response); ?>
Voorbeeld uitvoer:
Array ( [controller] => creditor [action] => add [status] => success [date] => 2022-11-24T12:00:00+02:00 [creditor] => Array ( [Identifier] => 3 [CreditorCode] => CD0003 [MyCustomerCode] => [CompanyName] => Supplier 1 [CompanyNumber] => [TaxNumber] => [Sex] => m [Initials] => Curtis [SurName] => Johnson [Address] => Adalbertstrasse 1 [ZipCode] => 10999 [City] => Berlin [Country] => DE [EmailAddress] => billing@supplier.de [PhoneNumber] => [MobileNumber] => [FaxNumber] => [Comment] => [Authorisation] => no [AccountNumber] => [AccountBIC] => [AccountName] => [AccountBank] => [AccountCity] => [Term] => 0 [Groups] => Array ( ) [Created] => 2022-11-24 11:00:00 [Modified] => 2022-11-24 11:00:00 [Translations] => Array ( [Country] => Duitsland ) ) )