Even geduld a.u.b...

Exact Online REST API - VATCodes

Endpoint

VATCodes

Good to know

Use this endpoint to create, update, view and delete VAT codes. VAT codes can only be deleted, when they are not yet used in financial entries.
In order to fill percentages, you need to add one ore more VATPercentage lines to the VAT code. This is only possible when you POST a VAT code.
Below is an example of the body request to POST VatCode with VatPercentages.

{
  Code : value,
  Description : value,
  Type : value,
  GLToClaim : value,
  GLToPay : value,
  VATPercentages: [
  {
   Percentage : value,
   Type : value
   }
  ]
}

Scope

Financial accounting

URI

/api/v1/{division}/vat/VATCodes


GET POST PUT DELETE

Example usage

/api/v1/{division}/vat/VATCodes

/api/v1/{division}/vat/VATCodes

/api/v1/{division}/vat/VATCodes

/api/v1/{division}/vat/VATCodes


Properties

Name Mandatory Value Value Type Description
ID False Edm.Guid Primary key
Account False Edm.Guid Tax account
AccountCode False Edm.String Code of Account
AccountName False Edm.String Name of Account
CalculationBasis False Edm.Byte Indicates how to calculate the tax. 0 = based on the gross amount, 1 = based on the gross amount + another tax
Charged False Edm.Boolean Indicates if transactions using the VAT code are transactions of the domestic VAT charging regulation (such as those for subcontractors) or transactions that are registered within the EU. If Charged=1 and linked to a purchase invoice, both a line for the VAT to pay and a line for the VAT to claim are being created
Code True Edm.String VAT code
Country False Edm.String Obsolete
Created False Edm.DateTime Creation date
Creator False Edm.Guid User ID of creator
CreatorFullName False Edm.String Name of creator
Description True Edm.String Description of the VAT code
Division False Edm.Int32 Division code
EUSalesListing False Edm.String Used in all legislations except France. Indicates if and how transactions using the VAT code appear on the ICT return (EU sales list). L = Listing goods, N = No listing, S = Listing services, T = Triangulation
ExcludeVATListing False Edm.Byte ExcludeVATListing. Used in Belgium Legislation to indicate whether the entries need to be excluded from the VAT Listing.
GLDiscountPurchase False Edm.Guid Indicates the purchase discount GL account linked to the VAT codes for German legislation
GLDiscountPurchaseCode False Edm.String Code of the G/L account used for VAT corrections of settlement discount purchase (Germany only)
GLDiscountPurchaseDescription False Edm.String Description of the G/L account used for VAT corrections of settlement discount purchase (Germany only)
GLDiscountSales False Edm.Guid Indicates the sales discount GL account linked to the VAT codes for German legislation
GLDiscountSalesCode False Edm.String Code of the G/L account used for VAT corrections of settlement discount sales (Germany only)
GLDiscountSalesDescription False Edm.String Description of the G/L account used for VAT corrections of settlement discount sales (Germany only)
GLToClaim False Edm.Guid G/L account that is used to book the VAT to claim. If you enter purchases with a VAT code, the VAT amount to be claimed is entered to this VAT account. Must be of type VAT
GLToClaimCode False Edm.String Code of the VAT to claim G/L account for the VAT code
GLToClaimDescription False Edm.String Description of the VAT to claim G/L account for the VAT code
GLToPay False Edm.Guid G/L account that is used to book the VAT to pay. If you enter sales with a VAT code, the VAT amount to be paid is entered to this VAT account. Must be of type VAT
GLToPayCode False Edm.String Code of the VAT to pay G/L account for the VAT code
GLToPayDescription False Edm.String Description of the VAT to pay G/L account for the VAT code
IntraStat False Edm.Boolean Used in all legislations except France. Indicates if intrastat is used
IntrastatType False Edm.String Used in France legislation only. Indicates if and how transactions using the VAT code appear on the DEB/DES return. L = Goods, N = Empty, S = Services
IsBlocked False Edm.Boolean Indicates if the VAT code may still be used
LegalText False Edm.String Legal description for VAT code to print in the total block of the invoice
Modified False Edm.DateTime Last modified date
Modifier False Edm.Guid User ID of modifier
ModifierFullName False Edm.String User name of modifier
OssCountry False Edm.String OSS country. Available when OneStopShop featureset is enabled in the administration.
Percentage False Edm.Double Percentage of the VAT code
TaxReturnType False Edm.Int16 Indicates what type of Taxcode it is: can be VAT, IncomeTax
Type False Edm.String Indicates how the VAT amount should be calculated in relation to the invoice amount. B = VAT 0% (Only base amount), E = Excluding, I = Including, N = No VAT
VatDocType False Edm.String Field in VAT code maintenance to calculate different VATs depending on the selected document type. P = purchase invoice, F = freelance invoice, E = expense voucher. The field is valid for witholding tax type
VatMargin False Edm.Byte The VAT margin scheme is used for the trade of secondhand goods which are purchased without VAT (for example when a company buys a secondhand good from a private person). In the VAT margin scheme, the VAT is not calculated based on the sales price. Instead of that, the VAT is calculated based on the margin (gross sales price minus the gross purchase price)
VATPartialRatio False Edm.Int16 Partial ratio explains which part of the VAT the company has to pay. Used in some branches where the sellers have a bad reputation, so the buyers have to take over the VAT-liability
VATPercentages False VAT percentages. You can have several VAT percentages, with start and end dates
VATTransactionType False Edm.String Indicates the type of transactions for which the VAT code may be used. B = Both, P = Purchase, S = Sales

Returns