Notice: This website is an unofficial Microsoft Knowledge Base (hereinafter KB) archive and is intended to provide a reliable access to deleted content from Microsoft KB. All KB articles are owned by Microsoft Corporation. Read full disclaimer for more details.

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


View products that this article applies to.

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.

↑ Back to the top


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).

↑ Back to the top


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:

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://docs.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:
[Asset 4551170]

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:

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.

↑ Back to the top


File information

How to obtain the Microsoft Dynamics AX updates files

This update is available for manual download and installation from the Microsoft Download Center.
 
 

Prerequisites

You must have one of the following products installed to apply this hotfix:

  • Microsoft Dynamics AX 2012 R3

Restart requirement

You must restart the Application Object Server (AOS) service after you apply the hotfix.

↑ Back to the top


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.

↑ Back to the top


Keywords: kbAutoHotfix, kbQFE, kbnoloc, kbMBSQuickPub, kbMBSPartner, kbExpertiseAdvanced, kbExpertiseBeginner, kbExpertiseInter, kbHotfixAuto, CI115000, kbsurveynew

↑ Back to the top

Article Info
Article ID : 4549662
Revision : 5
Created on : 4/1/2020
Published on : 4/1/2020
Exists online : False
Views : 341