iotoms Docs

Get an EU VAT return

GET
/api/v1/reports/tax/europe/vat-return

Returns net sales and output VAT for one EU member state (countryCode, for example DE or FR) between from and to, broken down by supply type and VAT rate.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Query Parameters

countryCode*string

EU member state code (e.g. DE, FR, IE)

from*string

Period start (yyyy-MM-dd)

Formatdate
to*string

Period end (yyyy-MM-dd)

Formatdate

Header Parameters

X-TenantID*string

Tenant identifier

Response Body

OK

*/*
  1. response
status*string

Outcome of the call: SUCCESS when the request was processed; otherwise an error status.

message*string

Short human-readable message describing the outcome, e.g. which record was saved or why the call failed.

data?

The VAT return figures for the requested period.

Example Request
curl -X GET 'https://beta.iotoms.com/api/v1/reports/tax/europe/vat-return?countryCode=string&from=2019-08-24&to=2019-08-24' \  -H 'X-TenantID: your-tenant-code'
Example Response
{  "status": "string",  "message": "string",  "data": {    "tenantId": "string",    "countryCode": "string",    "currency": "string",    "from": "2019-08-24",    "to": "2019-08-24",    "vatRegistrationNumber": "string",    "rateBreakdowns": [      {        "supplyType": "string",        "ratePercent": 0,        "netSales": 0,        "outputVat": 0      }    ],    "totalNetSales": 0,    "totalOutputVat": 0,    "totalInputVat": 0,    "netVatPayable": 0,    "transactionCount": 0  }}