NCCR Cash Register (NAV)

Note

NCCR Cash Register is available for Microsoft Dynamics 365 Business Central as an extension under the new product name fiskaltrust POS Interface. For more information, see [Docs] fiskaltrust POS Interface

Manual

☰ Contents

Appendix

• NAVAX Registration
  The current registration status of a NAVAX Dynamics NAV AddOn is displayed in the AddOn Setup page in the System group...
• Release Notes
• Upgrade to Business Central
  This topic is for developers and describes the steps required to transfer the data from the old C/AL version (NAV AddOn) to the new AL version (BC Extension)...

Docs  /  NCCR Cash Register (NAV)  /  Appendix
NAVAX Registration

Trial Version

Request Registration

Note

For registration, calling the online help and performing some actions, access to https://www.nccube.com and https://www.navax.app must be allowed. In addition, TLS 1.2 is required. For more information, see How to get earlier versions of the Dynamics NAV development environment to work with TLS 1.2 Public IP from www.navax.app for setting firewall access: 94.136.22.236, Port: TCP/443 Checking the connection to https://www.navax.app using PS: Test-NetConnection navax.app -port 443 (PS must be performed with the M-Tier service user) CRL Servers In addition, the following CRL Servers must also be accessible for the certificate check: https://certificates.godaddy.com/* http://crl.godaddy.com/* or their IP: 192.124.249.36

Activate/Update Registration

Terms & Conditions

https://www.navax.app/EULA.php?L=en

Data Security

https://www.navax.app/privacyStatement.php?L=en

Docs  /  NCCR Cash Register (NAV)  /  Appendix
Release Notes

Note

NCCR Cash Register is available for Microsoft Dynamics 365 Business Central as an extension under the new product name fiskaltrust POS Interface. For more information, see [Docs] fiskaltrust POS Interface

NCCR Update

NCCR 13.00

• Note

  This version is also available as a downgrade version for for older Dynamics NAV versions.

Caution

Due to various technical changes of Microsoft Dynamics 365 Business Central, the further development of NCCR as an extension and a general simplification/improvement of NCCR, the Quick Entry has been removed.

General

An update of the license file is necessary.

Update Codeunits are available. Note Due to the large number of changes, the update is a bit more extensive. Further information can be found in the Readme file in the update package.

A registration is necessary. The trial version expires in 30 days. For more information, see Appendix, NAVAX Registration.

Improvements

NC Cash Register is now available for Microsoft Dynamics 365 Business Central – OnPremises. For a complete list of all available versions, see the document Version Matrix. Note that the features or functionality of the solution may vary depending on the installed version, the client you are using, and/or your license model.

Report 1306 Standard Sales – Invoice and Report 1307 Standard Sales - Credit Memo now also contain the logic for printing the cash register information. The information will only be printed on RDLC Layout. If the Word Layout is in use, it must be modified manually.

Prepayments are now fully supported.

Added field Allow Manual Completion to the Cash Register ID window. The Complete manually action in the Cash Register Entries window can only be executed, if the field is set.

Added parameter 'ftPosSystemId' (GUID - is used to identify the NCCR software) to the fiscaltrust service request.

The fields Old Value, Document Value and New Value of the Cash Register Entries are now also displayed without Discount deduction.

Modifications

The system for cash register messages, errors, notes and tasks has been replaced by a new notification system. In the new Notifications field of the Cash Register User Setup window you can set whether you want to display Notifications (for example, transmission errors, notes and necessary actions) or not. The option 'No' should only be set in exceptional cases, since important information will be skipped. Users can now disable notifications for the rest of the day.

The Create Status Document functionality incl. Start of Operation and End of Operation has been completely revised. Status Documents are no longer posted manually via Sales Invoices, but are created directly as Posted Sales Invoices with an Amount of 0. Status Documents no longer require a special Payment Method Code. The fields Status Doc. Customer No. and Status Doc. Payment Method Code have been removed from the Cash Register ID window.

The cash register document printing functionality has been completely revised. Up from NAV 2016 Document Sending Profiles and Send Actions are now fully supported. The Report ID fields in the Cash Register ID window have been removed and a new window Report Selection - Cash Register, which can be accessed via the Cash Register Setup, has been added. Specifications for A4 – Invoice and A4 – Cr. Memo are optional. If you don’t specify the Reports, the Report Selection – Sales will be used for A4 Documents. Note It is possible to specify multiple reports per usage. For example, you can specify the Sales Slip 80 mm – Invoice in addition to the A4 – Invoice. Special for NAV 2009: The report selection for the cash register can be initialized in the RTC Client, but changes to the settings are only possible in the Classic Client.

Since the term Send is used by the standard application for documents, the Sending Attempts and all associated fields and actions have been renamed to Signature Attempts. Send again (Fix Errors) has been renamed to Fix Errors.

The fields QR Code Size A4 and QR Code Size Sales Slip have been moved from the Cash Register ID window to the Cash Register Setup window.

NAV Classic and NAV 2009: The Max. Characters fields have been moved from the Cash Register ID window to the Cash Register Setup window.

The VAT Identifier (Cash Register) field has been removed from the VAT Posting Setup. No Setup is required anymore. The indicator will now be determined automatically.

Removed the fields Archive Service Request and Archive Service Response and the Remove archived Requests/Responses action from the Cash Register ID window. Instead, the Delete Data function has been added to the Cash Register Setup window. All Requests sent to the service will be stored in the Signature Attempts. If necessary, this action can be used to remove the archived request data from the Sending Attempts. The responded data can not be deleted anymore. In addition, the stored QR Codes can also be deleted. QR Codes will only be archived (saved) if the new field Cache QR Code is set in the Cash Register Setup. If there is no saved QR Code, it will be regenerated when a report is printed. Note The period for deleting the data can be specified in the Delete Data Date Calculation field in the Cash Register Setup. Only data that is at least 6 months old can be deleted. If the field is empty, the minimum period is used.

Some windows have been redesigned/revised.

NCCR 11.00

Improvements

Added field HTTP Status Code to the Cash Register Entry Sending Attempts window.

Added field Pending Errors to the Cash Register Statistics window.

Added field History Tile to the Cash Register User Setup window. Depending on the selected option, the Role Center displays either a tile for the Cash Register Entries or two separate tiles for Invoices and Credit Memos.

Added field Messages without Tasks to the Cash Register User Setup window.

Added field Archive Service Request and Archive Service Response to the Cash Register ID window. Through these two fields, it is possible to disable the storage of the Requests/Responses, sent to the service, or returned by the service. Already archived Requests/Responses can be removed from the Sending Attempts with the new action Remove archived Requests/Responses.

The NCCR Version will now be sent in the 'ftReceiptCaseData' block to the fiskaltrust Service.

The fields Cash Register Payment Discount Amount and Cash Register Payment Amount have been added to various document windows. The Cash Register Payment Discount Amount field contains the discount amount. The Cash Register Payment Amount field contains the amount incl. VAT minus the discount amount. The information will also be printed on the Cash Register Documents. The possible payment discount will now also be deducted from the Document Value field in the Cash Register Entries. Note Whether a Payment Discount will be considered or not, depends on the date. If the Pmt. Discount Date >= the date of the cash register notification, the Payment Discount Amount will be considered. Especially for Subsequent Cash Payment the payment date is crucial. Exception: If a document is marked as Handwritten Document, the Pmt. Discount Date will not be checked.

Added action Subsequent Cash Payment to the Posted Sales Invoice and Posted Service Invoice window. If an invoice is subsequently paid in cash, the cash register notification can be made via this action. The document will be marked with Cash Register Posting = 'Subsequent' and a Cash Register Entry will be created and sent to the service. Note Whether a Payment Discount will be considered by the Subsequent Cash Payment or not, depends on the date. If the Pmt. Discount Date >= the date of the cash register notification, the Payment Discount Amount will be considered.

The QR Code size can now be set separately for the Sales Slip and the A4 Report.

Cash Register Entries will now be considered and displayed by Navigate.

Added action Reload Service Configuration to the Cash Register ID window. The action can be called after changes have been made to the configuration on the fiskaltrust portal (for example receiptrequestmode). The call prompts the fiskaltrust service to activate these changes immediately. Otherwise, according to fiskaltrust, it may take up to an hour for the changes to take effect.

Modifications

The registration is now bound to the Tenant.

It is now possible to enter negative values in the Unit Price field of the Cash Register Positions.

The Change field in the Cash Register User Setup has been renamed to Show Change.

The New Invoice field in the Cash Register User Setup has been renamed to Invoice Tile.

The New Document field in the Cash Register User Setup has been renamed to Document Tile.

The default setting for the Company Setting in the Cash Register Setup window is now 'Undefined'.

Negative document lines will no longer be sent in the 'cbChargeItems' block to the fiskaltrust Service, but in the 'cbPayItems' block with 'ftPayItemCase' = 0x4154000000000006.

The Service Time Correction (Hours) field is no longer needed and has been removed from the Cash Register ID window.

The layout and modifications in the standard A4 documents have been simplified. All cash register data has been added at the end of the document layout.

Corrections

In older versions before Microsoft Dynamics NAV 2013, some fields were not filled by the System Assignment (Cash Register ID window). An update of the System Assignment via the function Assign to current System is necessary after the NCCR 11.00 update. Note to developers: Different object versions of Codeunit 1011912 NCCR Assign Management for CSIDE and SQL no longer exists.

Under certain constellations, only one Task could be selected after Send again (Fix Errors).

In Microsoft Dynamics NAV 2009, a window was displayed under certain constellations during the QR Code creation.

NCCR 10.02

Improvements

Added Statistics for Cash Register IDs.

Added field Proxy Server IP-Address:Port to the Cash Register ID window.

Added function Remove System Assignment to the Cash Register ID window. Via this function it is possible to remove/reset the System Assignment of the ID.

For newer versions, starting with Microsoft Dynamics NAV 2013, the fields Assigned to Server 2, Assigned to Server 3, Assigned to Server 4 and Assigned to Server 5 have been added to the Cash Register ID window. Usually, the system will be assigned automatically and the server is entered in the field Assigned to Server. If additional servers are used, which also accesses the same database, these servers can be added (or if necessary removed) via the AssistEdit buttons of the new fields. To add a server, the User must be currently logged on via the server.

Modifications

Removed the buttons fiskaltrust Homepage and fiskaltrust Test Environment from the Cash Register ID window. The Service Homepage can now be opened via the new Open Service Page action or via AssistEdit in the Service Login ID (CashBoxId) field. The corresponding page will be opened depending on whether the Company is set as Real Company or as Test Company in the Cash Register Setup.

Depending on whether the Company is set as Real Company or as Test Company in the Cash Register Setup, the Service URL or the Service URL Test Env. field will now be displayed in the Cash Register ID window.

Some windows have been redesigned/improved.

Corrections

The service interface was changed by fiskaltrust after the release of NCCR 10.01. As a result, the Send again (Fix Errors) functionality could no longer be executed. After updating to NCCR 10.02 the Key receiptrequestmode must be set to 1 in the CashBox configuration. For more information see document "How Do I - fiskaltrust Registration", available via "What's New?" in the Cash Register Setup. Note If, because of the error, Cash Register Entries have been set to Manually Completed, this can also be reversed via the same action. The Entries can then be signed with Send again (Fix Errors).

In older versions before Microsoft Dynamics NAV 2013, some fields were not filled by the System Assignment (Cash Register ID window). An update of the System Assignment via the function Assign to current System is necessary after the NCCR 10.02 update.

When posting a Status Document an error occurred in connection with the field Calc. Inv. Discount from the Sales & Receivables Setup.

NCCR 10.01

Improvements

The Service Timeout (Milliseconds) field in the Cash Register ID window is now also available for older Microsoft Dynamics NAV Versions (Classic, 2009).

It is now possible to add comments to each entry in the Cash Register Entries window.

It is now possible to complete Cash Register Entries manually via the Complete manually action if necessary. The Entry will be marked as Manually Completed and a Note will be added. The operation can also be reversed via the same action. Note This feature should only be used in justified cases and only if there are no other options to complete the entry. The reason for the manual completion should be entered in the comments.

Within the Quick Entry windows it is now possible to add document lines via a list window.

Basically the creation time from the Cash Register Entry will be printed on the Reports. If the Document is transferred to a Service, the Processing Time from the Service will be printed instead. This time is returned by the fiskaltrust-Service in UTC. Therefore, a new field Service Time Correction (Hours) has been added to the Document group in the Cash Register ID window. With this field the time can be corrected. The value 1 should be entered if Service = fiskaltrust.

Modifications

So far, special characters (such as ²üÖß) have been ignored or transferred in converted form to the Service. The communication has been changed to UTF8 format. Special characters will be transferred correctly now.

For older Microsoft Dynamics NAV Versions (Classic, 2009), 'Microsoft XML, v6.0'.XMLHTTP60 was used for communication with the Service. Now 'Microsoft XML, v6.0'.ServerXMLHTTP60 will be used.

No Timeout will be set for the following Actions: 'Test Service Connection' 'Send again (Fix Error)' Transfer of Status Documents

Troubleshooting now checks, whether the Service is available or not.

Direct deletion of records in the tables Cash Register Entry, Cash Register Entry Document Data and Cash Register Entry Sending Attempt is no longer possible.

The Option All from the Messages field of the Cash Register User Setup triggered a message after each Cash Register posting. This behavior has been changed. The Option All is identical with the Option Notes and Errors until further notice.

After posting a Cash Register Document, transfer errors, notifications and upcoming tasks are displayed. Due to technical problems, the call of these Cash Register Tasks has been changed and detached from the posting function. Note Processing a task may affect other tasks. For this reason, only one task can be processed via this window. After a task has been completed, in most cases a new message window will be displayed, if necessary.

Security Device failed has been printed several times. Removed unnecessary empty lines.

Report ID A4 – Invoice and Report ID A4 - Cr. Memo must no longer be specified in the Cash Register ID window. If the fields are empty, the standard print logic will be called for A4 documents.

Post with Job Queue will now be ignored when posting Cash Register Documents. The Setting will also be ignored for all Documents, which are posted via the Quick Entry.

Within the Quick Entry windows it is no longer necessary to confirm the posting of a Zero Document. For all other Status Documents a confirmation is still required.

Some windows have been redesigned/improved.

Corrections

Response Time (Milliseconds) in the Cash Register Entry Sending Attempts window was empty in certain constellations.

In case of Signature Creation Device permanently failed also Signature Creation Device temporarily failed was displayed.

NCCR 10.00

Improvements

It is now possible to create as many Cash Register IDs as required. In the Cash Register User Setup you can then assign an ID to each User. The ID will be used as a default value in new documents.

The connection to the fiskaltrust-Service has been implemented. According to the RKSV, the additional document data (generated by the fiskaltrust-Service) will be stored in the Cash Register.

Modifications

Most windows have been redesigned/improved.

NCCR 9.02

Improvements

For Microsoft Dynamics NAV 2016 or higher, additional buttons can be displayed for the Quick Entry in the Web, Tablet and Phone Client.

Added function Create Credit Memo to the Posted Cash Register Invoice window. Via this function it is possible to create a Credit Memo based on the information of the Invoice.

Added function Unlock all Customers to the Cash Register Setup window. Via this function it is possible to set the field Quick Entry (Cash Register) for all Customers.

It is now possible to set filters for the functions Unlock all Items, Unlock all Resources and Unlock all Customers.

Added field Currency Code to the Cash Register Entries window.

It is now possible to change the position of the Cash Register Document Texts with the Up and Down Actions.

Corrections

Under certain constellations the Unit Price and the Line Discount % of G/L Accounts was not transferred from the Cash Register Positions to the Document.

NCCR 9.01

Improvements

Service Invoices and Service Credit Memos are now integrated in Cash Register.

Added fields Old Value, Document Value and New Value to the Cash Register Entries window. Document Value shows the posted Amount. Old Value and New Value show the accumulated value before and after posting.

Added field VAT Registration No. to the Cash Register Customer Card window.

The Cash Register Position Groups window now shows the number of allocated Cash Register Positions in the new field Positions.

It is now possible to specify Starting Date and Ending Date for Cash Register Document Texts.

Added functions Unlock all Items and Unlock all Resources to the Cash Register Setup window. Via these functions it is possible to set the field Quick Entry (Cash Register) for all Items/Resources.

Modifications

The design for the Quick Entry has been changed. There are now more than one ongoing documents per user allowed. The Park functionality is no longer necessary and has been removed.

The behavior for the Description field in the Cash Register Positions window has been changed. Previous behavior: The Description field was displayed in angle brackets. In this case the Description updated automatically when the Description of the master data was changed. If the field was manually overridden, the manual value was used for the Description in the documents. New behavior: If the new field Description Locked is specified, the Description is also used in the documents. Otherwise the Description from the master data is used in the documents. In addition, a new function Update all Descriptions has been added. The function updates the Description field for all Positions, where Description Locked is not set.

Docs  /  NCCR Cash Register (NAV)  /  Appendix
Upgrade to Business Central

Prerequisites for the Upgrade

• Minimum NCCR 13.00 Older versions of NCCR must first be updated in NAV.

Files for the upgrade

Preparation 1: Rename old tables in the NAV database

Preparation 2: Rename old fields in the standard tables of the NAV database

APPLICATION UPGRADE

[Microsoft Docs] Business Central - Upgrading Customized C/AL Application to Microsoft Base Application Version 19

Task 3: Move code customizations to extensions

https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v19#task-3-move-code-customizations-to-extensions

Task 4: Create empty System, Base, and customization extensions

https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v19#task-4-create-empty-system-base-and-customization-extensions

Task 5: Create table migration extension

https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v19#task-5-create-table-migration-extension

migration.json
{
    "apprules": [
        {
            "id": "63ca2fa4-4f03-4f2b-a480-172fef340d3f"
        },
        {
            "id": "437dbf0e-84ff-417a-965d-ed2bb9650972"
        },
        {
            "id": "1edd5525-f8a6-49b3-9a5d-575bce9b4f4a"
        }
    ]
}

Task 10: Publish DestinationAppsForMigrations extensions

https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v19#task-10-publish-destinationappsformigrations-extensions

Task 12: Install DestinationAppsForMigration and move tables

https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v19#task-12-install-destinationappsformigration-and-move-tables

Task 13: Publish final extensions

https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v19#task-13-publish-final-extensions

Task 14: Synchronize final extensions

https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v19#task-14-synchronize-final-extensions

Task 17: Upgrade and install final extensions

https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v19#task-17-upgrade-and-install-final-extensions

After the upgrade