Body

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