xml TAXCON (Tax Control)

A Tax Control message is used to enable the transmission of information relating to the tax details for an invoice, or a batch / batches of invoice messages (Invoices, Credit Notes, Debit Notes).

Fields used in the TAXCON message

In the below table you find a comprehensive list of required and optional fields for Tax control data.

Name Required Description Examples Xpath Type Limits Sort Id
(Header) : EDI message name No

The name of the EDI message

 
 <taxControl text="Btwentyfour Example Tax control message">

/b24Message/taxControl/@text

 Text 1000.00 1
(Header) : Environment No

Environment/test indicator - either "Production" or "Test"

 
 <taxControl text="Btwentyfour Example Tax control message" environment="Test">

/b24Message/taxControl/@environment

 Text 1100.00 2
(Header) : Tax control type Yes

Indicate that the message include a general tax declaration, predefined value; "TaxDeclaration"

 
 <taxControl text="Btwentyfour Example Tax control message" type="TaxDeclaration">

/b24Message/taxControl/@type

 Text 1200.00 3
(Header) : Btwentyfour message ID No

Message ID set by Btwentyfour Open Commerce Platform.

 
 <taxControl text="Btwentyfour Example Tax control message" messageId="237357">

/b24Message/taxControl/@messageId

 Number 1300.00 4
(Header) : Btwentyfour message date No

Message date set by Btwentyfour Open Commerce Platform.

 
 <taxControl text="Btwentyfour Example Tax control message" messageDate="2021-06-14T12:19:05.167Z">

/b24Message/taxControl/@messageDate

 Date/Time 1400.00 5
(Header) : Sender Yes

The sender of the EDI message, identified by a GLN

 
 <sender gln="7340117815580">

/b24Message/taxControl/sender/@gln

 Number 1500.00 6
(Header) : Recipient Yes

The recipient of the EDI message, identified by a GLN

 
 <recipient gln="7340117836950">

/b24Message/taxControl/recipient/@gln

 Number 1600.00 7
(Header) : Tax control number Yes

The unique tax control number set by the supplier

 
 <documentReference documentType="TaxControl" id="222">

/b24Message/taxControl/documentReference[@documentType="TaxControl"]/@id

 Text 1700.00 8
(Header) : Tax control date Yes

The tax control date set by the supplier

 
 <documentReference documentType="TaxControl" id="222" date="2021-06-01">

/b24Message/taxControl/documentReference[@documentType="TaxControl"]/@date

 Date/Time 1800.00 9
(Header) : Previous tax control number No

The last exchanged tax control number

 
 <documentReference documentType="PreviousTaxControl" id="111">

/b24Message/taxControl/documentReference[@documentType="PreviousTaxControl"]/@id

 Text 1900.00 10
(Header) : Previous tax control date No

The last exchanged tax control date

 
 <documentReference documentType="PreviousTaxControl" id="111" date="2021-05-01">

/b24Message/taxControl/documentReference[@documentType="PreviousTaxControl"]/@date

 Date/Time 2000.00 11
(Header) : Accounting period start date No

The accounting period start date to which the tax control message relates

 
 <property name="accountingPeriodStartDate">2021-05-01</property>

/b24Message/taxControl/property[@name="accountingPeriodStartDate"]

 Date/Time 2100.00 12
(Header) : Accounting period end date No

The accounting period end date to which the tax control message relates

 
 <property name="accountingPeriodEndDate">2021-06-01</property>

/b24Message/taxControl/property[@name="accountingPeriodEndDate"]

 Date/Time 2200.00 13
(Header) : Tax period start date No

The tax period start date to which the tax control message relates

 
 <property name="taxPeriodStartDate">2021-05-01</property>

/b24Message/taxControl/property[@name="taxPeriodStartDate"]

 Date/Time 2300.00 14
(Header) : Tax period end date No

The tax period end date to which the tax control message relates

 
 <property name="taxPeriodEndDate">2021-06-01</property>

/b24Message/taxControl/property[@name="taxPeriodEndDate"]

 Date/Time 2400.00 15
(Header) : Invoicing period start date No

The invoicing period start date to which the tax control message relates

 
 <property name="invoicingPeriodStartDate">2021-05-01</property>

/b24Message/taxControl/property[@name="invoicingPeriodStartDate"]

 Date/Time 2500.00 16
(Header) : Invoicing period end date No

The invoicing period end date to which the tax control message relates

 
 <property name="invoicingPeriodEndDate">2021-06-01</property>

/b24Message/taxControl/property[@name="invoicingPeriodEndDate"]

 Date/Time 2600.00 17
(Header) : Supplier GLN Yes

The supplier/brand, identified by a GLN

 
 <supplier gln="7340117815580" name="Btwentyfour Demo Supplier" contact="ReferenceName" reference="ReferenceNumber" orgNo="99999999-9999" vatNo="GB999999999">

/b24Message/taxControl/supplier/@gln

 Number 2700.00 18
(Header) : Supplier Name No

Name of the supplier party

 
 <supplier gln="7340117815580" name="Btwentyfour Demo Supplier" contact="ReferenceName" reference="ReferenceNumber" orgNo="99999999-9999" vatNo="GB999999999">

/b24Message/taxControl/supplier/@name

 Text 2800.00 19
(Header) : Supplier Address No

Address of the supplier party

 
 <address>StreetAddress</address>

/b24Message/taxControl/supplier/location/address

 Text 2900.00 20
(Header) : Supplier Zip Code No

Zip code of the supplier party

 
 <city code="ZipCode">CityName</city>

/b24Message/taxControl/supplier/location/city/@code

 Text 3000.00 21
(Header) : Supplier City No

City of the supplier party

 
 <city code="ZipCode">CityName</city>

/b24Message/taxControl/supplier/location/city

 Text 3100.00 22
(Header) : Supplier Country No

Country of the supplier party

 
 <country code="CountryCode">CountryName</country>

/b24Message/taxControl/supplier/location/country

 Text 3200.00 23
(Header) : Supplier Country Code No

Country code of the supplier party

 
 <country code="CountryCode">CountryName</country>

/b24Message/taxControl/supplier/location/country/@code

 Text 3300.00 24
(Header) : Supplier Org Number No

Corporate identity number of the supplier party

 
 <supplier gln="7340117815580" orgNo="99999999-9999">

/b24Message/taxControl/supplier/@orgNo

 Text 3400.00 25
(Header) : Supplier VAT number No

VAT number (value added tax number) of the supplier party

 
 <supplier gln="7340117815580" vatNo="GB999999999">

/b24Message/taxControl/supplier/@vatNo

 Text 3500.00 26
(Header) : Supplier external ID No

External identifier, set by sender of the message

 
 <property name="id">5122186</property>

/b24Message/taxControl/supplier/property[@name="id"]

 Text 3600.00 27
(Header) : Supplier internal ID No

Internal identifier, mapped in the Btwentyfour Open Commerce Platform.

 
 <property name="internalId">8899</property>

/b24Message/taxControl/supplier/property[@name="internalId"]

 Text 3700.00 28
(Header) : Buyer GLN Yes

The buying party, identified by a GLN

 
 <buyer gln="7340117836950" name="Btwentyfour Demo Buying Group" contact="Buyer's contact reference" reference="ReferenceNumber" orgNo="88888888-8888" vatNo="GB888888888">

/b24Message/taxControl/buyer/@gln

 Number 3800.00 29
(Header) : Buyer Name No

Name of the buyer party

 
 <buyer gln="7340117836950" name="Btwentyfour Demo Buying Group" contact="Buyer's contact reference" reference="ReferenceNumber" orgNo="88888888-8888" vatNo="GB888888888">

/b24Message/taxControl/buyer/@name

 Text 3900.00 30
(Header) : Buyer Address No

Address of the buyer party

 
 <address>StreetAddress</address>

/b24Message/taxControl/buyer/location/address

 Text 4000.00 31
(Header) : Buyer Zip Code No

Zip code of the buyer party

 
 <city code="ZipCode">CityName</city>

/b24Message/taxControl/buyer/location/city/@code

 Text 4100.00 32
(Header) : Buyer City No

City of the buyer party

 
 <city code="ZipCode">CityName</city>

/b24Message/taxControl/buyer/location/city

 Text 4200.00 33
(Header) : Buyer Country No

Country of the buyer party

 
 <country code="CountryCode">CountryName</country>

/b24Message/taxControl/buyer/location/country

 Text 4300.00 34
(Header) : Buyer Country Code No

Country code of the buyer party

 
 <country code="CountryCode">CountryName</country>

/b24Message/taxControl/buyer/location/country/@code

 Text 4400.00 35
(Header) : Buyer Org Number No

Corporate identity number of the buyer party

 
 <buyer gln="7340117836950" orgNo="88888888-8888">

/b24Message/taxControl/buyer/@orgNo

 Text 4500.00 36
(Header) : Buyer VAT number No

VAT number (value added tax number) of the buyer party

 
 <buyer gln="7340117836950" vatNo="GB888888888">

/b24Message/taxControl/buyer/@vatNo

 Text 4600.00 37
(Header) : Buyer external ID No

External identifier, set by sender of the message

 
 <property name="id">5122186</property>

/b24Message/taxControl/buyer/property[@name="id"]

 Text 4700.00 38
(Header) : Buyer internal ID No

Internal identifier, mapped in the Btwentyfour Open Commerce Platform.

 
 <property name="internalId">8899</property>

/b24Message/taxControl/buyer/property[@name="internalId"]

 Text 4800.00 39
(Header) : Buyer agent GLN No

The buying agent party, identified by a GLN

 
 <buyerAgent gln="Buyer agent GLN" name="Buyer agent name" orgNo="77777777-7777" vatNo="GB777777777">

/b24Message/taxControl/buyerAgent/@gln

 Number 4900.00 40
(Header) : Buyer agent name No

Name of the buyer agent party

 
 <buyerAgent gln="Buyer agent GLN" name="Buyer agent name" orgNo="77777777-7777" vatNo="GB777777777">

/b24Message/taxControl/buyerAgent/@name

 Text 5000.00 41
(Header) : Buyer agent Address No

Address of the buyer agent party

 
 <address>StreetAddress</address>

/b24Message/taxControl/buyerAgent/location/address

 Text 5100.00 42
(Header) : Buyer agent Zip Code No

Zip code of the buyer agent party

 
 <city code="ZipCode">CityName</city>

/b24Message/taxControl/buyerAgent/location/city/@code

 Text 5200.00 43
(Header) : Buyer agent City No

City of the buyer agent party

 
 <city code="ZipCode">CityName</city>

/b24Message/taxControl/buyerAgent/location/city

 Text 5300.00 44
(Header) : Buyer agent Country No

Country of the buyer agent party

 
 <country code="CountryCode">CountryName</country>

/b24Message/taxControl/buyerAgent/location/country

 Text 5400.00 45
(Header) : Buyer agent Country Code No

Country code of the buyer agent party

 
 <country code="CountryCode">CountryName</country>

/b24Message/taxControl/buyerAgent/location/country/@code

 Text 5500.00 46
(Header) : Buyer agent Org Number No

Corporate identity number of the buyer agent party

 
 <buyerAgent gln="Buyer agent GLN" orgNo="77777777-7777">

/b24Message/taxControl/buyerAgent/@orgNo

 Text 5600.00 47
(Header) : Buyer agent VAT number No

VAT number (value added tax number) of the buyer agent party

 
 <buyerAgent gln="Buyer agent GLN" vatNo="GB777777777">

/b24Message/taxControl/buyerAgent/@vatNo

 Text 5700.00 48
(Header) : Buyer agent external ID No

External identifier, set by sender of the message

 
 <property name="id">5122186</property>

/b24Message/taxControl/buyerAgent/property[@name="id"]

 Text 5800.00 49
(Header) : Buyer agent internal ID No

Internal identifier, mapped in the Btwentyfour Open Commerce Platform.

 
 <property name="internalId">8899</property>

/b24Message/taxControl/buyerAgent/property[@name="internalId"]

 Text 5900.00 50
(Header) : Supplier agent GLN No

The supplier agent, identified by a GLN

 
 <supplierAgent gln="Supplier agent GLN" name="Supplier agent name" orgNo="77777777-6666" vatNo="GB777777776">

/b24Message/taxControl/supplierAgent/@gln

 Number 6000.00 51
(Header) : Supplier agent Name No

Name of the supplier agent party

 
 <supplierAgent gln="Supplier agent GLN" name="Supplier agent name" orgNo="77777777-6666" vatNo="GB777777776">

/b24Message/taxControl/supplierAgent/@name

 Text 6100.00 52
(Header) : Supplier agent Address No

Address of the supplier agent party

 
 <address>StreetAddress</address>

/b24Message/taxControl/supplierAgent/location/address

 Text 6200.00 53
(Header) : Supplier agent Zip Code No

Zip code of the supplier agent party

 
 <city code="ZipCode">CityName</city>

/b24Message/taxControl/supplierAgent/location/city/@code

 Text 6300.00 54
(Header) : Supplier agent City No

City of the supplier agent party

 
 <city code="ZipCode">CityName</city>

/b24Message/taxControl/supplierAgent/location/city

 Text 6400.00 55
(Header) : Supplier agent Country No

Country of the supplier agent party

 
 <country code="CountryCode">CountryName</country>

/b24Message/taxControl/supplierAgent/location/country

 Text 6500.00 56
(Header) : Supplier agent Country Code No

Country code of the supplier agent party

 
 <country code="CountryCode">CountryName</country>

/b24Message/taxControl/supplierAgent/location/country/@code

 Text 6600.00 57
(Header) : Supplier agent Org Number No

Corporate identity number of the supplier agent party

 
 <supplierAgent gln="Supplier agent GLN" orgNo="77777777-6666">

/b24Message/taxControl/supplierAgent/@orgNo

 Text 6700.00 58
(Header) : Supplier agent VAT number No

VAT number (value added tax number) of the supplier agent party

 
 <supplierAgent gln="Supplier agent GLN" vatNo="GB777777776">

/b24Message/taxControl/supplierAgent/@vatNo

 Text 6800.00 59
(Header) : Supplier agent external ID No

External identifier, set by sender of the message

 
 <property name="id">6563221</property>

/b24Message/taxControl/supplierAgent/property[@name="id"]

 Text 6900.00 60
(Header) : Supplier agent internal ID No

Internal identifier, mapped in the Btwentyfour Open Commerce Platform.

 
 <property name="internalId">6336</property>

/b24Message/taxControl/supplierAgent/property[@name="internalId"]

 Text 7000.00 61
(Header) : Tax collector GLN No

The tax collector party, identified by a GLN

 
 <taxCollector gln="Tax collector GLN" name="Tax collector name" orgNo="66666666-5555" vatNo="GB666666665">

/b24Message/taxControl/taxCollector/@gln

 Number 7100.00 62
(Header) : Tax collector Name No

Name of the tax collector party

 
 <taxCollector gln="Tax collector GLN" name="Tax collector name" orgNo="66666666-5555" vatNo="GB666666665">

/b24Message/taxControl/taxCollector/@name

 Text 7200.00 63
(Header) : Tax collector Address No

Address of the tax collector party

 
 <address>StreetAddress</address>

/b24Message/taxControl/taxCollector/location/address

 Text 7300.00 64
(Header) : Tax collector Zip Code No

Zip code of the tax collector party

 
 <city code="ZipCode">CityName</city>

/b24Message/taxControl/taxCollector/location/city/@code

 Text 7400.00 65
(Header) : Tax collector City No

City of the tax collector party

 
 <city code="ZipCode">CityName</city>

/b24Message/taxControl/taxCollector/location/city

 Text 7500.00 66
(Header) : Tax collector Country No

Country of the tax collector party

 
 <country code="CountryCode">CountryName</country>

/b24Message/taxControl/taxCollector/location/country

 Text 7600.00 67
(Header) : Tax collector Country Code No

Country code of the tax collector party

 
 <country code="CountryCode">CountryName</country>

/b24Message/taxControl/taxCollector/location/country/@code

 Text 7700.00 68
(Header) : Tax collector Org Number No

Corporate identity number of the tax collector party

 
 <taxCollector gln="Tax collector GLN" orgNo="66666666-5555">

/b24Message/taxControl/taxCollector/@orgNo

 Text 7800.00 69
(Header) : Tax collector VAT number No

VAT number (value added tax number) of the tax collector party

 
 <taxCollector gln="Tax collector GLN" vatNo="GB666666665">

/b24Message/taxControl/taxCollector/@vatNo

 Text 7900.00 70
(Header) : Tax collector external ID No

External identifier, set by sender of the message

 
 <property name="id">5855241</property>

/b24Message/taxControl/taxCollector/property[@name="id"]

 Text 8000.00 71
(Header) : Tax collector internal ID No

Internal identifier, mapped in the Btwentyfour Open Commerce Platform.

 
 <property name="internalId">2477</property>

/b24Message/taxControl/taxCollector/property[@name="internalId"]

 Text 8100.00 72
(Header) : Invoice Batch Number Yes

The ID/number identifying a batch of messages (also to be specified on the original invoice messages)

 
 <documentReference documentType="InvoiceBatch" id="456">

/b24Message/taxControl/taxControlDetails/documentReference[@documentType="InvoiceBatch"]/@id

 Text 8200.00 73
(Header) : Invoice Batch Date Yes

The Invoice batch date

 
 <documentReference documentType="InvoiceBatch" id="456" date="2021-05-01">

/b24Message/taxControl/taxControlDetails/documentReference[@documentType="InvoiceBatch"]/@date

 Date/Time

D

 8300.00 74
(Header) : Invoice number No

The ID/number identifying a unique invoice number set by the supplier

 
 <documentReference documentType="InvoiceNumber" id="95159">

/b24Message/taxControl/taxControlDetails/documentReference[@documentType="InvoiceNumber"]/@id

 Text 8400.00 75
(Header) : Invoice date No

The invoice date set by the supplier

 
 <documentReference documentType="InvoiceNumber" id="95159" date="2021-05-01">

/b24Message/taxControl/taxControlDetails/documentReference[@documentType="InvoiceNumber"]/@date

 Date/Time 8500.00 76
(Header) : Document type (Invoice type) Yes

Predefined document type (Invoice type) for the document being referenced - "Debit","Credit","Interest" or "Proforma"

 
 <taxControlDocument type="Debit">

/b24Message/taxControl/taxControlDetails/taxControlDocument/@type

 Text 8600.00 77
(Header) : Currency for the the monetary amounts Yes

The currency in which the monetary amounts in the tax control message is specified relevant to the previous document type

 
 <taxControlDocument type="Debit" currency="GBP">

/b24Message/taxControl/taxControlDetails/taxControlDocument/@currency

 Text 8700.00 78
(Header) : Total taxable amount Yes

Total taxable amount relevant to the previous document type and the referenced invoice or invoice batch. Excluding taxes.

 
 <total taxableAmount="30000.00">

/b24Message/taxControl/taxControlDetails/taxControlDocument/total/@taxableAmount

 Number 8800.00 79
(Header) : Total non taxable amount No

Total non taxable amount relevant to the previous document type and the referenced invoice or invoice batch. Excluding taxes.

 
 <total nonTaxableAmount="0.00">

/b24Message/taxControl/taxControlDetails/taxControlDocument/total/@nonTaxableAmount

 Number 8900.00 80
(Header) : Total amount inc taxes No

Total invoice value relevant to the previous document type and the referenced invoice or invoice batch, Including taxes.

 
 <total netAmountIncTax="36000.00">

/b24Message/taxControl/taxControlDetails/taxControlDocument/total/@netAmountIncTax

 Number 9000.00 81
(Header) : Total number of messages Yes

Total number of messages (invoices) relevant to the previous document type

 
 <property name="totalMessages">3</property>

/b24Message/taxControl/taxControlDetails/taxControlDocument/property[@name="totalMessages"]

 Number 9100.00 82
(Header) : Tax type Yes

Duty/Tax/Fee type code such as VAT = Value added, ENG = energy tax, ENV = environmental tax etc

 
 <taxes code="VAT"/>

/b24Message/taxControl/taxControlDetails/taxControlDocument/taxes/@code

 Text 9200.00 83
(Header) : Tax category Yes

Duty/Tax/Fee category code, predefined values; "Mixed", "Exempt", "Lower", "Standard" or "Zero"

 
 <taxes rateCategory="Standard"/>

/b24Message/taxControl/taxControlDetails/taxControlDocument/taxes/@rateCategory

 Text 9300.00 84
(Header) : Tax rate Yes

Tax rate in percentage (%)

 
 <taxes code="VAT" rate="20.00"/>

/b24Message/taxControl/taxControlDetails/taxControlDocument/taxes/@rate

 Number 9400.00 85
(Header) : Taxable amount Yes

Duty/Tax/Fee amount (subject to specified tax rate)

 
 <taxes code="VAT" taxableAmount="30000.00"/>

/b24Message/taxControl/taxControlDetails/taxControlDocument/taxes/@taxableAmount

 Number 9500.00 86
(Header) : Tax amount Yes

Taxable amount (subject to specified tax rate)

 
 <taxes code="VAT" amount="6000.00"/>

/b24Message/taxControl/taxControlDetails/taxControlDocument/taxes/@amount

 Number 9600.00 87
(Header) : Invoicing currency Yes

The invoicing currency

 
 <taxes code="VAT" currency="GBP"/>

/b24Message/taxControl/taxControlDetails/taxControlDocument/taxes/@currency

 Text 9700.00 88