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
Verplichte velden: CompanyName of SurName

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
                )

        )

)