Acumulus web service API library
===============================

@author: Buro Rader (http://www.burorader.com/).
@support: TODO. zie het Acumulus forum.

Inleiding
---------
Deze Acumulus web service API library is bedoeld om het ontwikkelen van client
side code die communiceert met de Acumulus API te vereenvoudigen. De library is
in eerste instantie ontwikkelt voor gebruik door de koppelingen voor de webshop
software van Magento, PrestaShop, OpenCart, VirtueMart en WooCommerce, maar is
dusdanig opgezet dat ook andere koppelingen er hun voordeel mee kunnen doen.

Dit is dus een cross-CMS/webshop library. Daarom kan de code in deze library
niet voldoen aan specifieke richtlijnen voor een specifieke webshop of CMS. Denk
hierbij aan:
- Coding standards.
- Organisatie en naamgeving.
- Vertaling door gebruikmaking van webshop specifieke vertaalfunctionaliteit.
- Webshop specifieke "Best practises".

Licentie
--------
Als deze library u apart ter beschikking is gesteld, is dit onder de GNU GENERAL
PUBLIC LICENSE versie 3. De Engelstalige en enige officiële tekst hiervan kunt u
vinden op http://www.gnu.org/licenses/gpl.html. Een niet bindende
Nederlandstalige vertaling hiervan vindt u op
http://bartbeuving.files.wordpress.com/2008/07/gpl-v3-nl-101.pdf. Beide teksten
zijn ook meegeleverd met deze module.

Als deze library u als onderdeel van een koppeling ter beschikking is gesteld,
geldt de licentie van de koppeling ook voor deze library.

Ontwikkeling
------------
Deze library is nog (volop) in ontwikkeling en zal:
 - waar nodig aangepast worden om met nog meer webshops om te kunnen gaan
 - uitgebreid worden met nieuwe wensen.
 - waar mogelijk en zinvol nog verder geabstraheerd worden.

Backwards compatibility is daarbij een zorg maar geen absolute vereiste. Omdat
de webshopkoppelingen met library uitgeleverd worden is dit voor gebruikers geen
probleem. Voor ontwikkelaars die zelfstandig met deze library aan de slag zijn
gegaan kan dit wel voor problemen zorgen.

todo's:
- Class "webshop capabilities" die een aantal methods die een webshop-specifieke
  lijst terugkeren centraliseert (is er een credit note, is er een invoice)
- Class "Shop invoice" (wrapper zoals "Invoice Source").
- Margin scheme zal niet samen gaan met gebruik van getVatRangeTags(). Refactor
  dit.
- Versturen credit notes via opties op config formulier regelen: (wel/niet
  automatisch + moment van versturen),