Skip to main content

E-invoice & E-way Bill User Manual

E-Invoice Process

1.            E-Invoice Transaction

To process IRN Number with IRP Portal, go to transaction /PAYINV/EINVOICE_CP, use the select screen and input the values to get the selected documents in the e-invoice cockpit.

Based on the selection criteria the documents will be display in the cockpit.

Click on Process E-Invoice Documents button.

2. Detailed Overview of e-invoice selection screen. 

a.     Transaction Category:

·         Sales Documents: To process the Sales documents select the Sales Document radio button.

·         FI Documents: To process the FI documents select the FI Documents radio button

b.     Mandatory Section with Authorization: This section is Mandatory to fill while selecting the documents for IRN Number process. Based on this selection criteria, the documents will be displayed in the e-invoice cockpit.

c.     Additional Selection Options: Specific Billing Type, Billing Document or Billing Date can be displayed in the cockpit by using this additional Sales Parameter in the selection screen.

3. E-Invoice Cockpit Overview

Based on the selection Criteria, the cockpit will display the documents along with process status.

4. Status flag indicator in the E-Invoice Cockpit.

This flag gives a clear visibility to the user with the document status.

Checkered Flag Is Completed Flag; it means IRN is Generated Successfully.

Red Flag is Error Flag; it means there is an error in the document.

Green Flag is Submitted flag; it means the document is submitted to IRP Portal.

White Flag is Pending Flag; it is yet to be processed for IRN number.

(Note : we have updated the cockpit where REFRESH button is removed & will get the response after 7 sec of submitting document )

5. E-Invoice Cockpit Menu

a.     Refresh Button: will refresh the cockpit with existing data and if any IRN or Errors are generated for the submitted documents ,  it will show in the relevant columns. 

Note: If any documents which are submitted if Response is not generated, after ½ hour, it will reset the documents to pending so that the User can resubmit it again. This feature was added as a precautionary measure in case if there is any issue with the connection or downtime with the IRP portal.

b.    Submit Documents:  This button is used to Submit the document to IRP portal to generate the IRN Number. Once the documents are submitted it cannot be resubmitted until the process is complete.

Select a single or multiple line (shift + Select) and click on Submit documents button. Once the documents are submitted, the flag will turn.

If a User tries to resubmit the document, then an error will be displayed. The User will have to wait for the response back from the IRP Portal.

c.     Print Documents: This print document button is used to print documents which has the IRN number.

d.    History: This history button will display the entire log for each document. – Created, Submitted & Processed.

6. E-invoice Cockpit Document Selection

a.     Document Status: In this selection, the user has the option to pick the document based on the process status

·       All: All the documents which are pending, submitted and processed

·       Submitted: Documents that are submitted to IRP portal and IRN Number is yet to be generated.

·       Processed: Documents which are processed successfully and IRN number is generated.

·       Pending: Documents which are not processed.

·       Incomplete(error): Documents which are processed but has returned an error file from the IRP portal.

d.     Transaction Category: The documents that qualifies for IRN Number are:

·       B2B (Invoice, Credit Note and Debit Note)

·       Export

·       SEZ

·       Cancellation (Only Invoice)

The documents that do NOT quality for IRN number are:

·       B2C – Customer WITHOUT GSTIN Number.

·       Bill of Supply – Warehouse transfer WITHIN State or WITHIN same GSTIN Number.

IMPORTANT NOTE: Cancelled Documents will not be displayed in ALL drop-down selection as it has a separate process and the data sent to IRP Portal for cancellation is a different Schema. To cancel a document, please select Cancelled Documents selection criteria in the Transaction Category.

7. Understanding the Cockpit Screen Values.

o   Status Flag: Will show the user the status of the document, whether it is pending, submitted, or processed.

o   Month: It’s the Period for which the selected documents are displayed.

o   Company code: Business company code.

o   Sales Office: Sales office assigned to the billing document – This is taken from the item level.

o   Sales Office Description: Sales Office Description as per the sales office assigned to the billing document (item lines).

o   Branch GSTIN: Seller’s GSTIN in the billing document.

Business Place

Description

GSTIN

01

Jammu and Kashmir

01AADCP7818B1ZW

03

Punjab

03AADCP7818B1ZS

06

Haryana

06AADCP7818B1ZM

07

Delhi

07AADCP7818B1ZK

08

Rajasthan

08AADCP7818B1ZI

09

Uttar Pradesh

09AADCP7818B2ZF

10

Bihar

10AADCP7818B1ZX

18

Assam

18AADCP7818B1ZH

19

West Bengal

19AADCP7818B1ZF

21

Odisha

21AADCP7818B1ZU

23

Madhya Pradesh

23AADCP7818B1ZQ

24

Gujarat

24AADCP7818B1ZO

27

Maharashtra

27AADCP7818B1ZI

29

Karnataka

29AADCP7818B1ZE

32

Kerala

32AADCP7818B1ZR

33

Tamil Nadu

33AADCP7818B2ZO

36

Telangana

36AADCP7818B1ZJ

o   Billing Type: Document Billing type

Billing Type

Description

ZEF2

Invoice

ZEL2

Debit Memo

ZERE

Credit for Returns

ZEG2

Credit Memo

ZES1

Cancel. Invoice (S1)

ZES2

Cancel of Cred Memo

ZIV3

IN-Interplant STO Inv

ZEF8

Pro Forma Inv f Dlv

ZEF5

Pro Forma for Order

o   Document Number: 

o   Documents Date: Created date of the billing document.

o   GST Value: GST Value from taken from the Billing document header.

o   Document Value: Net Price taken from the Billing document header.

 

o   Customer Name: Bill-To Party Customer Name for the billing document.

o   Customer GSTIN: GSTIN Number of the Customer.

o   Registered Status: This is determined based on Customer has GSTIN Number.

§  Registered: If the customer has GSTIN Number.

§  Unregistered: If the Customer does not have GSTIN Number. 

o   Supply Type: Intra or Interstate based on the GST amount in the document.

§  If the document has CGST and SGST then it is considered as Intra State

§  If the document has IGST, then it is considered as Inter State.

o   Process Status: Process Status in detail – Pending, Submitted, Completed.

o   Various Date and Time: Created by/date, Submitted by Date/Time.

o   Submitted By: User ID of the user who processed the document.

o   IRN Number: If the IRP Portal has successfully generated the IRN number, then it will be displayed in the cockpit.

o   Ack.No: Acknowledgement Number, this is provided by the IRP Portal along with IRN number and QR code.

o   Ack.Date: Acknowledgement Date, this is again provided by the IRP Portal along with IRN number and Signed QR Code

o   Fill transfer Status to Govt Portal: This will give the indication that the file has been generated and sent out of SAP system for the process. Message 202 means it was successfully sent out of the SAP system. 

o   Cancel Date: IF the document has been successfully cancelled in the IRN Portal WITHIN 24 hours, then the IRP portal will provide an cancel date for the document.

o   Error Message from IRP Portal: IRP Portal will give a precise error message if the document does note meet the requirement in the schema. This document can be corrected and resubmitted to the IRP Portal.

Note: The Error List provided by IRP Portal is embedded in this document

                                                                       IRP Error List.xlsx

8. JSON file for the submitted document

For each document submitted via E-Invoice Cockpit, a JSON file gets created as per the government schema.

In this example, for document 9608004939, JSON is generated as per the govt Schema and this JSON file is sent to IRP Portal for IRN Generation.

Note: JSON File for document 9608004939 is embedded for reference.

                                                                                Petronas Request Json File (2).txt

9. Response File from IRP Portal: 

Once the response file is sent to SAP system, a background scheduler is set to run every 5 minutes to pick the response file and update the cockpit and the relevant SAP Tables which are very specific for e-invoice.

Example Response File from IRP Portal for reference.

                                                                                   Petronas Response JSON File.txt

NOTE: Since the update of response is a scheduler, please do wait for the response from IRP portal once document is submitted.

10. Master Code:

Master Name

Code

Description

Type of Transaction

B2B

Business to Business

SEZWP

SEZ with payment

SEZWOP

SEZ without payment

EXPWP

Export with Payment

EXPWOP

Export without Payment

DEXP

Deemed Export

Document Type

INV

Invoice

CRN

Credit Note

DBN

Debit Note

E-way Bill Transport Mode Details

1

Road

2

Rail

3

Air

4

Ship

E-way Bill Vehicle Type Details

O

ODC

R

Regular

Cancellation Reason

1

Duplicate

2

Data Entry Mistake

 

 

 

 

E-way Bill:

To process E-way Bill with IRP Portal, go to transaction ZEINVOICE, use the select screen and input the values to get the selected documents in the e-invoice cockpit.

Based on the selection criteria the documents will be display in the cockpit.

Click on Process E-way Bill button.

1. E-way Bill Overview:

Based on the selection Criteria, the cockpit will display the documents along with process status.

NOTE:  Only the documents which are processed successfully and the IRN number is generated is permitted for E-way bill in the cockpit.

2. E-way Bill Menu

a.     Additional Transport Details: This button is used to provide the transport details for a specific document number.

Select a single line and click on Additional Transport Details button. The E-way Bill transport details pop-up appears.

Select the mode of transport from the drop down- Road, Rail, Sea, Air. Based on the selection of the mode of transport 2 radio button appears viz. with vehicle detail and without vehicle detail. Manually fill the transport details and save. Once the document is saved, the EWB status column turns .

If a User tries to resubmit the document, then an error will be displayed. The User will have to wait for the response back from the IRP Portal.

b.     Cancel E-way Bill: This button is used to cancel the already generated E-way Bill.

c.     Print: This print button is used to print documents which has the E-way Bill No and IRN number.

 d.     Refresh: will refresh the cockpit with existing data and if any E-way bill no. or Errors are generated for the submitted documents , it will show in the relevant columns.

3. Understanding the Cockpit E-way Bill Screen Values.

  • Status Flag: Will show the user the status of the document, only the documents which are processed and the IRN is generated only those documents are permitted for E-way Bill.
  • EWB Status: Will show the user the status of the document, whether it is submitted, processed or error.

  This is Pending Status. Yet to be processed for E-way Bill No.

   This is Error Status. This means that there is error in the document 

   This is Completed Status. This means E-way Bill Number is generated                       

                       image.png This is Submit Status. This means document is submitted to IRP Portal 

o    Month: It’s the Period for which the selected documents are displayed.

o   Company code: Business company code.

o   Sales Organization: Business Sales Organization.

o   Bill Type: Document Billing type

o   Billing Type Description: Invoice, Debit Note or Credit Note.

o   Billing Document: Billing Document Number

o   Documents Date: Created date of the billing document.

o   Process Status: Completed if IRN number is generated.

o   Various Date and Time: Created by/date, Submitted by Date/Time.

o   IRN Number: If the IRP Portal has successfully generated the IRN number, then it will be displayed in the cockpit.

o   IRN Date: Date when IRN Number was generated.

o   E-Way Bill No: If IRP portal has successfully generated the E-Way Bill number, then it will be displayed in the cockpit.

o   E-Way Bill Time and Date: Date and Time when E-Way Bill was generated.

o   E-Way Bill Error: IRP Portal will give a precise error message if the document does not meet the requirement in the schema. This document can be corrected and resubmitted to the IRP Portal.

o   E-Way Bill Cancel Date: If the document has been successfully cancelled in the IRN Portal WITHIN 24 hours, then the IRP portal will provide an cancel date for the document.

4.            JSON file for the submitted E-way Bill document

For each document submitted via E-Invoice Cockpit, a JSON file for e-way bill gets created as per the government schema.

In this example, for document 9008050847, JSON is generated as per the govt Schema and this JSON file is sent to IRP Portal for E-way Bill Number Generation.

Note: JSON File for document 9008050847 is embedded for reference.

                                                                                Petronas E-way Bill Request File.json

5.            Response File from IRP Portal for E-Way Bill:

Once the response file is sent to SAP system, a background scheduler is set to run every 5 minutes to pick the response file and update the cockpit and the relevant SAP Tables which are very specific for e-way bill.

Example Response File from IRP Portal for reference.

                                                                             Petronas E-Way Bill Response File.json

NOTE: Since the update of response is a scheduler, please do wait for the response from IRP portal once document is submitted.

6.            Cancelling the E-Invoice.

To cancel the E-Invoice firstly the selected invoice should be cancelled in SAP.

Once cancelled in SAP Open the E-Invoice cockpit in the Document Selection ->Transaction Category -> Select Cancelled Document from the Drop Down.

Select a single file and click on Submit documents button.

Note: If an e-way bill is generated for the selected document then an error message pops-up “E-way bill is generated for this document Cancel the E-way bill first”.

To cancel the E-way bill go to the cockpit and enter the valid Billing Document Number and Click on process E-way bill.

Select the E-way bill document and Click on Cancel E-way Bill Button.

 

7.            Request File from IRP Portal for Cancelled E-Way Bill:

For each E-way bill document cancelled via E-Invoice Cockpit, a JSON file for cancelled e-way bill gets created as per the government schema.

In this example, for document 9008050847, JSON is generated as per the govt Schema and this JSON file is sent to IRP Portal for Cancelling the E-way Bill.

Note: JSON File for document 9008050847 is embedded for reference.

                                                                                      Petronas Cancelled E-Way Bill Request file.json

8.            Response File from IRP Portal for Cancelled E-Way Bill:

Once the response file is sent to SAP system, a background scheduler is set to run every 5 minutes to pick the response file and update the cockpit and the relevant SAP Tables which are very specific for e-way bill.

Example Response File from IRP Portal for reference.

                                                                                   Petronas Cancelled E-Way Bill Response File (2).json

NOTE: Since the update of response is a scheduler, please do wait for the response from IRP portal once document is submitted.

 

https://einv-apisandbox.nic.in/index.html

https://einvoice1.gst.gov.in/Others/MasterCodes

https://einv-apisandbox.nic.in/master-codes-list.html 

https://einv-apisandbox.nic.in/api-error-codes-list.html