HostFact API versie 3.1



Contacten

Contacten zijn te beheren via de controller 'handle'.



add

Middels deze functie is het mogelijk een contact toe te voegen.
Voorbeeldbestand: /voorbeelden/handle/handle.add.php


Invoerparameters:
Veldnaam Waarde Omschrijving
Handle string Het contactnummer
Registrar int Registrar Identifier
RegistrarHandle string Kenmerk bij registrar
Debtor int De unieke ID van een debiteur
DebtorCode int Het debiteurnummer
CompanyName string Bedrijfsnaam
CompanyNumber string KvK-nummer
LegalForm string Rechtsvorm, zie variabelen-lijst
TaxNumber string BTW-nummer
Sex string Geslacht. Standaard: 'm'
Initials string Voornaam
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
FaxNumber string Faxnummer
copyDataFromDebtor 'yes' of 'no' Contactgegevens overnemen van debiteur? Standaard: 'no'
copyDataFromHandle int Contactgegevens overnemen van bestaand contact? De unieke ID van een contact.
createAtRegistrar 'yes' of 'no' Maak contact aan bij registrar. Standaard: 'no'
Verplichte velden: Debtor of DebtorCode en CompanyName of SurName indien copyDataFromDebtor niet 'yes' is.


Voorbeeld invoer:
<?php

require_once("../hostfact_api.php");

$api = new HostFactAPI();

$handleParams = array(
			'DebtorCode'			=> 'DB0001',
			'copyDataFromDebtor'	=> 'yes'
);

$response = $api->sendRequest('handle', 'add', $handleParams);

print_r_pre($response);

?>

Voorbeeld uitvoer:
Array
(
    [controller] => handle
    [action] => add
    [status] => success
    [date] => 2022-11-24T12:00:00+02:00
    [success] => Array
        (
            [0] => Contact 'DB0001-002' is aangemaakt
        )

    [handle] => Array
        (
            [Identifier] => 2
            [Handle] => DB0001-002
            [Registrar] => 0
            [RegistrarHandle] => 
            [Debtor] => 1
            [DebtorCode] => DB0001
            [CompanyName] => Company X
            [CompanyNumber] => 123456789
            [LegalForm] => ANDERS
            [TaxNumber] => NL123456789B01
            [Sex] => m
            [Initials] => John
            [SurName] => Jackson
            [Address] => Keizersgracht 100
            [ZipCode] => 1015 AA
            [City] => Amsterdam
            [Country] => NL
            [EmailAddress] => info@company.com
            [PhoneNumber] => 010 - 22 33 44
            [FaxNumber] => 
            [Created] => 2022-11-24 11:00:00
            [Modified] => 2022-11-24 11:00:00
            [Translations] => Array
                (
                    [LegalForm] => Anders of onbekend
                    [Country] => Nederland
                    [RegistrarName] => 
                )

        )

)