From 728198b77cf36eadd468512fb467ef214be2ebd5 Mon Sep 17 00:00:00 2001 From: Thomas Steininger Date: Sun, 26 Jan 2020 12:53:22 +0100 Subject: [PATCH 1/4] clarify ReceiptCase usage separate between export preparation of DSFinV-K and TSE-operations - reworked `BON_TYP` for DSFinV-K - added `processType` for TSE-operations - added edge-cases to separate different TSE-operations for - Bestellung-V1 - SonstigerVorgang --- .../appendix-de-kassensichv.md | 48 ++++++++++--------- 1 file changed, 25 insertions(+), 23 deletions(-) diff --git a/doc/appendix-de-kassensichv/appendix-de-kassensichv.md b/doc/appendix-de-kassensichv/appendix-de-kassensichv.md index 8724cb97..fdb4f1fe 100644 --- a/doc/appendix-de-kassensichv/appendix-de-kassensichv.md +++ b/doc/appendix-de-kassensichv/appendix-de-kassensichv.md @@ -109,30 +109,32 @@ The ftReceiptCase indicates the receipt type and defines how it should be proces For Germany (DE) the country code is `0x4445`. Thus, the value of an unknown ftReceiptCase in Germany is `0x4445000000000000`. -| **Value** | **Description** | **BON_TYP (DSFinV-K)** | **Service- Version** | +| **Value** | **Description** | **BON_TYP (DSFinV-K)**
**processType (TSE)** | **Service- Version** | |---|---|---|---| -| `0x4445000000000000` | unknown type for country-code "DE"
This is handled like a pos-receipt (`0x4445000000000001`). | Beleg | 1.3- | -| `0x4445000000000001` | pos-receipt
main kind of receipt processed on a pos-system. creates a turnover and/or change in the amount of cash in the till or similar operations.
using the ChargeItems and PayItems to hand over details for processing. independent from the used flow (explicit/implicit), the ChargeItems and PayItems should contain the full final state of the receipt. the duration of the action is calculated using the minimum and maximum of datetime over ReceiptRequest/ChargeItems/PayItems.
DSFinV-K: BON_TYP=Beleg, can be overwritten by ftReceiptCaseFlag | Beleg | 1.3- | -| `0x4445000000000002` | zero-receipt
used for communication and functional test of the fiskaltrust.SecurityMechanism. In addition a detailed status information is responded on the used TSE-Device. Is only valid when charge items block (ftChargeItems) and pay items block (ftPayItems) in the ReceiptRequest are empty arrays.
Also TSE data are unloaded, what may cause a long running request.
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception.
if you want to end a ongoing transaction without turnover (e.g. all items on a receipt are voided) then use a regular ReceiptCase.
Informations returned:
- List of cbReceiptReference <-> Transaction-ID
- Statusdata of TSE, serialnumber, available/free memory, available number of signatures left, ...
DSFinV-K: BON_TYP=AVSonstige, ChargeItems and PayItems have to be empty | AVSonstige | 1.3- | -| `0x4445000000000003` | initial operation receipt / start-receipt
The request is only valid with the same property requirements as a zero-receipt. initializing a new fiskaltrust.SecurityMachanism, this includes also the initialization of the used TSE in the background. Depending on the TSE-Type used this includes different actions.
On successful initialization, a notification is created which includes the queue-id, scu-id, certificate/public-key, tse-serialnumber=hash(public-key). this notification need to be reported to tax administration.
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception.
DSFinV-K: BON_TYP=AVSonstige, ChargeItems and PayItems have to be empty | AVSonstige | 1.3- | -| `0x4445000000000004` | out of operation receipt / stop-receipt
The request is only valid with the same property requirements as a zero-receipt. disabling a fiskaltrust.SecurityMachanism, this includes also the deactivation of the used TSE in the background. Depending on the TSE-Type used this includes different actions.
On successful deactivation, a notification is created which includes the queue-id, scu-id, certificate/public-key, tse-serialnumber=hash(public-key). this notification needs to be reported to tax administration.
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception.
DSFinV-K: BON_TYP=AVSonstige, ChargeItems and PayItems have to be empty | AVSonstige | 1.3- | -| `0x4445000000000005` | monthly-closing
TBD: close all open cbReceiptReference <-> Transaction-ID
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | AVSonstige | 1.3- | -| `0x4445000000000006` | yearly-closing
TBD: close all open cbReceiptReference <-> Transaction-ID
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | AVSonstige | 1.3- | -| `0x4445000000000007` | daily-closing
TBD: close all open cbReceiptReference <-> Transaction-ID
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | AVSonstige | 1.3- | -| `0x4445000000000008` | start-transaction-receipt
starts a new, unfinished action. use ChargeItems and PayItems to hand over already known details for final receipt. using the same cbTerminalID and cbReceiptReferece in further calls connects the action items.
this works only on explicit flow. calling with the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | AVSonstige | 1.3- | -| `0x4445000000000009` | update-transaction-receipt
updates an ongoing action. use ChargeItems and PayItems to hand over all details for final receipt. using the same cbTerminalID and cbReceiptReferece in further calls connects the action items.
this works only on explicit flow. calling with the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | AVSonstige | 1.3- | -| `0x444500000000000A` | delta-transaction-receipt
updates an ongoing action. use ChargeItems and PayItems to hand changes for final receipt. using the same cbTerminalID and cbReceiptReferece in further calls connects the action items.
this works only on explicit flow. calling with the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | AVSonstige | 1.3- | -| `0x444500000000000B` | fail-transaction-receipt
stopps/fails an ongoing action. tries to finish an open transaction (accepts fail, continue on fail). clears cbReceiptReferece <-> Transaction-ID relation.
DSFinV-K: BON_TYP=AVBelegabbruch | AVSonstige | 1.3- | -| `0x444500000000000C` | b2b-invoice
TBD:
DSFinV-K: BON_TYP=Beleg, can be overwritten by ftReceiptCaseFlag | Beleg | 1.3- | -| `0x444500000000000D` | b2c-invoice
TBD:
DSFinV-K: BON_TYP=Beleg, can be overwritten by ftReceiptCaseFlag | Beleg | 1.3- | -| `0x444500000000000E` | info-invoice
TBD:
DSFinV-K: BON_TYP=AVRechnung | AVRechnung | 1.3- | -| `0x444500000000000F` | info-delivery-note
TBD:
DSFinV-K: BON_TYP=AVTransfer | AVTransfer | 1.3- | -| `0x4445000000000010` | info-order
TBD:
DSFinV-K: BON_TYP=AVBestellung | AVBestellung | 1.3- | -| `0x4445000000000011` | cash deposit / cash pay-in / cash pay-out / exchange
TBD:
DSFinV-K: BON_TYP=Beleg, can be overwritten by ftReceiptCaseFlag | Beleg | 1.3- | -| `0x4445000000000012` | material consumption
TBD:
DSFinV-K: BON_TYP=AVSachbezug | AVSachbezung | 1.3- | -| `0x4445000000000013` | info-internal
TBD:
DSFinV-K: BON_TYP=AVSonstige | AVSonstige | 1.3- | -| `0x4445000000000014` | protocol
TBD:
DSFinV-K: BON_TYP=AVSonstige | AVSonstige | 1.3- | -| `0x4445000000000015` | foreign sales
TBD:
DSFinV-K: BON_TYP=AVSonstige | AVSonstige | 1.3- | +| `0x4445000000000000` | unknown type for country-code "DE"
This is handled like a pos-receipt (`0x4445000000000001`). | Beleg
Kassenbeleg-V1 | 1.3- | +| `0x4445000000000001` | pos-receipt
main kind of receipt processed on a pos-system. creates a turnover and/or change in the amount of cash in the till or similar operations.
using the ChargeItems and PayItems to hand over details for processing. independent from the used flow (explicit/implicit), the ChargeItems and PayItems should contain the full final state of the receipt. the duration of the action is calculated using the minimum and maximum of datetime over ReceiptRequest/ChargeItems/PayItems.
DSFinV-K: BON_TYP=Beleg, can be overwritten by ftReceiptCaseFlag | Beleg
Kassenbeleg-V1 | 1.3- | +| `0x4445000000000002` | zero-receipt
used for communication and functional test of the fiskaltrust.SecurityMechanism. In addition a detailed status information is responded on the used TSE-Device. Is only valid when charge items block (ftChargeItems) and pay items block (ftPayItems) in the ReceiptRequest are empty arrays.
Also TSE data are unloaded, what may cause a long running request.
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception.
if you want to end a ongoing transaction without turnover (e.g. all items on a receipt are voided) then use a regular ReceiptCase.
Informations returned:
- List of cbReceiptReference <-> Transaction-ID
- Statusdata of TSE, serialnumber, available/free memory, available number of signatures left, ...
DSFinV-K: BON_TYP=AVSonstige, ChargeItems and PayItems have to be empty | AVSonstige ?? [none]
SonstigerVorgang | 1.3- | +| `0x4445000000000003` | initial operation receipt / start-receipt
The request is only valid with the same property requirements as a zero-receipt. initializing a new fiskaltrust.SecurityMachanism, this includes also the initialization of the used TSE in the background. Depending on the TSE-Type used this includes different actions.
On successful initialization, a notification is created which includes the queue-id, scu-id, certificate/public-key, tse-serialnumber=hash(public-key). this notification need to be reported to tax administration.
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception.
DSFinV-K: BON_TYP=AVSonstige, ChargeItems and PayItems have to be empty | AVSonstige ?? [none]
SonstigerVorgang | 1.3- | +| `0x4445000000000004` | out of operation receipt / stop-receipt
The request is only valid with the same property requirements as a zero-receipt. disabling a fiskaltrust.SecurityMachanism, this includes also the deactivation of the used TSE in the background. Depending on the TSE-Type used this includes different actions.
On successful deactivation, a notification is created which includes the queue-id, scu-id, certificate/public-key, tse-serialnumber=hash(public-key). this notification needs to be reported to tax administration.
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception.
DSFinV-K: BON_TYP=AVSonstige, ChargeItems and PayItems have to be empty | AVSonstige ?? [none]
SonstigerVorgang | 1.3- | +| `0x4445000000000005` | monthly-closing
TBD: close all open cbReceiptReference <-> Transaction-ID
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | AVSonstige ?? [none]
SonstigerVorgang | 1.3- | +| `0x4445000000000006` | yearly-closing
TBD: close all open cbReceiptReference <-> Transaction-ID
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | AVSonstige ?? [none]
SonstigerVorgang | 1.3- | +| `0x4445000000000007` | daily-closing
TBD: close all open cbReceiptReference <-> Transaction-ID
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | AVSonstige ?? [none]
SonstigerVorgang | 1.3- | +| `0x4445000000000008` | start-transaction-receipt
starts a new, unfinished action. use ChargeItems and PayItems to hand over already known details for final receipt. using the same cbTerminalID and cbReceiptReferece in further calls connects the action items.
this works only on explicit flow. calling with the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | [none]
[empty] | 1.3- | +| `0x4445000000000009` | update-transaction-receipt
updates an ongoing action. use ChargeItems and PayItems to hand over all details for final receipt. using the same cbTerminalID and cbReceiptReferece in further calls connects the action items.
this works only on explicit flow. calling with the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | [none]
[empty] | 1.3- | +| `0x444500000000000A` | delta-transaction-receipt
updates an ongoing action. use ChargeItems and PayItems to hand changes for final receipt. using the same cbTerminalID and cbReceiptReferece in further calls connects the action items.
this works only on explicit flow. calling with the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | [none]
[empty] | 1.3- | +| `0x444500000000000B` | fail-transaction-receipt
stopps/fails an ongoing action. tries to finish an open transaction (accepts fail, continue on fail). clears cbReceiptReferece <-> Transaction-ID relation.
DSFinV-K: BON_TYP=AVBelegabbruch | AVBelegabbruch
Kassenbeleg-V1 | 1.3- | +| `0x444500000000000C` | b2b-invoice
TBD:
DSFinV-K: BON_TYP=Beleg, can be overwritten by ftReceiptCaseFlag | Beleg
Kassenbeleg-V1 | 1.3- | +| `0x444500000000000D` | b2c-invoice
TBD:
DSFinV-K: BON_TYP=Beleg, can be overwritten by ftReceiptCaseFlag | Beleg
Kassenbeleg-V1 | 1.3- | +| `0x444500000000000E` | info-invoice
TBD:
DSFinV-K: BON_TYP=AVRechnung | AVRechnung
Kassenbeleg-V1 | 1.3- | +| `0x444500000000000F` | info-delivery-note
TBD:
DSFinV-K: BON_TYP=AVTransfer | AVTransfer
Kassenbeleg-V1 | 1.3- | +| `0x4445000000000010` | info-order
when goods are already delivered to customer and request-payitems not empty
(ReceiptRequest.PayItems == [])
DSFinV-K: BON_TYP=AVBestellung | AVBestellung
Kassenbeleg-V1 | 1.3- | +| `0x4445000000000010` | info-order
when recording an ongoing order and request-payitems are empty
(ReceiptRequest.PayItems == [])
DSFinV-K: BON_TYP=[none] | [none]
Bestellung-V1 | 1.3- | +| `0x4445000000000011` | cash deposit / cash pay-in / cash pay-out / exchange
TBD:
DSFinV-K: BON_TYP=Beleg, can be overwritten by ftReceiptCaseFlag | Beleg
Kassenbeleg-V1 | 1.3- | +| `0x4445000000000012` | material consumption
TBD:
DSFinV-K: BON_TYP=AVSachbezug | AVSachbezung
Kassenbeleg-V1 | 1.3- | +| `0x4445000000000013` | info-internal
when request-chargeitems are not empty and when request-payitems are not empty
DSFinV-K: BON_TYP=AVSonstige | AVSonstige
Kassenbeleg-V1 | 1.3- | +| `0x4445000000000013` | info-internal
when request-chargeitems are empty or when request-payitems are empty
(ReceiptRequest.ChargePayItems == [] && ReceiptRequest.PayItems == [])
DSFinV-K: BON_TYP=[none] | [none]
SonstigerVorgang | 1.3- | +| `0x4445000000000014` | protocol
TBD:
DSFinV-K: BON_TYP=[none] | [none]
SonstigerVorgang | 1.3- | +| `0x4445000000000015` | foreign sales
TBD:
DSFinV-K: BON_TYP=AVSonstige | AVSonstige
Kassenbeleg-V1 | 1.3- | ##### actions where a receiptcase has to be defined From 2d707a46a9024703412eaf2e4587e05bd6f540f5 Mon Sep 17 00:00:00 2001 From: Thomas Steininger Date: Sun, 26 Jan 2020 15:44:18 +0100 Subject: [PATCH 2/4] Update appendix-de-kassensichv.md fixed typo --- doc/appendix-de-kassensichv/appendix-de-kassensichv.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/appendix-de-kassensichv/appendix-de-kassensichv.md b/doc/appendix-de-kassensichv/appendix-de-kassensichv.md index fdb4f1fe..31455767 100644 --- a/doc/appendix-de-kassensichv/appendix-de-kassensichv.md +++ b/doc/appendix-de-kassensichv/appendix-de-kassensichv.md @@ -127,7 +127,7 @@ For Germany (DE) the country code is `0x4445`. Thus, the value of an unknown ftR | `0x444500000000000D` | b2c-invoice
TBD:
DSFinV-K: BON_TYP=Beleg, can be overwritten by ftReceiptCaseFlag | Beleg
Kassenbeleg-V1 | 1.3- | | `0x444500000000000E` | info-invoice
TBD:
DSFinV-K: BON_TYP=AVRechnung | AVRechnung
Kassenbeleg-V1 | 1.3- | | `0x444500000000000F` | info-delivery-note
TBD:
DSFinV-K: BON_TYP=AVTransfer | AVTransfer
Kassenbeleg-V1 | 1.3- | -| `0x4445000000000010` | info-order
when goods are already delivered to customer and request-payitems not empty
(ReceiptRequest.PayItems == [])
DSFinV-K: BON_TYP=AVBestellung | AVBestellung
Kassenbeleg-V1 | 1.3- | +| `0x4445000000000010` | info-order
when goods are already delivered to customer and request-payitems not empty
(ReceiptRequest.PayItems != [])
DSFinV-K: BON_TYP=AVBestellung | AVBestellung
Kassenbeleg-V1 | 1.3- | | `0x4445000000000010` | info-order
when recording an ongoing order and request-payitems are empty
(ReceiptRequest.PayItems == [])
DSFinV-K: BON_TYP=[none] | [none]
Bestellung-V1 | 1.3- | | `0x4445000000000011` | cash deposit / cash pay-in / cash pay-out / exchange
TBD:
DSFinV-K: BON_TYP=Beleg, can be overwritten by ftReceiptCaseFlag | Beleg
Kassenbeleg-V1 | 1.3- | | `0x4445000000000012` | material consumption
TBD:
DSFinV-K: BON_TYP=AVSachbezug | AVSachbezung
Kassenbeleg-V1 | 1.3- | From cd67871abd30203432da0b5ce6a687b18cb0da27 Mon Sep 17 00:00:00 2001 From: Thomas Steininger Date: Thu, 30 Jan 2020 11:53:57 +0100 Subject: [PATCH 3/4] Update appendix-de-kassensichv.md --- doc/appendix-de-kassensichv/appendix-de-kassensichv.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/doc/appendix-de-kassensichv/appendix-de-kassensichv.md b/doc/appendix-de-kassensichv/appendix-de-kassensichv.md index 31455767..91b6a55a 100644 --- a/doc/appendix-de-kassensichv/appendix-de-kassensichv.md +++ b/doc/appendix-de-kassensichv/appendix-de-kassensichv.md @@ -113,12 +113,12 @@ For Germany (DE) the country code is `0x4445`. Thus, the value of an unknown ftR |---|---|---|---| | `0x4445000000000000` | unknown type for country-code "DE"
This is handled like a pos-receipt (`0x4445000000000001`). | Beleg
Kassenbeleg-V1 | 1.3- | | `0x4445000000000001` | pos-receipt
main kind of receipt processed on a pos-system. creates a turnover and/or change in the amount of cash in the till or similar operations.
using the ChargeItems and PayItems to hand over details for processing. independent from the used flow (explicit/implicit), the ChargeItems and PayItems should contain the full final state of the receipt. the duration of the action is calculated using the minimum and maximum of datetime over ReceiptRequest/ChargeItems/PayItems.
DSFinV-K: BON_TYP=Beleg, can be overwritten by ftReceiptCaseFlag | Beleg
Kassenbeleg-V1 | 1.3- | -| `0x4445000000000002` | zero-receipt
used for communication and functional test of the fiskaltrust.SecurityMechanism. In addition a detailed status information is responded on the used TSE-Device. Is only valid when charge items block (ftChargeItems) and pay items block (ftPayItems) in the ReceiptRequest are empty arrays.
Also TSE data are unloaded, what may cause a long running request.
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception.
if you want to end a ongoing transaction without turnover (e.g. all items on a receipt are voided) then use a regular ReceiptCase.
Informations returned:
- List of cbReceiptReference <-> Transaction-ID
- Statusdata of TSE, serialnumber, available/free memory, available number of signatures left, ...
DSFinV-K: BON_TYP=AVSonstige, ChargeItems and PayItems have to be empty | AVSonstige ?? [none]
SonstigerVorgang | 1.3- | -| `0x4445000000000003` | initial operation receipt / start-receipt
The request is only valid with the same property requirements as a zero-receipt. initializing a new fiskaltrust.SecurityMachanism, this includes also the initialization of the used TSE in the background. Depending on the TSE-Type used this includes different actions.
On successful initialization, a notification is created which includes the queue-id, scu-id, certificate/public-key, tse-serialnumber=hash(public-key). this notification need to be reported to tax administration.
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception.
DSFinV-K: BON_TYP=AVSonstige, ChargeItems and PayItems have to be empty | AVSonstige ?? [none]
SonstigerVorgang | 1.3- | -| `0x4445000000000004` | out of operation receipt / stop-receipt
The request is only valid with the same property requirements as a zero-receipt. disabling a fiskaltrust.SecurityMachanism, this includes also the deactivation of the used TSE in the background. Depending on the TSE-Type used this includes different actions.
On successful deactivation, a notification is created which includes the queue-id, scu-id, certificate/public-key, tse-serialnumber=hash(public-key). this notification needs to be reported to tax administration.
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception.
DSFinV-K: BON_TYP=AVSonstige, ChargeItems and PayItems have to be empty | AVSonstige ?? [none]
SonstigerVorgang | 1.3- | +| `0x4445000000000002` | zero-receipt
used for communication and functional test of the fiskaltrust.SecurityMechanism. In addition a detailed status information is responded on the used TSE-Device. Is only valid when charge items block (ftChargeItems) and pay items block (ftPayItems) in the ReceiptRequest are empty arrays.
Also TSE data are unloaded, what may cause a long running request.
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception.
if you want to end a ongoing transaction without turnover (e.g. all items on a receipt are voided) then use a regular ReceiptCase.
Informations returned:
- List of cbReceiptReference <-> Transaction-ID
- Statusdata of TSE, serialnumber, available/free memory, available number of signatures left, ...
DSFinV-K: BON_TYP=AVSonstige, ChargeItems and PayItems have to be empty | [none]
SonstigerVorgang | 1.3- | +| `0x4445000000000003` | initial operation receipt / start-receipt
The request is only valid with the same property requirements as a zero-receipt. initializing a new fiskaltrust.SecurityMachanism, this includes also the initialization of the used TSE in the background. Depending on the TSE-Type used this includes different actions.
On successful initialization, a notification is created which includes the queue-id, scu-id, certificate/public-key, tse-serialnumber=hash(public-key). this notification need to be reported to tax administration.
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception.
DSFinV-K: BON_TYP=AVSonstige, ChargeItems and PayItems have to be empty | [none]
SonstigerVorgang | 1.3- | +| `0x4445000000000004` | out of operation receipt / stop-receipt
The request is only valid with the same property requirements as a zero-receipt. disabling a fiskaltrust.SecurityMachanism, this includes also the deactivation of the used TSE in the background. Depending on the TSE-Type used this includes different actions.
On successful deactivation, a notification is created which includes the queue-id, scu-id, certificate/public-key, tse-serialnumber=hash(public-key). this notification needs to be reported to tax administration.
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception.
DSFinV-K: BON_TYP=AVSonstige, ChargeItems and PayItems have to be empty | [none]
SonstigerVorgang | 1.3- | | `0x4445000000000005` | monthly-closing
TBD: close all open cbReceiptReference <-> Transaction-ID
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | AVSonstige ?? [none]
SonstigerVorgang | 1.3- | -| `0x4445000000000006` | yearly-closing
TBD: close all open cbReceiptReference <-> Transaction-ID
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | AVSonstige ?? [none]
SonstigerVorgang | 1.3- | -| `0x4445000000000007` | daily-closing
TBD: close all open cbReceiptReference <-> Transaction-ID
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | AVSonstige ?? [none]
SonstigerVorgang | 1.3- | +| `0x4445000000000006` | yearly-closing
TBD: close all open cbReceiptReference <-> Transaction-ID
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | [none]
SonstigerVorgang | 1.3- | +| `0x4445000000000007` | daily-closing
TBD: close all open cbReceiptReference <-> Transaction-ID
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | [none]
SonstigerVorgang | 1.3- | | `0x4445000000000008` | start-transaction-receipt
starts a new, unfinished action. use ChargeItems and PayItems to hand over already known details for final receipt. using the same cbTerminalID and cbReceiptReferece in further calls connects the action items.
this works only on explicit flow. calling with the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | [none]
[empty] | 1.3- | | `0x4445000000000009` | update-transaction-receipt
updates an ongoing action. use ChargeItems and PayItems to hand over all details for final receipt. using the same cbTerminalID and cbReceiptReferece in further calls connects the action items.
this works only on explicit flow. calling with the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | [none]
[empty] | 1.3- | | `0x444500000000000A` | delta-transaction-receipt
updates an ongoing action. use ChargeItems and PayItems to hand changes for final receipt. using the same cbTerminalID and cbReceiptReferece in further calls connects the action items.
this works only on explicit flow. calling with the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | [none]
[empty] | 1.3- | From c46e5bb9b9697d851d2d2b4200fa3bbb5c7196ca Mon Sep 17 00:00:00 2001 From: Thomas Steininger Date: Thu, 30 Jan 2020 11:54:35 +0100 Subject: [PATCH 4/4] Update appendix-de-kassensichv.md --- doc/appendix-de-kassensichv/appendix-de-kassensichv.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/appendix-de-kassensichv/appendix-de-kassensichv.md b/doc/appendix-de-kassensichv/appendix-de-kassensichv.md index 91b6a55a..9d873185 100644 --- a/doc/appendix-de-kassensichv/appendix-de-kassensichv.md +++ b/doc/appendix-de-kassensichv/appendix-de-kassensichv.md @@ -116,7 +116,7 @@ For Germany (DE) the country code is `0x4445`. Thus, the value of an unknown ftR | `0x4445000000000002` | zero-receipt
used for communication and functional test of the fiskaltrust.SecurityMechanism. In addition a detailed status information is responded on the used TSE-Device. Is only valid when charge items block (ftChargeItems) and pay items block (ftPayItems) in the ReceiptRequest are empty arrays.
Also TSE data are unloaded, what may cause a long running request.
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception.
if you want to end a ongoing transaction without turnover (e.g. all items on a receipt are voided) then use a regular ReceiptCase.
Informations returned:
- List of cbReceiptReference <-> Transaction-ID
- Statusdata of TSE, serialnumber, available/free memory, available number of signatures left, ...
DSFinV-K: BON_TYP=AVSonstige, ChargeItems and PayItems have to be empty | [none]
SonstigerVorgang | 1.3- | | `0x4445000000000003` | initial operation receipt / start-receipt
The request is only valid with the same property requirements as a zero-receipt. initializing a new fiskaltrust.SecurityMachanism, this includes also the initialization of the used TSE in the background. Depending on the TSE-Type used this includes different actions.
On successful initialization, a notification is created which includes the queue-id, scu-id, certificate/public-key, tse-serialnumber=hash(public-key). this notification need to be reported to tax administration.
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception.
DSFinV-K: BON_TYP=AVSonstige, ChargeItems and PayItems have to be empty | [none]
SonstigerVorgang | 1.3- | | `0x4445000000000004` | out of operation receipt / stop-receipt
The request is only valid with the same property requirements as a zero-receipt. disabling a fiskaltrust.SecurityMachanism, this includes also the deactivation of the used TSE in the background. Depending on the TSE-Type used this includes different actions.
On successful deactivation, a notification is created which includes the queue-id, scu-id, certificate/public-key, tse-serialnumber=hash(public-key). this notification needs to be reported to tax administration.
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception.
DSFinV-K: BON_TYP=AVSonstige, ChargeItems and PayItems have to be empty | [none]
SonstigerVorgang | 1.3- | -| `0x4445000000000005` | monthly-closing
TBD: close all open cbReceiptReference <-> Transaction-ID
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | AVSonstige ?? [none]
SonstigerVorgang | 1.3- | +| `0x4445000000000005` | monthly-closing
TBD: close all open cbReceiptReference <-> Transaction-ID
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | [none]
SonstigerVorgang | 1.3- | | `0x4445000000000006` | yearly-closing
TBD: close all open cbReceiptReference <-> Transaction-ID
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | [none]
SonstigerVorgang | 1.3- | | `0x4445000000000007` | daily-closing
TBD: close all open cbReceiptReference <-> Transaction-ID
this works only on implicit flow. calling without the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | [none]
SonstigerVorgang | 1.3- | | `0x4445000000000008` | start-transaction-receipt
starts a new, unfinished action. use ChargeItems and PayItems to hand over already known details for final receipt. using the same cbTerminalID and cbReceiptReferece in further calls connects the action items.
this works only on explicit flow. calling with the ReceiptCaseFlag 0x0000000100000000 ends up in an exception. | [none]
[empty] | 1.3- |