Skip to content

Commit

Permalink
Update dsfinv-k-generation.md
Browse files Browse the repository at this point in the history
  • Loading branch information
@steininger
steininger committed Apr 30, 2020
1 parent 49308b7 commit d35d9ce
Showing 1 changed file with 0 additions and 171 deletions.
171 changes: 0 additions & 171 deletions doc/appendix-de-kassensichv/procedural-documentation/dsfinv-k-generation.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -262,177 +262,6 @@ If you want (optional) to add other, additional references (from other systems o
| `TSE_TA_FEHLER` | Where appropriate, indications of TSE errors | String (200) | Automatically filled by ft|
| `TSE_VORGANGSDATEN` | Data of the operation (optional) | String | Automatically filled by ft |

#### Master data module (DE: Stammdatenmodul)

To avoid redundancies, the master data is only saved once for each cashpoint closing. If changes are made to the master data listed below, a closing must be created automatically beforehand.

The **master data** for the day that is closed by the daily closing receipt (or monthly, yaearly because they include the daily closing) **must be included into the closing receipt** (daily/monthly/yearly). To include the data please send the content of `ftReceiptCaseData` in JSON format and add the key value pair `dailyClosingMasterData`. The value should also be JSON and formatted as follows:
```json
"dailyClosingMasterData" : "{

"CompanyName" : "...",
"CompanyStreet" : "...",
"CompanyZip" : "...",
"CompanyCity" : "...",
"CompanyCountry" : "...",
"CompanyTaxNr" : "...",
"CompanyVATId" : "...",

"LocationName" : "...",
"LocationStreet" : "...",
"LocationZip" : "...",
"LocationCity" : "...",
"LocationCountry" : "...",
"LocationVATId" : "...",

"CashRegisterBrand" : "...",
"CashRegisterModel" : "...",
"CashRegisterSWBrand" : "...",
"CashRegisterSWBVersion" : "...",
"CashRegisterBaseCurrency" : "...",

"Terminals" : [ {
"Id" : "...",
"Brand" : "...",
"Model" : "...",
"SerialNr" : "...",
"SWBrand" : "...",
"SWVersion" : "..."
}, {...}, ...],

"Agencies" : [ {
"Id" : ...,
"Name" : "...",
"Street" : "...",
"Zip" : "...",
"City" : "...",
"Country" : "...",
"TaxNr" : "...",
"VATId" : "..."
}, {...}, ...],
}"
```

The DSFinV-K master data module is divided into the following files:

##### File: Stamm_Abschluss (cashpointclosing.csv)

| **Fieldname** | **Description** | **Format** | **ft.input** |
|----------------------|--------------------------|---------------------|---------------------|
| `Z_KASSE_ID` | ID of the (closing) cashpoint | String (50) | Automatically created and filled by ft (`ftCashBoxIdentification`) |
| `Z_ERSTELLUNG` | Date of the cashpoint closing | ISO 8601 und RFC3339 date | Automatically filled by ft from `cbReceiptMoment` of the daily closing receipt |
| `Z_NR` | Nr. of the cashpoint closing | Integer | Automatically created and filled by ft |
| `Z_BUCHUNGSTAG` | Booking date different from closing date (`Z_ERSTELLUNG`) | ISO 8601 und RFC3339 date | Can be send via `ftReceiptCaseData` in JSON format by adding the key value pair `BookingDate`. It is mandatory, if the booking date is different from the daily closing receipt date (`Z_ERSTELLUNG`). E.g. `"ftReceiptCaseData":"{ ..., "BookingDate":"2020-01-27", ... }"` |
| `TAXONOMIE_VERSION` | Version of the DFKA taxonomy cashpoint-data according to the title: [DFKA Taxonomie](https://dfka.net/taxonomie/) | String (10) | Automatically filled by ft |
| `Z_START_ID` | First BON_ID in closing | String (40) | Automatically filled by ft |
| `Z_ENDE_ID` | Last BON_ID in the closing | String (40) | Automatically filled by ft |
| `NAME` | Name of the company | String (60) | Mandatory, `dailyClosingMasterData.CompanyName` |
| `STRASSE` | Street | String (60) | Mandatory,`dailyClosingMasterData.CompanyStreet` |
| `PLZ` | Zip | String (10) | Mandatory, `dailyClosingMasterData.CompanyZip` |
| `ORT` | City | String (62) | Mandatory, `dailyClosingMasterData.CompanyCity` |
| `LAND` | Country | ISO 3166 ALPHA-3 country code | Mandatory, `dailyClosingMasterData.CompanyCountry` |
| `STNR` | Tax number of the company | String (20) | Mandatory, `dailyClosingMasterData.CompanyTaxNr` |
| `USTID` | VAT ID | String (15) | Mandatory, `dailyClosingMasterData.CompanyVATId` |
| `Z_SE_ZAHLUNGEN` | Total of all payments | Decimal (2) | Automatically filled by ft |
| `Z_SE_BARZAHLUNGEN` | Total of all cash payments | Decimal (2) | Automatically filled by ft |

(`dailyClosingMasterData`is described above in the chapter "Master data module")

##### File: Stamm_Orte (location.csv)

| **Fieldname** | **Description** | **Format** | **ft.input** |
|----------------------|--------------------------|---------------------|---------------------|
| `Z_KASSE_ID` | ID of the (closing) cashpoint | String (50) | Automatically created and filled by ft (`ftCashBoxIdentification`) |
| `Z_ERSTELLUNG` | Date of the cashpoint closing | ISO 8601 und RFC3339 date | Automatically filled by ft from `cbReceiptMoment` of the daily closing receipt |
| `Z_NR` | Nr. of the cashpoint closing | Integer | Automatically created and filled by ft |
| `LOC_NAME` | Name of the site | String (60) | Mandatory, `dailyClosingMasterData.LocationName` |
| `LOC_STRASSE` | Street | String (60) | Mandatory, `dailyClosingMasterData.LocationStreet` |
| `LOC_PLZ` | Zip | String (10) | Mandatory, `dailyClosingMasterData.LocationZip` |
| `LOC_ORT` | City | String (62) | Mandatory, `dailyClosingMasterData.LocationCity` |
| `LOC_LAND` | Country | ISO 3166 ALPHA-3 county code | Mandatory, `dailyClosingMasterData.LocationCountry` |
| `LOC_USTID` | VAT ID | String (15) | Mandatory, `dailyClosingMasterData.LocationVATId` |

(`dailyClosingMasterData`is described above in the chapter "Master data module")

##### File: Stamm_Kassen (cashregister.csv)

| **Fieldname** | **Description** | **Format** | **ft.input** |
|----------------------|--------------------------|---------------------|---------------------|
| `Z_KASSE_ID` | ID of the (closing) cashpoint | String (50) | Automatically created and filled by ft (`ftCashBoxIdentification`) |
| `Z_ERSTELLUNG` | Date of the cashpoint closing | ISO 8601 und RFC3339 date | Automatically filled by ft from `cbReceiptMoment` of the daily closing receipt |
| `Z_NR` | Nr. of the cashpoint closing | Integer | Automatically created and filled by ft |
| `KASSE_BRAND` | Brand of the cash register | String (50) | Mandatory, `dailyClosingMasterData.CashRegisterBrand` |
| `KASSE_MODELL` | Model designation | String (50) | Mandatory, `dailyClosingMasterData.CashRegisterModel` |
| `KASSE_SERIENNR` | Serial number of the cash register | String (70) | `ftCashBoxID` ?(tbd) |
| `KASSE_SW_BRAND` | Brand name of the software | String (50) | Mandatory, `dailyClosingMasterData.CashRegisterSWBrand` |
| `KASSE_SW_VERSION` | Version of the software | String (50) | Mandatory, `dailyClosingMasterData.CashRegisterSWVersion` |
| `KASSE_BASISWAEH_CODE` | Basis currency of the cash register | ISO 4217 currency code | Mandatory, `dailyClosingMasterData.CashRegisterBaseCurrency` |
| `KEINE_UST_ZUORDNUNG` | VAT not determinable | 0 or 1 | Automatically filled by ft |

(`dailyClosingMasterData`is described above in the chapter "Master data module")

##### File: Stamm_Terminals (slaves.csv)

| **Fieldname** | **Description** | **Format** | **ft.input** |
|----------------------|--------------------------|---------------------|---------------------|
| `Z_KASSE_ID` | ID of the (closing) cashpoint | String (50) | Automatically created and filled by ft (`ftCashBoxIdentification`) |
| `Z_ERSTELLUNG` | Date of the cashpoint closing | ISO 8601 und RFC3339 date | Automatically filled by ft from `cbReceiptMoment` of the daily closing receipt |
| `Z_NR` | Nr. of the cashpoint closing | Integer | Automatically created and filled by ft |
| `TERMINAL_ID` | ID of the terminal | String (50) |Mandatory, `dailyClosingMasterData.Terminals.Id` |
| `TERMINAL_BRAND` | Brand of the terminal | String (50) | Mandatory, `dailyClosingMasterData.Terminals.Brand`|
| `TERMINAL_MODELL` | Model designation | String (50) | Mandatory, `dailyClosingMasterData.Terminals.Model` |
| `TERMINAL_SERIENNR` | Serial number of the terminal | String (70) | Mandatory, `dailyClosingMasterData.Terminals.SerialNr` |
| `TERMINAL_SW_BRAND` | Brand name of the software | String (50) | Mandatory, `dailyClosingMasterData.Terminals.SWBrand` |
| `TERMINAL_SW_VERSION` | Version of the software | String (50) | Mandatory, `dailyClosingMasterData.Terminals.SWVersion` |

(`dailyClosingMasterData`is described above in the chapter "Master data module")

##### File: Stamm_Agenturen (pa.csv)


| **Fieldname** | **Description** | **Format** | **ft.input** |
|----------------------|--------------------------|---------------------|---------------------|
| `Z_KASSE_ID` | ID of the (closing) cashpoint | String (50) | Automatically created and filled by ft (`ftCashBoxIdentification`) |
| `Z_ERSTELLUNG` | Date of the cashpoint closing | ISO 8601 und RFC3339 date | Automatically filled by ft from `cbReceiptMoment` of the daily closing receipt |
| `Z_NR` | Nr. of the cashpoint closing | Integer | Automatically created and filled by ft |
| `AGENTUR_ID` | ID of the agency | Integer | Mandatory, `dailyClosingMasterData.Agencies.Id` |
| `AGENTUR_NAME` | Name of the client | String (60) | Mandatory, `dailyClosingMasterData.Agencies.Name` |
| `AGENTUR_STRASSE` | Street | String (60) | Mandatory, `dailyClosingMasterData.Agencies.Street`|
| `AGENTUR_PLZ` | Zip | String (10) | Mandatory, `dailyClosingMasterData.Agencies.Zip` |
| `AGENTUR_ORT` | City | String (62) | Mandatory, `dailyClosingMasterData.Agencies.City` |
| `AGENTUR_LAND` | ISO 3166 ALPHA-3 country code | String | Mandatory, `dailyClosingMasterData.Agencies.Country` |
| `AGENTUR_STNR` | Tax number | String (20) | Mandatory, `dailyClosingMasterData.Agencies.TaxNr` |
| `AGENTUR_USTID` | VAT ID| String (15) | Mandatory, `dailyClosingMasterData.Agencies.VATId` |

(`dailyClosingMasterData`is described above in the chapter "Master data module")

##### File: Stamm_USt (vat.csv)

| **Fieldname** | **Description** | **Format** | **ft.input** |
|----------------------|--------------------------|---------------------|---------------------|
| `Z_KASSE_ID` | ID of the (closing) cashpoint | String (50) | Automatically created and filled by ft (`ftCashBoxIdentification`) |
| `Z_ERSTELLUNG` | Date of the cashpoint closing | ISO 8601 und RFC3339 date | Automatically filled by ft from `cbReceiptMoment` of the daily closing receipt |
| `Z_NR` | Nr. of the cashpoint closing | Integer | Automatically created and filled by ft |
| `UST_SCHLUESSEL` | ID of the VAT rate| Integer | Automatically filled by ft |
| `UST_SATZ` | Percentage | Decimal (2) | Automatically filled by ft |
| `UST_BESCHR` | Description| String | Automatically filled by ft |

##### File: Stamm_TSE (tse.csv)

| **Fieldname** | **Description** | **Format** | **ft.input** |
|----------------------|--------------------------|---------------------|---------------------|
| `Z_KASSE_ID` | ID of the (closing) cashpoint | String (50) | Automatically created and filled by ft (`ftCashBoxIdentification`) |
| `Z_ERSTELLUNG` | Date of the cashpoint closing | ISO 8601 und RFC3339 date | Automatically filled by ft from `cbReceiptMoment` of the daily closing receipt |
| `Z_NR` | Nr. of the cashpoint closing | Integer | Automatically created and filled by ft |
| `TSE_ID` | TSE ID | Integer | Automatically filled by ft |
| `TSE_SERIAL` | Serial number of the TSE (Corresponds according to TR- 03153 section 7.5. to the hash value of the key contained in the certificate; octet string in hexadecimal representation) | String (68) | Automatically filled by ft |
| `TSE_SIG_ALGO` | The signature algorithm used by the TSE | String (21) | Automatically filled by ft |
| `TSE_ZEITFORMAT` | The format used by the TSE for the log-time | String (31) | Automatically filled by ft |
| `TSE_PD_ENCODING` | Text encoding of the process data (UTF-8 or ASCII) | String (5) | Automatically filled by ft |
| `TSE_PUBLIC_KEY` | Public key - eventually extracted from the TSE certificate - in base64 encoding | String (512) | Automatically filled by ft |
| `TSE_ZERTIFIKAT_I` | First 1,000 characters of the TSE certificate (in base64 encoding) | String (1000) | Automatically filled by ft |
| `TSE_ZERTIFIKAT_II` | Possibly another 1,000 characters of the certificate (in base64 encoding) | String (1000) | Automatically filled by ft |

#### Cashpoint closing module (DE: Kassenabschlussmodul)

The three structure levels (modules) allow transactions to be separated and grouped, so that they can be automatically posted or transferred to the bookkeeping. The cash register closing therefore has an accounting function, meaning that the data of the respective closing has to be exported digitally within this module.
Expand Down

0 comments on commit d35d9ce

Please sign in to comment.