API - VAT Info - BTW-informatie

Country-specific information about available rates


Resource:
/acumulus/stable/lookups/lookup_vatinfo.php
Since API:
Authentication:
None
Communication:
Basic submit (optional), including below structure


Submit

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

vatdate
Date in YYYY-MM-DD format for which the applied VAT information is requested. Defaults to current date. For Non-NL countries only dates greater or equal to 2015-01-01 are accepted.


vatcountry
2 character ISO3361-1 alpha 2 field identifying the country for which the VAT information is requested. Supported countries:


vatcountry
Description
AT
Austria
BE
Belgium
BG
Bulgaria
CY
Cyprus
CZ
Czech Republic
DE
Germany
DK
Denmark
EE
Estonia
GR
Greece
ES
Spain
FI
Finland
FR
France
GB
United Kingdom
HR
Croatia
HU
Hungary
IE
Ireland
IT
Italy
LT
Lithuania
LV
Latvia
LU
Luxembourg
MT
Malta
NL
Netherlands
PL
Poland
PT
Portugal
RO
Romania
SE
Sweden
SI
Slovenia
SK
Slovakia

Example response

<?xml version="1.0" encoding="UTF-8"?>
<response>
    <vatinfo>
        <vat>
            <vattype>reduced</vattype>
            <vatrate>6</vatrate>
        </vat>
        <vat>
            <vattype>normal</vattype>
            <vatrate>21</vatrate>
        </vat>
        <vat>
           ... 
        </vat>
    </vatinfo>
</response>

vattype
Identifier for the VAT structure. Can be "superreduced", "reduced", "normal", "parked". Multiple vatrates for a single vattype may be available. In which case multiple occurrences will be returned.

vatrate
Percentage applied to the vattype.