Acumulus API Changelog

API v3.3.18 - 22 June 2017 [integrated into stable]

  • Invoice PDF: Unified supporting text for iDEAL link.
  • Invoice PDF: Added support for value-free invoicelines acting as comments.
  • Invoice PDF: Aligned formatting for quantity with amounts.

API v3.3.17 - 5 April 2017 [integrated into stable]

  • Stock add: Added API for managing stock and availability modifications on products.

API v3.3.16 - 29 March 2017 [integrated into stable]

  • Invoice add: Bugfix code to properly translate ideal-link in email.
  • Invoice PDF: Added support for margeregeling field translation.

API v3.3.15 - 18 March 2017 [integrated into stable]

  • Internal release.

API v3.3.14 - 18 January 2017 [integrated into stable]

  • PDF invoice: Added support for plain invoices using optional gfx GET-parameter.

API v3.3.13 - 10 January 2017 [integrated into stable]

  • Report tripcompensations: Added API-call.
  • PDF invoice: Align strip of decimals with desktop version.

API v3.3.12 - 9 January 2017 [integrated into stable]

  • Invoice Add: Update clear contact IBAN when applicable/invalid.
  • Contact Manage: Update or clear contact IBAN when applicable/invalid.
  • Expense Add: Update or clear contact IBAN when applicable/invalid.

API v3.3.11 - 6 January 2017 [integrated into stable]

  • Invoice Add: Bugfix where quantity equals 0.

API v3.3.10 - 7 December 2016 [integrated into stable]

  • Invoice Add: Fixed over-aggressive sanitizing on some contact details.
  • Entry Update: Improve XML output when not supplying an entryfile.
  • Minor authentication enhancement.

API v3.3.9 - 5 December 2016 [integrated into stable]

  • Invoice Add: Removed warning on empty customer email address.
  • Invoice Add: Improved type determination when updating known contact.
  • Minor authentication enhancement.

API v3.3.8 - 15 November 2016 [integrated into stable]

  • Picklist products: Added support for product hash.
  • Picklist products: Remove bogus 0 when no associated contact available.

API v3.3.7 - 9 November 2016 [integrated into stable]

  • Invoice get PDF: Added support for custom filenames through templates.
  • Invoice mail: Added support for custom filenames through templates.
  • Packing slip get PDF: Added support for custom filenames through templates.

API v3.3.6 - 7 November 2016 [integrated into stable]

  • Invoice get PDF: Added error message instead of silent stop when requested sporadic removed template.
  • Invoice mail: Added error message instead of silent stop when requested sporadic removed template.
  • Packing slip get PDF: Added error message instead of silent stop when requested sporadic removed template.

API v3.3.5 - 5 October 2016 [integrated into stable]

  • Invoice add: Added support for contactstatus.

API v3.3.4 - 26 September 2016 [integrated into stable]

  • Contacts list: Added support for match against postal-code.
  • Contacts list: Minor documentation enhancement.

API v3.3.3 - 21 September 2016 [integrated into stable]

  • Invoice PDF: Added support for absolute total field in translations.
  • Invoice add: Added support for absolute total field in translations.
  • Invoice mail: Added support for absolute total field in translations.

API v3.3.2 - 5 September 2016 [integrated into stable]

  • Picklist projects: Added optional projectstatus parameter to limit listed projects.
  • Invoice PDF: Added missing customer IBAN translation support.

API v3.3.1 - 13 July 2016 [integrated into stable]

  • Entry update: Improved POLA-handling when omitting invoicetemplateid.

API v3.3.0 - 12 July 2016 [integrated into stable]

  • Entry update: Added support for uploading files using XML.

API v3.2.3 - 21 June 2016 [integrated into stable]

  • Packaging slip: Improved support for custom fields Allowing better translations.

API v3.2.2 - 5 June 2016 [integrated into stable]

  • Packaging slip: Improved XML response when requesting a removed packaging slip.

API v3.2.1 - 10 May 2016 [integrated into stable]

  • Invoice mail: Added support for new extended descriptiontext field.
  • Invoice add: Added support for new extended descriptiontext field.
  • Entry info: Added support for new extended descriptiontext field.
  • Packaging slip: Added support for new extended descriptiontext field.

API v3.2.0 - 9 May 2016 [integrated into stable]

  • Invoice mail: Added support for new template based BCC fields.
  • Invoice add: Added support for new template based BCC fields.
  • Packaging slip: Theoretical bugfix in rendering.

API v3.1.7 - 29 April 2016 [integrated into stable]

  • Picklist projects: Minor bugfix.
  • Picklist projectitems: Minor bugfix.
  • Picklist costcenters: Minor bugfix.
  • Picklist costheadings: Minor bugfix.
  • Picklist accounts: Minor bugfix.

API v3.1.6 - 20 April 2016 [integrated into stable]

  • Invoice PDF: Added translation support for foreign vat field from invoice template.

API v3.1.5 - 12 April 2016 [integrated into stable]

  • Contact get: Bugfix in output XML.

API v3.1.4 - 07 March 2016 [integrated into stable]

  • Internal refactoring.
  • Invoice add: Added missing retrieval from invoice template of name associated with email address.

API v3.1.3 - 26 January 2016 [integrated into stable]

  • Contacts list: Bugfix for sporadic incorrect XML response.
  • Expense add: Bugfix for incorrect handling when applying vatfree expenses.
  • Picklist products: Bugfix missing handling of producttagid filter.

API v3.1.2 - 21 January 2016 [integrated into stable]

  • Invoice add: Minor bugfix for not using template-preferred value regarding invoice total.
  • Project picklist: Minor bugfix when using projectid filter.

API v3.1.1 - 17 January 2016 [integrated into stable]

  • Invoice payment status set: Improved handling on connector xml node.
  • Invoice payment status set: Improved logging to entryid notes.
  • Invoice payment status set: Added entryid in xml response.
  • Invoice add: Improved handling on connector xml node.
  • Invoice add: Improved logging to entryid notes.
  • Invoice add: Removed obsolete warning.
  • Expense add: Improved handling on connector xml node.
  • Expense add: Improved logging to entryid notes.
  • Invoice email or reminder: Improved handling on connector xml node.
  • Invoice email or reminder: Improved logging to entryid notes.
  • Entry update: Improved handling on connector xml node.
  • Entry update: Improved logging to entryid notes.
  • Trip add: Improved handling on connector xml node.
  • Trip add: Improved logging to entryid notes.

API v3.1.0 - 12 January 2016 [integrated into stable]

  • Invoice add: Improve handling on connector xml node.
  • Connector feedback: Activated log to entryid when applicable.

API v3.0.7 - 11 January 2016 [integrated into stable]

  • Invoice get PDF: Fix typo in response when requesting an invalid or unauthorized token.
  • Internal: Minor parse cleanup.
  • Internal: Minor foreign vat bugfix.

API v3.0.6 - 05 January 2016 [integrated into stable]

  • Invoice add: Added concepttype option.
  • Picklist products: Added API-call to list all available standard products and services.
  • Picklist concepttypes: Added API-call to list all available concept type values.
  • Picklist producttags: Added API-call to list all available product tag values.
  • Picklist projects: Added projectid filter option to limit the output to a single project.

API v3.0.5 - 04 January 2016 [integrated into stable]

  • Invoice add: Added feedback warning when adding invoices without any invoice-lines.

API v3.0.4 - 02 January 2016 [integrated into stable]

  • Entry info: Added feedback warning when requesting specific information on empty invoices.
  • Invoice payment get status: Added feedback warning when requesting specific information on empty invoices.

API v3.0.3 - 21 December 2015 [integrated into stable]

  • Invoice add: Bugfix by adding missing invoicenotes in specific non-email cases.

API v3.0.2 - 16 December 2015 [integrated into stable]

  • Project picklist: Added projectcontactname.

API v3.0.1 - 14 December 2015 [integrated into stable]

  • PDF invoices: Added support for alternate VAT-number description.
  • PDF invoices: Added support for alternate VAT-free description.
  • PDF invoices: Bugfix template fallback selection.
  • Entry update: Added contactid support.

API v3.0.0 - 26 November 2015 [integrated into stable]

  • Project Manage: Added API-call.
  • Project Item Manage: Added API-call.
  • Picklist Projects: Added API-call.
  • Picklist Project Items: Added API-call.

API v2.5.8 - 17 November 2015 [integrated into stable]

  • Invoice mail: Added support for ideal-link in e-mail text to reminders.

API v2.5.7 - 13 November 2015 [integrated into stable]

  • Internal release.

API v2.5.6 - 11 November 2015 [integrated into stable]

  • Invoice PDF: Added support for configurable offset below adres.
  • Packaging slip PDF: Added support for configurable offset below adres.
  • Contact Manage: Fix typo in warning message.
  • Contact Manage: Added missing warning message.
  • Entry Info: Added missing error message.
  • Invoice Add: Minor bugfix in handling error message for invalid email address.

API v2.5.5 - 6 November 2015 [integrated into stable]

  • Invoice mail: Bugfix release.

API v2.5.4 - 2 November 2015 [integrated into stable]

  • Contacts list: Added contactname1 and contactname2 fields.
  • Invoice PDF: Revert granularity change from 2.5.3.

API v2.5.3 - 29 October 2015 [integrated into stable]

  • Invoice PDF: Improve granularity on rounding.

API v2.5.2 - 7 October 2015 [integrated into stable]

  • Bugfix: Fix typo which created obscure invalid xml response.

API v2.5.1 - 21 September 2015 [integrated into stable]

  • Entry info: Bugfix for deleted entries.
  • Entry info: Bugfix documentation for deleted xmlnode.

API v2.5.0 - 16 September 2015 [integrated into stable]

  • Picklist countries: Added picklist API call for supported countries.
  • Minor header improvement in API-responses.

API v2.4.9 - 8 September 2015 [integrated into stable]

  • Picklist trips: Added picklist API call for known trips retrieval.
  • Trips add: Added API call for registering business trips with privately owned vehicles.

API v2.4.8 - 3 September 2015 [integrated into stable]

  • Invoice add: Added option to automatically disable duplicate contacts.
  • Invoice add: Added support for new invoicetemplate fields.
  • Invoice mail: Added support for new invoicetemplate fields.
  • Invoice PDF: Added support for new invoicetemplate fields.
  • Contacts list: Added contactstatus to response.
  • Contacts list: Added contactstatus xmlnode.
  • Contacts manage: Minor bugfix parsing status.

API v2.4.7 - 27 August 2015 [integrated into stable]

  • Get PDF invoice: Minor bugfix in encoding.
  • Invoice add: Added support for nature xmlnode.
  • Invoice add: Added country xmlnode.
  • Invoice add: Fix typo in overwriteifexists parsing.
  • Invoice PDF: Added support for optional Nederland display.
  • Delivery packing slip: Added support for optional Nederland display.
  • Various: Improved mail handling.
  • General: Added support for special API usertype.

API v2.4.6 - 19 August 2015 [integrated into stable]

  • Packaging slip: Bugfix phone number.

API v2.4.5 - 05 August 2015 [integrated into stable]

  • Contacts list: Bugfix internal handling on contacttype for specific case.
  • Contacts list: Removal unneeded character in output.

API v2.4.4 - 31 July 2015 [integrated into stable]

  • Invoice get PDF invoice: Minor enhancement.
  • Contact manage: Minor enhancement in warning message.
  • Contact manage: Bugfix internal handling on contacttype for specific case.

API v2.4.3 - 27 July 2015 [integrated into stable]

  • Entry info API: Added paymentdate.
  • Entry info API: Bugfix not showing paymenttermdays.
  • Invoice paymentstatus get API: Added paymentdate.

API v2.4.2 - 23 July 2015 [integrated into stable]

  • Contact manage API: Added support to set contactvattype as a default for a contact.
  • Contact manage API: Added support to set contactcostheadingid as a default for a contact.
  • Contacts list API: Added contactvattype and contactcostheadingid to output.
  • Contact get API: Added contactvattype and contactcostheadingid to output.
  • General system message API: Removed requirement for authentication.

API v2.4.1 - 21 July 2015 [integrated into stable]

  • Accounts manage API: Added API-call to allow management of accounts / rekeningen.

API v2.4.0 - 19 July 2015 [integrated into stable]

  • Entry delete status API: Added API-call to allow entries to be marked as deleted and moved onto the deleted entries stack or back.

API v2.3.4 - 4 June 2015 [integrated into stable]

  • Contact get API: Provide FRST when contactsepaincassostatus is not set.

API v2.3.3 - 2 June 2015 [integrated into stable]

  • Invoice add API: Throw error message when not providing valid countrycode on locationcode3.
  • Contact manage API: Allow contactsepamandatedate to be empty when not applicable.
  • Contact get API: Provide truly empty contactsepamandatedate when applicable.

API v2.3.2 - 31 May 2015 [integrated into stable]

  • Contact manage API: Removed mandatory constraints from contactemail xml-node.

API v2.3.1 - 29 May 2015 [integrated into stable]

  • Contact get API: Provide default contactsepamandatenr when not set.

API v2.3.0 - 28 April 2015 [integrated into stable]

  • Invoice add API: Throw deprecation warning when locationcode equals 3 and countrycode is empty or missing.
  • Invoice add API: Bugfix for default vatratebase setting on creation of contact.
  • Expense add API: Removal of unused locationcode xml-node.
  • Several documentation fixes.

API v2.2.1 - 26 April 2015 [integrated into stable]

  • Invoice add API: Minor textual fix in invoice note field.
  • Invoice paymentstatus set API: Automatically activate associated accountnumber when the account has been marked as inactive.
  • Invoice add API: Automatically activate provided or determined accountnumber when marked as inactive.
  • Expense add API: Automatically activate provided or determined accountnumber when marked as inactive.

API v2.2.0 - 25 April 2015 [integrated into stable]

  • Contact get API: Added contactinvoicenotes to response.
  • Contact get API: Added contactsepamandatenr to response.
  • Contact get API: Added contactsepamandatedate to response.
  • Contact get API: Added contactsepaincassostatus to response.
  • Enry info API: Align accountnumber node instead of accountid.
  • Enry update API: Align accountnumber node instead of accountid.

API v2.1.2 - 21 April 2015 [integrated into stable]

  • Contact manage API: Do not send warnings on empty contactbic.

API v2.1.1 - 14 April 2015 [integrated into stable]

  • Invoice add API: Added support for multiline invoicenotes xml-node to API-call.
  • Invoice add API: Textual enhancement of generated notes.
  • Invoice add API: Minor enhancement when using vattype 5.
  • Invoice mail API: Added support for multiline invoicenotes xml-node to API-call.
  • Invoice mail API: Fix to prevent notes reset on mail-out.
  • Invoice mail API: Textual enhancement of generated notes.

API v2.1.0 - 8 April 2015 [integrated into stable]

  • Expense add API: Added new API-call.

API v2.0.17 - 4 April 2015 [integrated into stable]

  • Improved sanitation.

API v2.0.16 - 2 April 2015 [integrated into stable]

  • Invoice mail API: Fix newline handling in message node.
  • Invoice add API: Fix newline handling in message node.

API v2.0.15 - 10 March 2015 [integrated into stable]

  • Contact get API: Fix incorrect ISO-countrycode response.
  • General: Minor internal processing enhancement.

API v2.0.14 - 27 February 2015 [integrated into stable]

  • Invoice info API: Added missing escapes causing sporadic invalidated XML-response.

API v2.0.13 - 25 February 2015 [integrated into stable]

  • General: Improve retrieval of old invoice tokens.

API v2.0.12 - 24 February 2015 [integrated into stable]

  • Entry info API: Added missing escapes causing sporadic invalidated XML-response.

API v2.0.11 - 4 February 2015 [integrated into stable]

  • Minor internal restructure.

API v2.0.10 - 3 February 2015 [integrated into stable]

  • Added Entry update API: New feature available to alter some entry details.

API v2.0.9 - 3 February 2015 [integrated into stable]

  • Contact get API: Update contacttype, contractcountry and contactabout fields.

API v2.0.8 - 29 January 2015 [integrated into stable]

  • Invoice mail API: Minor enhancements in handling.
  • Documentation: Invoice mail API improve documentation in emailaspdf section.
  • General: Improve feedback for specific tokens.

API v2.0.7 - 20 January 2015 [integrated into stable]

  • Invoice add API: Minor enhancement in Reply-to header.
  • Invoice mail API: Minor invoicetype detection fix.
  • Documentation: Invoice add API improve documentation on emailfrom tag.

API v2.0.6 - 16 January 2015 [integrated into stable]

  • General: Improve relaying of mailer daemon messages.

API v2.0.5 - 15 January 2015 [integrated into stable]

  • Invoice add API: Minor bugfix for printing vat numbers.
  • Invoice add API: Minor bugfix for sorting invoice lines.
  • Invoice add API: Minor bugfix for printing template names.

API v2.0.4 - 7 January 2015 [integrated into stable]

  • General: Allow for +-symbol in interpretation of the local-part of an email address.
  • Invoice add API: Improved granularity in iDEAL generated tokens.

API v2.0.3 - 18 December 2014 [integrated into stable]

  • Contact manage API: Bugfix in contactcountrycode handling.

API v2.0.2 - 17 December 2014 [integrated into stable]

  • Minor changes to support improved backend.

API v2.0.1 - 16 December 2014 [integrated into stable]

  • Invoice add API: minor bugfixes.
  • Documentation: Invoice add API more explicit about vattypes.

API v2.0.0 - 13 December 2014 [integrated into stable]

  • Invoice add API: Added support for foreign VAT / vattype 6.
  • Invoice add API: Added filters to allow fallback vatrates when using foreign VAT.
  • Invoice get PDF invoice API: Added foreign VAT to PDF-markup.
  • Entry info API: Added foreignvat xml-node to output.
  • Contact get API: removed obsolete countactcountyid xml-node..
  • Documentation: Invoice add API updates.
  • Documentation: Contact get API updates.
  • Documentation: Entry info API updates.
  • Documentation: Updated authentication descriptions.
  • General: Improved warning message when hitting test-account limitations.
  • Reworked routines for vatrates.
  • Reworked routines for ISO 3166-1 countrycodes.

API v1.26.0 - 03 December 2014 [integrated into stable]

  • Invoice add API: Added support for contactid.
  • Invoice add API: Added support for contactyourid.

API v1.24.1 - 24 November 2014 [integrated into stable]

  • Invoice add API: Added support for testmode runs.

API v1.24.0 - 21 November 2014 [integrated into stable]

  • Added support for additional template fields to PDF invoice.
  • Added support for additional template fields to PDF reminders.
  • Added support for additional template fields to PDF packaging slip.

API v1.22.1 - 20 November 2014 [integrated into stable]

  • Contact Manage API: Fixed typos in some XML-warnings.
  • Contact Manage API: Added support for contactabout.
  • Contact Manage API: Added support for contactinvoicenotes.
  • Contact Manage API: Added contactyourid to XML-response.

API v1.22 - 13 November 2014 [integrated into stable]

  • Invoice add API: Added missing feedback on specific broken emailto and emailbcc sets.
  • Invoice add API: Several documentation fixes.
  • Invoice add API: Improved pickup of fancy emailfrom from template.
  • Invoice add API: Bugfix. Removed empty message dependency for fancy emailfrom.
  • Invoice add API: More robust delivery by improved honoring of modern SPF-policies when sending out email.
  • Invoice add API: Be more strict when supplying duplicate erroneous emailfrom tags.
  • Added vattype 6 to vattype picklist API.

API v1.20.3 - 12 November 2014 [integrated into stable]

  • Added VAT-info lookup API call.

API v1.20.2 - 9 November 2014 [integrated into stable]

  • Added contactyourid to contact_get.php response.
  • Added contactyourid to contacts_list.php response.
  • Added support for new TLD-style domains in email related tags.

API v1.20.1 - 3 November 2014 [integrated into stable]

  • Added new contact_manage.php API call.
  • Improved reporting on specific xml input errors.
  • Additional error reporting when submitting duplicate xml tags.

API v1.18.4 - 24 October 2014 [integrated into stable]

  • Minor enhancement to allow for quarterly tags in repeating invoices.

API v1.18.3 - 29 Sept 2014 [integrated into stable]

  • Added contactemail to contacts list API-call.
  • Added contacttelephone to contacts list API-call.
  • Improved xml response when requesting details on deleted entries.

API v1.18.2 - 21 Jun 2014 [integrated into stable]

  • Added entry-info API-call to retrieve detailed information about an Acumulus entry.
  • Minor bugfix when generating warnings.
  • Minor improvements in XML-response of invoice mail API-call.
  • Bugfix on PDF-invoices allowing once removed but restored invoices to be retrieved again.
  • Bugfix to properly display iDEAL reference on invoices.

API v1.18.1 - 25 Apr 2014 [integrated into stable]

  • Added entryid to the response of the invoice add API-call.

API v1.18 - 22 Apr 2014 [integrated into stable]

  • Improved date format display as per user-configuration.
  • Improved number format display as per user-configuration.

API v1.16.3 - 16 Apr 2014 [integrated into stable]

  • Added a My Acumulus call to general section.

API v1.16.2 - 11 Apr 2014 [integrated into stable]

  • Added contactaddress1 and contactaddress2 to contacts list call.

API v1.16.1 - 21 Mar 2014 [integrated into stable]

  • Backend updates.

API v1.16 - 11 Feb 2014 [integrated into stable]

  • Added API calls to enlist outgoing and incoming invoices on a per contact basis.

API v1.14 - 07 Feb 2014 [integrated into stable]

  • Added feature to delivery packing slip to allow some customization.

API v1.12 - 26 Jan 2014 [integrated into stable]

  • Improved feedback when using invalid XML-control characters.

API - hotfixes

  • Correctly process template and costcenter settings upon concept invoicing.
  • Allow emailbcc tag to be omitted in invoice add API-call.

API v1.10 - 30 Oct 2013 [integrated into stable]

  • Added support to include clientgegevens on PDF invoices.
  • Minor code cleanup.

API v1.8 - 18 Oct 2013 [integrated into stable]

  • Added feedback support
  • Pakbon and delivery improvements
  • Minor picture fix

API v1.6 - 23 Sept 2013 [integrated into stable]

  • Minor restructuring invoice add API-call
  • Fixed minor PDF rendering annoyance

API v1.4 - 22 Sept 2013 [integrated into stable]

  • Improved support for invoiced with removed templates using fall-back approach
  • Better token-filtering
  • Bug-fixes and code enhancements
  • Documentation updates

API v1.2 - 07 Aug 2013 [integrated into stable]

  • Restored and restructured invoice email API-call.
  • New API-call to allow you to update invoice payment status.
  • Add support for selecting contacttype in contacts_list.php.
  • New API-call to generate a simple packing slip (pakbon) based on an already available invoice.
  • Some small bugfixes and code enhancements

API v1.0 - 08 July 2013 [integrated into stable]

Below an overview of the changes that have been made to the legacy API.

    General

  • All API-calls have been relocated to a new path/location.
  • Heavily revised and detailed warning and error feedback.
  • Introduction of API-versions in order to improve backwards compatibility.
  • The JSON format can now be requested as part of the XML-structure using the < format > tag.
  • The < respons > tag has been replaced with the < response > tag.
  • All API-call are within the < response > tag.
  • The < code > tag has been replaced with the < contractcode > tag.
  • The token to identify (PDF) invoices has been renamed from "t" to "token".
  • The emailonerror and emailonwarning tags have been integrated into all API-calls.
  • The < email_onerror > tag was renamed to < emailonerror >.
  • The maximum size for posting a dataset into our API has been set to 16 megabytes. Please drop us a line if you intend to offer larger datasets.
    Invoice Add

  • The invoice add API call will only process a single contract. If you want more contracts to be processed you will need to make multiple API requests.
  • The invoice add API call will only process a single invoice. If you want more invoices to be processed you will need to make multiple API requests.
  • The invoice add API call will only process a single customer. If you want more customers to be processed you will need to make multiple API requests.
  • paymentstatus codes have been aligned with other api-calls.
  • The < quantity > tag within the < line > section of the invoice add API now defaults to 1.
  • The < unitprice > tag within the < line > section of the invoice add API now defaults to 1.
  • The < costheading > tag has been renamed to < costcenter > to avoid further confusion.
    Picklists

  • Removed unused costcenterdescription tag from documentation
  • The costcenter and costheading picklists have been renamed to costtype and costcenter to avoid further confusion. The tagnames of the xml-responses have been renamed accordingly.
    Reports

  • The < balanceperaccount > tag has been renamed to < accountbalances >.
  • The < totalaccountbalance > tag has been renamed to < accountbalancestotal >.
  • Added < accountbalancesyear > to the XML-response for the accountbalances report.
  • The filter=overdue parameter in the unpaid debtors report has been renamed to < due > with an option of 0 or 1.
  • Rather rare invoices with an empty input date are by default included in the unpaid debtors report to easy notification and correction.
    Contacts

  • The optional "q" search-parameter has been renamed to "filter".
  • The filter now includes matches against the city.