On this page
We recommend storing all merchant business location addresses in your system to pass in when calculating tax.

In addition to helping you calculate VAT for your merchants, we also make it very easy to help them file and remit their sales tax to the Tax authorities. Lovat’s transaction endpoints allow you to send completed order information to a merchant’s Lovat account. Simply include the merchant’s Lovat API token when posting, and those orders will show up in the merchant’s account with a return-ready report breaking out tax owed by jurisdiction. Merchants who choose to use Lovat will simply pay us based on the number of transactions we’re processing for them on a monthly basis.

POST

Method

The request type: POST
https://omp.vatcompliance.co/api/omp/tax_rate/{access_token}

JSON Params

Parameter Type Description Required
merchant_id String Unique identifier of the merchant Optional
merchant_establishment_country_id String Merchant establishment country. Three-letter uppercase country code per ISO 3166-1 alpha-3 Required
merchant_VAT_numbers Tax  number of merchant Optional
transaction_id String Maximum 255 characters. Optional
сurrency String Transaction currency. Three-letter currency code per ISO 4217. Required
transaction_datetime Date and time of the transaction in accordance with ISO 8601 GMT Optional
transaction_sum Float Total amount of the order, excluding shipping Required
delivery_fee Float Total amount of shipping for the order Optional
arrival_country String A country where the order shipped to. Three-letter uppercase country code per ISO 3166-1 alpha-3 Required
arrival_zip String Required for US orders: Postal code where the order shipped to Optional
arrival_state For US, Canada, UK: Two-letter ISO state code where the order shipped to Optional
departure_country String Three-letter ISO country code of the country where the order shipped from. All countries are specified as strings according to ISO 3166- 1 alpha-3 Required
departure_zip String For US orders: Postal code where the order shipped from Optional
departure_state String

For US, Canada:

Two-letter ISO state code where the order shipped from

service_code String Required for digitally supplied services. Tax categories of digital services Optional
good_code String Code of a good according to EU’s eight-digit coding system The Combined Nomenclature (CN) Optional
vat_number_of_buyer String Tax  number of buyer Optional
buyer_name String Optional
exemption_type String For US orders only Optional
nexus_state String Merchant nexus states. Two-letter ISO state code where the merchant has nexus Optional

 

Requests and Responses

sent over HTTPS,

use TLS 1.2 or higher,

contain authentication parameters,

Request Example

Command Line

curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' 
-d '{ 
   "transaction_id": "ttt4565-85546",
   "merchant_id": "678345101",
   "merchant_establishment_country_id": "DEU",
   "merchant_VAT_numbers": "DE9875234",
   "transaction_datetime": "2022-01-09T08:27:22 +00:00",
   "transaction_sum": 43.04,
   "delivery_fee": 2.3,
   "currency": "EUR",
   "arrival_country" : "LVA",
   "good_code": "62160000",
   "departure_country" : "AUS"
 }' 
'https://omp.vatcompliance.co/api/omp/tax_rate/6cec387781a94425b401206d1710801a
{ 
   "transaction_id": "0099990100",
   "merchant_id": "678345101",
   "merchant_VAT_numbers": "GB9875234",	
   "merchant_establishment_country_id": "GBR",
   "transaction_datetime": "2022-01-09T08:27:22 +00:00",
   "transaction_sum": 120.50,
   "delivery_fee": 2.3,
   "currency": "GBP",
   "arrival_country" : "DEU",	
   "good_code": "62160000",
   "departure_country" : "GBR"
 }
{ 
   "transaction_id": "0099990099",
   "merchant_id": "678345104",
   "merchant_establishment_country_id": "POL",
   "merchant_VAT_numbers": "DE9875234",
   "transaction_sum": 12.50,
   "currency": "EUR",
   "arrival_country" : "LVA",
   "good_code": "62160000",
   "departure_country" : "POL"
 }

Example Success Response

Command Line

{
  "transaction_id": "ttt4565-85546",
  "transaction_type": "lvg_deemed_import",
  "deemed": true,
  "taxable_jurisdiction": "LVA",
  "vat_percent": 21,
  "export_country": "AUS",
  "import_country": "LVA"
}
{
  "transaction_id": "0099990100",
  "transaction_type": "lvg_deemed_import",
  "deemed": true,
  "taxable_jurisdiction": "DEU",
  "vat_percent": 19,
  "export_country": "GBR",
  "import_country": "DEU"
}
{
  "transaction_id": "0099990099",
  "transaction_type": "b2c_distance_sales",
  "deemed": false,
  "taxable_jurisdiction": "LVA",
  "vat_percent": 21
}