API - Add Expense
Expense, purchase, investment. Inkoopfactuur, zakelijke uitgave en/of investering.
<?xml version="1.0" encoding="UTF-8"?> <myxml> ... <supplier> <type></type> <companyname1></companyname1> <companyname2></companyname2> <fullname></fullname> <salutation></salutation> <address1></address1> <address2></address2> <postalcode></postalcode> <city></city> <countrycode></countrycode> <vatnumber></vatnumber> <telephone></telephone> <fax></fax> <email></email> <overwriteifexists></overwriteifexists> <bankaccountnumber></bankaccountnumber> <mark></mark> <expense> <description></description> <amountexvat></amountexvat> <vatrate></vatrate> <vattype></vattype> <issuedate></issuedate> <costheading></costheading> <costcenter></costcenter> <disablelimiteddeduction></disablelimiteddeduction> <accountnumber></accountnumber> <paymentstatus></paymentstatus> <paymentdate></paymentdate> <privatepercentage></privatepercentage> <recurrences></recurrences> <monthly></monthly> <investment></investment> <writeoffinyears></writeoffinyears> <scrapvalue></scrapvalue> </expense> </supplier> </myxml>
It is advised to always provide the supplier section. In case of reverse charge of VAT, the supplier section including the VAT-number is mandatory. Default values for costheading, costcenter and accountnumber are applied unless provided otherwise.
Optional numeric Acumulus specific contact number when updating a known supplier as part of the expense process. Leave blank when adding a supplier as part of the process. The numeric value for contacts already part of you administration can be obtained using the contact get contact details API.
Field for company name and e.g. department.
Additional fields for company name and e.g. department.
Field for providing a full personal name or reference.
Complete salutation e.g. "Geachte heer van der Molen" or "Beste Peter" without trailing comma. When not set it defaults to content set in the contact details in Acumulus or when those details are not set to: "Geachte mevrouw/heer".
Use two-letter international standard country code (ISO 3166-1 alpha 2).
vatnumber non mandatory / mandatory
Supplier VAT-number. Mandatory when using vattype 2 or 3 (national reverse charge or international reverse charge). See vattype below for more information.
Supplier fax number.
Supplier telephone number.
Lookup is based on string comparison. If a customer with this email address exists, this customer will be selected. When multiple customers with the same email address are found only the most recent added contact is used. When no matches are made a new customer will be added as part of the invoice add transaction. Setting can be overruled when a matching contactid tag is provided.
If a supplier match has been made using the email address as an identifier, all supplier details can be overwritten with the information provided within the request. Even if this means that some fields will be cleared.
Customer bank account or IBAN number.
Extra label or mark e.g. "BSN: 1234.56.789".
Description for the expense. Although not mandatory it defaults to: "DESCRIPTION NOT PROVIDED" and throws a warning when leaving this empty.
Total amount of the expense excluding VAT. Please note that only expenses with a single VAT-rate can be processed. Expenses with multiple VAT-levels will need to be provided as separate API-requests to this call in which case the amountexvat value will have to be self-calculated.
Applicable vatrate for the expense. Defaults to "21". Please note that only expenses with a single VAT-rate can be processed. Expenses with multiple VAT-levels will need to be provided as separate API-requests to this call.
A single digit indicating the vattype of the invoice.
Invoice date, if omitted, today is selected. Format: YYYY-MM-DD.
costheading (kostensoort) mandatory
The value must either provided as an numeric identifier (when using the picklist feature) or as the exact name of the costheading. Please note that only references to active costheadings are allowed. When omitted, or when no match has been made possible costheading #17 (Various / Diversen) will be used.
The value must either provided as an numeric identifier (when using the picklist feature) or as the exact name of the costcenter. Please note that only references to active costcenters are allowed. When omitted, or when no match has been made possible, the first available costcenter in the contract will be selected.
The accountnumber correlates to the bankaccountnumber of the Acumulus contract owner. The value is either provided as an numeric identifier (when using the picklist feature) and automatically translated or as a string to be directly integrated onto the invoice. When omitted, or when no match has been made possible, the first available accountnumber in the contract will be selected. Please note that only references to active accountnumbers are allowed. When the provided or determined accountnumber has been marked as inactive it will be reactivated.
Date of payment. Default = issue date. Format: YYYY-MM-DD.
Option to overwrite the fiscal internal applied limited deduction rules for specific costheadings (courses and representational costs). By setting this to 1 you enforce the expense to be treated as you wish. This should only applies 100% business-costs. This is tax-wise not valid unless you can clarify the reasons for doing so. Please be advised. Defaults to 0.
Percentage value between 0 and 100 (including 0 and 100) to be applied to the expense. Defaults to 0 (no privatepercentage applied).
Amount of recurrences you want to be processed. To be used in conjunction with below monthly identifier. Only integers from 0 up to 60 are allowed. Defaults to 0. Ignored when investment is set to 1.
When treating this expense as a recurring item (see recurrences) you can use the monthly identifier to state the intermediate periods. Only integers from 0 up to 12 are allowed. Defaults to 0. Ignored when investment is set to 1.
Example 1: Same expense (supplier/price) to be paid for every month for the next 18 months -> Set recurrences to 18 and monthly to 1.
Example 2: Same expense (supplied/price) to be paid for every 3 months for the next 12 months -> Set recurrences to 4 and monthly to 3.
Indicator if the expense should be treated as an investment. When so the recurrences and monthly nodes are set to 0.
Amount of years to be used for writing off the investment. Defaults to 0. Use integers as value. Values with decimals are rounded up.
Remainder value after write-off. Up to 4 decimals. Defaults to 0.