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 |
|
/b24Message/taxControl/@text |
Text | 1.00 | 1 | ||
Environment | Environment/test indicator - either "Production" or "Test" |
|
/b24Message/taxControl/@environment |
Text | 2.00 | 2 | ||
Tax control type | Yes | Indicate that the message include a general tax declaration, predefined value; "TaxDeclaration" |
|
/b24Message/taxControl/@type |
Text | 3.00 | 3 | |
Btwentyfour message ID | Message ID set by Btwentyfour Open Commerce Platform. |
|
/b24Message/taxControl/@messageId |
Number | 4.00 | 4 | ||
Btwentyfour message date | Message date set by Btwentyfour Open Commerce Platform. |
|
/b24Message/taxControl/@messageDate |
Date/Time | 5.00 | 5 | ||
Sender | Yes | The sender of the EDI message, identified by a GLN |
|
/b24Message/taxControl/sender/@gln |
Number | 6.00 | 6 | |
Recipient | Yes | The recipient of the EDI message, identified by a GLN |
|
/b24Message/taxControl/recipient/@gln |
Number | 7.00 | 7 | |
Tax control number | Yes | The unique tax control number set by the supplier |
|
/b24Message/taxControl/documentReference[@documentType="TaxControl"]/@id |
Text | 8.00 | 8 | |
Tax control date | Yes | The tax control date set by the supplier |
|
/b24Message/taxControl/documentReference[@documentType="TaxControl"]/@date |
Date/Time | 9.00 | 9 | |
Previous tax control number | The last exchanged tax control number |
|
/b24Message/taxControl/documentReference[@documentType="PreviousTaxControl"]/@id |
Text | 10.00 | 10 | ||
Previous tax control date | The last exchanged tax control date |
|
/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 |
|
/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 |
|
/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 |
|
/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 |
|
/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 |
|
/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 |
|
/b24Message/taxControl/property[@name="invoicingPeriodEndDate"] |
Date/Time | 17.00 | 17 | ||
Supplier GLN | Yes | The supplier/brand, identified by a GLN |
|
/b24Message/taxControl/supplier/@gln |
Number | 18.00 | 18 | |
Supplier Name | Name of the supplier party |
|
/b24Message/taxControl/supplier/@name |
Text | 19.00 | 19 | ||
Supplier Address | Address of the supplier party |
|
/b24Message/taxControl/supplier/location/address |
Text | 20.00 | 20 | ||
Supplier Zip Code | Zip code of the supplier party |
|
/b24Message/taxControl/supplier/location/city/@code |
Text | 21.00 | 21 | ||
Supplier City | City of the supplier party |
|
/b24Message/taxControl/supplier/location/city |
Text | 22.00 | 22 | ||
Supplier Country | Country of the supplier party |
|
/b24Message/taxControl/supplier/location/country |
Text | 23.00 | 23 | ||
Supplier Country Code | Country code of the supplier party |
|
/b24Message/taxControl/supplier/location/country/@code |
Text | 24.00 | 24 | ||
Supplier Org Number | Corporate identity number of the supplier party |
|
/b24Message/taxControl/supplier/@orgNo |
Text | 25.00 | 25 | ||
Supplier VAT number | VAT number (value added tax number) of the supplier party |
|
/b24Message/taxControl/supplier/@vatNo |
Text | 26.00 | 26 | ||
Supplier external ID | External identifier, set by sender of the message |
|
/b24Message/taxControl/supplier/property[@name="id"] |
Text | 27.00 | 27 | ||
Supplier internal ID | Internal identifier, mapped in the Btwentyfour Open Commerce Platform. |
|
/b24Message/taxControl/supplier/property[@name="internalId"] |
Text | 28.00 | 28 | ||
Buyer GLN | Yes | The buying party, identified by a GLN |
|
/b24Message/taxControl/buyer/@gln |
Number | 29.00 | 29 | |
Buyer Name | Name of the buyer party |
|
/b24Message/taxControl/buyer/@name |
Text | 30.00 | 30 | ||
Buyer Address | Address of the buyer party |
|
/b24Message/taxControl/buyer/location/address |
Text | 31.00 | 31 | ||
Buyer Zip Code | Zip code of the buyer party |
|
/b24Message/taxControl/buyer/location/city/@code |
Text | 32.00 | 32 | ||
Buyer City | City of the buyer party |
|
/b24Message/taxControl/buyer/location/city |
Text | 33.00 | 33 | ||
Buyer Country | Country of the buyer party |
|
/b24Message/taxControl/buyer/location/country |
Text | 34.00 | 34 | ||
Buyer Country Code | Country code of the buyer party |
|
/b24Message/taxControl/buyer/location/country/@code |
Text | 35.00 | 35 | ||
Buyer Org Number | Corporate identity number of the buyer party |
|
/b24Message/taxControl/buyer/@orgNo |
Text | 36.00 | 36 | ||
Buyer VAT number | VAT number (value added tax number) of the buyer party |
|
/b24Message/taxControl/buyer/@vatNo |
Text | 37.00 | 37 | ||
Buyer external ID | External identifier, set by sender of the message |
|
/b24Message/taxControl/buyer/property[@name="id"] |
Text | 38.00 | 38 | ||
Buyer internal ID | Internal identifier, mapped in the Btwentyfour Open Commerce Platform. |
|
/b24Message/taxControl/buyer/property[@name="internalId"] |
Text | 39.00 | 39 | ||
Buyer agent GLN | The buying agent party, identified by a GLN |
|
/b24Message/taxControl/buyerAgent/@gln |
Number | 40.00 | 40 | ||
Buyer agent name | Name of the buyer agent party |
|
/b24Message/taxControl/buyerAgent/@name |
Text | 41.00 | 41 | ||
Buyer agent Address | Address of the buyer agent party |
|
/b24Message/taxControl/buyerAgent/location/address |
Text | 42.00 | 42 | ||
Buyer agent Zip Code | Zip code of the buyer agent party |
|
/b24Message/taxControl/buyerAgent/location/city/@code |
Text | 43.00 | 43 | ||
Buyer agent City | City of the buyer agent party |
|
/b24Message/taxControl/buyerAgent/location/city |
Text | 44.00 | 44 | ||
Buyer agent Country | Country of the buyer agent party |
|
/b24Message/taxControl/buyerAgent/location/country |
Text | 45.00 | 45 | ||
Buyer agent Country Code | Country code of the buyer agent party |
|
/b24Message/taxControl/buyerAgent/location/country/@code |
Text | 46.00 | 46 | ||
Buyer agent Org Number | Corporate identity number of the buyer agent party |
|
/b24Message/taxControl/buyerAgent/@orgNo |
Text | 47.00 | 47 | ||
Buyer agent VAT number | VAT number (value added tax number) of the buyer agent party |
|
/b24Message/taxControl/buyerAgent/@vatNo |
Text | 48.00 | 48 | ||
Buyer agent external ID | External identifier, set by sender of the message |
|
/b24Message/taxControl/buyerAgent/property[@name="id"] |
Text | 49.00 | 49 | ||
Buyer agent internal ID | Internal identifier, mapped in the Btwentyfour Open Commerce Platform. |
|
/b24Message/taxControl/buyerAgent/property[@name="internalId"] |
Text | 50.00 | 50 | ||
Supplier agent GLN | The supplier agent, identified by a GLN |
|
/b24Message/taxControl/supplierAgent/@gln |
Number | 51.00 | 51 | ||
Supplier agent Name | Name of the supplier agent party |
|
/b24Message/taxControl/supplierAgent/@name |
Text | 52.00 | 52 | ||
Supplier agent Address | Address of the supplier agent party |
|
/b24Message/taxControl/supplierAgent/location/address |
Text | 53.00 | 53 | ||
Supplier agent Zip Code | Zip code of the supplier agent party |
|
/b24Message/taxControl/supplierAgent/location/city/@code |
Text | 54.00 | 54 | ||
Supplier agent City | City of the supplier agent party |
|
/b24Message/taxControl/supplierAgent/location/city |
Text | 55.00 | 55 | ||
Supplier agent Country | Country of the supplier agent party |
|
/b24Message/taxControl/supplierAgent/location/country |
Text | 56.00 | 56 | ||
Supplier agent Country Code | Country code of the supplier agent party |
|
/b24Message/taxControl/supplierAgent/location/country/@code |
Text | 57.00 | 57 | ||
Supplier agent Org Number | Corporate identity number of the supplier agent party |
|
/b24Message/taxControl/supplierAgent/@orgNo |
Text | 58.00 | 58 | ||
Supplier agent VAT number | VAT number (value added tax number) of the supplier agent party |
|
/b24Message/taxControl/supplierAgent/@vatNo |
Text | 59.00 | 59 | ||
Supplier agent external ID | External identifier, set by sender of the message |
|
/b24Message/taxControl/supplierAgent/property[@name="id"] |
Text | 60.00 | 60 | ||
Supplier agent internal ID | Internal identifier, mapped in the Btwentyfour Open Commerce Platform. |
|
/b24Message/taxControl/supplierAgent/property[@name="internalId"] |
Text | 61.00 | 61 | ||
Tax collector GLN | The tax collector party, identified by a GLN |
|
/b24Message/taxControl/taxCollector/@gln |
Number | 62.00 | 62 | ||
Tax collector Name | Name of the tax collector party |
|
/b24Message/taxControl/taxCollector/@name |
Text | 63.00 | 63 | ||
Tax collector Address | Address of the tax collector party |
|
/b24Message/taxControl/taxCollector/location/address |
Text | 64.00 | 64 | ||
Tax collector Zip Code | Zip code of the tax collector party |
|
/b24Message/taxControl/taxCollector/location/city/@code |
Text | 65.00 | 65 | ||
Tax collector City | City of the tax collector party |
|
/b24Message/taxControl/taxCollector/location/city |
Text | 66.00 | 66 | ||
Tax collector Country | Country of the tax collector party |
|
/b24Message/taxControl/taxCollector/location/country |
Text | 67.00 | 67 | ||
Tax collector Country Code | Country code of the tax collector party |
|
/b24Message/taxControl/taxCollector/location/country/@code |
Text | 68.00 | 68 | ||
Tax collector Org Number | Corporate identity number of the tax collector party |
|
/b24Message/taxControl/taxCollector/@orgNo |
Text | 69.00 | 69 | ||
Tax collector VAT number | VAT number (value added tax number) of the tax collector party |
|
/b24Message/taxControl/taxCollector/@vatNo |
Text | 70.00 | 70 | ||
Tax collector external ID | External identifier, set by sender of the message |
|
/b24Message/taxControl/taxCollector/property[@name="id"] |
Text | 71.00 | 71 | ||
Tax collector internal ID | Internal identifier, mapped in the Btwentyfour Open Commerce Platform. |
|
/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) |
|
/b24Message/taxControl/taxControlDetails/documentReference[@documentType="InvoiceBatch"]/@id |
Text | 73.00 | 73 | |
Invoice Batch Date | Yes | The Invoice batch date |
|
/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 |
|
/b24Message/taxControl/taxControlDetails/documentReference[@documentType="InvoiceNumber"]/@id |
Text | 75.00 | 75 | ||
Invoice date | The invoice date set by the supplier |
|
/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" |
|
/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 |
|
/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. |
|
/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. |
|
/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. |
|
/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 |
|
/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 |
|
/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" |
|
/b24Message/taxControl/taxControlDetails/taxControlDocument/taxes/@rateCategory |
Text | 84.00 | 84 | |
Tax rate | Yes | Tax rate in percentage (%) |
|
/b24Message/taxControl/taxControlDetails/taxControlDocument/taxes/@rate |
Number | 85.00 | 85 | |
Taxable amount | Yes | Duty/Tax/Fee amount (subject to specified tax rate) |
|
/b24Message/taxControl/taxControlDetails/taxControlDocument/taxes/@taxableAmount |
Number | 86.00 | 86 | |
Tax amount | Yes | Taxable amount (subject to specified tax rate) |
|
/b24Message/taxControl/taxControlDetails/taxControlDocument/taxes/@amount |
Number | 87.00 | 87 | |
Invoicing currency | Yes | The invoicing currency |
|
/b24Message/taxControl/taxControlDetails/taxControlDocument/taxes/@currency |
Text | 88.00 | 88 |