Skip to main content

Reference Tables

As the Middleware abstracts processes and data accross multiple markets and countries, there is a specific mapping for each market. This mapping is based on the overall tagging system, which provides the additional benefit of a semantical value to all receipts, charge items, and pay items. The following section briefly describes the overall format.

Format

Every case sent to the middleware, and every item returned from the middleware, is based on this tagging system. The tagging system uses hex-based numbers, as they simplify flagging and ensure a consistent numbering scheme.

The _CCCC_vIII_gggg_xxxx overall format consists of four sections and can be described as follows:

ValueDescription
CCCC(e.g., 4954) ASCII of a two-letter ISO country code (https://en.wikipedia.org/wiki/ISO_3166-1) (e.g., IT = 4954)
vIII(e.g., 2000) This section is for versioning the tagging system (currently v2) and for future use.
gggg(e.g., 0010) These items are used for flags. Flags can change the basic behavior of a given type, but will leave the overall semantical meaning of a type the same. (e.g., voiding of a receipt).
xxxx(e.g., 0001) The last category is usually case-specific but always consists of 4 numbers.

ftReceiptCase

Format: CCCC_vlll_gggg_txcc

t - ReceiptCaseType

TypeCategoryDescription
0ReceiptA basic receipt generated as part of a POS sale. It usually serves as proof of payment and is used after the transaction is completed (i.e., once goods are received). This is the usual process done at a POS.
1InvoiceAn invoice is generated when payment isn't handled immediately.
2DailyOperationsThis category contains receipt cases that the Middleware requires for various downstream processes (e.g., bookkeeping).
3LogLogs are used to store and secure events needed for additional processing or downstream processes (e.g., a log for when the cash drawer is opened).
4LifecycleThese operations change the overall state of the Middleware. Depending on local regulations, these receipts are handed over as part of a notification (e.g., FinanzOnline).

txcc - ReceiptCase

ValueDescription
0000Unknown receipt type.
Use this as a fallback; it is handled the same way as a point-of-sale receipt.
0001Point-of-sale receipt type.
0002Payment transfer receipt type.
0003Point-of-sale receipt without fiscalization obligation or with exceptions to fiscalization regulations.
0004E-Commerce receipt type.
0005Delivery note.
0006Table Check [PT]/ Note [FR]/ Zwischenrechnung [AT]/
0007Proforma invoice.
1000Unknown invoice type (simplified invoice in the future).
1001B2C invoice type.
1002B2B invoice type.
1003B2G invoice type.
2000Zero receipt.
2001(Reserved) One receipt.
2010Shift closing receipt.
2011Daily closing receipt.
2012Monthly closing receipt.
2013Yearly closing receipt.
3000Protocol (unspecified type).
3001Protocol (technical event).
3002Protocol (audit event/accounting event).
3003Internal usage/material consumption.
3004Order (log order).
3005Pay (log payment).
3010Copy receipt/print existing receipt.
3011Archive receipt/archive all data receipt.
4001Queue-start-receipt (initial operations receipt).
4002Queue-stop-receipt (out of operations receipt).
4011Initiate SCU-switch.
4012Finish SCU-switch.
4021Initiate migration.
4022Finish migration.

gggg - Global tagging/flags

ftReceiptCaseFlag
ValueDescription
0001Process as Late Signing Receipt
The cash register lost connection to the queue and processed receipts without communicating with the it. All processed receipts marked with the hint "Security mechanism not reachable" must be sent to the queue with this maker.
0002Training Receipt.
0800Group by Position-Number
Position fields are represented as decimal numbers: the whole number indicates the grouped line item, and the fractional part is used within that group. The sum of all ChargeItems within a position must count toward the total receipt amount. If the quantity and amount are 0,00, the quantity and amount will not be visualized for this line on the digital receipt, regardless of whether it is a main item or a subitem.
8000ReceiptRequest
If you don’t receive a response, try this flag first before taking any other action. This will return a stored result, for example in case of a timeout when cash register calls the queue.
PosReceipt (Invoice only)
ValueDescription
0004IsVoid
Marks a receipt as Void relative to a previous one. Line items should also be marked as IsVoid to signal cleared data.
0008Process as Handwritten Receipt
During a power outage, the cash register will not work, and the merchant issues handwritten receipts. These receipts must be sent to the Security Mechanism using this flag.
0010IssuerIsSmallBusiness
Businesses below a country-specific size in revenue do not need to declare VAT. With this marker, the receipt shows no VAT, all prices are gross, and a country-specific hint must be printed.
0020ReceiverIsBusiness
Specific data must be included on the receipt.
0040ReceiverIsKnown
Characteristics related to UStG are provided. For example, Name, Adress, VAT-ID, other local details.
0080IsSaleInForeignCountry
0100IsReturn/IsRefund
Marks the receipt as a return of goods or services.
0200InvoiceProcessingOnly/InvoiceDelivery
Used when a queueitemid should be generated for later processing, e.g., issue.
0400HasTransportInformation
If used, transport information is included in the document.
ZeroReceipt (Dailyoperation only)
ValueDescription
0010Request additional information from SCU (TseInfo in Germany, RTInfo in Italy, SignatureCertificate in Austria and France).
0020Request Force Connection/Download from SCU.
0040Request Bypass Connection/Download from SCU.
0080Request Self-Test from SCU.
0100Request MasterData update.
8000Direct SCU communication
ftReceiptCaseData carries the request payload within eu.fiskaltrust.Middleware.SCU.[CC].[implementation], and ftStateData carries the response payload in the same property name.
LifecycleReceipt only
ValueDescription
0010Queue registration/de-registration only. Bypass SCU factory default initialization.
0020Bypass SCU communication and execute when communication with SCU has failed.

lll - Local tagging/flags

AT (Austria)

cba … c=reserved ; b=reporting ; a = scu related

ValueDescription
TBDTBD
DE (Germany)

All Receipt Type (xxxx)

ValueDescription
001Implicit mode: create StartTransaction implicitly for each ReceiptType; no call to Start-Transaction-Receipt is required.

Log operation (3xxx)

ValueDescription
010Start-Transaction (with technical log type 3001)
020Update-Transaction (with technical log type 3001)
030Delta-Transaction (with technical log type 3001)
040Fail-Transaction-Receipt (with technical log type 3001)
FR (France)

cba … c=reserved ; b=reporting ; a = scu related

ValueDescription
TBDTBD
IT (Italy)

cba … c=reserved ; b=reporting ; a = scu related

ValueDescription
001[RT-Printer/RT-Server/Government Service] not reachable.
Responded in case of a zero-receipt and other hard dependencies to the service. (TBD can this be replaced by Request Bypass Connec-tion/Download from SCU).
ReceiptCaseData
  • Reference in case of "Void" - when cbReceiptReference cannot be used because of source receipt is in a different queue or system. Fields included: { RT-Device-Serialnumber, Z-Number, Document-Number, Document-Moment }

  • Reference in case of "InvoicePayment"

Type of Service: ftChargeItemCase

Format: CCCC_vlll_gggg_NNSV

v - version version 2

V - VAT

For more information, see VAT rules and rates.

VDescriptionVAT table code
0Unknown VAT rateG
1Discounted-1 VAT rateB
2Discounted-2 VAT rateC
3Normal VAT rateA
4Super reduced-1 VAT rateD
5Super reduced-2 VAT rateE
6Parking VAT rateF
7Zero VAT rateH
8Not taxable (in VAT context)I

S - Type of Service

SDescription
0Unknown type of service.
1Delivery (supply of goods) - goods purchased and sold.
2Other service (supply of service) – services provided.
3Tip. For owner, use V=0 to 7 (related to total amount). For employee, use V=8 (Not Taxable).
4Voucher. For Single-Use Voucher, use V=0 to 7. For Multi-Use Voucher, use V=8 (Not Taxable). Voucher sale is a positive (+) amount; voucher redeem is a negative (-) amount. IsVoid can be applied to reverse amounts. Avoid using this for Multi-Use Voucher; instead, use PayItem with ShowInChargeItems flag. For Single-Use Voucher, apply ShowInPayItems flag to visualize it like a payment and keep the total amount unreduced.
5Catalog service (service or good produced in-house) — To be modified!!!
6Not own sales/agency business.
7Own consumption.
8Grant. For unreal grant, use V=0 to 7. For real grant, use V=8.
9Receivable. Creation is a negative (-) amount; reduction is a positive (+) amount. IsVoid can be applied to reverse amounts. Avoid using this; use PayItem with the ShowInChargeItems flag instead.
ACash transfer. Cash transfer to the till is positive (+); from the till is negative (-). Only usable with V=8 (Not Taxable). IsVoid can be applied to reverse amounts.
FSuper-specific type of tax. Detailed definition in NN=nn. V=8 required.

NN - Nature of VAT

NNDescriptionITGR
00Usual VAT applies.
10Not Taxable.
1x can be used to speci-fy more country-specific details, e.g, IGL.
NI (N3) marker mandatory
[10] Not taxable – exports
[11] Non-taxable – intra-community supplies
[12] Non-taxable – transfers to San Marino
[13] Non-taxable – transactions assimilated to export supplies
[14] Non-taxable – following declarations of intent
[15] Non-taxable – other operations which do not contribute to the formation of the ceiling
Marker to print [fiskaltrust]{myData}
[11] (mydata:14) Article 33. non-taxable - intra-community sup-plies Χωρίς ΦΠΑ - άρθρο 33 του Κώδικα ΦΠΑ
[12] (mydata:8) Article 29-Export of goods outside of EU Χωρίς ΦΠΑ - άρθρο 29 του Κώδικα ΦΠΑ
[13] (mydata:28) TAXFREE retail to non eu citi-zens Χωρίς ΦΠΑ – άρθρο 29 περ. β’ παρ.1 του Κώδικα ΦΠΑ
[14] (myda-ta:16) Article 45 Includes the special regime of payment of tax from the receiver of goods and ser-vices NOT THE ISSUER Χωρίς ΦΠΑ - άρθρο 45 του Κώδικα ΦΠΑ
[15] (mydata:6) Article 24 Bottle package recycling, sales of tickets, sales of newspa-pers and maga-zines   Χωρίς ΦΠΑ - άρθρο 24 του Κώδικα ΦΠΑ
[16] (mydata:7) article 27 Services in Greece for med-ical services, ser-vices provided from doctors, den-tists, insurance services, bank ser-vices, sale of 1st residence Χωρίς ΦΠΑ - άρθρο 27 του Κώδικα ΦΠΑ
20Not Subject.
2x can be used to specify more country-specific details.
NS (N2) marker mandatory
[20] not subject to VAT pursuant to articles from 7 to 7-septies of Presidential Decree 633/72
[21] not subject, other cases
30Exempt.
3x
ES (N4) marker mandatory
[30] exempt
[31] (mydata:20) article 50 Comments Special regime for travel agencies, travel packages taxed in GR. ΦΠΑ εμπεριεχόμενος - άρθρο 50 του Κώδικα ΦΠΑ
[32] (mydata:9) article 30 It concerns the exemptions applied under special customs regimes. Goods placed in special customs regimes (e.g., customs warehousing, active processing, etc.) are exempt from VAT. Χωρίς ΦΠΑ - άρθρο 30 του Κώδικα ΦΠΑ
[33] (mydata:15) Article 44 It concerns the special regime for small businesses (below 10K invoices). Χωρίς ΦΠΑ - άρθρο 44 του Κώδικα ΦΠΑ
40Margin scheme. Do not print/show VAT rate and amount on receipt/invoice. 4x can be used to specify more country specific details.RM (N5) marker mandatory
[40] margin scheme / VAT not shown on the invoice
[41] (myda-ta:22) Article52 Special taxation regime for taxable resellers who deliver second-hand goods and objects of artistic, collector's or archaeological value. Χωρίς ΦΠΑ εμπεριεχόμενος - άρθρο 52 του Κώδικα ΦΠΑ
50Reverse charge.
5x
AL (N6) marker mandatory
[50] reverse charge - disposal of scrap and other salvage materials
[51] reverse charge - sale of gold and silver pursuant to law 7/2000 as well as used jewelery to OPO
[52] reverse charge - subcontracting in the construction sector
[53] reverse charge - sale of buildings
[54] reverse charge - supply of mobile phones
[55] reverse charge - supply of electronic products
[56] reverse charge - performance in the construction sector and related sectors
[57] reverse charge - energy sector transactions
[58] reverse charge - other cases [51] (myda-ta:19) Article54 The delivery, intra-Community acquisition and import of investment gold, including investment gold for which there are certificates, by type or by type or which is the subject of a transaction between gold accounts, including, in particular, gold loans and swaps, with a right of ownership or claim to investment gold, as well as investment gold transactions with futures and forward contracts, which cause a change of ownership or claim to investment gold, Χωρίς ΦΠΑ - άρθρο 54 του Κώδικα ΦΠΑ
60VAT paid in other EU country.
6x
(N7) marker mandatory
[60] paid in another EU country (provision of telecommunications, broadcasting and electronic services pursuant to art. 7-octies, paragraph 1 letter a, b, art. 74-sexies of Presidential Decree 633/72)
[61] (myda-ta:3) article 17 Sales of goods which DURING SALES are located outside Greece, sales on boats and or planes during an intra-eu sale Χωρίς ΦΠΑ - άρθρο 17 του Κώδικα ΦΠΑ
[62] (mydata:4) article 18 Services taxed outside Greece including restaurant and catering services provided abroad INCLUDING SERVICES provided digitally when the receiver is living abroad. Χωρίς ΦΠΑ - άρθρο 18 του Κώδικα ΦΠΑ
70VAT distribution*VI (VI) is a fiscal VAT (IVA) regime that certain retailers can adopt. It allows the global registration of the daily takings amount without distinguishing the individual VAT rates. Applies only to goods.
80Excluded
8x
*EE (N1) marker mandatory
[80] excluded pursuant to art. 15 of Presidential Decree 633/72
[81] (mydata:1) Article 2&3 Includes transactions outside the scope of VAT (e.g., compensations for material damages, income from participations, subsidies, grants, etc., as well as the special regime of Mount Athos.
Χωρίς ΦΠΑ - άρθρο 2 και 3 του Κώδικα ΦΠΑ
[82] (mydata:2) Article 5 Case of transfer of assets of a business as a) a whole, b) a branch, or c) a part of it through onerous or gratuitous cause or in the form of contribution to an existing or newly established legal entity.
Χωρίς ΦΠΑ - άρθρο 5 του Κώδικα ΦΠΑ
[83] (mydata:10) Article 31 Rare case of tax warehouses sales
Χωρίς ΦΠΑ - άρθρο 31 του Κώδικα ΦΠΑ
[84] (mydata:11) Article 32 It includes exemptions applicable to: certain categories of ships and watercraft and aircraft, for diplomatic and consular authorities, recognized international organizations, the European Community, the European Central Bank, etc., NATO and its organizations, to meet the needs of refugees and vulnerable groups, public donors, etc. for certain transports for
[85] (mydata:12) Article 32.Open seas ships
[86] (mydata:13) Article 32.1.Open seas ships
[87] Χωρίς ΦΠΑ - ΠΟΛ.1029/1995
[88] (mydata 26) special case where you don’t pay vat as long as the goods or services are intented for another EU state or 3rd party country
Χωρίς ΦΠΑ - άρθρο 32 του Κώδικα ΦΠΑ
nn (nature of non-VAT/
super specific tax V==8 && S==F)
DescriptionITGR
00Exact description is used for mapping and printing.
10
20
30
40
50
60
70
80

gggg - Global tagging/flags

ValueDescription
0001IsVoid
Marks ChargeItem as Void of the previous position. Quantity and amount are inverted, related to the original item.
0002IsReturn/IsRefund
Marks ChargeItem as Return of good or service. Quantity and amount are inverted, related to the original item.
0004Discount
Marks ChargeItem as Discount / Extra for the previous position. Positive (+) amount is extra, negative (-) amount is discount. IsVoid or IsReturn/IsRefund will invert this behavior.
0008Downpayment
Marks ChargeItem as a Downpayment. Positive (+) amount creates a downpayment, negative (-) amount reduces it. IsVoid or IsReturn/IsRefund will invert this behavior.
0010Returnable
Marks ChargeItem as Returnable. Positive (+) amount/quantity is handout, negative (-) is reverse**. IsVoid or IsReturn/IsRefund will invert this behavior.
0020TakeAway
Marks ChargeItem as TakeAway item to prove special VAT application.
4000RespondInReceiptResponse
Respond in ReceiptResponse.
8000ShowInPayments
Visualize the item after Total Amount. Amount is inverted and not included in the visualized total amount on the receipt.

lll - Local tagging/flags

TBD

Type of Payment: ftPayItemCase

Format: CCCC_vlll_gggg_xxPP

v - version version 2

PP - Payment type

ValueDescriptionGR
00Unknown
01CashGR: Cash
02NonCash
03Crossed ChequeGR: Cheque
04Debit CardGR: POS/e-POS
05Credit CardGR: POS/e-POS
06VoucherGR: Cheque
07Online
08Loyalty Program/Customer Card
09Accounts ReceivableGR: On Credit
0ASEPA Transfer (Wire Transfer)GR: Default maps to Domestic payments.
GR: Description == “IRIS” maps to IRIS
GR: Description == "RF code payment (Web banking)" maps to Web banking.
0BOther Bank TransferGR: maps to International Business Payment Account
0CTransfer to Cashbook/Vault/ Owner/Employee.
Positive (+) amount increases cashbook/vault.
Negative (-) amount decreases cashbook/vault.
0DInternal/Material Consumption
0EGrant
0FTicket Restaurant (Sodexo, Edenred, etc.)

gggg - Global tagging/flags

ValueDescription
0001IsVoid
Marks PayItem as Void of the previous position. Quantity and amount are inverted, related to the original item. Used when the exchange of money has not been executed yet.
0002IsReturn / IsRefund
Marks PayItem as Return of good or service. Quantity and amount are inverted, related to the original item. Used when the exchange of money has already been executed.
0004(reserved)
0008Downpayment
Marks PayItem as a downpayment. Positive (+) amount is reduction of downpayment. Negative (-) amount is creation of downpayment.
0010IsForeignCurrency
Amount is still in EUR at the moment of acceptance. ftPayItemData requires two data elements with foreignCurrencySymbol and foreignCurrencyAmount to persist data for daily closing and later bookkeeping transactions.
0020IsChange
Usually contains a negative (-) amount. (IsVoid => can be inverted)
0040IsTip
Must be a negative (-) amount to flow out of the payment method. ShowInChargeItems flag can be used to raise the total amount by the tip amount for better visualization.
0080IsDigital/IsElectronic
Electronic or digital money.
0100IsInterface/AmountVerified
Amount was verified by interface; automated amount transfer.
4000Respond in ReceiptResponse.
8000ShowInChargeItems
Visualize the item before Total Amount. This inverts amount and does include the amount into the visualized total amount on the receipt.

ReceiptResponse related mapping

ftReceiptnumber

ft{ReiceiptNumeratorHex}#{RT-Device-Z-Number}-{RT-Device-recNumber}

ftState

Format: CCCC_vlll_gggg_gggg

v - version version 2

gggg_gggg - Global tagging/flags

ValueDescription
0000_0001Security Mechanism is Out of Operation.
Queue is not started or already stopped.
0000_0008Deferred Queue Mode/Late Signing Mode is active.
When the cash register doesn’t reach the queue, it queues up the receipt requests while continuing to do business. Also, with a major failure of the cash register or a power outage, handwritten paper receipts are queued up while continuing to do business. After returning to a fully functional state, these queued ReceiptRequests are sent to the queue, keeping the original cbReceipt-Moment of the business case ReceiptCase tagged/flagged with 0001 (Deferred Queue/Late Signing) or 0008 (Handwritten).
A result of this is a marker within the ftState, which can be resolved via ZeroReceipt. The reason for the marker is a mismatch between processed time along the receipt chain and a manual event to clean up the state, and maybe notify 3rd parties of an outage.
0000_0040Message Pending.
Middleware/Queue is a headless background service, but there are situations where communication with the cashier/operator or the cash register is necessary. For example, if the last daily closing was missed or if a special condition related to the signature creation unit or service happened. This is when the message pending flag is set by the middleware and should be signaled to the cashier by the POS system. By executing a ZeroReceipt, the cashier can read the message or instruction on the printed or displayed receipt.
Related to local regulations, this receipt may be stored/archived for bookkeeping purposes; if so, this is also visualized.
0000_0100DailyClosing due.
When the first cbReceiptMoment used since the last DailyClosing and the current/latest cbReceiptMoment in the ReceiptRequest have a date gap of more than two days (e.g., the first since the last daily closing is 24/08 and the current is 26/08), then this state indicates a DailyClosing should be done.
DailyClosing is an essential part of the security mechanism and executes additional market-specific clean-up tasks. Therefore, each queue should perform a DailyClsoing to clear persistent changes in business data and updates in the business period.
0000_0200MonthlyClosing due.
When the first cbReceiptMoment used since last MonthlyClosing and the current/latest cbReceiptMoment in the ReceiptRequest are different, this state indicates a MonthlyClosing should be done.
0000_0400YearlyClosing due.
EEEE_EEEEError.
Something went wrong while processing the last request. QueueItem exists but didn’t reach the state of a ReceiptItem and didn’t consume a ftReceiptNumber within the chain. Error reason is shown within the responded ftSignatureItems. This happens, for example, if the ReceiptCase is not recognized or is wrong.
FFFF_FFFFFail.
Something went wrong while processing the last request, and nothing persisted within the Queue. Fail reason is shown within the responded ftSignatureItems. This happens, for example, when the flag ReceiptRequest is used after a communication outage, and no properly processed item is found.

lll - Local tagging/flags

AT (Austria)

cba … c=reserved ; b=reporting ; a = scu related

ValueDescription
001SCU permanent out of service.
48h FinanzOnline timeout reached.
002Backup SCU in use.

DE (Germany)

cba … c=reserved ; b=reporting ; a = scu related

ValueDescription
001SCU is in a switching state.
The queue is in the process of switching SCUs. This state is returned in case any receipts are processed between the initialize-switch and finish-switch receipts. These receipts are protected by fiskaltrust.SecurityMechanism, but are not sent to any TSE, as no SCU is connected at this point.

FR (France)

cba … c=reserved ; b=reporting ; a = scu related

ValueDescription
TBDTBD

IT (Italy)

cba … c=reserved ; b=reporting ; a = scu related

ValueDescription
001[RT-Printer/RT-Server/Government Service] not reachable.
Responded in case of a zero-receipt and other hard dependencies to the service.

ES (Spain)

cba … c=reserved ; b=reporting ; a = scu related

ValueDescription
TBDTBD

ftSignature

Format of Signature: ftSignatureFormat

Format: p_ffff_

ffff - Format

ValueDescription
0000Unknown/no format defined
0001Text
0002Link
0003QR-Code (2D Code)
0004Code128 (Barcode)
0005OCR-A (optical character recognition, possible for Base32 data)
0006PDF417-(2D Code)
0007DATAMATRIX-(2D Code)
0008AZTEC-(2D Code)
0009EAN-8 (Barcode)
000AEAN-13 (Barcode)
000BUPC-A (Barcode)
000CCode39 (Barcode, possible for Base32 data)
000DBase64 (Raw Data)

p - Position

The Basic Layout is: [Header] [ChargeItemBlock] [TotalTaxBlock] [PayItemBlock] [SignatureBlock] [Footer]

SignatureItems must be printed or visualized on the Receipt within the SignatureBlock, in the order they were received, and according to any additional format and visualization flags. For each SignatureItem, the first line should display its caption in text format, followed by a new line showing the content of the SignatureItem formatted according to the specified format.

ValueDescription
0After PayItemBlock/Before Footer
1After Header/Before ChargeItemBlock
2After ChargeItemBlock/Before TotalTaxBlock
3After TotalTaxBlock/Before PayItemBlock
4After Footer
5Before Header
ValueDescription
0100Print/Visualize after Header (usual position is after PayItems/before Footer)
0200Print/Visualize after ChargeItems (usual position is after PayItems)
0400Print/Visualize after Total (usual position is after PayItems)
0800Print/Visualize after ChargeItems (usual position is after PayItems)

ftSignatureFormatFlags

TBD

Type of Signature: ftSignatureType

Format: _CCCC_vlll_gggg_tsss

v - version version 2

t - Type/Category

ValueDescription
0Uncategorized; Normal use (notification)
1Information (notification); low priority
2Alert (notification); high priority
3Failure (notification); high priority

sss - SignatureCase

CaseDescriptionCaption
000Notification
001Primary market-related compliance signature
010??Middleware version: the version of the middlware used to generate the given receipt
Exx??Related information to EEEE_EEEE ftState
Flag: do not print/visualize
Data: Base64 stack trace if debug/sandbox
Exception Number/Name
Fxx??Related information to FFFF_FFFF ftState
Flag: do not print/visualize
Data: Base64 stack trace if debug/sandbox
Exception Number/Name

gggg - Global tagging/flags

ValueDescription
0001Archiving required.
Signatures marked with this flag are known to be archived related to market-specific bookkeeping requirements. For offline usage or pure open-source usage, receipts or artefacts with this flag should be treated as bookkeeping/accounting-relevant items.
0010Printing/Visualization is optional.
0020Do not print/visualize.
0040Printed receipt only.
0080Digital receipt only.

sss - SignatureCase (by market)

AT (Austria)
CaseDescriptionCaption
001Signature/Payload according to RKSV[www.fiskaltrust.at]
002Daily operation notification
003FinanzOnline notification
2D code to execute FinanzOnline notification in case of offline usage or pure open-source usage.
DE (Germany)
CaseDescriptionCaption
001Signature/Payload according to Kassen-SichV
[qr] format
[www.fiskaltrust.de]
010Start-transaction-result
[do-not-print] flag
011Finish-transaction-payload
[do-not-print] flag
012Finish-transaction-result
[do-not-print] flag
013QR-Code Version for receipt
[optional-print] flag
014Cashregister Serialnumber for receipt
[optional-print] flag
015ProcessType for receipt
[optional-print] flag
016ProcessData for receipt
[optional-print] flag
017Transaction number for receipt
[optional-print] flag
018Signature counter for receipt
[optional-print] flag
019Transaction start time for receipt
[optional-print] flag
01ASignature logtime for receipt
[optional-print] flag
01BSignature algorithm for receipt
[optional-print] flag
01CSignature logtime format for receipt
[optional-print] flag
01DSignature for receipt
[optional-print] flag
01EPublic key for receipt
[optional-print] flag
01FProcess start time for receipt
020Update-transaction-payload
[do-not-print] flag
021Update-transaction-result
[do-not-print] flag
022Certification identification and protection profile restrictions for receipt
023TSE serial number for receipt
FR (France)
CaseDescriptionCaption
001Signature/Payload according to French security mechanism (BOI-TVA-DECLA-30-10-30)
This is a JWT [qr] format.
[www.fiskaltrust.fr]
010Shift closing payload
011Day closing payload
012Month closing payload
013Year closing payload
014Archive Totals payload
015Perpetual Totals payload
IT (Italy)
CaseDescriptionCaption
001Print below [PayItemBlock]/Document fiscalization
RT-Printer
[DATE(DD-MM-YYYY)]
[TIME(HH:MM)][NEWLINE]
DOCUMENTO N. [z-Number]-[Document-Number][NEWLINE]
Codice Lotteria: [LotteryID][NEWLINE]
Codice Fiscale: [CustomerID][NEWLINE]
RT [SERIALNUMBER][NEWLINE]
RT-Server
[DATE(DD-MM-YYYY)] [TIME(HH:MM)][NEWLINE]
DOCUMENTO N. [z-Number]-[Document-Number][NEWLINE]
Codice Lotteria: [LotteryID][NEWLINE]
Codice Fiscale: [CustomerID][NEWLINE]
Server RT [SERIALNUMBER][NEWLINE]
Cassa [ftCashboxIdentifica-tion][NEWLINE]
-----FIRMA ELETTRONICA-----[NEWLINE]
[SHA-METADATA][NEWLINE]
---------------------------[NEWLINE]
FE (Fattura Elettronica)
[DATE(DD-MM-YYYY)] [TIME(HH:MM)][NEWLINE]
[VAT-ID][NEWLINE]
[ftReceiptIdentification][NEWLINE]
[ftCashboxIdentification][NEWLINE]
If number/signature is present/not null
[www.fiskaltrust.it]
002Print below [Header]/Document Type
Document-Type (1) Vendita
DOCUMENTO COMMERCIA-LE[NEWLINE]
di vendita o prestazione[NEWLINE]
Document-Type (3) Reso
DOCUMENTO COMMERCIA-LE[NEWLINE]
emesso per ANNULLAMEN-TO[NEWLINE]
[NEWLINE]
Documento di riferimento:
N. [reference-z-Number]-[reference-Document-Number] del [reference-Document-Date(DD-MM-YYYY)][NEWLINE]
N. [reference-z-Number]-[reference-Document-Number] del [reference-Document-Date(DD-MM-YYYY)][NEWLINE]
RT [reference-RT-Printer-Serialnumber][NEWLINE]
Server RT [reference-RT-Server-Serialnumber][NEWLINE]
Cassa [reference-ftCashboxIdentification][NEWLINE]
XXX del [reference-Document-Date(DD-MM-YYYY)][NEWLINE]
Document-Type (5) Annullo
DOCUMENTO COMMERCIA-LE[NEWLINE]
emesso per RESO MERCE[NEWLINE]
[NEWLINE]
Documento di riferimento:
N. [reference-z-Number]-[reference-Document-Number] del [reference-Document-Date(DD-MM-YYYY)][NEWLINE]
N. [reference-z-Number]-[reference-Document-Number] del [reference-Document-Date(DD-MM-YYYY)][NEWLINE]RT
[reference-RT-Printer-Serialnumber][NEWLINE]
Server RT [reference-RT-Server-Serialnumber][NEWLINE]
Cassa [reference-ftCashboxIdentification][NEWLINE]
XXX del [reference-Document-Date(DD-MM-YYYY)][NEWLINE]
If number is on same system
If number is on different system
If number is unknown XXX
"POS" in the case of a POS receipt;
"VR" in the case of returnable containers;
“ND” in other cases
DOCUMENTO COMMERCIALE
010RT printer/server serial number
011RT printer/server Z-Number
012RT printer/server Document-Number
013RT printer/server Document-Moment
014RT printer/server Document Type
015RT printer/server LotteryID
016RT printer/server CustomerID
017RT server SHA Metadata
018Amount
020RT Reference ZNumber
021RT Reference DocNumber
022RT Reference Document Moment
ES (Spain)
CaseDescriptionCaption
TBDTBD
PT (Portugal)
CaseDescriptionCaption
TBDTBD
GR (Greece)
CaseDescriptionCaption
TBDTBD

Type of Journal: ftJournalType

Format: CCCC_vlll_gggg_tjjj

v - version version 2

t - Type/Category

ValueDescription
0Common
1Market specific

jjj - JournalCase

CaseDescription
000Version Information
001ActionJournal
002ReceiptJournal
003QueueItemJournal

gggg - Global tagging/flags

ValueDescription
0001Use ZIP compressed stream

jjj - JournalCase (by market)

AT (Austria)

CaseDescription
001Status Information QueueAT
002RKSV-DEP-Export

DE (Germany)

CaseDescription
000Status Information QueueDE
001.TAR-File-Export passthrough from TSE device
Limited to data at device. Usually, data are purged from device after successful export.
002DSFinV-K Export
ZIP compression required.
003.TAR-File-Export

FR (France)

CaseDescription
000Status Information QueueFR
001Ticket ("T" group) export
002Payment Prove ("P" group) export
003Invoice ("I" group) export
004Grand Total ("G" group) export
007Bill ("B" group) export
008Archive ("A" group) export
009Log ("L" group) export
00ACopy ("C" group) export
00BTraining ("X" group) export
010Export (in conjunction with Archiv)

IT (Italy)

CaseDescription
000Status Information QueueIT
001TBD passthrough from RT device
002
003

ES (Spain)

CaseDescription
000Status Information QueueES
001
002
003