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
EDI message name

The name of the EDI message

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

/b24Message/taxControl/@text

 Text 1.00 1
Environment

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

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

/b24Message/taxControl/@environment

 Text 2.00 2
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 3.00 3
Btwentyfour message ID

Message ID set by Btwentyfour Open Commerce Platform.

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

/b24Message/taxControl/@messageId

 Number 4.00 4
Btwentyfour message date

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 5.00 5
Sender Yes

The sender of the EDI message, identified by a GLN

 
 <sender gln="7340117815580">

/b24Message/taxControl/sender/@gln

 Number 6.00 6
Recipient Yes

The recipient of the EDI message, identified by a GLN

 
 <recipient gln="7340117836950">

/b24Message/taxControl/recipient/@gln

 Number 7.00 7
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 8.00 8
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 9.00 9
Previous tax control number

The last exchanged tax control number

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

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

 Text 10.00 10
Previous tax control date

The last exchanged tax control date

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

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

 Date/Time 11.00 11
Accounting period start date

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 12.00 12
Accounting period end date

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 13.00 13
Tax period start date

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 14.00 14
Tax period end date

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 15.00 15
Invoicing period start date

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 16.00 16
Invoicing period end date

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 17.00 17
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 18.00 18
Supplier Name

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 19.00 19
Supplier Address

Address of the supplier party

 
 <address>StreetAddress</address>

/b24Message/taxControl/supplier/location/address

 Text 20.00 20
Supplier Zip Code

Zip code of the supplier party

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

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

 Text 21.00 21
Supplier City

City of the supplier party

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

/b24Message/taxControl/supplier/location/city

 Text 22.00 22
Supplier Country

Country of the supplier party

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

/b24Message/taxControl/supplier/location/country

 Text 23.00 23
Supplier Country Code

Country code of the supplier party

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

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

 Text 24.00 24
Supplier Org Number

Corporate identity number of the supplier party

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

/b24Message/taxControl/supplier/@orgNo

 Text 25.00 25
Supplier VAT number

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

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

/b24Message/taxControl/supplier/@vatNo

 Text 26.00 26
Supplier external ID

External identifier, set by sender of the message

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

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

 Text 27.00 27
Supplier internal ID

Internal identifier, mapped in the Btwentyfour Open Commerce Platform.

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

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

 Text 28.00 28
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 29.00 29
Buyer Name

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 30.00 30
Buyer Address

Address of the buyer party

 
 <address>StreetAddress</address>

/b24Message/taxControl/buyer/location/address

 Text 31.00 31
Buyer Zip Code

Zip code of the buyer party

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

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

 Text 32.00 32
Buyer City

City of the buyer party

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

/b24Message/taxControl/buyer/location/city

 Text 33.00 33
Buyer Country

Country of the buyer party

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

/b24Message/taxControl/buyer/location/country

 Text 34.00 34
Buyer Country Code

Country code of the buyer party

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

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

 Text 35.00 35
Buyer Org Number

Corporate identity number of the buyer party

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

/b24Message/taxControl/buyer/@orgNo

 Text 36.00 36
Buyer VAT number

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

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

/b24Message/taxControl/buyer/@vatNo

 Text 37.00 37
Buyer external ID

External identifier, set by sender of the message

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

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

 Text 38.00 38
Buyer internal ID

Internal identifier, mapped in the Btwentyfour Open Commerce Platform.

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

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

 Text 39.00 39
Buyer agent GLN

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 40.00 40
Buyer agent name

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 41.00 41
Buyer agent Address

Address of the buyer agent party

 
 <address>StreetAddress</address>

/b24Message/taxControl/buyerAgent/location/address

 Text 42.00 42
Buyer agent Zip Code

Zip code of the buyer agent party

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

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

 Text 43.00 43
Buyer agent City

City of the buyer agent party

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

/b24Message/taxControl/buyerAgent/location/city

 Text 44.00 44
Buyer agent Country

Country of the buyer agent party

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

/b24Message/taxControl/buyerAgent/location/country

 Text 45.00 45
Buyer agent Country Code

Country code of the buyer agent party

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

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

 Text 46.00 46
Buyer agent Org Number

Corporate identity number of the buyer agent party

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

/b24Message/taxControl/buyerAgent/@orgNo

 Text 47.00 47
Buyer agent VAT number

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

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

/b24Message/taxControl/buyerAgent/@vatNo

 Text 48.00 48
Buyer agent external ID

External identifier, set by sender of the message

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

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

 Text 49.00 49
Buyer agent internal ID

Internal identifier, mapped in the Btwentyfour Open Commerce Platform.

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

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

 Text 50.00 50
Supplier agent GLN

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 51.00 51
Supplier agent Name

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 52.00 52
Supplier agent Address

Address of the supplier agent party

 
 <address>StreetAddress</address>

/b24Message/taxControl/supplierAgent/location/address

 Text 53.00 53
Supplier agent Zip Code

Zip code of the supplier agent party

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

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

 Text 54.00 54
Supplier agent City

City of the supplier agent party

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

/b24Message/taxControl/supplierAgent/location/city

 Text 55.00 55
Supplier agent Country

Country of the supplier agent party

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

/b24Message/taxControl/supplierAgent/location/country

 Text 56.00 56
Supplier agent Country Code

Country code of the supplier agent party

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

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

 Text 57.00 57
Supplier agent Org Number

Corporate identity number of the supplier agent party

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

/b24Message/taxControl/supplierAgent/@orgNo

 Text 58.00 58
Supplier agent VAT number

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

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

/b24Message/taxControl/supplierAgent/@vatNo

 Text 59.00 59
Supplier agent external ID

External identifier, set by sender of the message

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

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

 Text 60.00 60
Supplier agent internal ID

Internal identifier, mapped in the Btwentyfour Open Commerce Platform.

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

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

 Text 61.00 61
Tax collector GLN

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 62.00 62
Tax collector Name

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 63.00 63
Tax collector Address

Address of the tax collector party

 
 <address>StreetAddress</address>

/b24Message/taxControl/taxCollector/location/address

 Text 64.00 64
Tax collector Zip Code

Zip code of the tax collector party

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

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

 Text 65.00 65
Tax collector City

City of the tax collector party

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

/b24Message/taxControl/taxCollector/location/city

 Text 66.00 66
Tax collector Country

Country of the tax collector party

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

/b24Message/taxControl/taxCollector/location/country

 Text 67.00 67
Tax collector Country Code

Country code of the tax collector party

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

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

 Text 68.00 68
Tax collector Org Number

Corporate identity number of the tax collector party

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

/b24Message/taxControl/taxCollector/@orgNo

 Text 69.00 69
Tax collector VAT number

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

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

/b24Message/taxControl/taxCollector/@vatNo

 Text 70.00 70
Tax collector external ID

External identifier, set by sender of the message

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

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

 Text 71.00 71
Tax collector internal ID

Internal identifier, mapped in the Btwentyfour Open Commerce Platform.

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

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

 Text 72.00 72
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 73.00 73
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

 74.00 74
Invoice number

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 75.00 75
Invoice date

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 76.00 76
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 77.00 77
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 78.00 78
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 79.00 79
Total non taxable amount

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 80.00 80
Total amount inc taxes

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 81.00 81
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 82.00 82
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 83.00 83
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 84.00 84
Tax rate Yes

Tax rate in percentage (%)

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

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

 Number 85.00 85
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 86.00 86
Tax amount Yes

Taxable amount (subject to specified tax rate)

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

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

 Number 87.00 87
Invoicing currency Yes

The invoicing currency

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

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

 Text 88.00 88