Summary

This application update enables multiple scenarios for electronic invoice under GST in India:

  • Using multiple sets of credentials for integration with IRP (Invoice Registration Portal) per a company GST registration number in one legal entity

  • Creating electronic invoices for stock transfer orders including stock transfer order cancelation

  • and adds a number of improvements:

    • Better traceability of e-Invoices

    • Improved management of e-invoice status

    • Updated E-invoice status form

    • Trouble shooting and re-processing of messages with errors

    • Debit note identification

    • Encrypted QR code

    • Mapping of electronic invoice data elements

    • Configurable eInvoice tax components.

More information

Prerequisites      

Implemented changes in scope of this update require new set of configurations to be imported as well as an updated data package for Electronic messaging setup.

Import Electronic reporting (ER) configurations

You must import the following ER configurations. Refer to Download Electronic reporting configurations from Lifecycle Services article for details. It is enough if you import format configurations only, all the other required configuration types will be automatically imported.

Number

Configuration name

Configuration version

Configuration type

1

Invoice model

231 or higher

Model

2

Invoice model mapping (IN)

231.6 or higher

Model mapping

3

 GST Invoice format (IN)

231.5 or higher

Format

4

Electronic Messages framework model

31 or higher

Model

5

eInvoice model mapping

31.12 or higher

Model mapping

6

eInvoice format (IN)

31.3 or higher

Format

7

eInvoice authentication import format (IN)

31.5 or higher

Format

8

eInvoice data import format (IN)

31.10 or higher

Format

 

Important

Be sure to import the most recent versions of these configurations. The version description usually includes the number of the Microsoft Knowledge Base (KB) article that explains the changes that were introduced in the configuration version.

Note

After all the ER configurations from the preceding table are imported, set the Default for model mapping option to Yes for the eInvoice model mapping configuration. Please note that with this update, the validation format prior posting has changed, and you should select GST Invoice format (IN) in the E-invoice parameters form.

Set up Electronic messaging (EM) functionality

Electronic message functionality is provided to maintain the different processes that are used in electronic reporting and transmission of different document types. For more information about electronic messages, see Electronic messaging article.

The most important step in setting up Electronic messaging functionality for IRP integration is to import the updated data package Indian IRP integration setup v2.zip. Once successfully imported setup data, almost all required setup will be auto created. There only remaining required setup will be selecting parameters for executable classes and setting up number sequences for Electronic messaging. All those tasks are described below.

 

Import a package of data entities that includes a predefined EM setup

The process of setting up the electronic message functionality to interoperate with the IRP system has multiple steps. Because the names of some predefined entities are used in the ER configurations, it's important that you use a set of predefined values that are delivered in a package of data entities for the related tables, and that you import the ER configurations before you import the data entities.

1.      In Microsoft Dynamics Lifecycle Service (LCS), go to the Shared asset library, and select the Data package asset type.

2.      In the list of data package files, find and download Indian IRP integration setup v2.zip.

3.      After the file is downloaded, open Finance, and select the company that you will interoperate with the IRP system from.

4.      Go to Workspaces > Data management.

5.      In the Data management workspace, go to Framework parameters > Entity settings, and select Refresh entity list. Wait for confirmation that the refresh has been completed. For more information about how to refresh the entity list, see Entity list refresh.

6.      Validate that the source data and target data are correctly mapped. For more information, see Validate that the source data and target data are mapped correctly.

7.      Before the data entities are used for the first time to import the data from the package, sync the mapping of the source data and target data. In the list for the package, select a data entity, and then, on the Action Pane, select Modify target mapping.

8.      Above the grid for the package, select Generate mapping to create a mapping from scratch, and then save the mapping.

9.      Repeat steps 7 and 8 for every data entity in the package before you start the import.

For more information about data management, see Data management overview.

You must now import data from the Indian IRP integration setup v2.zip file into the selected company. In the Data management workspace, select Import, specify a Group name, select Add file, and then, in the drop-down dialog box, set the Source data format field to Package.

10.   Select Upload and add, select the Indian IRP integration setup v2.zip file on your computer, and upload it.

11.   After the data entities are uploaded, on the Action Pane, select Import.

You will receive a notification in the Action center, or you can manually refresh the page to view the progress of the data import. When the import is completed, the Execution summary page shows the results.

 

In order to finalize Electronic messages setup after importing data package, you need to complete the below procedure:

  1. Open Tax > Setup > Electronic messages > Executable class setting.

  2. Select Executable class “Generate EM”.

  3. In the Action Pane, select Parameters and then, in the dialog box that appears, set the following values for the parameters of the executable class.

    1. Format mapping to GST Invoice format (IN)

    2. Message status in case of success to Generated

    3. Message item status in case of technical error to Created

 

Important

In case you previously imported the Indian IRP integration setup.zip data package as described in Knowledge Base Article KB4554936 you must  follow the below steps. Please note, it is not needed if you did not import the previous data package.

  1. Open Tax > Setup > Electronic messages > Message processing actions

  2. Select “Generate cancel invoice request”

  3. Remove “Error generating cancel invoice request” from Initial statuses fast tab.

  4. Select “Generate invoice request”

  5. Remove “Error generating invoice request” from Initial statuses fast tab.

  6. Select “Generate token request”

  7. Remove “Error generating token request” from Initial statuses fast tab.

  8. Select “Import decrypted cancel IRN response”

  9. Remove “Error cancel invoice response importing” from Initial statuses fast tab.

  10. Select “Import decrypted generate IRN response”

  11. Remove “Error decrypting generate IRN” from Initial statuses fast tab.

  12. Select “Import encrypted cancel IRN response”

  13. Remove “Error decrypting cancel IRN” from Initial statuses fast tab.

  14. Select “Import encrypted generate IRN response”

  15. Remove “Error invoice response importing” from Initial statuses fast tab.

  16. Select “Import token response”

  17. Remove “Error token response importing” from Initial statuses fast tab.

  18. Select “Submit cancel invoice request”

  19. Remove “Error sending cancel invoice request” from Initial statuses fast tab.

  20. Select “Submit token request”

  21. Remove “Error sending token request” from Initial statuses fast tab.

  22. Select “Generate ProjInvoice EM”

  23. In General fast tab choose “Generate EM” in Executable class dropdown list.

  24. Select “Generate SalesInvoice EM”

  25. In General fast tab choose “Generate EM” in Executable class dropdown list.

 

Multiple GSTINs in a single entity

Certain businesses were suffering from inability to parameterize the system to enter a separate set of credentials used for integration with IRP per GSTIN. With this update, besides single set of credentials that can be entered in Accounts receivable > Setup > Electronic invoices parameters and still being used as a default set, you can use Enterprise tax registration numbers form to enter User name, User password, Client ID, Client Secret and Certificate secrets per GSTIN registration number.

Complete the below procedure to enable multiple GSTINs support:

  1. Go to Tax > Setup > Sales tax >Enterprise tax registration numbers

  2. If you do not have any GSTIN type registration numbers, create a new record. Otherwise go to step number 5.

  3. Select Tax type = GST, Type = GSTIN and Registration number type = Company

  4. Enter the Registration number and save the data

  5. Expand the eInvoice parameters fast tab

  6. Enter the parameters used as credentials: User name, User password, Client ID, Client Secret and Certificate.

  7. Save the data and close the form.

   image.png

Note: The new fast tab eInvoice parameters in Enterprise tax registration numbers form is available only when all following conditions are met: Tax type = GST, Type = GSTIN, Registration number type = Company and the user has full access rights to the menu item which opens the form Electronic invoices parameters (India).

 

When you send an invoice for registration at IRP, the system is first trying to obtain parameters from Enterprise tax registration numbers for the seller GSTIN of the electronic invoice. In case these settings are not found, the system will use parameters from Electronic invoices parameters (India). These global parameters will be used only when GSTIN in these settings is the same as the seller GSTIN of the electronic invoice that is being sent. If global settings have different GSTIN, it means that there were no credentials found that can be used for communication with IRP, and the error will be shown:

image.png

Note: The Infolog contains GSTIN of the invoice seller to understand which GSTIN is missing setup and \ or requires additional registration at IRP under your PAN.

 

Electronic invoices for stock transfer orders

The stock transfer orders are now enabled to create electronic invoices and cancel previously registered invoices.

Register invoice for stock transfer order

Complete the below procedure to register an electronic invoice for a stock transfer order:

1.      Create and post shipment for a stock transfer order in Inventory management > Outbound orders > Transfer order. Process details are described in the Stock transfer orders for India article.

Note: Electronic invoice will be created and ready for sending for any posted shipment when GST is computed, and the transfer between different GSTINs takes place.

2.      Click Transfer order history button or go to Inventory management > Inquiries and reports > Transfer orders > Transfer order history.image.png

3.      Use E-invoice button to review the electronic invoice status. Default eInvoice status is ‘Created’.

4.      To register invoice for stock transfer order, open Tax > Inquiries and Report > Electronic messages > Electronic messages page

5.      Select OnlineInvoicing processing

6.      Use Run processing function to create electronic invoices for all relevant posted documents and send them to IRP.

7.      Upon completion of processing you may use Original document button to open Transfer order history form.

image.png

Note: Credit and debit notes are not applicable to transfer orders as stock transfer orders created manually can be posted only with positive quantities. If correction is needed, a new transfer order with swapped from – to warehouses should be created.

Cancel invoice for stock transfer order

The cancelation procedure may be conducted in two ways. Complete the below procedure to manually cancel the invoice previously registered at IRP.

  1. Go to Inventory management > Inquiries and reports > Transfer orders > Transfer order history and select sent electronically transfer order for which you want to cancel the invoice

  2. Use E-invoice button to open the electronic invoice status form image.png

  3. Use Cancel function to select a previously successfully registered invoice for cancelation image.png

Note: Status will be updated to “Cancel”

 

There is other option to handle cancelation when a feature “Transfer Order Cancelation” is available and enabled in the Feature management. Once it is enabled, there is a possibility to cancel a shipment.

  1. Go to Inventory management > Inquiries and reports > Transfer orders > Transfer order history and select the shipment for cancelation

  2. Use Cancel button and confirm shipment cancelation image.pngNote: You will see an extra line created in Transfer order history. The original shipment transfer e-invoice will be auto-marked for cancelation. image.png

  3. Use E-invoice button to review the status of the electronic invoice

image.png

 

Regardless of the process followed to mark an invoice for cancelation, please follow these steps to cancel invoice at IRP:

  1. Open Tax > Inquiries and Report > Electronic messages > Electronic messages page

  2. Select CancelInvoice processing

  3. Use Run processing function to cancel all electronic invoices selected for cancelation

Other improvements

Better traceability of e-Invoices

The details for documents in Customer invoice and Project invoice journals as well as Transfer order history journal have an indication that a document was sent electronically. You can open any of referred forms to inquire on that and filter documents which are not sent electronically. The status is updated upon successful registration of the invoice.

image.png

Improved management of e-invoice status

Now apart from previously available process of auto-creating e-invoice status ‘Created’ for the documents posted with customer enabled for electronic invoice, there is a new function Accounts receivable > Periodic task > Create e-invoice status which allows you to override all the criteria except one – the document must not be marked as “sent electronically” what mean it could not be registered at IRP earlier.

 

image.png

 

You can follow the below procedure to bulk create electronic invoices for sending and define recurrency:

  1. Go to Accounts receivable > Periodic task > Create e-invoice status

  2. Expand Records to include and click Filter to apply any required criteria to filter only invoices which need to be sent to IRP image.png

  3. Expand Run in the background to define Recurrence and run function in batch processing.

image.png

This procedure can be used for the documents posted prior to the installation of this application update. In all the cases it is assumed that the posted document \ invoice contains all the required information. Existence of all the mandatory data can be confirmed by reviewing inquiry forms (e.g. invoice journal header \ lines, tax document etc.) or printing the GST invoice.

Updated E-invoice status form

There are additional functions available in E-invoice form which can be opened for any applicable posted invoice in customer invoice, project invoice or transfer order history journal.

image.png

Message item open – opens electronic message items page to review message status, applicable processing, or attachments for electronic message.

Cancel – available previously function to mark the document for cancelation. Now there is a dialog to confirm that you want to complete this operation, since the operation can’t be reverted.

Delete – if the e-invoice status was created for posted document which should not be registered at IRP, it is possible to delete the status to remove the invoice from processing.

 

Note: Availability of functions depends on the document status and its processing stage. Message item button is only available when any processing was run and message items were created, Cancel button is available only for previously successfully registered invoice at IRP and Delete is available only for status ‘Created’, until invoice is successfully registered at IRP.

Trouble shooting and re-processing of messages with errors

Running ‘OnlineInvoicng’ and ‘CancelInvoice’ processing may result in unsuccessful completion of the actions. Those messages will not be processed again until errors are reviewed, corrected if needed where possible, and mark the message as ready for re-processing.

Reviewing the errors

  1. Open Tax > Inquiries and Report > Electronic messages > Electronic messages page

  2. Select OnlineInvoicing processing

  3. In the Messages table select any message that has Error status

  4. In the Action log table you can see the list of actions that were taken for your message. The last Action log item should have a Response code and a Response description.

Example:

image.png

This message has status “Error token response importing”. It means that you should check your KeyVault credentials for Client-ID and Client-Secret. After you have fixed your credentials you can proceed with message re-processing.

Re-processing

Select a message with an Error status and click on “Update status” button in the Messages table action pane. This will show you Update status dialog:

image.png

The default values of this dialog:

  1. Action is set to “Process Error Messages”

  2. New status is set to “Evaluated”

If you want to bulk process messages with Errors, you can simply remove criteria from the Filter in “Records to include” section.

After you click OK, your message(s) status will be set to “Evaluated”. This means that you can run the processing again and see if the error is gone.

 

Debit note identification

The electronic invoice message according to the specification may contain only positive quantities and amounts regardless of document type: invoice, credit note and debit note. Issued document is considered as a credit or a debit note when there is an association of the original transaction reference in a respective Tax document for the invoice. Issued document is considered as a credit note even without the mentioned association in case its total amount is negative.

Example of Tax document for Free text invoice debit note:

image.png

Document is sent as a credit note (CRN) when there is original transaction id \ date reference, and the total invoice amount is negative. It is sent as a debit note (DBN) when there is a reference, and the total invoice amount is equal of higher than 0. Regular invoice (INV) is sent in all other cases.

 

Encrypted QR code

The QR code that is printed in the GST invoice report after successful document registration, now represents signed and encrypted information to enable offline verification of invoices using Mobile App.

image.png

Mapping of electronic invoice data elements

You might have been receiving inappropriate and misleading errors and warnings while trying to register a document that has been posted with accurate GSTINs, addresses and other information. Now all the data elements in electronic invoice JSON format are mapped differently and in order to ensure all-the-time consistency with printed GST invoice are using the same data sources as the printable form (report data providers). Be sure you completed steps in prerequisites to make sure new configurations and mappings are used.

 

Configurable eInvoice tax components

Proper mapping for eInvoice tax components is required to indicate classification of configurable GST components in the electronic invoice. This mapping is done is an Electronic reporting configuration. Complete the following procedure to review or update eInvoice tax components mapping.

  1. Go to Organization administration > Electronic reporting workspace

  2. Create and activate your configuration provider

  3. Open Reporting configurations and find GST Invoice format (IN) in the configuration tree

  4. Open Designer and switch to the Mapping tab

  5. Expand the Constants container

image.png

This is the set of currently supported tax components. Each constant is a string with the name of a corresponding component. You can see the string representing the tax component by selecting each and clicking Edit – Edit formula. If your system has Tax components with custom names, please derive this configuration, update the constants, complete the configuration and use your new configuration in Executable class settings and in validation format at Electronic invoice parameters.

 

 

 

Need more help?

Want more options?

Explore subscription benefits, browse training courses, learn how to secure your device, and more.

Communities help you ask and answer questions, give feedback, and hear from experts with rich knowledge.