About Tax Codes

Tax Codes

The Taxes API allow external parties to Create, Read, Update, and Delete a companies tax codes within Pleo.

They are used to calculate the tax for each expense for proper reporting. A tax code is linked to a category (type of spend defined by the user), so all spend classified within this category will have a default tax code attached to it.

As part of the review process for expense before exporting from Pleo, a bookkeeper is able to change this tax code manually if the default tax code is not correct or if the expense needs multiple tax rates according to the line items of the purchase.

Tax Code Object

ObjectTypeDescription
accountingIntegrationSystemstringThe accounting system used by the customer
archivedbooleanThe flag used to archive or unarchive an account. When set to true, account is not visible or usable on the platform.
codestringThe accounting system's internal identifier of the tax code
companyIdstringThe Pleo unique identifier of the company the tax code belongs to
createdAtstringDate and time the tax code was created

Format: YYYY-MM-DDTHH:mi:ssZ
IdstringThe unique identifier generated by Pleo for the tax code
ingoingTaxAccountstringIngoing tax account is usually used to account for reverse VAT
namestringName of the tax code

Example: Standard (20%)
outgoingTaxAccountstringOutgoing tax account usually used to account for reverse VAT
ratenumberPercentage rate applied for this tax code represented in decimals and not the percentage. e.g. 20% tax rate would be 0.20
typeenumClassification of this tax code
inclusive
exclusive
reverse
updatedAtstringDate and time the tax code was last updated

Format: YYYY-MM-DDTHH:mi:ssZ