---
title: "DeclarationsByRange (Twinfield)"
description: "VAT Declarations by Range"
language: en
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/en/datamodels/twinfield/Twinfield.Twinfield.DeclarationsByRange
original: https://documentation.invantive.eu/en/datamodels/twinfield/Twinfield.Twinfield.DeclarationsByRange
updated: 2026-11-01T17:45:47Z
license: https://documentation.invantive.eu/en/
---

# DeclarationsByRange: Twinfield VAT Declarations by Range

`read only` `per partition` `XML`

- Catalog: `Twinfield`
- Schema: `Twinfield`
- Label: VAT Declarations by Range

The data in this table is partitioned per value of the `COMPANY_CODE` column.

Can only retrieve data.

## Summary

Declaration summaries.

## API Source

- XML service: `webservices/declarations.asmx`
- XML topic: `DeclarationsByRange`
- XML path: `/tns:vatReturn/tns:DeclarationSummary`
- SOAP action: `GetRangeOfSummaries`

## Performance Characteristics

| Characteristic | Value |
|---|---:|
| Average access latency (ms) | 54 |
| Full scan rows per minute | 1,690 |
| Point query rows per minute | 1,111 |
| Write rows per minute | 2,080 |

The result can be cached on the client.

## Parameters

| Name | Data Type | Required | Default | Documentation |
|---|---|:---:|---|---|
| `COMPANY_CODE` | `` | [ ] |  | Code of company. |
| `count` | `` | [x] |  | Count. |
| `startIndex` | `` | [x] |  | Start index. |

## Table Columns

The columns of the table `DeclarationsByRange` are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert and update.

| Name | Data Type | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `ASSIGNEECODE` | `varchar2` | Tfd Assignee Code | [ ] | `/soap:Envelope/soap:Body/tns:GetRangeOfSummariesResponse/tns:vatReturn/tns:DeclarationSummary/tns:Assignee/tns:Code` |  |
| `ASSIGNEENAME` | `varchar2` | Tfd Assignee Name | [ ] | `/soap:Envelope/soap:Body/tns:GetRangeOfSummariesResponse/tns:vatReturn/tns:DeclarationSummary/tns:Assignee/tns:Name` |  |
| `COMPANY_CODE` | `varchar2` | Company ID | [x] |  |  |
| `COMPANY_NAME` | `varchar2` | Company Name | [x] |  |  |
| `DOCUMENTCODE` | `varchar2` | Tfd Document Code | [ ] | `/soap:Envelope/soap:Body/tns:GetRangeOfSummariesResponse/tns:vatReturn/tns:DeclarationSummary/tns:DocumentCode` |  |
| `ID` | `int32` | Tfd ID | [x] | `/soap:Envelope/soap:Body/tns:GetRangeOfSummariesResponse/tns:vatReturn/tns:DeclarationSummary/tns:Id` |  |
| `NAME` | `varchar2` | Tfd Name | [ ] | `/soap:Envelope/soap:Body/tns:GetRangeOfSummariesResponse/tns:vatReturn/tns:DeclarationSummary/tns:Name` |  |
| `PERIOD` | `varchar2` | Tfd Period | [x] | `/soap:Envelope/soap:Body/tns:GetRangeOfSummariesResponse/tns:vatReturn/tns:DeclarationSummary/tns:DocumentTimeFrame/tns:Period` |  |
| `STATUSDESCRIPTION` | `varchar2` | Tfd Status Description | [ ] | `/soap:Envelope/soap:Body/tns:GetRangeOfSummariesResponse/tns:vatReturn/tns:DeclarationSummary/tns:Status/tns:Description` |  |
| `STATUSEXTRAINFORMATION` | `varchar2` | Tfd Status Extra Information | [ ] | `/soap:Envelope/soap:Body/tns:GetRangeOfSummariesResponse/tns:vatReturn/tns:DeclarationSummary/tns:Status/tns:ExtraInformation` |  |
| `STATUSSTEP` | `int32` | Tfd Status Step | [x] | `/soap:Envelope/soap:Body/tns:GetRangeOfSummariesResponse/tns:vatReturn/tns:DeclarationSummary/tns:Status/tns:StepIndex` | Status: 1 = Created, 2 = Modified, 3 = Sending, 4 = Error while sending, 5 = Sent, 6 = Rejected, 7 = Approved, 8 = Authorized. |
| `YEAR` | `int32` | Tfd Year | [x] | `/soap:Envelope/soap:Body/tns:GetRangeOfSummariesResponse/tns:vatReturn/tns:DeclarationSummary/tns:DocumentTimeFrame/tns:Year` |  |



## Release Notes

What changed per release in the tables, columns, attributes and capabilities of the driver:

- [Twinfield](/en/release-notes/drivers?driver=twinfield)

