Merge pull request #25 from steininger/master

additional reference tables

doc/appendix-de-kassensichv/appendix-de-kassensichv.md

@@ -334,3 +334,38 @@ This table expands on the values provided in table [ftPayItemCase in General Par
 | `0x4445000000000016` | cash transfer from/to cash book <br /> not taxable <br /> DSFinV-K transformation required. negative amount gets converted to GV_TYP=Einzahlung. positive amount gets converted to GV_TYP=Auszahlung. amount=-amount.  in case of void-receipt everything turned | Keine | 1.3- |
 | `0x4445000000000017` | cash amount difference from/to till<br /> not taxable<br /> DSFinV-K transformation required. UST_Schluessel=5. GV_TYP=DifferenzSollIst. amount=-amount. | Keine | 1.3- |
 
+
+
+
+
+### Type of Signature: ftSignatureType
+
+The ftSignatureType indicates type and origin of the signature. The data type is `Int64` and can contain a country specific code which is a value following the ISO-3166-1-ALPHA-2 standard, converted from ASCII into hex and used as byte 8 and 7.
+
+For definitions regarding national laws, please refer to the appropriate appendix<span id="t-type-of-signature-ftsignaturetype-127">.</span>
+
+| **Value**            | **Description**          | **Service-Version** |
+|----------------------|--------------------------|---------------------|
+| `0x4445000000000001` | Signature according to kasssichv (qr-code content)                  | 1.3                 |
+| `0x4445000000000002` | Archiving required  | 1.3                |
+| `0x4445000000000003` | notification       | 1.3                 |
+| `0x4445000000000010` | start-transaction-result     | 1.3                 |
+| `0x4445000000000011` | finish-transaction-payload     | 1.3                 |
+| `0x4445000000000012` | finish-transaction-result     | 1.3                 |
+| `0x4445000000000013` | receipt / qr-version     | 1.3                 |
+| `0x4445000000000014` | receipt / kassenseriennummer     | 1.3                 |
+| `0x4445000000000015` | receipt / processtype     | 1.3                 |
+| `0x4445000000000016` | receipt / processdata     | 1.3                 |
+| `0x4445000000000017` | receipt / transaktionsnummer     | 1.3                 |
+| `0x4445000000000018` | receipt / signaturzähler     | 1.3                 |
+| `0x4445000000000019` | receipt / startzeit (start-transaction)    | 1.3                 |
+| `0x444500000000001A` | receipt / logtime     | 1.3                 |
+| `0x444500000000001B` | receipt / signaturalgorithmus     | 1.3                 |
+| `0x444500000000001C` | receipt / logtime-format     | 1.3                 |
+| `0x444500000000001D` | receipt / signatur     | 1.3                 |
+| `0x444500000000001E` | receipt / public-key     | 1.3                 |
+| `0x444500000000001F` | receipt /  vorgangsbeginn (action)    | 1.3                 |
+
+
+*Table 15. Type of Signature: ftSignatureType*
+

doc/appendix-de-kassensichv/examples/info-order.md

@@ -0,0 +1,85 @@
+
+info-order
+implicit flow
+
+this is unsed to persist orders
+
+same `cbReceiptReference` in multiple receiptrequest/receiptresponse (sign-calls) can be used to connect multiple actions into a business-action. each `cbReceiptReference` can only be used once within a explicit flow. this also meanse only one time start-transaction can be done with one specific `cbReceiptReference`, because it is mapped 1:1 to the ongoing transaction of the (tse).
+the implicit flow uses start-transaction and finish-transaction within the same receiptrequest/receiptresponse. therefore in this case the `cbReceiptReference` has no impact on already ongoing transactions as long as there wasn't a start-transaction with same `cbReceiptReference` before.
+
+and additional method to connect multiple actions to a ongoing business-action is to reference a previouse action by `cbPreviouseReceiptReference`.
+
+
+Request
+
+{
+"ftCashBoxID": "cashboxid-guid",
+"ftPosSystemId": "possystemid-guid",
+"cbTerminalID": "terminalid",
+"cbReceiptReference": "233348",
+"cbReceiptMoment": "2019-07-19T12:52:34.9609375Z",
+"cbChargeItems": [
+{
+"Quantity": 2.0,
+"Description": "0,5 Soda Zitrone",
+"Amount": 5.6,
+"VATRate":19.0000,
+"ftChargeItemCase":4919338167972134913
+}
+],
+"cbPayItems": [
+{
+"Quantity": 1.0,
+"Description": "Internal",
+"Amount": 5.6,
+// 0x4445 0000 0000 000A (internal / material consumption)
+"ftPayItemCase": 4919338167972134922
+}
+],
+// 0x4445 0000 0000 0010 (info-order) + 0000 0001 0000 0000 (implicit flow)
+"ftReceiptCase":4919338172267102224,
+"cbArea": "Tisch 56",
+"cbPreviousReceiptReference": "233347"
+}
+
+
+Response
+{
+"ftCashBoxID": "cashboxid-guid",
+"ftPosSystemId": "possystemid-guid",
+"cbTerminalID": "terminalid",
+"cbReceiptReference": "233348",
+
+"ftQueueID":"queueid-guid",
+"ftQueueItemID":"queueitemid-guid",
+"ftQueueRow":"queuerow",
+"ftReceiptMoment":"2019-10-25T13:48:04.323Z",
+
+"ftCashboxIdentification":"fiskaltrust1=tse-client-id",
+"ftReceiptIdentification":"ft[queue-receiptnumerator-hex]#IT[tse-transaction]"
+
+ftSignatures[
+        {
+            "ftSignatureFormat":13,
+            //0x4445000000000010 (start-transaction-result)
+            "ftSignatureType": 4919338167972134928,
+            "caption": "start-transaction-signature",
+            "data": "[startTransactionResult]"
+        },
+        {
+            "ftSignatureFormat":13,
+            //0x4445000000000011 (finish-transaction-payload)
+            "ftSignatureType": 4919338167972134929,
+            "caption": "finish-transaction-payload",
+            "data": "[finishTransactionPayload]"
+        },
+        {
+            "ftSignatureFormat": 13,
+            //0x4445000000000012 (finish-transaction-result)
+            "ftSignatureType": 4919338167972134930,
+            "caption": "finish-transaction-payload",
+            "data": "[finishTransactionResult]"
+        }
+]
+
+}