Skip to content

Commit 4d5ca0c

Browse files
sjai-odooafma-odoo
authored andcommitted
[IMP] localization_austria: intrducing fiskaly for austria
In this commit: ------------------- - This adds a usage and configuration guide for integrating Fiskaly with the POS system in Austria. It outlines setup steps, key requirements, and expected behavior to ensure compliance with Austrian fiscal regulations. closes #13705 Task: 4872635 Signed-off-by: Xavier Platteau (xpl) <[email protected]>
1 parent 6f7b3ee commit 4d5ca0c

File tree

3 files changed

+174
-0
lines changed

3 files changed

+174
-0
lines changed

content/applications/finance/fiscal_localizations/austria.rst

Lines changed: 174 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22
Austria
33
=======
44

5+
.. _localizations/austria/configuration:
6+
57
Configuration
68
=============
79

@@ -23,11 +25,16 @@ localization.
2325
* - :guilabel:`Austrian SAF-T Export`
2426
- `l10n_at_saft`
2527
- Adds the SAF-T export.
28+
* - :guilabel:`Austria - Security Regulation for Point of Sale`
29+
- `l10n_at_pos`
30+
- Adds RKSV compliance for POS.
2631

2732
.. seealso::
2833
:doc:`Documentation on e-invoicing’s legality and compliance in Austria
2934
<../accounting/customer_invoices/electronic_invoicing/austria>`
3035

36+
.. _localizations/austria/financial-reports:
37+
3138
Financial reports
3239
=================
3340

@@ -39,19 +46,25 @@ The following localized reports are available:
3946
.. seealso::
4047
:doc:`Accounting reporting documentation <../accounting/reporting>`
4148

49+
.. _localizations/austria/saf-t:
50+
4251
SAF-T (Standard Audit File for Tax)
4352
===================================
4453

4554
The Austrian tax office may request a SAF-T. The Austrian SAF-T Export module allows exporting the
4655
report in XML format.
4756

57+
.. _localizations/austria/saf-t-configuration:
58+
4859
Configuration
4960
-------------
5061

5162
This section explains how to configure the database to ensure all the information required by the
5263
SAF-T is available. If anything is missing, a warning message listing which information is needed
5364
will be displayed during the export.
5465

66+
.. _localizations/austria/saf-t-company:
67+
5568
Company information
5669
~~~~~~~~~~~~~~~~~~~
5770

@@ -70,6 +83,8 @@ Open the database :guilabel:`Settings`. Under the :guilabel:`Companies` section,
7083
- :guilabel:`Tax ID` by providing, if you have one, your :abbr:`UID-Nummer
7184
(Umsatzsteueridentifikationsnummer)` (including the country prefix)
7285

86+
.. _localizations/austria/saf-t-contact:
87+
7388
Contact person
7489
**************
7590

@@ -79,6 +94,8 @@ At least one **contact person** must be linked to your company in the :guilabel:
7994
- Select your company in the :guilabel:`Company name` field.
8095
- Provide at least one phone number using the :guilabel:`Phone` or :guilabel:`Mobile` field.
8196

97+
.. _localizations/austria/saf-t-customer-supplier-information:
98+
8299
Customer and supplier information
83100
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
84101

@@ -88,6 +105,8 @@ your invoices, vendor bills, or payments.
88105
For partners that are companies, fill in the VAT number (including the country prefix) in the
89106
:guilabel:`Tax ID` field.
90107

108+
.. _localizations/austria/saf-t-accounting:
109+
91110
Accounting settings
92111
~~~~~~~~~~~~~~~~~~~
93112

@@ -101,6 +120,8 @@ localization` section, fill in the following fields:
101120
`ÖNACE information on the Austrian Economic Chambers website
102121
<https://www.wko.at/service/zahlen-daten-fakten/oenace.html>`_
103122

123+
.. _localizations/austria/saf-t-chart-of-account:
124+
104125
Chart of accounts mapping
105126
~~~~~~~~~~~~~~~~~~~~~~~~~
106127

@@ -121,6 +142,8 @@ or the mapping. Clicking :guilabel:`View Problematic Accounts` lets you view the
121142
.. seealso::
122143
:doc:`Chart of accounts documentation <../accounting/get_started/chart_of_accounts>`
123144

145+
.. _localizations/austria/saf-t-exporting:
146+
124147
Exporting the SAF-T report
125148
--------------------------
126149

@@ -129,3 +152,154 @@ the right side of the :guilabel:`PDF` button and select :guilabel:`SAF-T`.
129152

130153
.. image:: austria/austria-saft-button.png
131154
:alt: The SAF-T button to export the file in XML format
155+
156+
.. _localizations/austria/pos:
157+
158+
Point of Sale
159+
=============
160+
161+
.. _localizations/austria/pos-rksv:
162+
163+
RKSV (Registrierkassensicherheitsverordnung)
164+
--------------------------------------------
165+
166+
The :abbr:`RKSV (Registrierkassensicherheitsverordnung)` is an Austrian regulation designed
167+
to secure cash registers and prevent tax fraud. It requires businesses to use tamper-proof
168+
electronic cash register systems, including :doc:`point of sale </applications/sales/point_of_sale>`
169+
systems.
170+
171+
These systems must be equipped with a **Signature Creation Unit (SCU)**, which is
172+
responsible for signing each transaction. This ensures that the transaction data cannot be altered.
173+
Additionally, the regulation mandates periodic transaction data exports for audit purposes. Odoo
174+
provides a compliant solution through `fiskaly <https://fiskaly.com>`_, a *cloud-based solution*.
175+
176+
.. _localizations/austria/pos-rksv-configuration:
177+
178+
Configuration
179+
~~~~~~~~~~~~~
180+
181+
:ref:`Install <general/install>` the **Austria - Security Regulation for Point of Sale**
182+
(`l10n_at_pos`) module.
183+
184+
.. tip::
185+
If this module is not listed, :ref:`update the app list <general/install>`.
186+
187+
.. _localizations/austria/pos-rksv-company:
188+
189+
Company information
190+
*******************
191+
192+
Open the Settings app, navigate to the :guilabel:`Companies` section, and click
193+
:icon:`oi-arrow-right` :guilabel:`Update Info` to make sure the :ref:`information
194+
<localizations/austria/saf-t-company>` is up-to-date and correctly filled in.
195+
196+
To link your company to Fiskaly and use it in Odoo, open the :guilabel:`Fiskaly` tab and enable
197+
:guilabel:`Managed by Odoo` :icon:`fa-toggle-on`, which activates automatic integration management.
198+
199+
If a Fiskaly account already exists with its own credentials, disable the toggle and configure the
200+
existing :guilabel:`Fiskaly credentials` manually.
201+
202+
.. note::
203+
For testing, ensure that :guilabel:`Test Fiskaly` :icon:`fa-toggle-on` is enabled to run the
204+
integration without impacting the production server. Since test mode is enabled by default,
205+
disable :guilabel:`Test Fiskaly` :icon:`fa-toggle-off` to switch to production mode.
206+
207+
.. image:: austria/management-toggle.png
208+
:alt: Management toggle
209+
210+
.. important::
211+
Once the credentials have been authenticated, the Fiskaly management option (by Odoo or custom)
212+
and the mode (test or production) can no longer be modified.
213+
214+
Click :guilabel:`Generate Credentials` to create a new organization in the Fiskaly system and
215+
generate the necessary credentials to run the service. Next, click :guilabel:`Authenticate Keys`
216+
to validate those credentials.
217+
218+
.. _localizations/austria/pos-fiskaly-finanzonline:
219+
220+
Link a Fiskaly organization to FinanzOnline
221+
*******************************************
222+
223+
To link the Fiskaly organization with the Austrian Ministry of Finance, FinanzOnline credentials
224+
must be provided. To do so, fill in the following information in your company's :guilabel:`Fiskaly`
225+
tab:
226+
227+
- :guilabel:`Participant Identifier`
228+
- :guilabel:`User Identifier`
229+
- :guilabel:`User Pin`
230+
231+
.. note::
232+
FinanzOnline credentials can be accessed through an existing account or by `creating a new one
233+
<https://finanzonline.bmf.gv.at/>`_ if it has not yet been set up.
234+
235+
.. tip::
236+
Random credentials can be used in **test mode**, but valid credentials are required in
237+
**production mode**.
238+
239+
Click :guilabel:`Authenticate FON` to link your Fiskaly organization to the Austrian Ministry of
240+
Finance and start regular :doc:`point of sale </applications/sales/point_of_sale>` operations.
241+
242+
.. _localizations/austria/pos-digitally-sign-receipts:
243+
244+
Digitally signatured receipts
245+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
246+
247+
To ensure the integrity and authenticity of the receipts, the system automatically signs them using
248+
the :abbr:`SCU (Signature Creation Unit)` in a background process. The receipt then displays an
249+
encrypted signature as a QR code containing the receipt number and information about the SCU used to
250+
sign it.
251+
252+
.. note::
253+
- If the :abbr:`SCU (Signature Creation Unit)` is unavailable, receipts may not include a QR
254+
code; in such cases:
255+
256+
- Make sure the receipt includes a :guilabel:`Sicherheitseinrichtung ausgefallen` message,
257+
indicating that the system is linked to Fiskaly services, but the SCU is temporarily
258+
unavailable.
259+
- If this message is missing from the receipt, it indicates no connection to Fiskaly services.
260+
261+
- Orders that remain unsigned due to SCU unavailability can be signed manually. To do so, follow
262+
these steps:
263+
264+
#. Go to :menuselection:`Point of Sale --> Orders --> Orders`.
265+
#. To identify unsigned orders, click the :icon:`oi-settings-adjust` :guilabel:`(adjust
266+
settings)` icon in the :guilabel:`Orders` list view to reveal the :guilabel:`Receipt
267+
Signed?` column.
268+
#. Select the unsigned orders, click :icon:`fa-cog` :guilabel:`Actions`, and select
269+
:guilabel:`Sign Order`.
270+
271+
.. _localizations/austria/pos-dep7:
272+
273+
DEP7 export
274+
~~~~~~~~~~~
275+
276+
The exported :abbr:`DEP7 (Digitale Schnittstelle der Finanzverwaltung für Kassensysteme)` file
277+
allows authorities to verify transactions and ensure compliance with anti-fraud measures. Businesses
278+
must periodically generate it for audit purposes and submit it to the Austrian tax authorities upon
279+
request.
280+
281+
To generate it, go to :menuselection:`Point of Sale --> Reporting --> DEP7 Reports`, and, in the
282+
:guilabel:`DEP7 Reports`, fill in the following mandatory fields:
283+
284+
- :guilabel:`Start Datetime`: Exports data with dates on or after the start date.
285+
- :guilabel:`End Datetime`: Exports data with dates on or before the end date.
286+
- :guilabel:`Point of Sale`: Specify from which point of sale(s) data must be exported.
287+
288+
Then, click :guilabel:`Print` to download the PDF file with DEP7 data.
289+
290+
.. image:: austria/dep7-reports.png
291+
:alt: DEP7 Reports
292+
293+
.. _localizations/austria/pos-montly-yearly-receipts:
294+
295+
Monthly / Yearly closing receipts
296+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
297+
298+
To print monthly/yearly closing receipts, :ref:`start a session <pos/session-start>` from the **POS
299+
dashboard** and click :guilabel:`Open Register` on the related point of sale. Click the
300+
:icon:`oi-view-list` :guilabel:`(list view)` icon in the top-right corner and select
301+
:guilabel:`Montly/Yearly Receipts`.
302+
303+
The last month is selected by default in the :guilabel:`Print closing receipts` window. To change
304+
it, select :guilabel:`Monthly` or :guilabel:`Yearly`, then click the :icon:`fa-calendar-o`
305+
:guilabel:`(calendar)` icon to select the desired month/year.
Loading
Loading

0 commit comments

Comments
 (0)