Klanten

Klanten zijn te beheren via de controller 'debtor'.


add

Middels deze functie is het mogelijk een klant toe te voegen.


Invoerparameters:


Veldnaam Waarde Omschrijving
DebtorCode string Het klantnummer
Geef deze parameter niet mee wanneer het klantnummer automatisch bepaald mag worden.
CompanyName string Bedrijfsnaam
CompanyNumber string KvK-nummer
TaxNumber string BTW-nummer
Sex 'm', 'f', 'd', 'fam' of 'u' 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
MobileNumber string Mobielnummer
FaxNumber string Fax nummer
Comment text Opmerking / commentaar
InvoiceMethod int Factuur verzendmethode, zie variabelen-lijst.
Standaard: '0' (per e-mail]
DirectDebitApplyTo 'none', 'invoices', 'subscriptions', 'all' Betalen via automatisch incasso, standaard: 'none'
MandateID string Machtigingskenmerk
MandateDate date Datum ondertekening, standaard: vandaag
AccountNumber string Bankrekeningnummer (IBAN)
MandateCreationType 'manual', 'automatic' Gebruik 'manual' om een incasso machtiging aan te maken met eigen invoer voor MandateID, MandateDate and AccountNumber.
Gebruik 'automatic' om een machtingsverzoek naar de klant te versturen per mail.
Wanneer Mollie actief is, is dit veld vereist. Zonder Mollie incasso is dit veld ongebruikt.
AccountName string Rekeninghouder
AccountBank string Naam van de bank
AccountCity string Vestigingsplaats bank
AccountBIC string BIC Code
Mailing 'yes', 'no' of 'unsubscribed' Klant wil mailings ontvangen
InvoiceTerm int Afwijkende betalingstermijn.
PeriodicInvoiceDays '-1' of 'int' '-1' gebruikt de standaard instellingen
PaymentMail '-1' of 'int' '-1' gebruikt de standaard instellingen
LanguageCode string Huisstijl. Leeglaten betekent standaard huisstijl.
Currency string Valuta, zie variabelen-lijst.
CustomTaxCode string Afwijkende BTW-code. Leeglaten betekent niet afwijkend
ReminderEmailAddress string Afwijkende e-mailadres voor herinnering & aanmaning
Groups array array met ID's van klantgroepen of lege string voor geen klantgroepen
CustomFields array array met eigen velden. De key van de array komt overeen met de veldcode, de value met de waarde
Verplichte velden: CompanyName of SurName
Let op: de velden MandateId, MandateDate, AccountNumber, AccountName, AccountBank, AccountCity en AccountBIC werken niet wanneer Mollie incasso actief is.

Voorbeeld invoer:


$parameters = [
    "CompanyName" => "Jan Janssen B.V.",
    "CompanyNumber" => "123456789",
    "TaxNumber" => "NL123456789B01",
    "Sex" => "m",
    "Initials" => "Jan",
    "SurName" => "Janssen",
    "Address" => "Keizersgracht 100",
    "ZipCode" => "1015 AA",
    "City" => "Amsterdam",
    "Country" => "NL",
    "EmailAddress" => "info@example.com",
    "PhoneNumber" => "010 - 22 33 44",
    "Groups" => [
        1
    ]
];

$api->sendRequest('debtor', 'add', $parameters);

Voorbeeld uitvoer:


Array
(
    [controller] => debtor
    [action] => add
    [status] => success
    [date] => 2024-01-21T12:00:00+02:00
    [debtor] => Array
        (
            [Identifier] => 1
            [DebtorCode] => DB10000
            [CompanyName] => Jan Janssen B.V.
            [CompanyNumber] => 123456789
            [TaxNumber] => NL123456789B01
            [Sex] => m
            [Initials] => Jan
            [SurName] => Janssen
            [Address] => Keizersgracht 100
            [ZipCode] => 1015 AA
            [City] => Amsterdam
            [Country] => NL
            [EmailAddress] => info@example.com
            [PhoneNumber] => 010 - 22 33 44
            [MobileNumber] => 
            [FaxNumber] => 
            [Comment] => 
            [InvoiceMethod] => 0
            [DirectDebitApplyTo] => none
            [InvoiceAuthorisation] => no
            [MandateDate] => 
            [MandateID] => 
            [AccountNumber] => 
            [AccountIban] => 
            [AccountBIC] => 
            [AccountName] => 
            [AccountBank] => 
            [AccountCity] => 
            [Mailing] => yes
            [InvoiceTerm] => -1
            [PeriodicInvoiceDays] => -1
            [PaymentMail] => -1
            [LanguageCode] => nl_nl
            [Currency] => EUR
            [CustomTaxCode] => 
            [ReminderEmailAddress] => 
            [Groups] => Array
                (
                    [1] => Array
                        (
                            [id] => 1
                            [GroupName] => Laadpaal
                        )

                )

            [Created] => 2024-01-21 11:00:00
            [Modified] => 2024-01-21 11:00:00
            [DefaultBillingContactId] => 0
            [DefaultQuoteContactId] => 0
            [ExtraClientContacts] => Array
                (
                )

            [InvoiceDataForPriceQuote] => no
            [InvoiceCompanyName] => 
            [InvoiceSex] => m
            [InvoiceInitials] => 
            [InvoiceSurName] => 
            [InvoiceAddress] => 
            [InvoiceZipCode] => 
            [InvoiceCity] => 
            [InvoiceCountry] => NL
            [InvoiceEmailAddress] => 
            [Translations] => Array
                (
                    [Country] => Nederland
                    [InvoiceMethod] => Per e‑mail
                    [InvoiceCountry] => Nederland
                    [LanguageLabel] => Nederlands
                )

        )

)