---
title: "TaxRecord"
canonical: "https://openfinanceguide.com/en/stet/1.6.3/resources/tax-record"
edition: "STET PSD2 API 1.6.3.1"
source: "https://openfinanceguide.com/docs/stet/1.6.3/pdf/api-dsp2-stet-v1.6.3.2-openapi.yaml"
pdf: "https://openfinanceguide.com/docs/stet/1.6.3/pdf/api-dsp2-stet-v1.6.3.1-part-2-functional-model.pdf"
language: "en"
normative: "The normative text is the English PDF and OpenAPI file published by STET. This Markdown reproduces it for reading; where they differ, the PDF prevails."
license: "CC BY 3.0 FR (https://creativecommons.org/licenses/by/3.0/fr/), STET. Converted to Markdown by Open Finance Guide."
---

# TaxRecord

Type: `object` · Kind: ISO20022

Record of tax details
the [period] property embbeds the set of elements used to provide details on the period of time related to the tax payment.
the [amount] property embbeds the set of elements used to provide information on the amount of the tax record.

Fields:

- `type`, `string` — High level code to identify the type of tax details.
  Constraints: maxLength 35.
- `category`, `string` — Specifies the tax code as published by the tax authority.
  Constraints: maxLength 35.
- `categoryDetails`, `string` — Provides further details of the category tax code.
  Constraints: maxLength 35.
- `debtorStatus`, `string` — Code provided by local authority to identify the status of the party that has drawn up the settlement document.
  Constraints: maxLength 35.
- `certificateIdentification`, `string` — Identification number of the tax report as assigned by the taxing authority.
  Constraints: maxLength 35.
- `formsCode`, `string` — Identifies, in a coded form, on which template the tax report is to be provided.
  Constraints: maxLength 35.
- `period`, [`TaxPeriod`](https://openfinanceguide.com/raw/stet/1.6.3/en/resources/tax-period.md)
- `taxAmount`, [`TaxAmount`](https://openfinanceguide.com/raw/stet/1.6.3/en/resources/tax-amount.md)
- `additionalInformation`, `string` — Further details of the tax record.
  Constraints: maxLength 140.

## Example

```json
{
  "type": "NationalTax",
  "category": "VAT",
  "categoryDetails": "VAT02",
  "debtorStatus": "Valid",
  "certificateIdentification": "CertId56RD",
  "formsCode": "FormHJH7",
  "period": {
    "year": "2020",
    "type": "QTR4",
    "fromDate": "2019-10-01",
    "toDate": "2020-01-01"
  },
  "taxAmount": {
    "details": [
      {
        "period": {
          "year": "2020",
          "type": "QTR4",
          "fromDate": "2019-10-01",
          "toDate": "2020-01-01"
        },
        "amount": {
          "amount": 123.45,
          "currency": "EUR"
        }
      }
    ]
  },
  "additionalInformation": "Some comment"
}
```

## Used by

- `GET /accounts/{accountResourceId}/transactions` (accountsTransactionsGet)
- `POST /payment-requests/{paymentRequestResourceId}/confirmation` (paymentRequestConfirmationPost)
- `PUT /payment-requests/{paymentRequestResourceId}` (paymentRequestPut)
- `GET /payment-requests/{paymentRequestResourceId}` (paymentRequestsGet)
- `POST /payment-requests` (paymentRequestsPost)
- `GET /payment-requests/{paymentRequestResourceId}/transactions` (paymentRequestTransactionsGet)