Klanten

Klanten zijn te beheren via de controller 'debtor'.


edit

Met behulp van deze functie is het mogelijk om een klant te bewerken. Alleen ingevoerde parameters worden gewijzigd.


Invoerparameters:


Veldnaam Waarde Omschrijving
Identifier int De unieke ID van een klant.
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: Identifier of DebtorCode, 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 = [
    "DebtorCode" => "DB10000",
    "CompanyName" => "Bedrijfsnaam"
];

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

Voorbeeld uitvoer:


Array
(
    [controller] => debtor
    [action] => edit
    [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
                (
                )

            [Created] => 2024-01-21 11:00:00
            [Modified] => 2024-01-21 11:00:00
            [DefaultBillingContactId] => 1
            [DefaultQuoteContactId] => 0
            [ExtraClientContacts] => Array
                (
                    [0] => Array
                        (
                            [Identifier] => 1
                            [ClientId] => 1
                            [CompanyName] => Bedrijfsnaam
                            [Salutation] => m
                            [FirstName] => Jan
                            [LastName] => Janssen
                            [Address] => Keizersgracht 100
                            [ZipCode] => 1015 AA
                            [City] => Amsterdam
                            [Country] => NL
                            [EmailAddress] => info@example.com
                            [PhoneNumber] => 010 - 22 33 44
                            [MobileNumber] => 012 - 22 33 44
                            [Created] => 2024-01-21 11:00:00
                            [Modified] => 2024-01-21 11:00:00
                        )

                )

            [InvoiceDataForPriceQuote] => no
            [InvoiceCompanyName] => Bedrijfsnaam
            [InvoiceSex] => m
            [InvoiceInitials] => Jan
            [InvoiceSurName] => Janssen
            [InvoiceAddress] => Keizersgracht 100
            [InvoiceZipCode] => 1015 AA
            [InvoiceCity] => Amsterdam
            [InvoiceCountry] => NL
            [InvoiceEmailAddress] => info@example.com
            [Translations] => Array
                (
                    [Country] => Nederland
                    [InvoiceMethod] => Per e‑mail
                    [InvoiceCountry] => Nederland
                    [LanguageLabel] => Nederlands
                )

        )

)