TAXCODE: Tax code
A tax code defining a named tax rate for application to client invoices and purchase transactions.
TAXCODE definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches TAXCODE.Entity properties
| Property | Value |
|---|---|
| Entity code | TAXCODE |
| Display name | Tax code |
| Plural | Tax codes |
| Level | 250 |
Use cases
A tax code defining a named tax rate for application to client invoices and purchase transactions.
TAXCODE stores tax codes with their associated rates, used for invoice and transaction tax calculation. Both CLIENT and COM reference TAXCODE via the taxcode objectLookup in the Administration panel. Each record has a human-readable name (e.g. 'Standard Rate', 'Reduced Rate', 'Zero Rated'), a short code for integration with accounting systems, a numeric rate (as a percentage), and optional comments explaining applicability. This entity supports multi-jurisdiction tax handling by allowing different tax codes for different countries or product types. The code field is marked as required, ensuring every tax code has a system-compatible identifier for export to external finance systems.
Fields
General
| Field | Type | Required | Notes |
|---|---|---|---|
name | text | Yes | Name. |
code | text | Yes | Code. |
rate | number | Yes | Rate. |
comments | text (multi-line) | Comments. |
Relationships
No declared relationships in the default definition.
Creating a Tax code via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "TAXCODE",
"level": 250,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Example name",
"code": "Example code",
"rate": 0
}Listing Tax codes
GET /v1/entities/TAXCODE/SUB