Feedback|  Print Manual

NCCR Cash Register



Manual


Creation Date: 2021/06/13

Contents



General

Setup

  • Cash Register Setup
  • Cash Register IDs
  • Create BMF User
  • Registration with fiskaltrust
  • Cash Register User
  • Report Selection - Cash Register
  • Report Layout Selection
  • Payment Methods

Tasks

  • Working with Cash Register
  • Create Status Documents
  • Annual Closure
  • Error Handling
  • Handwritten Document
  • Subsequent Cash Payment

Reports and Analysis

  • Cash Register Statistics

Archive

  • Data Collection Protocol (§ 7 RKSV)
  • Cash Register Entries
  • Cash Register Entry Signature Attempts
  • Cash Register Entry Request/Response
  • Cash Register Entry Document Data
  • Cash Register Entry Comments

Appendix

  • Delete Cash Register Data
  • NAVAX License Overview
  • Version History
  • Environment Confirmations
  • Information for Administrators
  • Information for Developers
  • Release Notes


General

NCCR Cash Register extends the Dynamics 365 Business Central processes to meet legal national requirements for the fiscalization of POS systems by using a service developed by fiskaltrust. Supported countries: Austria (RKSV) WKO Information (DE): https://www.wko.at/service/steuern/registrierkassenpflicht-unternehmen.html

Navigation

NCCR Cash Register is integrated into existing sales and service processes. Sales documents and service documents are created, posted and printed as before. Within the Accountant and Accounting Manager role, the NCCR Cash Register Setup can also be called directly via Actions, Setup. Fields, actions, pages and reports originating from the NCCR Cash Register extension are identified by the abbreviation NCCR. NCCR stands for NAVAX Consulting Cash Register. This additional identification allows the windows and functions belonging to the NCCR Cash Register to be clearly distinguished from other extensions (which may use similar names and designations). The search term "nccr" is also recognized by "Tell me what you want to do". This allows very fast access to the individual areas of the NCCR Cash Register.


Setup,
Cash Register Setup

Before the NCCR Cash Register can be used, its basic functionality and at least one Cash Register ID must be set up. In the NCCR Cash Register Setup window the general settings and defaults are defined.

General, Fields

Logo Representation Sales SlipSpecifies whether the company logo should be printed on the sales slip and, if so, in which format.
QR Code SizeSpecifies the QR Code size for the documents.
Cache QR CodeSpecifies whether QR Codes should be saved when printing a report, or regenerated each time. Saving the QR Codes can be useful for performance reasons, but on the other hand it generates much more data. Activate the field only if necessary.

Cash Register IDs

In the Cash Register IDs area the Cash Register IDs are created or managed. For more information, see Setup, Cash Register IDs.

Setup, Actions

  • Users

    View or set up the settings for the cash register users. For more information, see Setup, Cash Register User.
  • Report Selection

    View or set up which reports are used when printing a cash register document. For more information, see Setup, Report Selection - Cash Register.
  • Report Layout Selection

    View or set up which layouts are used for the reports. For more information, see Setup, Report Layout Selection.
  • Payment Methods

    View or set up for which Payment Methods a Cash Register Notification must be made. For more information, see Setup, Payment Methods.

System, Fields

License StatusSpecifies the current license status of the Extension. For more information, see Appendix, NAVAX License Overview.
Serial No.Specifies the serial number of the Extension.
VersionSpecifies the currently installed version of the Extension.
Delete Data Date CalculationSpecifies the time period for deleting data via the Delete Data action. Only data that is at least 6 months old can be deleted. If the field is empty, the minimum period is used.
Last Date Archived Request Data deletedSpecifies the date on which Delete Data was last executed.
Archived Request Data deleted untilSpecifies the date until which the archived request data was deleted from the Signature Attempts.

System, Actions

  • What's New?

    Opens an external website with additional information about the extension and through which the license of the extension can be requested or checked. For more information, see Appendix, NAVAX License Overview.
  • Update License

    Updates the License of the Extension or checks if it is up to date. For more information, see Appendix, NAVAX License Overview.
  • Version History

    Views when which version of the Extension was installed. For more information, see Appendix, Version History.
  • Environment Confirmations

    View or set up the Environment Confirmations of the Extension. NCCR Cash Register uses Environment Confirmations to prevent test data from being accidentally forwarded to the external service of fiskaltrust as real data. For more information, see Appendix, Environment Confirmations.
  • Delete Data

    If necessary, this action can be used to remove the archived request data from the Signature Attempts. The stored QR Codes can also be deleted. For more information, see Appendix, Delete Cash Register Data.


Setup,
Cash Register IDs

Cash Register IDs are managed or created in the NCCR Cash Register Setup window. Any number of IDs can be created. In the NCCR Cash Register User Setup it is possible to assign an ID to the individual users, which is then used as a default value when creating new documents.

General, Fields

IDSpecifies the cash register identification number according to RKSV. The field must match the ID that is stored in the service.
DescriptionSpecifies the description of the Cash Register ID.
StatusSpecifies the current status of the Cash Register ID.
  • Pending indicates that the ID is not yet in operation.
  • Active indicates that the ID is ready for operation.
  • Out of Operation indicates that the ID is no longer in operation.
BlockedSpecifies whether the Cash Register ID is blocked. You cannot post documents with a blocked Cash Register ID.
Pending ErrorsSpecifies the number of Cash Register Entries with a pending error for the Cash Register ID.
Ongoing DocumentsSpecifies the number of ongoing sales documents for the Cash Register ID. Ongoing documents were created but not yet posted.
Ongoing Service DocumentsSpecifies the number of ongoing service documents for the Cash Register ID. Ongoing service documents were created but not yet posted.
Allow Manual CompletionSpecifies whether the Complete manually action may be executed in the Cash Register Entries.

Important

The function Complete manually may only be used in justified exceptional cases and only if there are no other possibilities to complete an entry in the Cash Register Entries.

Service, Fields

ServiceSpecifies the desired service. The fiskaltrust service assigns a sequential document number, increases the sales counter(s) according to the RKSV, encrypts the sales counter, creates a signature and the machine-readable code according to the RKSV. The additional document contents created by the fiskaltrust service are returned to and additionally saved to the cash register in accordance with the RKSV. For more information, see Setup, Registration with fiskaltrust.
Service Login ID (CashBoxId)Specifies the CashBoxId (credentials) for the service. For more information, see Setup, Registration with fiskaltrust.
Service Access TokenSpecifies the AccessToken (credentials) for the service. For more information, see Setup, Registration with fiskaltrust.
Service URLSpecifies the connection to the service in the Production Environment (Real Data).
Service URL SandboxSpecifies the connection to the service in the Sandbox Environment (Test Data).

Warning

Cash register postings in the sandbox environment (test environment) are also forwarded to the service. To prevent this data from being incorrectly interpreted as real data, the Service URL of the production environment must never be specified in the Service URL Sandbox field.
Timeout (Milliseconds)Specifies the length of time in milliseconds that the service is allowed to use, before aborting the signature attempt with an error. The actions Create Status Document, Fix Errors and Test Service Connection do not set a timeout and ignore the setting.

Setup, Actions

  • Start of Operation

    This will put the ID into operation. The start document will be created as a Posted Sales Invoices with amount 0. If the document has been successfully signed by the service, the Status of the ID is set to Active. If an error occurs, the cause of the error must first be corrected and then a further signature attempt must be made with the Fix Errors action. For more information, see Tasks, Error Handling.

    Note

    The Start Document must be kept as basic records for at least seven years (§ 132 BAO). The Start Document can be printed as a sales slip or as an A4 document. In order for the cash register data to be printed on the A4 document of the posted sales invoice, the appropriate report layouts must be set up. For more information, see Setup, Report Layout Selection and Setup, Report Selection - Cash Register
  • End of Operation

    This will put the ID out of operation. The procedure is identical to that for Start of Operation.

    Note

    The Final Document must be kept as basic records for at least seven years (§ 132 BAO).
  • Reload Service Configuration

    For change of the receiptrequestmode to take effect immediately, this action must be called for the cash register ID. For more information, see Setup, Registration with fiskaltrust.

Actions

  • Create Status Document

    This action can be used to create status documents. After posting a cash register document, you are notified when a status document (Zero Document, Month Document, Year Document) can/must be created. For more information, see Tasks, Create Status Documents.
  • Fix Errors

    Sends all Cash Register Entries with a pending error to the service again and tries to sign them. After posting a cash register document, you will be notified if an error has occurred during communication with the service or if there are errors for the Cash Register ID. For more information, see Tasks, Error Handling.
  • Test Service Connection

    Checks whether the service can be reached and a connection with the stored settings is possible.
  • Open Service Page

    This action opens the service home page.

    Note

    The fiskaltrust service has a separate homepage for the sandbox environment and for the production environment. Depending on which environment you are currently in, the corresponding page is opened. Alternatively, the page can also be opened via the Service Login ID (CashBoxId) field (AssistEdit).

History, Fields

Start of Operation DateSpecifies the start of operation date for the Cash Register ID.
Last Month Document DateSpecifies the date of the last month document for the Cash Register ID.
Last Year Document DateSpecifies the date of the last year document for the Cash Register ID.
End of Operation DateSpecifies the end of operation date for the Cash Register ID.
No. of EntriesSpecifies the number of Cash Register Entries for the Cash Register ID.

History, Actions

  • Entries

    View the Cash Register Entries for the Cash Register ID.
  • Statistics

    View statistics about the Cash Register ID.


Setup,
Create BMF User

The NCCR Cash Register uses a service from fiskaltrust for automatic reporting to FinanzOnline. For automation by fiskaltrust, a Cash Register WebService User must be created in FinanzOnline. For more information, see https://finanzonline.bmf.gv.at/eLearning/BMF_Handbuch_Registrierkassen.pdf.

Creating a User for Cash Register Web Service

Under FinanzOnline in the function selection, click on Anlegen eines Benutzers für Registrierkassen-Webservice to open the page for entering user data. Enter the following FinanzOnline access codes under User data:
  • Benutzer-Identifikation

    Enter any term between 8 and 12 characters long, which must contain at least one letter and one digit. Umlauts and special characters may not be used.
  • PIN (Personal identification number)

    Enter any term between 8 and 12 characters long, which must contain at least one letter and one digit.
  • PIN-Wiederholung

    The PIN must be repeated for security reasons.


Setup,
Registration with fiskaltrust

For the creation of the digital signature, the NCCR Cash Register uses an HSM (Hardware Security Module) signature creation device, which is operated online by fiskaltrust. By registering with fiskaltrust, this signature creation device is automatically registered with FinanzOnline.

Registration

Click on the following link to register with fiskaltrust: https://portal.fiskaltrust.at/Home/Dashboard Click the Registrieren button and enter the mail address to be used for registration. Place a check mark in the Ich bin kein Roboter field to perform the login. Choose a password and enter your personal data. Please click first on the AGB link to view and read them. Afterwards you can close the AGB-Tab again and accept the AGB. By clicking on WEITER you will get to the next page.

Rolls

In the Übersicht area you must assign the role Registrierkassenbetreiber to your company. To do this, click on the company name in the navigation area and select Übersicht. The Kassenbetreiber role must be activated or set to On.

Base Data

In the Stammdaten area you enter various information about the company account. To do this, click on the company name in the navigation area and select Stammdaten. Enter the company data in the appropriate fields. Click the Speichern button. Please note that the company register number, UID number and tax number are used for the connection or messages for FinanzOnline and the button Data Check must be clicked for the check.

AT FinanzOnline Reporting

In the AT FinanzOnline Meldungen area you enter the Cash Register WebService User from FinanzOnline. For more information, see Setup, Create BMF User. To do this, click on Werkzeuge in the navigation area and select AT FinanzOnline Meldungen. Enter the FinanzOnline access data.

Shop

To be able to use the fiskaltrust service, you need the product 4154-0207 fiskaltrust.SignatureCloud (AT-2018) inkl. Sorglos, which must be added via the shop. To do this, click on Shop in the menu and then on Produkte. Select the product 4154-0207 fiskaltrust.SignatureCloud (AT-2018) inkl. Sorglos and add it to your shopping cart. Check the shopping cart afterwards. If you have a PayPal account, you can pay immediately. As soon as the product has been paid successfully, you will receive a reply e-mail.

Configuration - receiptrequestmode

In the next step the key receiptrequestmode for the CashBox must be set to the value 1. To do this, click on Konfiguration in the menu and then on CashBox. Then click on the line with the fiskaltrust.SignatureCloud in the Beschreibung area. 1.) Click on the settings (cogwheel):
2.) Enter the value receiptrequestmode in the Key field and the value 1 in the Value field. Then click the + button: 3.) Click on Speichern und schließen:
4.) Click on Rebuild configuration:

Note

For the change to take effect immediately, the Reload Service Configuration action in the NCCR Cash Register ID window must be called for the corresponding Cash Register ID in Microsoft Dynamics 365 Business Central. Otherwise, according to fiskaltrust, it can take up to an hour for the change of receiptrequestmode to take effect. If cash register error correction in Microsoft Dynamics 365 Business Central is performed during this time, it terminates with an error message and must be restarted later.
.

Configuration – Microsoft Dynamics 365 Business Central

In the last step, the CashBox access data must be stored with the corresponding Cash Register ID in Microsoft Dynamics 365 Business Central. To do this, click on Konfiguration in the menu and then on CashBox. Click on the line with the fiskaltrust.SignatureCloud in the Beschreibung area. Copy the value from the field CashBoxId into the Service Login ID (CashBoxId) field of the NCCR Cash Register ID window in Microsoft Dynamics 365 Business Central. Copy the value from the field AccessToken to the Service Access Token field of the NCCR Cash Register ID window in Microsoft Dynamics 365 Business Central.

Note

The field Kassenidentifikationsnummer must match the field ID in the NCCR Cash Register ID window in Microsoft Dynamics 365 Business Central. In order for the change of receiptrequestmode to take effect immediately, the Reload Service Configuration action in the NCCR Cash Register ID window must be called for the corresponding Cash Register ID in Microsoft Dynamics 365 Business Central.

Sandbox (Test System)

fiskaltrust transfers all data at regular intervals (can take several days) from the real system to the test system or sandbox. If you need immediate access to the sandbox, you must repeat all the steps of the registration in the sandbox. To do this, click on the following link: https://portal-sandbox.fiskaltrust.at/Home/Dashboard Please note that all data in the sandbox (including the CashBoxid and the AccessToken) is deleted at regular intervals and overwritten with the data of the real system. To activate product 4154-0207 fiskaltrust.SignatureCloud (AT-2018) inkl. Sorglos in the sandbox, add the product via shop and finish the order. Then send the company name to info@fiskaltrust.at and ask for activation of the products in the sandbox.


Setup,
Cash Register User

The settings and preferences for cash register users are set in the NCCR Cash Register User Setup window.

Fields

User IDSpecifies for which user the settings apply. The specification is optional.

Tip

If no User ID is specified, the settings are general and apply to all users for whom no special settings exist.
User NameSpecifies the user name for the User ID.
Cash Register IDSpecifies whether a Cash Register ID should be proposed for the user in the documents, if a Payment Method with Cash Register Posting Yes is selected.
Cash Register ID StatusSpecifies the Status of the Cash Register ID.
Document FormatSpecifies whether the user receives an A4 document, a sales slip, or a selection when posting/printing a cash register document.
Paper RollSpecifies the paper roll width for the sales slip (80 or 57 mm).
Default OutputSpecifies a default value for the Create Status Document action.
Base32 instead of QR CodeSpecifies whether Base32 should be printed on the document instead of a QR Code. Select this setting when the user uses a printer that cannot print QR Codes.
NotificationsSpecifies whether to display feedback (e.g., delivery errors, notes, and necessary actions).

Important

The option No should only be set in exceptional cases, as important information is ignored. Users can also disable notifications for the rest of the day.


Setup,
Report Selection - Cash Register

The Report Selection - Cash Register window specifies which reports are used when printing a cash register document. Cash register documents can be printed as a sales slip or as an A4 document. Specifications for Sales Invoice and Sales Credit Memo (or Service Invoice and Service Credit Memo) are optional and only have to be entered if a deviation from Report Selection - Sales (or Report Selection - Service) is required for A4 cash register documents.

Note

In order for the cash register data to be printed on the A4 documents, the appropriate NCCR report layouts must be set up. For more information, see Setup, Report Layout Selection.

Tip

It is possible to define several reports per usage. For example, you could add the NCCR Cash Register Invoice Sales Slip 80 mm in addition to the A4 document for Sales Invoice.

Fields

UsageSpecifies which type of document the report is used for.
SequenceSpecifies a number that indicates where this report is in the printing order.
Report IDSpecifies the object ID of the report.
Report CaptionSpecifies the display name of the report.
Use for Email BodySpecifies that summarized information, such as invoice number, due date, and payment service link, will be inserted in the body of the email that you send.
Use for Email AttachmentSpecifies that the related document will be attached to the email.
Email Body Layout CodeSpecifies the ID of the email body layout that is used.
Email Body Layout DescriptionSpecifies a description of the email body layout that is used.

Actions

  • Printer Selections

    View or set up a printer that will be used to print the report.


Setup,
Report Layout Selection

In the Report Layout Selection you can specify which layout should be used when printing a document. In order for the cash register data to be printed on the A4 documents, the appropriate NCCR report layouts must be set up. Currently RDLC report layouts are supported.

Available NCCR Report Layouts

NCCR report layouts are available for the following documents.
Report IDReport NameBuilt-in NCCR Report Layout
1306Sales - Invoice./NCCRStandardSalesInvoice.rdlc
1307Sales - Credit Memo./NCCRStandardSalesCrMemo.rdlc
5911Service - Invoice./NCCRServiceInvoice.rdlc
5912Service - Credit Memo./NCCRServiceCreditMemo.rdlc

Tip

Use the search term 1306|1307|5911|5912 to filter all documents supported by the cash register.
For more information, see Managing Report and Document Layouts and Setup, Report Selection - Cash Register


Setup,
Payment Methods

The selected Payment Method in an invoice or credit memo determines whether or not the document becomes a cash register document when posted.

Fields

NCCR Cash Register PostingSpecifies whether a Cash Register Notification must be made for the Payment Method. If the field is set, the cash register logic is called during posting and the document data is forwarded to the service and signed.


Tasks,
Working with Cash Register

Sales documents and service documents are created, posted and printed as before. The field Payment Method in the document determines whether a Cash Register Notification must be made for the document. For more information, see Setup, Payment Methods.

Note

Sales documents can be printed as a sales slip or as an A4 document. Service documents can only be printed as an A4 document. In order for the cash register data to be printed on the A4 document, the appropriate report layouts must be set up. For more information, see Setup, Report Layout Selection and Setup, Report Selection - Cash Register

Documents

The following fields are available in the Order, Invoice and Credit Memo in Sales and Service.
NCCR Cash Register PostingSpecifies whether a Cash Register Notification must be made for the selected Payment Method. If this is the case, the NCCR Cash Register ID must also be specified. If the field is set, the cash register logic is called during posting and the document data is forwarded to the service and signed.
NCCR Cash Register IDIs proposed or must be filled if the selected Payment Method is defined as Cash Register Posting. For more information, see Setup, Cash Register User.
NCCR Handwritten DocumentSpecifies whether the document was originally written by hand. For more information, see Tasks, Handwritten Document.

Note

The field is not available in the Order.

Cash Register Notifications

Transmission errors, notes and pending tasks are displayed after posting, if any exists. Via the notification window you have the possibility to react to the notifications and execute an action accordingly. Since the various actions may affect other open tasks or even complete them, only one action can be executed at a time via the window. After an action has been executed, a new notification window is displayed if there are still open tasks.

Note

Users can also disable these cash register notifications for normal documents for the rest of the day. After creating status documents via the Create Status Document action, cash register notifications are always displayed, if any exists.

Posted Documents

The following fields are available in the Posted Invoice and Posted Credit Memo in Sales and Service.
NCCR Cash Register PostingSpecifies whether the document is a cash register document.
  • Yes means that this is a normal cash register posting.
  • Subsequent indicates that the invoice was subsequently paid in cash. For more information, see Tasks, Subsequent Cash Payment.
  • Zero Document, Month Document and Year Document are cash register status documents. For more information, see Tasks, Create Status Documents.
  • Start Document and Final Document are special forms for start and end of operation of a cash register.
NCCR Cash Register IDSpecifies the Cash Register ID of the document.
NCCR Handwritten DocumentSpecifies whether the document was originally written by hand. For more information, see Tasks, Handwritten Document.

Actions

The following actions are available in the Posted Invoice Card in Sales and Service.
  • Subsequent Cash Payment

    If an invoice gets subsequently paid in cash, the cash register notification can be made via this action. For more information, see Tasks, Subsequent Cash Payment.


Tasks,
Create Status Documents

After posting a cash register document, you are notified when a status document (Zero Document, Month Document, Year Document) can/must be created. Status documents can be created from various areas using the function Create Cash Register Status Document or Create Status Document. Status documents are created as Posted Sales Invoices with amount 0.

Note

Status Documents can be printed as a sales slip or as an A4 document. In order for the cash register data to be printed on the A4 document of the posted sales invoice, the appropriate report layouts must be set up. For more information, see Setup, Report Layout Selection and Setup, Report Selection - Cash Register

Options

Cash Register PostingSpecifies the type of status document.

Note

Start Document and Final Document Status documents of type Start Document and Final Document are created using the functions Start of Operation and End of Operation in the Cash Register ID window. A Start Document or a Final Document must be kept as basic records for at least seven years (§ 132 BAO). Year Document On 31 December of each year, users of cash registers must prepare, print and store the Year Document instead of a Month Document (§ 8 RKSV). For more information, see Tasks, Annual Closure.
Cash Register IDSpecifies for which Cash Register ID the status document should be created.
OutputSpecifies the output for the document.


Tasks,
Annual Closure

On 31 December of each year, users of cash registers must prepare, print and store the Year Document instead of a Month Document (§ 8 RKSV).

General Information

  • Technical Requirement

    The Year Document must be signed correctly. If the signature creation device has failed, the creation and verification of the Year Document must be rescheduled immediately after the end of this failure. In most cases, these failures can be terminated by creating a Zero Document.
  • Special Cases

    Cash register closing after midnight: You operate a business that generates cash sales beyond midnight on 31 December. You may then create the Year Document after the close of business or immediately before the start of the following business day. Seasonal operation: If you are in seasonal operation and your last cash turnover was already made before December (e.g. in September), the Year Document can already be created and checked in a previous month.
  • Further Information

    Extensive legal information can be found at https://www.fiskaltrust.at/rechtsgrundlagen.

Create Year Document

The Year Document must be created for each active Cash Register ID of a company. The Year Document can be created from various areas using the function Create Cash Register Status Document or Create Status Document. For more information, see Tasks, Create Status Documents. After the document has been successfully transmitted to fiskaltrust, you will receive two e-mails from fiskaltrust. One e-mail contains the confirmation for the Year Document, the other e-mail contains the verification via web service by fiskaltrust at FON.

Note

Both emails are to be kept by means of a printout.


Tasks,
Error Handling

After posting a cash register document, you will be notified if an error has occurred during communication with the service or if there are errors for the Cash Register ID. The error correction can be accessed from different areas (e.g. Cash Register ID window). The Pending Errors field shows the number of Cash Register Entries with a pending error. Click on the field (or on Entries) for more information. The Test Service Connection action can be used to check whether the service is available. After the cause of the error has been eliminated, all incorrect entries can be resent to the service via the Fix Errors action. This automatically activates the Post-Recording of the service. The Post-Recording is active until a final Zero Document is created via the Create Status Document action (NCCR Cash Register ID window). Simultaneous or interim recording of "normal" cash register documents is still possible, even if the service is running in Post-Recording mode. However, after posting a cash register receipt, you will be notified that Post-Recording is active.

Details

Details about the incorrect entries are displayed in the cash register entries. Entries that contain the value Error or Pending in the Status field are considered to be incorrect and are taken into account by the Fix Errors action. The Signature Attempts field specifies the number of signature attempts made so far. The Error Type field normally indicates Electronic Recording System failed for errors. This means that it is technically impossible for the cash register to access the service. Postprocessing Error means there is a problem with your data structure. In this case, contact your Microsoft Dynamics 365 Business Central Partner directly. The Error Message field specifies technical details about the error.

Note

Faulty documents are marked with the label Electronic Recording System failed and a running error counter instead of the signature block. A copy is also printed automatically. The copy must be archived.

Signature Creation Device

A failure of the signature creation device occurs if the service temporarily cannot communicate with the signature creation device. Failures of the signature device are not directly marked as "error". Instead, the field Signature Creation Device displays the value Temporarily failed. If the failure lasts longer than 48 hours, the value Permanently failed is displayed. For failures of the signature unit no Fix Errors is necessary or possible. If the signature creation device is available again, these documents are combined in a Zero Document and signed. To inform the cash register about these status changes, you are notified when a Zero Document is required after posting a cash register document.

Complete manually

In justified exceptional cases, this action can be used to close entries. The entry is marked with Manually Completed and a note with Date, Time and User ID is created. The process can also be undone using the same action.

Important

The function may only be used in justified exceptional cases and only if there are no other possibilities to complete an entry. A justification for manual closure should be included in the comments.


Tasks,
Handwritten Document

Set the field Handwritten Document in a sales document or in a service document if the document was originally handwritten.

Note

Handwritten documents are not automatically forwarded to the service when posting, but creates entries with status Pending. After all documents have been entered and posted, they must be signed via the Fix Errors action (NCCR Cash Register ID window). This automatically activates the Post-Recording of the service. The Post-Recording is active until a final Zero Document is created via the Create Status Document action (NCCR Cash Register ID window). Simultaneous or interim recording of "normal" cash register documents is still possible, even if the service is running in Post-Recording mode. However, after posting a cash register receipt, you will be notified that Post-Recording is active.


Tasks,
Subsequent Cash Payment

If an invoice gets subsequently paid in cash, the cash register notification can be made in the Posted Sales Invoice or Posted Service Invoice window via the Subsequent Cash Payment action. The document is marked with Cash Register Posting Subsequent and a Cash Register Entry is created which is forwarded to the service.

Note

No posting is made in the system. The document is therefore not automatically applied/closed.


Reports and Analysis,
Cash Register Statistics

The NCCR Cash Register Statistics window shows statistical data of a Cash Register ID.

General, Fields

IDSpecifies the Cash Register ID.
Last Month Document DateSpecifies the date of the last month document for the Cash Register ID.
Last Year Document DateSpecifies the date of the last year document for the Cash Register ID.
No. of EntriesSpecifies the number of Cash Register Entries for the Cash Register ID.
Pending ErrorsSpecifies the number of Cash Register Entries with a pending error for the Cash Register ID.
Ongoing DocumentsSpecifies the number of ongoing sales documents for the Cash Register ID. Ongoing documents were created but not yet posted.
Ongoing Service DocumentsSpecifies the number of ongoing service documents for the Cash Register ID. Ongoing service documents were created but not yet posted.

Options

View bySpecifies by which period amounts are displayed.
View asSpecifies how amounts are displayed.
  • Net Change displays the net change in the balance for the selected period.
  • Balance at Date shows the balance as of the last day in the selected period.

Lines

Period StartSpecifies a series of dates according to the selected time interval.
Period NameSpecifies the name of the period shown in the line.
AmountSpecifies the total amount for the corresponding time period. The field Sales Counter Document Value from the NCCR Entries is used for the calculation.
Amount Foreign CurrencySpecifies the cumulative foreign currency total amount (cross currency code) for the corresponding time period. The value serves mainly as information that foreign currencies were posted to the Cash Register ID in the corresponding period. The field Sales Counter Document Value from the NCCR Entries is used for the calculation.
No. of EntriesSpecifies the number of status documents for the Cash Register ID in the corresponding time period.
No. of Status DocumentsSpecifies the number of status documents for the Cash Register ID in the corresponding time period.
Month Document ExistsSpecifies whether there is a month document for the Cash Register ID in the corresponding time period.
Year Document ExistsSpecifies whether there is a year document for the Cash Register ID in the corresponding time period.


Archive,
Data Collection Protocol (§ 7 RKSV)

The Data Collection Protocol is stored online at fiskaltrust and can be downloaded via the portal of fiskaltrust.

Create export file

Select the menu item Queue in the Konfiguration navigation area. 1.) Click on Exportieren at the corresponding CashBox:
2.) In the Export-Formate area, click RKSV-DEP, hold the mouse button down and drag RKSV-DEP to the Exportformate und -ziele area:: 3.) Then click Export starten und schließen: The export may take some time. In the meantime, you can leave the portal. After completion (which can take several hours, depending on the number of documents), you will receive a notification by e-mail.

Download export file

After the export file has been created, it can be downloaded via the menu item Exportieren in the Werkzeuge navigation area. Click on the corresponding CashBox and select the file atdep.zip:


Archive,
Cash Register Entries

The NCCR Cash Register Entries window shows the history of all cash register documents (Invoices, Credit Memos, Status Documents).

Fields

DateSpecifies the date on which the entry was created.
TimeSpecifies the time when the entry was created.
Handwritten DocumentSpecifies whether the document was originally written by hand. For more information, see Tasks, Handwritten Document.
User IDSpecifies the ID of the user who created the entry.
User NameSpecifies the user name for the User ID.
Document TypeSpecifies whether the cash register document is an invoice or a credit memo.
Document No.Specifies the number of the cash register document.
Service Mgt. DocumentSpecifies whether the cash register document is a service document.
Posting DateSpecifies the posting date of the cash register document.
Payment Method CodeSpecifies the payment method code of the cash register document.
Cash Register PostingSpecifies the type of the cash register document.
  • Yes means that this is a normal cash register posting.
  • Subsequent indicates that the invoice was subsequently paid in cash. For more information, see Tasks, Subsequent Cash Payment.
  • Zero Document, Month Document and Year Document are cash register status documents. For more information, see Tasks, Create Status Documents.
  • Start Document and Final Document are special forms for start and end of operation of a cash register.
Cash Register IDSpecifies the Cash Register ID for which the entry was created.
Terminal IDThis field is currently filled with the value 'D365BC'.
ServiceSpecifies to which service the data was sent.
Signature AttemptsSpecifies the number of signature attempts made so far.
StatusSpecifies the status of the entry. Entries that contain the value Error or Pending in the Status field are considered to be incorrect and are taken into account by the error correction. For more information, see Tasks, Error Handling.
Error TypeNormally indicates Electronic Recording System failed for errors. This means that it is technically impossible for the cash register to access the service. Postprocessing Error means there is a problem with your data structure. In this case, contact your Microsoft Dynamics 365 Business Central Partner directly.
Error MessageSpecifies technical details about the error.
Signature Creation DeviceSpecifies problems with the signature creation device. A failure of the signature creation device occurs if the service temporarily cannot communicate with the signature creation device. For more information, see Tasks, Error Handling.
NotificationsSpecifies the number of notifications and tasks that were current at the time of the last signature attempt.
Post-Recording activatedSpecifies whether the Post-Recording was active at the time of the last signature attempt. For more information, see Tasks, Error Handling.
CommentsSpecifies whether there is a comment for the entry.
Amount Including VATSpecifies the Amount Including VAT of the cash register document.
Payment Discount AmountSpecifies the Payment Discount Amount of the cash register document.

Note

Whether a payment discount is deducted or calculated depends on the date. The payment discount amount is only taken into account if the Pmt. Discount Date is >= the date of the Cash Register Notification. Especially in the case of subsequent cash payment the date on which the payment (and thus the notification) is made is decisive. Exception: If a document is entered as a Handwritten Document, the Pmt. Discount Date is not checked.
Payment AmountSpecifies the Amount Including VAT minus the Payment Discount Amount.
Currency CodeSpecifies the currency code of the cash register document.
Sales Counter Document ValueSpecifies the amount that is sent to the service and used to calculate the Sales Counter.
Sales CounterSpecifies the accumulated value after the payment.

Note

The amount is cross currency code. No distinction is made between the local currency and the foreign currency, nor is it converted.
SandboxSpecifies whether the entry was created in the sandbox environment.
Manually CompletedSpecifies whether the cash register entry was manually completed.
Entry No.Specifies the number assigned to the cash register entry. The application assigns a unique number to each cash register entry.

Actions

  • Show Document

    Displays the window for the document.
  • Send

    Prepares to send the document according to the customer's sending profile. The Send Document to window opens in which you can confirm or select a Sending Profile.
  • Print

    Prepares to print the document.
  • Email

    Prepares to send the document by email. The Send Email window opens with the email address of the customer already entered. You can add information or change existing information before sending the email.
  • Navigate

    Find all entries and documents that exist for the document number and posting date on the selected entry or document.

Entry, Actions

Via the actions in the group Entry more detailed information or technical details about the entry can be displayed.
  • Additional Document Data

    View the additional data for the cash register document.
  • Show Request/Response

    View detailed information about what has been sent to or returned by the service.
  • Signature Attempts

    View detailed information about the signature attempts.
  • Comments

    View or add comments for the record.

Filter, Actions

Via the actions in the group Filter the data can be filtered. Click on My Documents if you only want to see documents that have been posted by you. Click on All Documents if you want to see all documents.

System, Actions

  • Complete manually

    In justified exceptional cases, this action can be used to close entries. For more information, see Tasks, Error Handling.


Archive,
Cash Register Entry Signature Attempts

The NCCR Cash Register Entry Signature Attempts window shows detailed information about the signature attempts.

Fields

Signature AttemptSpecifies the number of the signature attempt.
DateSpecifies the date on which the signature attempt was created.
TimeSpecifies the time when the signature attempt was created.
SandboxSpecifies whether the signature attempt was made in the sandbox environment.
ServiceSpecifies to which service the data was sent.
Failure Post-RecordingSpecifies whether the signature attempt was triggered by the action Fix Errors (Cash Register ID window).

Note

Depending on whether the service is available or not, the Fix Errors action automatically activates the Post-Recording. The Post-Recording activated field shows whether Post-Recording has been activated or was (already) active.
StatusSpecifies the status of the signature attempt. Entries that contain the value Error or Pending in the Status field are considered to be incorrect.
HTTP Status CodeSpecifies the HTTP status code returned when communicating with the service. The information may be useful for technical support.
Error TypeNormally indicates Electronic Recording System failed for errors. This means that it is technically impossible for the cash register to access the service. Postprocessing Error means there is a problem with your data structure. In this case, contact your Microsoft Dynamics 365 Business Central Partner directly.
Error MessageSpecifies technical details about the error.
Signature Creation DeviceSpecifies problems with the signature creation device. A failure of the signature creation device occurs if the service temporarily cannot communicate with the signature creation device. For more information, see Tasks, Error Handling.
NotificationsSpecifies the number of notifications and tasks that were current at the time of the last signature attempt.
Post-Recording activatedSpecifies whether the Post-Recording was active at the time of the signature attempt. For more information, see Tasks, Error Handling.
Archived Request ExistsSpecifies whether the data sent to the service exists or is stored. All request data sent to the service is stored in the signature attempts. If necessary, the archived request data can be removed from the signature attempts via the Delete Data action in the NCCR Cash Register Setup. For more information, see Appendix, Delete Cash Register Data.
Archived Response ExistsSpecifies whether data has been returned by the service. All response data returned by the service is stored in the signature attempts. The data, unlike the request data, cannot be deleted.
Service Cash Register IDSpecifies the cash register ID returned by the service according to RKSV. The value must match the field Cash Register ID from the corresponding cash register entry.
Service Cash Register Entry No.Specifies the cash register entry number returned by the service according to RKSV.
Service Processing DateSpecifies the processing date returned by the service.
Service Processing Time (UTC)Specifies the processing time (UTC) returned by the service.
Service StatusSpecifies the status returned by the service. The information may be useful for technical support.
Service QueueIDSpecifies the QueueID returned by the service. The information may be useful for technical support.
Service QueueItemIDSpecifies the QueueItemID returned by the service. The information may be useful for technical support.
Service QueueRowSpecifies the QueueRow returned by the service. The information may be useful for technical support.
Response Time (Milliseconds)Specifies the response time from the service in milliseconds.
Cash Register Entry No.Specifies the entry number of the associated Cash Register Entry.

Signature Attempt, Actions

Via the actions in the group Signature Attempt more detailed information or technical details about the entry can be displayed.
  • Additional Document Data

    View the additional data for the cash register document.
  • Show Request/Response

    View detailed information about what has been sent to or returned by the service.


Archive,
Cash Register Entry Request/Response

The NCCR Cash Register Entry Request/Response window shows in detail which information was sent to or returned from the service. The information can be useful for technical support.

Fields

RequestSpecifies the request sent to the service.
ResponseSpecifies the response returned by the service.

Actions

  • Export Request

    Exports the request to a file.
  • Export Response

    Exports the response to a file.


Archive,
Cash Register Entry Document Data

The NCCR Cash Register Entry Document Data window shows additional data for the cash register document.

Fields

Signature AttemptSpecifies the entry number of the associated Signature Attempt.
TypeSpecifies the type of data.
DataSpecifies the data.
InformationSpecifies additional information.
Cash Register Entry No.Specifies the entry number of the associated Cash Register Entry.


Archive,
Cash Register Entry Comments

If necessary, comments on the entries can be stored in the NCCR Cash Register Entry Comments window.

Fields

DateSpecifies the date of the comment.
CommentSpecifies the comment.


Appendix,
Delete Cash Register Data

All request data sent to the service are stored in the signature attempts. With the Delete Data action in the NCCR Cash Register Setup, the archived request data can be removed from the signature attempts if necessary. The stored QR Codes can also be deleted. QR Codes are only stored if the field Cache QR Code is set in the NCCR Cash Register Setup.

Note

  • The period for deleting the data can be specified in the NCCR Cash Register Setup in the field Delete Data Date Calculation.
  • Only data that is at least 6 months old can be deleted. If the field is empty, the minimum period is used.

    Options

    Delete Archived Request DataSpecifies whether the archived request data should be deleted.
    Delete QR CodesSpecifies whether the QR Codes should be deleted.
    

    Appendix,
    NAVAX License Overview

    The NAVAX License Overview window (in older versions NCEX License Overview) displays the current license status of the NAVAX extensions. In order for a NAVAX extension to be displayed in this window, the corresponding setup of the extension must first be opened. All information and actions displayed in this overview can also be found in the corresponding setup windows in the System area.

    Trial Version

    A NAVAX extension can be tested or used free of charge for 30 days after installation. After that the functions of the extension can only be used with a valid license.

    Request License

    The license can be requested or checked via the action What's New?. This opens a browser window. Click on Send License Request in the browser window to send an E-Mail with your request. Please note that the licensing process may take some time. In the next few days you will receive an E-Mail with further information. For more information about the Terms and Conditions, see https://www.navax.app/EULA.php?L=en.

    Activate/Update License

    As soon as the licensing has been completed, you will receive an E-Mail and the license can be activated via the Update License action. The license is company independent. So it does not matter in which company the action is called. Information for Administrators For licensing, calling the online help and performing some actions, access to https://www.navax.app must be allowed. Public IP from www.navax.app for setting firewall access: 94.136.22.236, Port: TCP/443

    Note

    The licence must be updated once a year via the Update License action. The update is only possible or necessary within the last 30 days before the license expires, or afterwards. Within the last 30 days before the license expires, notes are displayed.

    Fields

    NameSpecifies the name of the Extension.
    License StatusSpecifies the current license status of the Extension.
    Serial No.Specifies the serial number of the Extension.
    VersionSpecifies the currently installed version of the Extension.

    Actions

    • What's New?

      Opens an external website with additional information about the extension and through which the license of the extension can be requested or checked.
    • Update License

      Updates the License of the Extension or checks if it is up to date.

      Note

      The license is company independent. So it does not matter in which company the action is called.
    • Version History

      Views when which version of the Extension was installed. For more information, see Version History.
    • Environment Confirmations

      View or set up the Environment Confirmations of the Extension. For more information, see Environment Confirmations.
    

    Appendix,
    Version History

    The Version History window shows when which version of the extension was installed.

    Fields

    VersionSpecifies the version.
    DateSpecifies the date since the version was used.

    Appendix,
    Environment Confirmations

    Environment Confirmations add an additional level of security to actions and processes to prevent test data from being accidentally interpreted as real data. These additional secured actions and processes can only be executed if the current environment in which the action is executed is already confirmed or will be confirmed.

    Example

    Environment Confirmations are used, for example, by the NCCR Cash Register from the cash register posting process. This is to prevent test data from being accidentally forwarded to the external service of fiskaltrust as real data. This case can occur, for example, especially when deploying via On-Premises, if a test or development database (or a test company) has been created based on the real data and is not defined as a Business Central sandbox environment. Without another level of security, cash register postings from this test system would also be forwarded to the fiskaltrust service as real data. By using Environment Confirmations, the cash register posting recognizes that the test environment has not yet been confirmed and the user can now respond to the warning.

    Testing and Confirmation

    An environment is defined by the company name, the database name and the server name. When the environment is checked, the entry with this data is searched for. If the current environment is found, the action may be executed if additionally Confirmed as matches the current Business Central environment setting.
    • A Business Central production environment can be confirmed as a production environment or a sandbox environment. If you confirm the environment as a production environment, all information will be interpreted as real data. If you confirm the environment as a sandbox environment (which, as described in the example, should be done in the case of a test or development database), the action or process may not be executed again until the Business Central environment is also defined as a sandbox.

      Warning

      Confirm your current environment only if you are absolutely sure. Once the environment is confirmed, the action or process is confirmed for all users. While environments that have already been confirmed can be deleted at any time, this will not undo any action that has already been performed.
    • A Business Central sandbox environment cannot be confirmed as a production environment. Nevertheless, confirmation is necessary for security reasons.

    Change a confirmation

    All confirmed environments of an extension can be viewed via the extension's setup window (in the System area) or via the NAVAX License Overview window. An environment confirmation cannot be changed directly, but must be deleted first. As soon as a secured action or process in the environment is executed, the environment must be reconfirmed.

    Tip

    The current environment can also be confirmed immediately using the Confirm Current Environment action.

    Fields

    Company NameSpecifies the company name of the confirmed environment.
    Database NameSpecifies the database name of the confirmed environment.
    Server NameSpecifies the server name of the confirmed environment.
    Current EnvironmentSpecifies whether the confirmed environment is the current environment.
    Confirmed asSpecifies whether the environment was confirmed as a production environment (Real Data) or as a sandbox environment (Test Data).
    Date ConfirmedSpecifies the date when the environment was confirmed.
    Time ConfirmedSpecifies what time the environment was confirmed.
    Confirmed BySpecifies the user ID of the person who confirmed this environment.

    Actions

    • Confirm Current Environment

      Confirms the current environment as a production environment or as a sandbox environment.
    

    Appendix,
    Information for Administrators

    Permission Sets

    The following permission sets are available for the NCCR Cash Register:
    • NCCR Cash Register

      To use the NCCR Cash Register.
    • NCCR Cash Register Setup

      To use and set up the NCCR Cash Register.

    External Addresses

    • https://www.navax.app

      For licensing, calling the online help and performing some actions, access to https://www.navax.app must be allowed. Public IP from www.navax.app for setting firewall access: 94.136.22.236, Port: TCP/443
    • https://qrcode.tec-it.com

      To create the QR Codes, access to https://qrcode.tec-it.com must be allowed.
    

    Appendix,
    Information for Developers

    Dependencies

    QR Code Generation

    The QR Codes are generated via a function from the NCEX Extension Base. Via the OnBeforeCreateQRCode event in Codeunit "NCCR QR Code Mgt." another solution can be integrated.
    

    Appendix,
    Release Notes

    Would you like to know what has changed in NCCR Cash Register? Below you'll find an overview about new features and changes that has been done in the updates.

    NCCR 18.0.0.0

    Business Central 18.0

      Business Central Update

      Improvements

    • The cash register data can now also be printed on the A4 documents. In order for the cash register data to be printed on the A4 documents, the appropriate report layouts must be set up. For more information, see Setup, Report Layout Selection and Setup, Report Selection - Cash Register

    NCCR 17.0.1.0

    Business Central 17.0

      Improvements

    • NCCR Cash Register now uses Environment Confirmations to prevent test data from being accidentally forwarded to the external service of fiskaltrust as real data. For more information, see Appendix, Environment Confirmations.
    • Modifications

    • An external service was used to create the QR codes, which has been discontinued. A function from NCEX Extension Base is now used.
    • Some fields in the NCCR Cash Register Setup window have been rearranged. For more information, see Setup, Cash Register Setup.

    NCCR 17.0.0.0

    Business Central 17.0

      Initial release

      Feedback|  Print Manual
    DE|EN Imprint