Hungary: Update to support Online Invoicing System v.2.0 support in Dynamics AX 2012 R3

Introduction

As of 1 July 2018, National Tax and Customs Administration of Hungary announced that companies in Hungary obliged to supply data of their invoices issued through electronic platform of Online Invoicing System.

On February 27, 2020, National Tax and Customs Administration of Hungary announced that as of April 1, 2020, the XSD version 2.0, must be applied in the Online Invoice System. Version 1.1 will not be in use from that day. The process of transition from version 1.1 to 2.0:

• The XSD version 2.0 can be used from 23:00, 27 February 2020 until midnight on 31 March 2020 in the production Online Invoice System; however, its application is not mandatory during this period.

• As of 1st April 2020, solely the XSD version 2.0 will be applicable in the productive environment. After this date, NTCA system will not process data disclosures sent with the usage of the XSD scheme, version 1.1.

On March 24, 2020, National Tax and Customs Administration of Hungary announced that the date when XSD version 2.0 becomes mandatory and solely applicable is changed to July 1, 2020. Before this date version 2.0 XSD can already be used live in parallel with Version 1.1 XSD.

Find more related information on https://onlineszamla.nav.gov.hu/.

KB about initial feature to support interoperation with Hungarian Online Invoicing System: https://support.microsoft.com/help/4338447

Information about previous update to version 1.1 is available in following KB article: https://support.microsoft.com/en-us/help/4499828

Current hotfix provides support of XSD version 2.0 of Hungarian Online Invoicing System.

Overview

This document provides information about how to prepare Dynamics AX 2012 R3 to work with Hungarian Online Invoicing System starting from April 1, 2020 (with XSD version 2.0).

Setup

This section provides information about what changes in the setup of Dynamics AX 2012 R3 must be done to prepare the system to report in version 2.0. It is assumed that system is setup to interoperate with Hungarian Online Invoicing System version 1.1. To do all the necessary setup, refer previous feature KB articles:

• https://support.microsoft.com/help/4338447

• https://support.microsoft.com/en-us/help/4499828

To prepare Dynamics AX 2012 R3 to work with Hungarian Online Invoicing System starting from April 1, 2020 follow the steps:

1. Install DLL package on the machine where AOS is working to support SHA3-512

2. Define new request version in Online invoicing system parameters

3. Define new internet address in Online invoicing system services

Install DLL package on the machine where AOS is working to support SHA3-512

Version 2.0 of Hungarian Online Invoicing System uses 3rd party solution to compute SHA3-512 hash, which is specific for this feature. DLL package to support SHA3-512 hash must be installed on the machine where AOS is working. To install the DLL follow the following steps:

1. Download compiled assembly of release 1.8.5 of BouncyCastle.Crypto.dll by the link to the official source: https://www.bouncycastle.org/csharp/index.html

2. Open Command Prompt in the folder containing BouncyCastle.Crypto.dll

3. Register the DLL via Gacutil.exe tool: https://learn.microsoft.com/en-us/dotnet/framework/app-domains/install-assembly-into-gac?redirectedfrom=MSDN

4. Open: Dynamics AX 6.3 Development > AOT > References: Add reference > find package BouncyCastle.Crypto > Select > Ok

5. Put BouncyCastle.Crypto.dll in two bin folders: Server and Client folders in Microsoft Dynamics AX installation path. Possible paths: 

c:\Microsoft Dynamics AX\60\Server\Microsoft\bin
c:\Microsoft Dynamics AX\60\Client\Bin

1. Restart AOS

Define new request version in Online invoicing system parameters

When DLL to support SHA3-512 hash is installed and company is ready to start using XSD version 2.0, switch your Dynamics AX 2012 R3 to the new version.

Open General ledger > Setup > Sales tax > External > Online invoicing system parameters and select “2.0” in “Request version” field:

Define new internet address in Online invoicing system services

Requests to Hungarian Online Invoicing System supporting XSD version 2.0 version must be sent to new internet addresses.

Open General ledger > Setup > Sales tax > External > Online invoicing system services form and specify for “Customer invoices” type:

• https://api-test.onlineszamla.nav.gov.hu/invoiceService/v2 - for testing Online invoicing system

• https://api.onlineszamla.nav.gov.hu/invoiceService/v2 - for production Online invoicing system

Changes overview

Version 2.0 of Online invoicing system introduces many changes related mostly to the architecture of interoperation. Current update covers the following important changes to support version 2.0 of Online invoicing system:

• 'Request signature' in 'User' node in all requests now implements new hashing algorithm SHA3-512 (instead of SHA-512).

• 'SoftwareNode' in all requests became mandatory.

• ‘lineNatureIndicator' flag added. It describes the nature of the line and can have one of the following values: 'PRODUCT', 'SERVICE', 'OTHER'. Related data is collected from “Reporting type” field of related “Item sales tax group”. If this parameter is not filled for “Item sales tax group” used in a tax transaction - 'OTHER' value will be reported.

• Every monetary expression in invoice lines and their corresponding invoice summary data are extended to contain the value both in the currency of the invoice and in Hungarian Forints. Refer to page 159 of documentation for full list of fields. Amounts in HUF are calculated by multiplying amount in invoice currency by exchange rate.

• Changed algorithm of defining 'LineTaxAmountCur' field value under 'Line' node. This field was previously collected from TaxTrans.SourceTaxAmountCut, in new version it is collected from TaxTrans.SourceRegulateAmountCur (to cover the case when tax transaction information was adjusted).

• Generated file name was changed from 'QueryInvoiceStatusRequest.xml' to 'QueryTransactionStatusRequest.xml'.

• ‘requestSignature’ in the header is now calculated differently for ManageInvoice operation.

• New 'SAVED' status of invoice processing result is introduced. The new status is described as “Message item is saved in the Online invoicing system, but the processing has not been completed yet”.

• ‘ModificationIndex’ tag added – to report serial number of the modifying document referencing invoice. This field values defined automatically.

Additional information

To guaranty correct reporting in Online invoicing system of data from the system, we recommend you create credit note for one invoice. Avoid scenario when one credit note is created for several invoices.

File information

More information

You can contact technical support for Microsoft Dynamics by phone using these links for country specific phone numbers. To do this, visit one of the following Microsoft websites:

Partners

https://mbs.microsoft.com/partnersource/resources/support/supportinformation/Global+Support+Contacts

Customers

https://mbs.microsoft.com/customersource/northamerica/help/help/contactus

In special cases, charges that are ordinarily incurred for support calls may be canceled if a Technical Support Professional for Microsoft Dynamics and related products determines that a specific update will resolve your problem. The usual support costs will apply to any additional support questions and issues that do not qualify for the specific update in question.

Note This is a "FAST PUBLISH" article created directly from within the Microsoft support organization. The information contained here in is provided as-is in response to emerging issues. As a result of the speed in making it available, the materials may include typographical errors and may be revised at any time without notice. See Terms of Use for other considerations.