Export
SAF-T Export
The Fiscal Authority requires an export in the SAF-T format. It includes base data, transactions and events. The export can be triggered in the efsta portal and on the local EFR installation on page “Kontroll”.
REST Implementation
For export use e.g.
GET /control/export?from=2022-01-01&till=2022-12-31
Optional query parameters for /control/export:
&target=...
Specify a directory path where the export .xml shall be stored. Else a .zip containing the export file will be sent in response body.
SAF-T Events
Fiscal law requires recording of special “events” that are included in the export. Some events are recorded automatically by EFR, some are recorded additionally on special transactions, others must be sent as audit-entry:
<Audit Code="DRAWER_OPEN" Dsc="Drawer open" TL="001" TT="1" Opr="1" OprN="Operator
name" />
{
"Audit": {
"Code": "DRAWER_OPEN",
"Dsc": "Drawer open",
"TL": "001",
"TT": "1",
"Opr": "1",
"OprN": "Operator name"
}
}
The correct predefined event ID is mapped by Audit.Code, e.g. DRAWER_OPEN maps to 13005.
Predefined EventID | Description | Code | Auto |
---|---|---|---|
13001 | POS start | POS_START | On EFR startup |
13002 | POS stop | POS_STOP | |
13003 | Opr login | On NFS=“LOGIN“ | |
13004 | Opr logout | On NFS=“LOGOUT“ | |
13005 | Cash drawer open | DRAWER_OPEN | |
13006 | Cash drawer close | DRAWER_CLOSE | |
13007 | Software update | UPDATE | |
13008 | X-Report | On NFS=“X“ | |
13009 | Z-Report | On NFS=“Z“ | |
13010 | Suspend receipt | SUSPEND_RECEIPT | |
13011 | Resume receipt | RESUME_RECEIPT | |
13012 | Receipt printed | RECEIPT_PRINTED | |
13013 | Return items | On negative items | |
13014 | Print duplicate | On NFS=“DUP“ | |
13015 | Provisional receipt | On NFS=“PROVISIONAL“ or DT=”PROVISIONAL” | |
13016 | Delivery receipt | On NFS=“DELIVERY“ or DT=”DELIVERY” | |
13017 | Training receipt | On NFS=“TRAINING“ | |
13018 | Report | REPORT | |
13019 | Pay out | On NFS=“PAY | |
13020 | Export | EXPORT | On /control/export |
13021 | Price change | PRICE_CHANGE | |
13022 | Price lookup | PRICE_LOOKUP | |
13023 | Training On | TRAINING_ON | |
13024 | Training Off | TRAINING_OFF | |
13025 | Disk full | MEM_FULL | |
13026 | Emergency mode On | EMERGENCY_ON | |
13027 | Emergency mode Off | EMERGENCY_OFF | |
13028 | Void receipt | On ESR.Void=“1“ and ESR.T <0 | |
13029 | Steb receipt | STEB_RECEIPT | |
13030 | Receipt not printed | RECEIPT_NOT_PRINTED | |
13999 | Other | OTHER |