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

# TransactionByNumber: Twinfield Transaction by Number

`read only` `per partition` `XML`

- Catalog: `Twinfield`
- Schema: `Settings`
- Label: Transaction by Number

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

Can only retrieve data.

## Summary

The head of one financial transaction, of whichever daybook. Carries what a browse does not: where the transaction came from, who entered it and when it was last changed. Its lines are answered by TransactionLinesByNumber.

## API Source

- XML service: `webservices/processxml.asmx`
- XML topic: `transaction`
- XML path: `/transaction/header`

## 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 | 376 |

The result can be cached on the client.

## Parameters

| Name | Data Type | Required | Default | Documentation |
|---|---|:---:|---|---|
| `code` | `` | [x] |  | Code of the daybook, such as VRK for sales. |
| `COMPANY_CODE` | `` | [x] |  | Code of company. |
| `number` | `` | [x] |  | Number of the transaction within the daybook. |

## Table Columns

The columns of the table `TransactionByNumber` 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 |
|---|---|---|:---:|---|---|
| `CODE` | `varchar2` | Code | [ ] | `/soap:Envelope/soap:Body/tns:ProcessXmlDocumentResponse/tns:ProcessXmlDocumentResult/transaction/header/code` | Code of the daybook. |
| `CODE_NAME` | `varchar2` | Daybook Name | [ ] | `/soap:Envelope/soap:Body/tns:ProcessXmlDocumentResponse/tns:ProcessXmlDocumentResult/transaction/header/code/name` |  |
| `COMPANY_CODE` | `varchar2` | Company ID | [x] |  |  |
| `COMPANY_NAME` | `varchar2` | Company Name | [x] |  |  |
| `CURRENCY` | `varchar2` | Currency | [ ] | `/soap:Envelope/soap:Body/tns:ProcessXmlDocumentResponse/tns:ProcessXmlDocumentResult/transaction/header/currency` |  |
| `DATE` | `datetime` | Date | [ ] | `/soap:Envelope/soap:Body/tns:ProcessXmlDocumentResponse/tns:ProcessXmlDocumentResult/transaction/header/date` |  |
| `DUEDATE` | `datetime` | Due Date | [ ] | `/soap:Envelope/soap:Body/tns:ProcessXmlDocumentResponse/tns:ProcessXmlDocumentResult/transaction/header/duedate` |  |
| `FREETEXT1` | `varchar2` | Free Text 1 | [ ] | `/soap:Envelope/soap:Body/tns:ProcessXmlDocumentResponse/tns:ProcessXmlDocumentResult/transaction/header/freetext1` |  |
| `FREETEXT2` | `varchar2` | Free Text 2 | [ ] | `/soap:Envelope/soap:Body/tns:ProcessXmlDocumentResponse/tns:ProcessXmlDocumentResult/transaction/header/freetext2` |  |
| `FREETEXT3` | `varchar2` | Free Text 3 | [ ] | `/soap:Envelope/soap:Body/tns:ProcessXmlDocumentResponse/tns:ProcessXmlDocumentResult/transaction/header/freetext3` |  |
| `INPUTDATE` | `datetime` | Input Date | [ ] | `/soap:Envelope/soap:Body/tns:ProcessXmlDocumentResponse/tns:ProcessXmlDocumentResult/transaction/header/inputdate` |  |
| `INVOICENUMBER` | `varchar2` | Invoice Number | [ ] | `/soap:Envelope/soap:Body/tns:ProcessXmlDocumentResponse/tns:ProcessXmlDocumentResult/transaction/header/invoicenumber` |  |
| `MODIFICATIONDATE` | `datetime` | Modified | [ ] | `/soap:Envelope/soap:Body/tns:ProcessXmlDocumentResponse/tns:ProcessXmlDocumentResult/transaction/header/modificationdate` |  |
| `NUMBER` | `varchar2` | Number | [ ] | `/soap:Envelope/soap:Body/tns:ProcessXmlDocumentResponse/tns:ProcessXmlDocumentResult/transaction/header/number` |  |
| `OFFICE` | `varchar2` | Office | [ ] | `/soap:Envelope/soap:Body/tns:ProcessXmlDocumentResponse/tns:ProcessXmlDocumentResult/transaction/header/office` |  |
| `ORIGIN` | `varchar2` | Origin | [ ] | `/soap:Envelope/soap:Body/tns:ProcessXmlDocumentResponse/tns:ProcessXmlDocumentResult/transaction/header/origin` | How the transaction came about, such as by hand or from a bank statement. |
| `ORIGINREFERENCE` | `varchar2` | Origin Reference | [ ] | `/soap:Envelope/soap:Body/tns:ProcessXmlDocumentResponse/tns:ProcessXmlDocumentResult/transaction/header/originreference` |  |
| `PAYMENTREFERENCE` | `varchar2` | Payment Reference | [ ] | `/soap:Envelope/soap:Body/tns:ProcessXmlDocumentResponse/tns:ProcessXmlDocumentResult/transaction/header/paymentreference` |  |
| `PERIOD` | `varchar2` | Period | [ ] | `/soap:Envelope/soap:Body/tns:ProcessXmlDocumentResponse/tns:ProcessXmlDocumentResult/transaction/header/period` | Financial period, as year and period separated by a solidus. |
| `USER` | `varchar2` | User | [ ] | `/soap:Envelope/soap:Body/tns:ProcessXmlDocumentResponse/tns:ProcessXmlDocumentResult/transaction/header/user` | User who entered the transaction. |
| `USER_NAME` | `varchar2` | User Name | [ ] | `/soap:Envelope/soap:Body/tns:ProcessXmlDocumentResponse/tns:ProcessXmlDocumentResult/transaction/header/user/name` |  |



## Release Notes

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

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

### Changes of This Table, 26.0 to 27.0

<div class="rn-item" id="TFD-27.0-D013">

##### Table function Twinfield.Settings.TransactionByNumber is added

The table function has 21 columns and can select.

<div class="rn-chips">

- importance 3

</div>

</div>

[All changes of the driver, 26.0 to 27.0](/en/release-notes/drivers?driver=twinfield&step=26.0-to-27.0#twinfield-26.0-to-27.0)

