API - Get contact details

Retrieve detailed contact information / contactinformatie


Resource:
/acumulus/stable/contacts/contact_get.php
Since API:
Available for authenticated:
API gebruiker
Available for authenticated:
API beheerder
Communication:
Basic submit, including below structure

Support voor inodes :

Submit

<?xml version="1.0" encoding="UTF-8"?>
<myxml>
    ...
    <contactid></contactid>
</myxml>

contactid mandatory
Numeric identifier for the contact you are trying to retrieve detailed information for. You can find these numeric identifiers in both Acumulus and by using the contacts list API-call.


Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
    <contact>
        <contactid></contactid>
        <contactyourid></contactyourid>
        <contactname1></contactname1>
        <contactname2></contactname2>
        <contacttype></contacttype>
        <contacttypename></contacttypename>
        <contacttypenamenl></contacttypenamenl>
        <contactvattypeid></contactvattypeid>
        <contactvattype></contactvattype>
        <contactvattypenl></contactvattypenl>
        <contactperson></contactperson>
        <contactsalutation></contactsalutation>
        <contactaddress1></contactaddress1>
        <contactaddress2></contactaddress2>
        <contactpostalcode></contactpostalcode>
        <contactcity></contactcity>
        <contactcountry></contactcountry>
        <contactcountryid></contactcountryid>
        <contactcountrytypeid></contactcountrytypeid>
        <contactcountrycode></contactcountrycode>
        <contacttelephone></contacttelephone>
        <contactfax></contactfax>
        <contactemail></contactemail>
        <contactwebsite></contactwebsite>
        <contactbankaccountnumber></contactbankaccountnumber>
        <contactiban></contactiban>
        <contactbic></contactbic>
        <contactmark></contactmark>
 
        <contactaltname1></contactaltname1>
        <contactaltname2></contactaltname2>
        <contactaltperson></contactaltperson>
        <contactaltaddress1></contactaltaddress1>
        <contactaltaddress2></contactaltaddress2>
        <contactaltpostalcode></contactaltpostalcode>
        <contactaltcity></contactaltcity>
        <contactaltcountry></contactaltcountry>
        <contactaltcountryid></contactaltcountryid>
        <contactaltcountrytypeid></contactaltcountrytypeid>
        <contactaltcountrycode></contactaltcountrycode>
 
        <contactvatnumber></contactvatnumber>
        <contactabout></contactabout>
        <contactinvoicenotes></contactinvoicenotes>
        <contactsepamandatenr></contactsepamandatenr>
        <contactsepamandatedate></contactsepamandatadate>
        <contactsepaincassostatus></contactsepaincassostatus>
        <contactstatus></contactstatus>
 
        <contactvattype></contactvattype>
        <contactinvoicetemplateid></contactinvoicetemplateid>
        <contactentrydescription></contactentrydescription>
        <contactvatratebase></contactvatratebase>
        <contactbankaccountid></contactbankaccountid>
        <contactcostheadingid></contactcostheadingid>
        <contactprivaterate></contactprivaterate>
        <contactcostcenterid></contactcostcenterid>
    </contact>
</response>

A single contact data set is returned.

contactid
Numeric identifier for the contact.

contactyourid
Your numeric identifier for the contact. Defaults to 0 when empty.

contactname1
Primary contact name.

contactname1
Secondary contact name.


contacttype

contacttypename

contacttypenamenl
Numeric and strings describing name of the type of contact. Also available through picklist API-call.

contacttype
contacttypename
contacttypenamenl
1
Debitor (customer)
Debiteur (klant)
2
Creditor (supplier)
Crediteur (leverancier)
3
Contact
Relatie

contactvattypeid

contactvattype

contactvattypenl
Numeric and strings describing name of the vattype of contact.

contactvattypeid
contactvattype
contactvattypenl
1
Private and/or VAT exempt
Particulier en/of btw-vrijgesteld
2
Business VAT taxable
Zakelijk btw-plichtig

contactperson
Name of the contact.

contactsalutation
Complete salutation for the contact.

contactaddress1
Address field.

contactaddress2
Address field.

contactpostalcode
Address field.

contactcity
City

contactcountry
Contact country. Falls back to Acumulus country reference when empty.

contactcountryid
Numeric identifier for the country.

contactcountrycode
International standard country code (ISO 3166-1).

contactcountrytypeid
Fiscal region relative to The Netherlands.

contactcountrytypeid
Fiscal region
1
Netherlands
2
Europe
3
World
0
Not set

contacttelephone
Contact telephone number.

contactfax
Contact fax number.

contactemail
Contact email address.

contactwebsite
Contact website.

contactbankaccountnumber
Contact bank account number.

contactiban
Contact IBAN number.

contactbic
Contact BIC number.

contactmark
Contact extra label or mark, useful for i.e. "BSN: 1234.56.789".


contactaltperson
Name of the contact.

contactaltsalutation
Complete salutation for the contact.

contactaltaddress1
Address field.

contactaltaddress2
Address field.

contactaltpostalcode
Address field.

contactaltcity
City

contactaltcountry
Contact country. Falls back to Acumulus country reference when empty.

contactaltcountryid
Numeric identifier for the country.

contactaltcountrycode
International standard country code (ISO 3166-1).

contactaltcountrytypeid
Fiscal region relative to The Netherlands.

contactaltcountrytypeid
Fiscal region
1
Netherlands
2
Europe
3
World
0
Not set

contactvatnumber
Contact VAT number.

contactabout
Contact specific information or remarks.

contactinvoicenotes
Notes to appear on invoices for this contact

contactsepamandatenr
Unique number assigned to this contact for SEPA-incasso transactions.

contactsepamandatedate
Date in YYYY-MM-DD format starting the mandate given by this contact for SEPA-incasso transactions.

contactsepaincassostatus
Current status for this contact applicable to SEPA-incasso transactions. One of FRST, RCUR, OOFF or FNAL.

contactstatus
Status of the contact. Either 0 or 1.

Option
Description
0
Inactive/Locked contact. Not available or linkable for new entries.
Existing entries not affected
1
Contact active.

Defaults, indicating preferences

contactvattype
Contact VAT type. Similar to invoice vattype.

contactinvoicetemplateid
Default invoicetemplateid for the contact.

contactentrydescription
Default entrydescription for the contact.

contactvatratebase
Default VAT value for the contact.

contactbankaccountid
Default bankaccountid for the contact.

contactcostheadingid
Default costheadingid for the contact.

contactprivaterate
Default privaterate for the contact.

contactcostcenterid
Default costcenterid for the contact.