| # IRN Workbench (cisli9350m00l) Use this session to generate the Invoice Registration Number (IRN) using GST E-Invoice APIs. Based on the guidelines provided in the Invoice Registration Portal (IRP), the API details are used for the IRN generation. The IRN Workbench (cisli9350m00l) session provides a graphical representation for the invoices based on the Tax Invoice Number, GSTIN, Source and so on. Prerequisites to access the workbench A financial company must be defined in the User Data (ttadv2500m00) session In the India Localization Parameters (tccom9136m00l) session: the E-Invoicing Implemented check box must be selected. the Connection Point field must be set to LN Workbench in the India Localization Parameters (tccom9136m00l) session. The required API details must be specified. These details are used to generate the Authorization token . These API along with the authentication token and the session encryption key (SEK) is used to generate the IRN. Workbench Layout The workbench consists of these sections: Filter Selection In this section, the financial company and the GSTIN (Set) number are used to filter the invoices that are displayed. You can click Get Invoices to retrieve and populate the Open Invoices section. Process Result This section displays the status of the IRN generation process along with the time stamp. In case an error occurs during the API retrieval process, the error details are displayed. Note The Process Result section includes information about the error message with the Copy Process Result text to Clipboard You can clear the process result by clicking Clear Process Results button. These are the two options in this session: Generate IRN This option is used to generate IRN of the selected invoices. LN checks the selected invoices for valid JSON. The invoices for which a valid JSON is available, are sent to the API server for generation of the IRN. You can select single or multiple invoices to generate the IRN. Note If the JSON Request field is blank for an Invoice, the invoice is not selected. The Generate IRN option is enabled only if an invoice is selected. The invoices for which the IRN generation is successful, are not displayed in the session. The validation process verifies the JSON structure and not the schema. The IRN status is displayed in the Process Results section and is also defaulted in the E-Invoices Register (cisli9160m00l) session. Cancel Invoice Use this option to cancel an invoice. On clicking this option, a pop-up window is displayed wherein you must specify the Financial Company and the Tax Invoice Number associated with the invoice to be cancelled. When the cancellation process is initiated, the IRN Workbench (cisli9350m00l) session validates the invoice details before invoking the API. The invoice with a valid IRN is submitted to IRP for cancellation. The invoice status is updated in Infor ERP LN and is displayed in the Process Result section. User Settings The User Settings window that is displayed comprises of these sections: Generate IRN The data set up in this section includes: Selecting the Auto check box to run the session in Auto mode, based on the value defined in the Time interval (in minutes) field. This setting enables you to retrieve the available set of open invoices at the specified time interval for automatic processing. Note: If this check box is selected, you must not close this Workbench session. Specifying the time interval in minutes (1-30) in the Time interval (in minutes). The IRN Workbench (cisli9350m00l) session runs in Auto mode at the time interval specified in this field. Authorization Token Token: The authorization token number used to call the APIs. This number is defaulted from IRP. Valid till: The date and time up to when Token number is valid. API SEK: The session encryption key which represents the encryption and decryption of the API requests and responses. SEK is used to encrypt the payload of the subsequent API requests and to decrypt response payload using AES 256 (AES/ECB/PKCS7Padding) symmetric algorithm. Verify: Use this option to verify the validity of the Token number. The verification details are displayed in JSON format. Note To use the API, you must perform the authentication process in IRP. If the authentication process is successful, the Authorization Token ID, the Session Encryption Key (SEK), and the Expiry time are obtained. If the Auth. API is called prior to the date and time specified in the Valid Till field, the application returns the same Token ID and SEK. If the Auth. API is called with the parameter “ForceRefreshAccessToken” set to True, a new Token ID is generated before the date and time specified in the Valid Till field is exceeded. Others The Financial Company and GSTIN (Set) in the main screen can also be saved in the user settings section. Workbench Logs Note If the IRN is generated successfully in the IRP but the update to LN fails, an error log is generated with complete details. These details can be used to manually generate the JSON file. A user with Administrator role can access the Workbench log files from: The Tomcat log folder on the Tomcat server on which the Workbench is deployed for On Prem deployment. The Workbench specific collector file using the Sumo Logic tool. This is specific for single tenant Cloud edition. Related topics e-Invoicing – overview and process for India localization e-Invoicing process in Infor ERP LN |