Skip to main content

Reference tables

Service Status: ftState

The ftState is returned with every receipt response. Through this status, fiskaltrust.Middleware can signal its operability or request processing logic.

The country-specific code is made of the country's code value following the ISO-3166-1-ALPHA-2 standard, converted from ASCII into hex. For France (FR), the country code is 0x4652, which results in 0x4652000000000000 as the value for the "ready" status.

The table below describes supported statuses for the ftState field. Those codes can be combined by using the logic operator OR.

ValueDescriptionMiddleware Version
0x4652000000000040Message Pending
Use Zero-Receipt to show Message on Receipt
1.0

Type of Receipt: ftReceiptCase

The ftReceiptCase defines the type of receipt and hence how fiskaltrust.SecurityMechanisms should process receipts according to French law.

The country-specific code is made of the country's code value following the ISO-3166-1-ALPHA-2 standard, converted from ASCII into hex. For France (FR), the country code is 0x4652. Thus, the value for an unknown ftReceiptCase in France is 0x4652000000000000.

ValueDescriptionMiddleware-Version
0x4652000000000000Unknown receipt for FR
Processed like a ticket
1.2
0x4652000000000001Ticket
Legal document; has to be signed.
Sign: Yes
Chain and national numbering: T
Details: GT counters are raised
1.2
0x4652000000000002Payment Prove
Payment without knowing what was paid.
Legal document; has to be signed.
Sign: Yes
Chain and national numbering: P
No ChargeItems on payment-prove, the total amount is always zero, a negative payitem of type 0x4652000000000011 is used to get the sum of PayItems to zero.
Details: GT counters are not raised
0x4652000000000003Invoice
Legal document; has to be signed.
Sign: Yes
Chain and national numbering: I
A reference to the ticket can be created by using cbPreviousReceiptNumber in the request.
Detail: GT counters are raised
0x4652000000000004Shift Receipt / Grand Total Ticket / Grand Total Invoice: Shift
Sign: Yes
Chain and national numbering: G
Details: Resets the shift-counter, keeps all other counters
1.2
0x4652000000000005Daily Receipt / Grand Total Ticket / Grand Total Invoice: Daily
Sign: Yes
Chain and national numbering: G
Details:
- Adds a daily-counter to the monthly-counter and then resets the daily-counter
- keeps the shift-counter
1.2
0x4652000000000006Monthly Receipt / Grand Total Ticket / Grand Total Invoice: Month
Sign: Yes
Chain and national numbering: G
Details:
- Adds a daily-counter to the monthly-counter and then resets the daily-counter
- Adds a monthly-counter to the yearly-counter and then resets the monthly-counter
- keeps the shift-counter
1.2
0x4652000000000007Yearly Receipt / Grand Total Ticket / Grand Total Invoice: Year
Sign: Yes
Chain and national numbering: G
Details:
- Adds a daily-counter to the monthly-counter and then resets the daily-counter
- Adds a monthly-counter to the yearly-counter and then resets the monthly-counter
- Resets the yearly-counter
- keeps the shift-counter
1.2
0x4652000000000008Bill
List of ChargeItems to be paid. Used to inform customers about their open ChargeItems. PayItemType 0x4652000000000011 is used
Sign: Yes
Chain and national numbering: B
Details: GT counters are not raised. When the bill is used, the phrase "document provisoire" is returned with the fiskaltrust signature and must be printed on the bill. If bill and payment prove are created, this does not replace a ticket creation. A ticket or an invoice has to be issued to raise turnover and raise the GT counters as well
0x4652000000000009Delivery Note
Sign: no
Chain and national numbering: no
0x465200000000000ACash pay-in / Cash Deposit
Same handling as payment prove
Chain and national numbering: P
0x465200000000000BCash pay-out
Same handling as payment prove
Chain and national numbering: P
0x465200000000000CPayment transfer
Switch between payment method, e.g. from cash to credit card
Sign: Yes
Chain and national numbering: P
0x465200000000000DInternal / Material
Sign: No
Chain and national numbering: no
0x465200000000000EForeign sales
Same handling as bill. To be used when something sold in an other country.
Sign: Yes
Chain und national numbering: B
0x465200000000000FZero-Receipt
Sign: Yes
Chain and national numbering: G
Details: A receipt with empty charge items block ftChargeItem and empty payment block ftPayItem which amounts to a total of "0".
0x4652000000000010Start-Receipt
Sign: Yes
Chain and national numbering: G
0x4652000000000011Stop-Receipt
Sign: Yes
Chain and national numbering: G
0x4652000000000012Protocol / Technical Event Log
Has to be signed
Sign: Yes
Chain and national numbering: L
Details: Can be used by the POS-System to log custom data.
1.2
0x4652000000000013Protocol / Accounting / Audit
Has to be signed
Sign: Yes
Chain and national numbering: L
Details: Can be used by the POS-System to log custom data.
1.2
0x4652000000000014Protocol / Custom
Does not need to be signed
Sign: No
Chain and national numbering: No
Details: Can be used by the POS-System to log custom data.
1.2
0x4652000000000015Archive
Has to be Signed
Sign: Yes
Chain and national numbering: A
Details: Will trigger a daily closing automatically.
Creates an archive starting with the first receipt of the queue (or the last archive receipt) until the last receipt before this request. It must not contain more than 365 days.
To retrieve the export as a zip-file (containing the certificate, ReceiptJournals and QueueItems), a normal /journalrequest has to be sent to the ftJournalType: 0x4652000000010010. The value of ftQueueRow in the response of this ReceiptCase has to be sent in the from-parameter.
The content of the retrieved zip-file can be verified with the ExportTool for France. It can be downloaded here
1.2
0x4652000000000016Copy
Has to be Signed
Sign: Yes
Chain and national numbering: C
Details: in a request the cbPreviousReceiptReference is mandatory. It contains the receipt number which was handed out as a copy, issued by the original cash register. When a copy of a receipt is requested, the phrase "duplicata" is returned with the fiskaltrust signature and must be printed on the receipt. Every time the receipt is reprinted, an up-counting number denoting how many times the receipt has been printed, is returned. It must be printed on the receipt and is then recorded in the journal.The layout and the information contained shall be the same as in the original document.
1.2
*Table 33. Type of Receipt: ftReceiptCase (FR – BOI-TVA-DECL 30-10-30)*

ftReceiptCaseFlag

According to French law and regulations, various business transactions can result in specific combinations of types of receipts. For this, bytes 6, 5, 4 and 3 are used as combinable codes. These codes can be added with the logic operator "OR".

ValueDescriptionVersion
0x0000000000010000Failed receipt
Common behaviour, see general part.
1.2
0x0000000000020000Training receipt
All requests issued with this flag are chained and signed in a separate chain. The phrase "mode école" is printed on any artefact that is printed while the flag is being used. For national numbering "X" is used.
GT counters are not raised.
1.2
0x0000000000040000Reverse/voided receipt
Common behaviour, see general part.
0x0000800000000000Receipt request
Common behaviour, see general part.

Table 34. Type of Receipt: ftReceiptCase Flags (FR – BOI-TVA-DECL 30-10-30)

Type of Service: ftChargeItemCase

The ftChargeItemCase defines the type of service in charge item blocks and how fiskaltrust.SecurityMechanism processes individual receipts following French law.

For France (FR), the country code is 0x4652. Thus, the value for an unknown ftChargeItemCase in France is 0x4652000000000000.

ValueDescriptionMiddleware Version
0x4652000000000000Unknown type of service for FR
With the help of the VAT-rates table saved within fiskaltrust.SecurityMechanisms, an allocation to standard /reduced-1 /reduced-2 / super-reduced/zero is attempted.
1.2
0x4652000000000001Undefined type of service for FR reduced-1
(as of 1.1.2017, this is calculated with 5,5%).
1.2
0x4652000000000002Undefined type of service for FR reduced-2
(as of 1.1.2016, this is calculated with 10%,
Loi n° 2015-1786 du 29 décembre 2015, art. 79).
1.2
0x4652000000000003Undefined type of service for FR normal
(as of 1.1.2014, this is 20%,
Loi n° 2012-1510 du 29 décembre 2012, art. 68-III-B).
1.2
0x4652000000000004Undefined type of service for FR special (super-reduced)
Includes all rates that are not contained in the previous ones (as of 1.1.2017, this can be, for example, 2,1%).
1.2
0x4652000000000005Undefined type of service for FR zero
Includes data indicated with 0% sales tax and data where the sales tax is unknown, for example, about an outgoing invoice. Also, in cases where the sales tax should not be apparent, for example, in differential taxation, the data can be issued with this code.
1.2
0x4652000000000006Reverse charge
Reversal of tax liability.
1.2
0x4652000000000007Not own sales
In the data, a VAT-rate can be indicated.
1.2
0x4652000000000008Delivery reduced-1
For processing, see (0x4652000000000001)
1.2
0x4652000000000009Delivery reduced-2
For processing, see (0x4652000000000002)
1.2
0x465200000000000ADelivery normal
For processing, see (0x4652000000000003)
1.2
0x465200000000000BDelivery special
For processing, see (0x4652000000000004)
1.2
0x465200000000000CDelivery zero
For processing, see (0x4652000000000005)
1.2
0x465200000000000DOther services reduced-1
For processing, see (0x4652000000000001)
1.2
0x465200000000000EOther services reduced-2
For processing, see (0x4652000000000002)
1.2
0x465200000000000FOther services normal
For processing, see (0x4652000000000003)
1.2
0x4652000000000010Other services special
For processing, see (0x4652000000000004)
1.2
0x4652000000000011Other services zero
For processing, see (0x4652000000000005)
1.2
0x4652000000000012Catalogue services reduced-1
For processing, see (0x4652000000000001)
1.2
0x4652000000000013Catalogue services reduced-2
For processing, see (0x4652000000000002)
1.2
0x4652000000000014Catalogue services normal
For processing, see (0x4652000000000003)
1.2
0x4652000000000015Catalogue services special
For processing, see (0x4652000000000004)
1.2
0x4652000000000016Catalogue services zero
For processing, see (0x4652000000000005)
1.2
0x4652000000000017Own consumption reduced-1
For processing, see (0x4652000000000001)
1.2
0x4652000000000018Own consumption reduced-2
For processing, see (0x4652000000000002)
1.2
0x4652000000000019Own consumption normal
For processing, see (0x4652000000000003)
1.2
0x465200000000001AOwn consumption special
For processing, see (0x4652000000000004)
1.2
0x465200000000001BOwn consumption zero
For processing, see (0x4652000000000005)
1.2
0x465200000000001CPrepayment reduced-1
For processing, see (0x4652000000000001)
1.2
0x465200000000001DPrepayment reduced-2
For processing, see (0x4652000000000002)
1.2
0x465200000000001EPrepayment normal
For processing, see (0x4652000000000003)
1.2
0x465200000000001FPrepayment special
For processing, see (0x4652000000000004)
1.2
0x4652000000000020Prepayment zero
For processing, see (0x4652000000000005)
1.2
0x4652000000000021Account of a third party/ third party name/ collection
For processing, see (0x4652000000000007)
1.2
0x4652000000000022Obligation1.2

Table 35. Type of Service: ftChargeItemCase (FR – BOI-TVA-DECL 30-10-30)

In the following there are further guidelines for using ftChargeItemCase.

Type of Payment: ftPayItemCase

The ftPayItemCase defines the type of payment within the pay items block and how the fiskaltrust.SecurityMechanism processes individual payment of the receipt.

ValueDescriptionMiddleware Version
0x4652000000000000Default value
Unknown payment type: Automatic processing through the fiskaltrust.SecurityMechanism settings is attempted.
1.2
0x4652000000000000Unknown payment type for FR
This is handled like a cash payment in national currency.
1.2
0x4652000000000001Cash payment in national currency
cash
1.2
0x4652000000000002Cash payment in foreign currency
cash
1.2
0x4652000000000003Crossed cheque
cash
1.2
0x4652000000000004Debit card payment
noncash
1.2
0x4652000000000005Credit card payment
cash
1.2
0x4652000000000006Voucher payment (coupon) - voucher by money value
cash
1.2
0x4652000000000007Online payment
noncash
1.2
0x4652000000000008Customer card payment
noncash
1.2
0x4652000000000009Other debit card
noncash
1.2
0x465200000000000AOther credit card
cash
1.2
0x465200000000000BAccount receivable
Delivery note/ settlement in foreign currency
internal
1.2
0x465200000000000CSEPA transfer
noncash
1.2
0x465200000000000DOther transfer
noncash
1.2
0x465200000000000ECash book expense
internal
1.2
0x465200000000000FCash book contribution
internal
1.2
0x4652000000000010Levy
internal
1.2
0x4652000000000011Internal/ material consumption
Can be used for bill
internal
1.2
0x4652000000000012Change
tip
cash
1.2

Table 36. Type of Payment: ftPayItemCase (FR - BOI-TVA-DECL 30-10-30)

Type of Signature: ftSignatureType

The ftSignatureType indicates the type and origin of the signature.

ValueDescriptionVersion
0x4652000000000000unknown FR
0x4652000000000001JWT1.2
0x4652000000000002Shift Closing Sum1.2
0x4652000000000003Day Closing Sum1.2
0x4652000000000004Month Closing Sum1.2
0x4652000000000005Year Closing Sum1.2
0x4652000000000006Archive Totals Sum1.2
0x4652000000000007Perpetual Total Sum1.2

Table 37. Type of Signature: ftSignatureType (FR - BOI-TVA-DECL 30-10-30)

Type of Journal: ftJournalType

The ftJournalType is used in connection with the journal function and defines the journal stream given back according to the French law. In the ftJournalType, the ISO-3166-1-ALPHA-2 from ASCII value is converted into hex and used as byte 8 and 7. For France (FR) this is 0x4652.

ValueDescriptionVersion
0x4652000000000000Status information for queue FR1.2
0x4652000000000001Ticket ("T" group) export1.2
0x4652000000000002Payment Prove ("P" group) export1.2
0x4652000000000003Invoice ("I" group) export1.2
0x4652000000000004Grand Total ("G" group) export1.2
0x4652000000000007Bill ("B" group) export1.2
0x4652000000000008Archive ("A" group) export1.2
0x4652000000000009Log ("L" group) export1.2
0x465200000000000ACopy ("C" group) export1.2
0x465200000000000BTraining ("X" group) export1.2
0x4652000000000010Export (in conjunction with Archiv)1.2

Table 38. Type of Journal: ftJournalType (FR - BOI-TVA-DECL 30-10-30)

ftJournalTypeFlag

Journals can be extracted in combination with these flags, indicated using codes in byte 5. These codes can be combined using the logic operator OR.

ValueDescriptionVersion
0x0000000000010000Receive Archive as zip-file created with ReceiptCase 0x46520000000000151.2