An API for VAT compliance

Feed API

  • Let you upload order data to Lovat

VAT Rate Api

  • Give you precise tax rate for your products or services

Request and response

AIl API requests must be made over HTTPS. Calls made over plain HTTP will fail. You must authenticate for all requests.

The SEND method implements the reception of data on the transaction, taking into account the processing and calculation of VAT and system charges.

https address correct example

Referrer URL

https://merchant.vatcompliance.co/api/1/send/{access_token}?if_digital={true/false}&if_vat_calculate={true/false}

Call Options

Call parameters are divided into two types:

  • Path parameters (token)
  • Query parameters (transaction data)

The token is generated in the internal account of the merchant at the first stage of adding the web-site. You can get it from your manager or find it in the Section Store –Settings.

The request parameters are generated by the merchant and sent to the server using the POST method in the application / x-www-form-urlencoded or application / json format.

Example query for goods:
Sample request from the console

curl-v POST
https://merchant.vatcompliance.co/api/1/send/5aae918d97964ff88df64b059c2cc0f8?if_digital=false&if_vat_calcilate=false
--header"Content-Type: application/json" \
-d '{
         "transaction_id ": "ttt4565-85546",
         "transaction_datetime": "2017-01-09T08:27:22 +00:00",
         "transaction_sum ": 158.04,
         "currency": "GBP",
         "arrival_country" : " GBR",
         "arrival_city" : " London",
         "arrival_address_line" : " Peckham Road",
         "transaction_status" : "Success",
         "good_code": "62160000",
         "vat_percent": 20.00,
         "vat": 28.73,
         "departure_country" : "AUS",
}'

Parameters

transaction_id
String/ 555-yyy
Transaction ID
transaction_datetime
DateTime / 2017-01-09T08:27:22 +00:00
Date and time of the transaction in accordance with ISO 8601 GMT
transaction_sum
String / 25
Transaction Amount
currency
String / “GBP”, “EUR”, “RUB”
All currencies are specified as strings according to ISO 4217
arrival_country
String / "GBR"
All countries are specified as strings according to ISO 3166-1 alpha-3
transaction_status
String / “Success”, “Charge back”, “Refund”, “Movement own goods”
Transaction Status
good_code
String / “62160000”
Code of a good according to EU's eight-digit coding system The Combined Nomenclature (CN)

The full list of parameters is available in API guides