4[FORM GST INV – 1
(See Rule 48)
Format/Schema for e-Invoice
Note 1: Cardinality means whether reporting of the item(s) is mandatory or optional as explained below:
0..1: It means that reporting of item is optional and when reported, the same cannot be repeated.
1..1: It means that reporting of item is mandatory but cannot be repeated.
1..n: It means that reporting of item is mandatory and can be repeated more than once.
0..n: It means that reporting of item is optional but can be repeated more than once if reported. For example, previous invoice reference is optional but if required one can mention many previous invoice references.
Note 2: Field specification Number (Max length: m, n) indicates ‘m’ places before decimal point and ‘n’ places after decimal point. For example, Number (Max length: 3,3) will have the format 999.999
Schema (Version 1.1) | |||||||
Sr. No. |
Technical name of the field | Cardinality (0..1/ 1..1/ 0..n/ 1..n) | Brief Description of the field | Whether Mandatory/ Optional | Technical Field Specification |
Sample Value of the field |
Explanatory Notes |
1. | Basic Details | 1..1 | Mandatory | Header for Basic Details | |||
1.0 | Version | 1..1 | Version Number | Mandatory | String (Max. Length:6) | 1.1 | This is version of the e-invoice schema. It will be used to keep track of version of Invoice specification. |
1.1 | IRN | 1..1 | Invoice Reference Number | Mandatory | String (Length: 64) | a5c12dca80e 7433217…..b a4013750f20 46f229 |
This will be a unique reference number for the invoice. However, the supplier will not be populating this field. The registration request may not have this field populated. The Invoice Registration Portal (IRP) will generate this IRN and respond to the registration request. e-invoice is valid only when it has the IRN. Hence, this is marked as mandatory field. |
1.2 | Supply_Type_ Code | 1..1 | Code for Supply Type | Mandatory | Enumerated List | B2B/B2C/SE ZWP/SEZW OP/EXP WP/EXPWO P/DEXP |
This will be the code to identify type of supply. B2B: Business to Business B2C: Business to Consumer SEZWP: To SEZ with Payment SEZWOP: To SEZ without Payment EXPWP: Export with Payment EXPWOP: Export without Payment DEXP: Deemed Export |
1.3 | Document_Type _Code | 1..1 | Code for Document Type | Mandatory | Enumerated List | INV / CRN / DBN |
Type of Document: INV for Invoice, CRN for Credit Note, DBN for Debit note. |
1.4 | Document_Num | 1..1 | Document Number | Mandatory | String (Max Length:16) | Sa/1/2019 | This is as per relevant rule in CGST/SGST/UTGST Rules. |
1.5 | Document_Date | 1..1 | Document Date | Mandatory | String (DD/MM/YYYY) | 21/07/2019 | The date on which the Invoice was issued. Format "DD/MM/YYYY" |
1.6 | Additional_ Currency_Code | 0..1 | Additional Currency Code | Optional | Enumerated List | USD, EUR |
The field is for reporting additional currency, if any, in which all invoice amounts can be given, along with INR. One such additional currency may be used in the invoice, as per list published under ISO 4217 standard. List published and updated from time to time at https://www.icegate.gov.in/Webap pl/CUR_ENQ |
1.7 | Reverse_Charge | 0..1 | Reverse Charge | Optional | String (Length:1) | Y | Whether the tax liability payable is under Reverse Charge. |
1.8 | IGST_Applicabilit y_despite_Supplie r_and_Recipient_l ocated_in_same_ State/UT | 0..1 | IGST Applicability despite Supplier and Recipient located in same State/UT | Optional | String (Length: 1) | N | To report the scenarios where the supply is chargeable to IGST despite the fact that the Supplier and Recipient are located within same State/UT |
2. | Document_Period | 0..1 | Optional | Header for Document Period | |||
2.1 | Document_Period _Start _Date | 1..1 | Document Period Start Date | Mandatory | String (DD/MM/YYYY) | 21/07/2019 |
This is the start date of the document period (delivery/invoice period). (This field is mandatory only if this section is selected) |
2.2 | Document_ Period_End_ Date | 1..1 | Document Period End Date | Mandatory | String (DD/MM/YYYY) | 21/07/2019 |
This is the end date of the document period (delivery/invoice period). (This field is mandatory only if this section is selected) |
3. | Preceding Document / Contract Reference | 0..1 | Optional | Header for Preceding Document / Contract Reference | |||
3.1 | Preceding Document Reference | 0..n | Optional | Sub-header for Preceding Document Reference | |||
3.1.1 | Preceding_Document_ Number | 1..1 | Preceding Document Number | Mandatory | String (Max length:16) | Sa/1/2019 |
This is the reference of original document/invoice to be provided optionally in the case of debit or credit notes. Credit/Debit notes, against invoices can also be referred here. (This field is mandatory only if this section is selected) |
3.1.2 | Preceding_ Document_ Date | 1..1 | Date of Preceding Document | Mandatory | String (DD/MM/YYYY) | 21/07/2019 |
Date of preceding document/invoice. (This field is mandatory only if this section is selected) |
3.1.3 | Other_ Reference | 0..1 | Other Reference | Optional | String (Max length:20) | KOL01 | This field is to provide any additional reference e.g. specific branch, their user ID, their employee ID, sales centre reference etc. |
3.2 | Receipt / Contract References | 0..n | Optional | Sub-header for Receipt / Contract References | |||
3.2.1 | Receipt_Advice_R eference | 0..1 | Receipt Advice Reference | Optional | String (Max length:20) | CREDIT30 | This reference is kept for user to provide number of their receipt advice to their customer, in lieu of advance. |
3.2.2 | Receipt_Advice _Date | 0..1 | Date of Receipt Advice | Optional | String (DD/MM/YYYY) | 21/07/2019 | Date of issue of receipt advice for advance. |
3.2.3 | Tender_or_Lot_ Reference | 0..1 | Tender or Lot Reference | Optional | String (Max length:20) | TENDERJAN2020 | This reference is kept for mentioning number or details of Lot or Tender, if supplies are made under such Lot or tender. |
3.2.4 | Contract_ Reference | 0..1 | Contract Reference | Optional | String (Max length:20) | CONT23072019 | This reference is kept for mentioning contract number, if supplies are made under any specific Contract |
3.2.5 | External_ Reference | 0..1 | External Reference | Optional | String (Max length:20) | EXT23222 | An additional field for provision of any additional/external reference number for the supply. |
3.2.6 | Project_ Reference | 0..1 | Project Reference | Optional | String (Max length:20) | PJTCODE01 | This reference is kept for mentioning project number, if supplies are made under any specific project |
3.2.7 | PO _Ref_Num | 0..1 | PO Reference Number | Optional | String (Max length:16) | Vendor PO /1 | This is the reference number of Purchase Order |
3.2.8 | PO_Ref_Date | 0..1 | PO Reference Date | Optional | String (DD/MM/YYYY) | 21/07/2019 | This is the date of Purchase Order. |
4. | Supplier Information | 1..1 | Mandatory | Header for Supplier Information | |||
4.1 | Supplier_Legal_N ame | 1..1 | Supplier Legal Name | Mandatory | String (Max. length:100) | XYZ Ltd. | Legal Name, as appearing in PAN of the Supplier |
4.2 | Supplier_Trade_ Name | 0..1 | Trade Name of Supplier | Optional | String (Max length:100) | ABC Traders | A name by which the Supplier is known, i.e. Business Name, other than legal name |
4.3 | Supplier_ GSTIN | 1..1 | GSTIN of Supplier | Mandatory | String (Length:15) | 29AADFV7589C1 ZX | GSTIN of the Supplier |
4.4 | Supplier_ Address1 | 1..1 | Supplier Address 1 | Mandatory | String (Max length:100) | # 1-23-120, Flat No. 3, Nalanda Apartments, MG Road, Vasanth Nagar | Address 1 of the Supplier (Building/Flat no., Road/Street, Locality etc.) |
4.5 | Supplier_ Address2 | 0..1 | Supplier Address 2 | Optional | String (Max length:100) | # 1-23-120, Flat No. 3, Nalanda Apartments, MG Road, Vasanth Nagar | Address 2 of the Supplier (Building/Flat no., Road/Street, Locality etc.), if any |
4.6 | Supplier_Place | 1..1 | Supplier Place | Mandatory | String (Max length:50) | Bangalore | Location of the Supplier (City/Town/Village) |
4.7 | Supplier_State_ Code | 1..1 | Supplier State Code | Mandatory | Enumerated List | 29 |
State Code of the Supplier as per GST System List published and updated from time to time at https://www.icegate.gov.in/Web appl/STATE_ENQ |
4.8 | Supplier_Pincode | 1..1 | Supplier PIN Code | Mandatory | Number (Length: 6) | 560087 | PIN Code of the Supplier Locality |
4.9 | Supplier_ Phone | 0..1 | Supplier Phone | Optional | String (Max length:12) | 9999999999 | Contact number of the Supplier |
4.10 | Supplier_Email | 0..1 | Supplier e-mail | Optional | String (Max length:100) | supplier@abc.com | e-mail ID of the Supplier, as per REGEX (Regular Expressions) pattern |
5. | Recipient Information | 1..1 | Mandatory | Header for Recipient Information | |||
5.1 | Recipient_Legal_ Name | 1..1 | Recipient Legal Name | Mandatory | String (Max. length:100) | PQR Pvt. Ltd. | It will be legal name of recipient, as per PAN. |
5.2 | Recipient_Trade_ Name | 0..1 | Recipient Trade Name | Optional | String (Max length:100) | Adarsha | It will be trade name of recipient, if available. |
5.3 | Recipient_ GSTIN | 1..1 | GSTIN of Recipient | Mandatory | String (Length:15) | 29ABCCR1832C1 ZX, URP |
GSTIN of the Recipient, if available. URP: In case of exports or if supplies are made to unregistered persons |
5.4 | Place_Of_Supply_ State_ Code | 1..1 | Place of Supply (State Code) | Mandatory | Enumerated List | 29, 96 |
Code/State Code of Place of Supply as per GST System. List published and updated from time to time at https://www.icegate.gov.in/Web appl/STATE_ENQ |
5.5 | Recipient_ Address1 | 1..1 | Recipient Address 1 | Mandatory | String (Max length:100) | # 1-23-120, Flat No. 3, Nalanda Apartments, MG Road, Vasanth Nagar | Address 1 of the Recipient (Building/Flat no., Road/Street, Locality etc.) |
5.6 | Recipient_Addre ss2 | 0..1 | Recipient Address 2 | Optional | String (Max length:100) | # 1-23-120, Flat No. 3, Nalanda Apartments, MG Road, Vasanth Nagar |
Address 2, if any, of the Recipient (Building/Flat no., Road/Street, Locality etc.), if any |
5.7 | Recipient_Place | 1..1 | Recipient Place | Mandatory | String (Max length:100) | Mysore | Location of the Recipient (City/Town/Village) |
5.8 | Recipient_State_C ode | 1..1 | Recipient State Code | Mandatory | Enumerated List | 29 |
Code/State Code of the Recipient. List published and updated from time to time at https://www.icegate.gov.in/Web appl/STATE_ENQ |
5.9 | Recipient_Pinc ode | 0..1 | Recipient PIN Code | Optional | Number (Length: 6) | 560002 |
PIN code of the Recipient locality. In case of export, Pincode need not be mentioned. |
5.10 | Country_Code_of _Export | 0..1 | Country Code of Export | Optional | Enumerated List | AN |
Code of country of export as per ISO 3166-1 alpha-2 / Indian Customs EDI system. List published and updated from time to time at https://www.icegate.gov.in/Web appl/COUNTRY_ENQ |
5.11 | Recipient_Phone | 0..1 | Recipient Phone | Optional | String (Max length:12) | 0802223323 | Contact number of the Recipient |
5.12 | Recipient_email_ID | 0..1 | Recipient e-mail ID | Optional | String (Max length:100) | billing@xyz.com | e-mail ID of the Recipient, as per REGEX (Regular Expressions) pattern |
6. | Payee Information | 0..1 | Optional | Header for Payee Information | |||
6.1 | Payee_Name | 0..1 | Payee Name | Optional | String (Max length:100) | Ramesh K | Name of the person to whom payment is to be made |
6.2 | Payee_Bank_ Account_Number | 0..1 | Payee Bank Account Number | Optional | String (Max length:18) | 3868501747262 | Bank Account Number of Payee |
6.3 | Mode_of_ Payment | 0..1 | Mode of Payment | Optional | String (Max length:18) | Direct Transfer | Mode of Payment: Cash/Credit/Direct Transfer etc. |
6.4 | Bank _ Branch_Code | 0..1 | Bank Branch Code | Optional | String (Max length:11) | SBIN9876543 | Indian Financial System Code (IFSC) of Payee‘s Bank Branch |
6.5 | Payment_Terms | 0..1 | Payment Terms | Optional | String (Max length:100) | Text | Terms of Payment, if any, with the Recipient can be provided. |
6.6 | Payment_ Instruction | 0..1 | Payment Instruction | Optional | String (Max length:100) | Text | Instruction, if any, regarding payment can be provided |
6.7 | Credit_Transfer_T erms | 0..1 | Credit Transfer Terms | Optional | String (Max length:100) | Text | Terms to specify credit transfer payments. |
6.8 | Direct_Debit_ Terms | 0..1 | Direct Debit Terms | Optional | String (Ma x length:100) | Text | Terms, if any, to specify a direct debit. |
6.9 | Credit_Days | 0..1 | Credit Days | Optional | Numeric (Max length:4) | 30 | Number of days within which payment is due. |
7. | Delivery_ Information | 0..1 | Optional | Header for Delivery Information | |||
7.1 | Ship_To_Details | 0..1 | Ship To Details | Optional | Refer A 1.0 | Details of location to which the supply has to be delivered. | |
7.2 | Dispatch_From_ Details | 0..1 | Dispatch From Details | Optional | Refer A 1.1 | Details of location from where Supply has to be dispatched. | |
8. | Invoice Item Details | 1..n | Man datory | Header for Invoice Item Details | |||
8.1 | Item_List | 1..n | Item List | Mandatory | Refer A 1.2 | Provides information about the goods and services being invoiced. | |
9. | Document Total | 1..1 | Man datory | Header for Document Total Details | |||
9.1 | Document_Total_ Details | 1..1 | Document Total Details | Mandatory | Refer A 1.3 | Details of document total including taxes. | |
10. | Extra Information | 0..1 | Optional | Header for Extra Information | |||
10.1 | Tax_Scheme | 1..1 | Tax Scheme | Mandatory | String (Max length: 10) | GST | To specify the tax/levy applicable – GST (This field is mandatory only if this section is selected) |
10.2 | Remarks | 0..1 | Remarks | Optional | String (Max length: 100) | New batch Items submitted | A textual note that gives unstructured information that is relevant to the Invoice as a whole e.g. reasons for any correction or assignment note in case the invoice has been factored etc. |
10.3 | Port_Code | 0..1 | Port Code | Optional | Enumerated List | Alpha numeric |
In case of export/supply to SEZ, port code can be mentioned as per Indian Customs EDI System (ICES), if applicable and available at the time of reporting e-invoice. Lists published and updated from time to time at below URLs: EDI Port Codes: https://www.icegate.gov.in/Web appl/LOCATION_ENQ Non-EDI Port Codes: https://www.icegate.gov.in/Web appl/nonlocation_det_all.jsp |
10.4 | Shipping_Bill_ Number | 0..1 | Shipping Bill Number | Optional | String (Max length: 20) | Alpha numeric | In case of export/supply to SEZ, shipping bill number as per Indian Customs EDI System (ICES), can be mentioned, if applicable and available at the time of reporting e-invoice. |
10.5 | Shipping_Bill_ Date | 0..1 | Shipping Bill Date | Optional | String(DD/M M/YYYY) | 03/12/2020 | Date of Shipping Bill as per Indian Customs EDI System (ICES) |
10.6 | Export_Duty_ Amount | 0..1 | Export Duty Amount | Optional | Number (Max Length: 12,2) | 1200000.50 | Amount of Export Duty in INR, if any, applicable (in case of invoices for export) |
10.7 | Supplier_Can_ Opt_Refund | 0..1 | Supplier Can Opt Refund | Optional | String (Length: 1) | Y / N | In case of deemed export supplies, this field is for mentioning whether supplier can exercise the option of claiming refund or not. |
10.8 | ECOM_GSTIN | 0..1 | e-Commerce Operator‘s GSTIN | Optional | String (Length: 15) | 29ABCCR1832C1 CX | GSTIN of e-commerce operator, if supply is made through him/her. |
11. | Additional_ Supporting_ Documents | 0..n | Optional | Header for Additional Supporting Documents | |||
11.1 | Additional_ Supporting_ Documents_URL | 0..1 | Additional Supporting Documents URL | Optional | String (Max length: 100) | http://www.xyz.co m/abc | This is to enter URL reference of additional supporting documents, if any. |
11.2 | Additional_ Supporting _ Documents_ base64 | 0..1 | AdditionalSuppor ting Document in base64 | Optional | String (Max length: 1000) | Base 64 encoded Document | This is to add any additional document in PDF/Microsoft Word in Base64 encoded format. |
11.3 | Additional_Infor mation | 0..1 | Additional Information | Optional | String (Max length: 1000) | Free text, remarks, identifiers, etc. | Any additional information, names, values, data etc. that is specific for the Supplier- Recipient transaction e.g. CIN, trade-specific information, Drug Licence Reg. No., FOB/CIF etc. |
12. | E-way Bill Details | 0..1 | Optional | Header for e-way Bill Details | |||
12.1 | Transporter_ID | 0..1 | Transporter ID | Optional | String (Length: 15) | 29AADFV7589C1 ZO |
Registration / Enrolment Number of the transporter (This field is required if Part-A of E-waybill has to be generated) |
12.2 | Trans_Mode | 0..1 | Mode of Transportation | Optional | Enumerated List | 1/2/3/4 |
Option to be provided based on mode of transport available on e- Way Bill Portal 1 for Road; 2 for Rail; 3 for Air; 4 for Ship (This field is required if Part-B of e-way bill is also to be generated) |
12.3 | Trans_Distance | 1..1 | Distance of Transportation | Mandatory | Number (Max length: 4) | 200 |
Distance of Transportation (This field is mandatory only if this section is selected) |
12.4 | Transporter_Name | 0..1 | Transporter Name | Optional | String (Max length: 100) | Sphurthi Transporters | Name of the Transporter |
12.5 | Trans_Doc_No. | 0..1 | Transport Document Number | Optional | String (Max length: 15) | As/34/746 |
Transport Document Number (This field is mandatory if mode of Transport is Rail or Air or Ship) |
12.6 | Trans_Doc_Date | 0..1 | Transport Document Date | Optional | String (DD/MM/YYYY) | 21/07/2019 |
Date of Transport document. (This field is mandatory if mode of Transport is Rail or Air or Ship) |
12.7 | Vehicle_No. | 0..1 | Vehicle Number | Optional | String (Max. length: 20) | KA12KA1234 or KA12K1234 or KA123456 or KAR1234 |
Vehicle Registration Number (This field is mandatory if mode of Transport is Road) |
12.8 | Vehicle_Type | 0..1 | Vehicle Type | Optional | Enumeration List | O / R |
To mention nature of vehicle: O: Over-Dimensional Cargo R: Regular (This field is mandatory if Part- B of e-way bill is also to be generated) |
A 1.0 | Ship To Details | 0..1 | Optional | Header for Annexure A 1.0: Ship To Details | |||
Sr. No. | Parameter Name | Cardin ality | Description | Whether optional or mandatory | Field Specifications | Sample Value | Explanatory Notes |
A.1.0.1 | ShipTo_Legal_ Name | 1..1 | Ship To Legal Name | Mandatory | String (Max length: 100) | ABC-1 Ltd. |
Legal Name of the entity to whom the supplies are shipped to. (This field is mandatory only if this section is selected) |
A.1.0.2 | ShipTo_Trade_Name | 0..1 | Ship To Trade Name | Optional | String (Max length: 100) | XYZ-1 | Trade Name of the entity to whom the supplies are shipped to. |
A.1.0.3 | ShipTo_GSTIN | 0..1 | Ship To GSTIN | Optional | String (Length: 15) | 36AABCT2223L1 ZF | GSTIN of the entity to whom the supplies are shipped to. |
A.1.0.4 | ShipTo_Address1 | 1..1 | Ship To Address1 | Mandatory | String (Max length: 100) | Flat No. 2, Priya Towers, Omega Road, Srinivasa Nagar |
Address 1 of the entity to whom the supplies are shipped to (This field is mandatory only if this section is selected) |
A.1.0.5 | ShipTo_Address2 | 0..1 | Ship To Address2 | Optional | String (Max length: 100) | Flat No. 2, Priya Towers, Omega Road, Srinivasa Nagar | Address 2, if any, of the entity to whom the supplies are shipped to |
A.1.0.6 | ShipTo_Place | 1..1 | Ship To Place | Mandatory | String (Max length: 100) | Bangalore |
Place (City/Town/Village) of entity to whom the supplies are shipped to. (This field is mandatory only if this section is selected) |
A.1.0.7 | ShipTo_Pincode | 1..1 | Ship To Pincode | Mandatory | Number (Max length: 6) | 560001 |
PIN code of the location to which the supplies are shipped to. (This field is mandatory only if this section is selected) |
A.1.0.8 | Ship_To_State_ Code | 1..1 | Ship To State Code | Mandatory | Enumerated List | 29 |
Code/State Code (as per GST System) to which the supplies are shipped to. List published and updated from time to time at https://www.icegate.gov.in/Web appl/STATE_ENQ (This field is mandatory only if this section is selected) |
10.6 | Export_Duty_ Amount | 0..1 | Export Duty Amount | Optional | Number (Max Length: 12,2) | 1200000.50 | Amount of Export Duty in INR, if any, applicable (in case of invoices for export) |
10.7 | Supplier_Can_ Opt_Refund | 0..1 | Supplier Can Opt Refund | Optional | String (Length: 1) | Y / N | In case of deemed export supplies, this field is for mentioning whether supplier can exercise the option of claiming refund or not. |
10.8 | ECOM_GSTIN | 0..1 | e-Commerce Operator‘s GSTIN | Optional | String (Length: 15) | 29ABCCR1832 C1CX | GSTIN of e-commerce operator, if supply is made through him/her. |
11. | Additional_Sup porting_Docum ents | 0..n | Optional | Header for Additional Supporting Documents | |||
11.1 | Additional_ Supportin g_Documents_ URL | 0..1 | Additional Supporting Documents URL | Optional | String (Max length: 100) | http://www.xyz. com/abc | This is to enter URL reference of additional supporting documents, if any. |
11.2 | Additional_ Supporting _ Documents_ base64 | 0..1 | AdditionalSupp orting Document in base64 | Optional | String (Max length: 1000) | Base 64 encoded Document | This is to add any additional document in PDF/Microsoft Word in Base64 encoded format. |
11.3 | Additional_ Information | 0..1 | Additional Information | Optional | String (Max length: 1000) | Free text, remarks, identifiers, etc. | Any additional information, names, values, data etc. that is specific for the Supplier-Recipient transaction e.g. CIN, trade-specific information, Drug Licence Reg. No., FOB/CIF etc. |
12. | E-way Bill Details | 0..1 | Optional | Header for e-way Bill Details | |||
12.1 | Transporter_ID | 0..1 | Transporter ID | Optional | String (Length: 15) | 29AADFV7589 C1ZO |
Registration / Enrolment Number of the transporter (This field is required if Part-A of E-waybill has to be generated) |
12.2 | Trans_Mode | 0..1 | Mode of Transportation | Optional | Enumerated List | 1/2/3/4 |
Option to be provided based on mode of transport available on e- Way Bill Portal 1 for Road; 2 for Rail; 3 for Air; 4 for Ship (This field is required if Part-B of e-way bill is also to be generated) |
12.3 | Trans_Distance | 0..1 | Distance of Transportation | Mandatory | Number (Max length: 4) | 200 |
Distance of Transportation (This field is mandatory only if this section is selected) |
12.4 | Transporter_Name | 0..1 | Transporter Name | Optional | String (Max length: 100) | Sphurthi Transporters | Name of the Transporter |
12.5 | Trans_Doc_No. | 0..1 | Transport Document Number | Optional | String (Max length: 15) | As/34/746 |
Transport Document Number (This field is mandatory if mode of Transport is Rail or Air or Ship) |
12.6 | Trans_Doc_Date | 0..1 | Transport Document Date | Optional | String (DD/MM/YYYY) | 21/07/2019 |
Date of Transport document. (This field is mandatory if mode of Transport is Rail or Air or Ship) |
12.7 | Vehicle_No. | 0..1 | Vehicle Number | Optional | String (Max. length: 20) | KA12KA1234 or KA12K1234 or KA123456 or KAR1234 |
Vehicle Registration Number (This field is mandatory if mode of Transport is Road) |
12.8 | Vehicle_Type | 0..1 | Vehicle Type | Optional | Enumeration List | O / R |
To mention nature of vehicle: O: Over-Dimensional Cargo R: Regular (This field is mandatory if Part-B of e-way bill is also to be generated) |
A 1.0 | Ship To Details | 0..1 | Optional | Header for Annexure A 1.0: Ship To Details | |||
Sr. No. |
Parameter Name |
Description | Whether optional or mandatory | Field Specifications | Sample Value | Explanatory Notes | |
A.1.0.1 | Ship To_Legal_ Name | 0..1 | Ship To Legal Name | Mandatory | String (Max length: 100) | ABC-1 Ltd. |
Legal Name of the entity to whom the supplies are shipped to. (This field is mandatory only if this section is selected) |
A.1.0.2 | Ship To_Trade_ Name | 0..1 | Ship To Trade Name | Optional | String (Max length: 100) | XYZ-1 | Trade Name of the entity to whom the supplies are shipped to. |
A.1.0.3 | Ship To_GSTIN | 0..1 | Ship To GSTIN | Optional | String (Length: 15) | 36AABCT2223 L1ZF | GSTIN of the entity to whom the supplies are shipped to. |
A.1.0.4 | Ship To_Address1 | 1..1 | Ship To Address1 | Mandatory | String (Max length: 100) | Flat No. 2, Priya Towers, Omega Road, Srinivasa Nagar |
Address 1 of the entity to whom the supplies are shipped to (This field is mandatory only if this section is selected) |
A.1.0.5 | ShipTo_Address2 | 0..1 | Ship To Address2 | Optional | String (Max length: 100) | Flat No. 2, Priya Towers, Omega Road, Srinivasa Nagar | Address 2, if any, of the entity to whom the supplies are shipped to |
A.1.0.6 | Ship To_Place | 1..1 | Ship To Place | Mandatory | String (Max length: 100) | Bangalore | Place (City/Town/Village) of entity to whom the supplies are shipped to. |
A.1.0.7 | Ship To_Pincode | 1..1 | Ship To Pincode | Mandatory | Number (Max length: 6) | 560001 |
PIN code of the location to which the supplies are shipped to. (This field is mandatory only if this section is selected) |
A.1.0.8 | Ship_To_State_ Code | 1..1 | Ship To State Code | Mandatory | Enumerated List | 29 |
Code/State Code (as per GST System) to which the supplies are shipped to. List published and updated from time to time at https://www.icegate.gov.in/Webap pl/STATE_ENQ (This field is mandatory only if this section is selected) |
A 1.1
|
Dispatch From Details | 0..1 | Optional | Header for Annexure A 1.1: Dispatch From Details | |||
Sr. No. | Parameter Name | Cardinality | Description | Whether mandatory or optional | Field Specifications | Sample Value | Explanatory Notes |
A.1.1.1 | Dispatch From_Name | 1..1 | Dispatch From Name | Mandatory | String (Max length:100) | XYZ-2 |
Name of the entity from which goods are dispatched. (This field is mandatory only if this section is selected) |
A.1.1.2 | Dispatch From_ Address1 | 0..1 | Dispatch From Address1 | Optional | String (Max length: 100) | Building No. 4/2, Flat No. 3, Kakatiya Apartments, Vasanth Nagar |
Address 1 of the entity from which goods are dispatched. (This field is mandatory only if this section is selected) |
A.1.1.3 | Dispatch From_ Address2 | 1..1 | Dispatch From Address2 | Mandatory | String (Max length: 100) | Building No. 4/2, Flat No. 3, Kakatiya Apartments, Vasanth Nagar | Address 2 of the entity from which goods are dispatched. |
A.1.1.4 | Dispatch From_ Place | 1..1 | Dispatch From Place | Mandatory | String (Max length: 100) | Bangalore |
Place (City/Town/Village) of the entity from which goods are dispatched. (This field is mandatory only if this section is selected) |
A.1.1.5 | Dispatch From_ State_Code | 1..1 | Dispatch From State Code | Mandatory | Enumerated List | 29 |
Code/State Code of the entity (as per GST System), from which goods are dispatched. List published and updated from time to time at https://www.icegate.gov.in/Webap pl/STATE_ENQ (This field is mandatory only if this section is selected) |
A.1.1.6 | Dispatch From_ Pincode | 1..1 | Dispatch From Pincode | Mandatory | Number (Length: 6) | 560087 |
Pincode of the locality of entity from where goods are dispatched. (This field is mandatory only if this section is selected) |
A 1.2 | Item Details | 1..n | Mandatory | Header for Annexure A 1.2: Item Details | |||
Sr. No. | Parameter Name | Cardinality | Description | Whether mandatory or optional | Field Specifications | Sample Value | Explanatory Notes |
A.1.2.1 | Sl_No. | 1..1 | Serial Number | Mandatory | String (Max length: 6) | 1,2,3 | Serial number of the item |
A.1.2.2 | Item_Description | Item Description | Optional | String (Max length: 300) | Mobile | Description of the item | |
A.1.2.3 | Is_Service | 1..1 | Service | Mandatory | String (Length: 1) | Y/N | Specify whether supply is service or not. |
A.1.2.4 | HSN_Code | 1..1 | HSN Code | Mandatory | String (Max length: 8) | 1122 | To enter applicable HSN / SAC Code of Goods / Service |
A.1.2.5 | Batch Details | 0..1 | Optional | Refer A 1.4 | Some manufacturers may mention batch details (in Section A 1.4) | ||
A.1.2.6 | Barcode | 0..1 | Barcode | Optional | String (Max length: 30) | b123 | Barcode, if any, of the item. |
A.1.2.7 | Quantity | 0..1 | Quantity | Optional | Number (Max length: 10,3) | 10 |
The quantity of items to be mentioned in the invoice. This is mandatory only in case of goods. |
A.1.2.8 | Free_Qty | 0..1 | Free Quantity | Optional | Number (Max length: 10,3) | 99 | Quantity of item(s), if any, given free of charge (FOC) |
A.1.2.9 | Unit_Of_ Measurement | 0..1 | Unit of Measurement | Optional | String (Max length: 8) | Box | The Unit of Measurement (UOM), if any, applicable on invoiced goods. |
A.1.2.10 | Item_Price | 1..1 | Item Price | Mandatory | Number (Max length : 12,3) | 500.5 | Price per unit item |
A.1.2.11 | Gross_Amount | 1..1 | Gross Amount | Mandatory | Number (Max length : 12,2) | 5000 | The gross price of an item (cost multiplied by quantity - rounded off to 2 decimal), exclusive of taxes. |
A.1.2.12 | Item_Discount_ Amount | 0..1 | Item Discount Amount | Optional | Number (Max length: 12,2) | 10.25 | Discount amount, if any, for the item. |
A.1.2.13 | Pre_Tax_Value | 0..1 | Pre-Tax Value | Optional | Number (Max length: 12,2) | 99.00 |
If pre-tax value is different from taxable value, mention the pre-tax value and taxable values separately. In some cases, the pre-tax value may be different from taxable value. For example, where old goods are exchanged for new ones (e.g. new phone supplied for INR 20,000 along with exchange of old phone, then pre-tax value would be INR 20,000 and taxable value would be INR 24,000, assuming exchange value of old phone is 4,000. Another example is in the case of real estate where pre-tax value may be different from taxable value. |
A.1.2.14 | Item_Taxable_ Value | 1..1 | Item Taxable Value | Mandatory | Number (Max length: 12,2) | 5000 | This is the value on which tax is computed. Value cannot be negative. |
A.1.2.15 | GST_Rate | 1..1 | GST Rate | Mandatory | Number (Max length: 3,3) | 5 | The GST rate, represented as percentage that applies to the invoiced item. It will be IGST rate or sum of CGST & SGST Rates. |
A.1.2.16 | IGST_Amt | 0..1 | IGST Amount | Optional | Number (Max Length: 12,2) | 999.45 | Amount of IGST payable per item (rounded off to 2 decimals). If IGST is reported, then CGST & SGST/UTGST will be blank. For taxable supplies, either IGST or CGST &SGST/UTGST should be reported. |
A.1.2.17 | CGST_Amt | 0..1 | CGST Amount | Optional | Number (Max Length: 12,2) | 650.00 |
Amount of CGST payable per item (rounded off to 2 decimals). If CGST is reported, then SGST/UTGST has to be reported and IGST will be blank. |
A.1.2.18 | SGST_UTGST Amt | 0..1 | SGST/UTGST Amount | Optional | Number (Max length: 12,2) | 650.00 |
Amount of SGST/UTGST payable per item(rounded off to 2 decimals). If SGST/UTGST is reported, then CGST must be reported and IGST will be blank. |
A1.2.19 | Comp_Cess_Rate _Ad_valorem | 0..1 | Compensation Cess Rate, Ad_Valorem | Optional | Number (Max length: 3,3) | 2.5% | Ad valorem Rate of GST Compensation Cess, applicable, if any |
A1.2.20 | Comp_Cess_Amt _ Ad_Valorem | 0..1 | Compensation Cess Amount, Ad Valorem | Optional | Number (Max length: 12,2) | 56.00 | GST Compensation Cess amount, ad valorem (rounded off to 2 decimals) (based on value of the item) |
A1.2.21 | Comp_Cess_Amt _Non_Ad_ Valorem | 0..1 | Compensation Cess Amount, Non ad valorem | Optional | Number (Max length:12,2) | 23.00 | GST Compensation Cess amount, computed on the basis other than value of item (i.e. specific cess amount computed based on quantity, number etc.) |
A1.2.22 | State_Cess_Rate _ad_valorem | 0..1 | State Cess Rate, Ad Valorem | Optional | Number (Max length: 3,3) | 1.5 % | Ad valorem Rate of State/UT Cess, applicable, if any |
A1.2.23 | State_Cess_Amt _Ad_Valorem | 0..1 | State Cess Amount, ad valorem | Optional | Number (Max length: 12,2) | 43.00 | State/UT Cess amount, ad valorem (based on value of the item) |
A1.2.24 | State_Cess_Amt _Non_Ad_ Valorem | 0..1 | State Cess Amount, non ad valorem | Optional | Number (Max length: 12,2) | 12.00 | State/UT Cess amount, computed on the basis other than value of item (i.e. specific cess amount computed based on quantity, number etc.) |
A.1.2.25 | Other_Charges_ Item_Level | 0..1 | Other Charges (item level) | Optional | Number (Max length: 12,2) | 874.95 |
Any other charges applicable at item level. These may not be part of taxable value, e.g. in case of pure agent reimbursement. |
A.1.2.26 | Purchase_Order_ Line_Reference | 0..1 | Purchase Order Line Reference | Optional | String (Max length: 50) | 746/ABC/01 | Reference of Purchase Order Line |
A.1.2.27 | Item_Total_Amt | 0..1 | Item Total Amount | Mandatory | Number (Max length: 12,2) | 5000 |
The item total value that includes all taxes, cesses, as well as other charges. However, this value excludes discount, if any. |
A.1.2.28 | Origin_Country_ Code | 0..1 | Code of Country of Origin | Optional | Enumerated List | DZ |
This is to specify country of origin of the item, e.g. mobile phone sold in India could be manufactured in other country; Code of country of export as per ISO 3166-1 alpha-2 / Indian Customs EDI system (ICES). List published and updated from time to time at https://www.icegate.gov.in/Webap pl/COUNTRY_ENQ |
A.1.2.29 | Unique_Serial_ Number | 0..1 | Unique Serial Number | Optional | String (Max length: 20) | 553 | Serial number, in case of each item having a unique number. |
A.1.2.30 | Product_ Attribute_Details | 0..n | Optional | Refer A 1.5 | Attribute details of product | ||
A 1.3 | Document Total Details | 1..1 | Mandatory | Header for Annexure A 1.3: Document Total Details | |||
Sr. No. | Parameter Name | Cardinality | Description | Whether mandatory or optional | Field Specifications | Sample Value | Explanatory Notes |
A.1.3.1 | Taxable_Value_ Total | 1..1 | Total Taxable Value | Mandatory | Number (Max length: 14,2) | 768439.35 | This is the sum of the taxable values of all the items in the document. |
A.1.3.2 | IGST_Amt_Total | 0..1 | Total IGST Amount | Optional | Number (Max length : 14,2) | 265.50 |
Total IGST amount for the invoice. Appropriate taxes based on rule will be applicable. For example, either of CGST & SGST/UTGST or IGST will be mandatory. As this is conditional mandatory, it is marked as ‘optional’ |
A.1.3.3 | CGST_Am_ Total | 0..1 | Total CGST Amount | Optional | Number (Max length: 14,2) | 65.45 |
Total CGST amount for the invoice. Appropriate taxes based on rule will be applicable. For example, either of CGST & SGST/UTGST or IGST will be mandatory. As this is conditional mandatory, it is marked as ‘optional’ |
A.1.3.4 | SGST_UTGST_ Amt_Total | 0..1 | Total SGST/UTGST Amount | Optional | Number (Max length : 14,2) | 65.45 |
Total SGST/UTGST amount for the invoice. Appropriate taxes based on rule will be applicable. For example, either of CGST & SGST/UTGST or IGST will be mandatory. As it is conditional mandatory, it is marked as ‘optional’ |
A.1.3.5 | Comp_Cess_ Amt_Total | 0..1 | Total Compensation Cess Amount | Optional | Number (Max length : 14,2) | 24.95 | Total GST Compensation Cess amount for the invoice (ad valorem as well as non-ad valorem) |
A.1.3.6 | State_Cess_Amt _Total | 0..1 | Total State Cess Amount | Optional | Number (Max length : 14,2) | 5.45 | Total State cess amount for the invoice (ad valorem as well as non-ad valorem) |
A.1.3.7 | Discount_Amt_ Invoice_Level | 0..1 | Invoice Level Discount Amount | Optional | Number (Max length: 14,2) | 100.00 | This is Discount Amount, if any, applicable on total invoice value |
A.1.3.8 | Other_Charges_ Invoice_Level | 0..1 | Other Charges (Invoice Level) | Optional | Number(Max length: 14,2) | 200.00 | This is Other charges, if any, applicable on total invoice value |
A.1.3.9 | Round_Off_ Amount | 0..1 | Round Off Amount | Optional | Number (Max length: 2,2) | 31.21 | This is round off amount of total invoice value |
A.1.3.10 | Total_Invoice_ Value_INR | 1..1 | Total Invoice Value in INR | Mandatory | Number (Max length: 14,2) | 745249678.50 | The total value of invoice including taxes/GST and rounded to two decimals maximum. |
A.1.3.11 | Total_Invoice_ Value_FCNR | 0..1 | Total Invoice Value in FCNR | Optional | Number (Max length: 14,2) | $5729.65 | The total value of invoice in Additional Currency |
A.1.3.12 | Paid_Amount | 0..1 | Paid Amount | Optional | Number (Max length:14,2) | 8463.50 |
The amount, if any, which has been paid in advance. It must be rounded to maximum 2 decimals. |
A.1.3.13 | Amount_Due_ | 0..1 | Amount Due | Optional | Number (Max length:14,2) | 98789.50 | The outstanding amount due for payment. It must be rounded to maximum 2 decimals. |
A 1.4 | Batch Details | 0..1 | Optional | Header for Annexure A 1.4: Batch Details | |||
Sr. No. | Parameter Name | Cardinality | Description | Whether mandatory or optional | Field Specifications | Sample Value | Explanatory Notes |
A.1.4.1 | Batch_Number | 1..1 | Batch Number | Mandatory | String (Max Length: 20) | 673927 | Certain set of manufacturers may mention batch number details. (This field is mandatory only if this section is selected) |
A.1.4.2 | Batch_Expiry_ Date | 0..1 | Batch Expiry Date | Optional | String (DD/MM/YYYY) | 21/11/2019 | Expiry Date of the Batch, if any |
A.1.4.3 | Warranty_Date | 0..1 | Warranty Date | Optional | String (DD/MM/YYYY) | 21/11/2019 | Warranty date for the Item, if any. |
A 1.5 | Attribute Details of Item | 0..n | Optional | Header for Annexure A 1.5: Attribute Details of Item | |||
Sr. No. | Parameter Name | Cardinality | Description | Whether mandatory or optional | Field Specifications | Sample Value | Explanatory notes |
A.1.5.1 | Attribute_Name | 0..1 | Attribute Name | Optional | String (Max Length: 100) | Colour | Attribute Name of the item. |
A.1.5.2 | Attribute_Value | 0..1 | Attribute Value | Optional | String (Max Length: 100) | Red, green, etc. | Attribute Value of item.]4 |
1. Substituted (w.e.f. 1st February, 2018) vide Notification No. 3/2018 – Central tax dated 23-01-2018, for "UT"
2. Substituted vide Notification No.12/2018 – Central Tax dated 07-03-2018, for
FORM GST INV – 1
(See rule 138A)
Generation of Invoice Reference Number
IRN: | Date: | ||||||
Details of Supplier | |||||||
GSTIN | |||||||
Legal Name | |||||||
Trade name, if any | |||||||
Address | |||||||
Serial No. of Invoice | |||||||
Date of Invoice | |||||||
Details of Recipient (Billed to) | Details of Consignee (Shipped to) | ||||||
GSTIN or UIN, if available | |||||||
Name | |||||||
Address | |||||||
State (name and code) | |||||||
Type of supply – | |||||||
B to B supply | |||||||
B to C supply | |||||||
Attracts Reverse Charge | |||||||
Attracts TCS | GSTIN of operator | ||||||
Attracts TDS | GSTIN of TDS Authority | ||||||
Export | |||||||
Supplies made to SEZ | |||||||
Deemed export | |||||||
Sr. No. | Description of Goods | HS N | Qty. | Unit | Price (per unit) | Total value | Discount, if any | Taxable value | Central tax | State or 1[Union territory]1 tax | Integrated tax | Cess | ||||
Rate | Amt. | Rate | Amt. | Rate | Amt. | Rate | Amt. | |||||||||
Freight | ||||||||||||||||
Insurance | ||||||||||||||||
Packing and Forwarding Charges etc. | ||||||||||||||||
Total | ||||||||||||||||
Total Invoice Value (In figure) | ||||||||||||||||
Total Invoice Value (In Words) |
Signature
Name of the Signatory
Designation or Status”
3. Substituted vide Notification No. 02/2020 – Central Tax dated 01-01-2020 for
"2[FORM GST INV – 1
(See rule 138A)
Generation of Invoice Reference Number
IRN: |
Date: |
||||
Details of Supplier | |||||
GSTIN | |||||
Legal Name | |||||
Trade name, if any | |||||
Address | |||||
Serial No. of Invoice | |||||
Date of Invoice | |||||
Details of Recipient (Billed to) | Details of Consignee (Shipped to) | ||||
GSTIN or UIN, if available | |||||
Name | |||||
Address | |||||
State (name and code) | |||||
Type of supply – | |||||
B to B supply | |||||
B to C supply | |||||
Attracts Reverse Charge | |||||
Attracts TCS | GSTIN of operator | ||||
Attracts TDS | GSTIN of TDS Authority | ||||
Export | |||||
Supplies made to SEZ | |||||
Deemed export | |||||
Sr. No. | Description of Goods | HS N | Qty. | Unit | Price (per unit) | Total value | Discount, if any | Taxable value | Central tax | State or Union territory tax | Integrated tax | Cess | |||||
Rate | Amt. | Rate | Amt. | Rate | Amt. | Rate | Amt. | ||||||||||
Freight | |||||||||||||||||
Insurance | |||||||||||||||||
Packing and Forwarding Charges etc. | |||||||||||||||||
Total | |||||||||||||||||
Total Invoice Value (In figure) | |||||||||||||||||
Total Invoice Value (In Words) | 2]" | ||||||||||||||||
4. Substituted vide Notification No. 60/2020 – Central Tax dated 30-7-2020 for
"3[Note: Cardinality Means occurance of field in the schema. Below are the the meaning of various symbol used in this column:
0..1 : It means this item is optional and even if mentioned can not be repeated
1..1: It means that this item is mandatory and can be mentioned only once.
1..n: It means this item is mandatory and can be repeated more than once
0..n: It means this item is optional but can be repated many times. For example: Previous invoice reference is optional but if required one can mention many previous invoice reference.
FORM GST INV – 1 (See rules 48) |
|||||||||
S No |
Technical Field name | Cardi nalit y |
Small Description of the field |
Is it Mand atory on invoic e? |
Technic al Field Specific ations |
Sample Value of the field |
Explanatory Notes of the Field | ||
0 | Version | 1..1 | Version number |
Mand atory |
string(M ax length:1 0) | 1.0 | It is the version of schema. It will be used to keep track of version of Invoice specification. | ||
1 | IRN | 0..1 |
Invoice Refernce Number |
Mand atory |
string(M ax length:5 0) |
649b01ft | This will be a unique reference number for this invoice. It can be generated by application based on the Algorithm provided by E-Invoice system or can be left blank. In case this field has been left blank E-Invoice system will generate it and respond back in response to registration request. In case application send this number then e-Invoice system will validate it and after validation registered same number against this invoice. Invoice will only be valid once it has this number and it is registered on E-invoice system. | ||
2 | Invoice_type_code | 1..1 |
Code for Invoice type |
Mand atory |
string(M ax length:1 0) |
B2B/B2C/SEZWP/ SEZWOP/EXP WP/EXPWOP/DEXP /ISD/BOS/D C |
This will be the code to identify type of supply, some of the examples are mentioned. It will have also code for bill of entry, invoice and other type of documents. B2C invoice can be mentionted as type and based on that some fields will become optional. Detail JSON schema will mention these details later. | ||
3 | Invoice_Subtype_co de | 1..1 |
Sub_Code for Invoice type |
Mand atory | Drop Down | Regular / CreditNote / DebitNote |
Type of the Document Can be used as Regular for Bill of Supply and Delivery Challan etc |
||
4 | InvoiceNum | 1..1 | Invoice number | Mand atory | string(M ax length:1 6) | Sa/1/2019 | It will be as per invoice number rule mentionted in CGST/SGST rule. Rule to be checked. | ||
5 | InvoiceDate | 1..1 | Invoice Date | Mand atory |
string (DD/M M/YYYY) |
21/7/2019 | The date when the Invoice was issued. Format "DD/MM/YYYY" | ||
6 | Invoice_currency_co de | 1..1 | Currency code | Optio nal |
string(M ax length:1 6) |
USD | It depicts an additional currency in which all Invoice amounts can be given along with INR. one additional currency shall be used in the Invoice. | ||
7 | Reversecharge | 0..1 | Reverse Charge |
option al |
Charact er | Y | Is the liability payable under reverse charge | ||
8 | Delivery_or_Invo ice_Period | 0..1 | Opti onal | ||||||
9 | Invoice_Period_Star t_Date | 1..1 | Invoice period start date |
Mand atory (if this sectio n is select ed or used) |
string (DD/M M/YYYY) |
21-07-19 | |||
10 | Invoice_Period_End _Date | 1..1 | Invoice Period End date |
Mand atory (if this sectio n is select ed or used) |
string (DD/M M/YYYY) |
21-07-19 | |||
11 | Order and Sales Order Reference | 0..1 | Opti onal | ||||||
12 | Preceding Invoice Reference | 0..n | |||||||
13 | Preceeding_Invoice _Number | 1..1 | Detail of Base Invoice which is being amended by subsequent document |
Mand atory (if this sectio n is select ed or used) |
string(M ax length:1 6) |
Sa/1/2019 | This is the reference of original invoice to be provided in the case of debit and credit notes. In mere invoicing this is not required. It is required to keep future expansion of e versions of Credit notes, Debit Notes and other documents requried under GST | ||
14 | Invoice_Document_ Reference | 1.1 | Invoice reference | Optio nal | string(M ax length:2 0) | KOL01 | This reference is kept for user to provide any additional fields for eg., some branch, their user id, their employee id, sales centre reference etc. | ||
15 | Preceeding_Invoice _Date | 1..1 | Date of Invoice |
Mand atory (if this sectio n is select ed or used) |
string (DD/M M/YYYY) |
21-07-19 | |||
16 | Other References | 0..1 | |||||||
17 | Receipt_Advice_Ref erence | 0..1 | Terms reference | Optio nal | string(M ax length:20) | CREDIT30 | This reference is kept for user to provide their receipt advice details to their customer. | ||
18 | Tender_or_Lot_Refe rence | 0..1 | Lot / Batch Reference | Optio nal | string(M ax length:2 0) | TENDERJAN2020 | This reference is kept for mentioning number or detail of Lot or Tender if supplies are made under such Lot or tender | ||
19 | Contract_Reference | 0..1 |
Contract Number |
Optio nal | string(M ax length:2 0) | CONT23072019 | This reference is kept for mentioning contract number if supplies are made under any specific Contract | ||
20 | External_Reference | 0..1 | Any other reference | Optio nal | string(M ax length:2 0) | EXT23222 | An additional field for provision of any additional reference number for such supply. | ||
21 | Project_Reference | 0..1 |
Project Reference |
Optio nal | string(M ax length:2 0) | PJTCODE01 | This reference is kept for mentioning Project number if supplies are made under any specific Project | ||
22 | RefNum | 0..1 | Vendor PO Reference number | Optio nal | string(M ax length:1 6) | Vendor PO /1 | 0 | ||
23 | RefDate | 0..1 | Vendor PO Reference date | Optio nal |
string (DD/M M/YYYY) |
21-07-19 | 00-01-00 | ||
24 |
Supplier Information |
1..1 |
Man datory
|
A group of business terms providing information about the Supplier. | |||||
25 | Supplier_Legal_N ame | 1.. 1 | Supplier_Le gal_Name | Mand atory | string(M ax length:1 00) | The Institute of Charetred Accountants of India | Name as appearing in PAN of the Supplier | ||
26 | Supplier_trading_ name | 0.. 1 | Trade Name of Supplier | Optio nal | string(M ax length:1 00) | ICAI | A name by which the Supplier is known, other than Supplier name (also known as Business name). | ||
27 | Supplier_GSTIN | 1.. 1 | Gstin of the Supplier | Mand atory |
Alphanu meric with 15 characte rs |
29AADFV7589C1ZO | GSTIN of the supplier | ||
28 | Supplier_Address 1 | 1.. 1 | Supplier address1 | Mand atory | string(M ax length:1 00) | Vasanth Nagar | Address of the Supplier | ||
29 | Supplier_Address 2 | 0.. 1 | Supplier address 2 | Optio nal | string(M ax length:1 00) | Bangalore | City of the Supplier | ||
30 | Supplier_City | 1.. 1 | Supplier address 2 | Optio nal | string(M ax length:5 0) | Bangalore | City of the Supplier | ||
31 | Supplier_State | 1.. 1 | Place | Mand atory | string(M ax length:5 0) | Karnataka | State of the Supplier | ||
32 | Supplier_Pincode | 1.. 1 | Pincode | Mand atory |
string(M ax length:6 ) |
560087 | Pincode of the Supplier | ||
33 | Supplier_Phone | 0.. 1 | Phone | Optio nal | string(M ax length:1 2) | 9999999999 | Contact number of the Supplier | ||
34 | Supplier_Email | 0.. 1 | eMail id | Optio nal | string(M ax length:5 0) | Supplier@icai.com | Email id of the Supplier. | ||
35 |
Buyer Information |
1..1 |
Man dator y |
Header for Buyer information | |||||
36 | Billing_Name | 1.. 1 | Buyer Legal name | Mand atory | string(M ax length:1 00) | Adarsha | It will be legal name of buyer | ||
37 | Billing_Trade_Na me | 1.. 1 | Buyer Legal name | Mand atory | string(M ax length:1 00) | Adarsha | It will be Trade Name of buyer | ||
38 | Billing_GSTIN | 1.. 1 | GSTIN | Mand atory | string(M ax length:1 5) | 29AACCR7832C1ZD | GSTIN of the Buyer | ||
39 | Billing_POS | 1.. 1 | State code | Mand atory | String(M ax length:2) | 29 | Place of supply code of Supply | ||
40 | Billing_Address1 | 1.. 1 | Address1 | Mand atory | string(M ax length:1 00) | Address | Address of the Buyer | ||
41 | Billing_Address2 | 0.. 1 | Address2 |
option al |
string(M ax length:1 00) | Address | Address of the Buyer | ||
42 | Billing_State | 1.. 1 | Place | Mand atory | string(M ax length:5 0) | Bangalore | State of the Buyer | ||
43 | Billing_Pincode | 1.. 1 | pincode | Mand atory |
string(M ax length:6 ) |
560002 | Pincode of the Buyer | ||
44 | Billing_Phone | 0.. 1 | Phone number | Optio nal | string(M ax length:1 2) | 080 2223323 | contact number of the Buyer | ||
45 | Billing_Email | 0.. 1 | eMail id | Optio nal |
string(M ax length:5 0) |
billing@icai.com | Email id of the buyer. This should be provided to help E-Invoicing system to receive this invoice on mail. | ||
46 |
Payee Information (Seller payment information) |
0..1 | optio nal | Header for Payee Information - person to whom amount is payable. Optional for cases where payment is to be made to a person other than Supplier | |||||
47 | Payee_Name | 1.. 1 | Payee name | Mand atory | string(M ax length:1 00) | Name of the person to whom payment is to be made | |||
48 | Payee_Financial_ Account | 1..1 | Account Number | Mand atory | string(M ax length:1 8) | Account number of Payee | |||
49 | ModeofPayment | 1..1 | Payment mode | Mand atory |
string(M ax length:6 ) |
Cash/Credit/Direct Transfer | Cash/Credit/Direct Transfer | ||
50 | Financial_Institution _Branch | 1..1 |
Financial Institution Branch (IFSC Code) |
Mand atory | string(M ax length:1 1) | A group of business terms to specify Branch of Payee | |||
51 | Payment_Terms | 0..1 | Payment Terms | Optio nal | string(M ax length:5 0) | Terms of Payment with the recipient if to be provided | |||
52 | Payment_Instructio n | 0..1 | Payment Instruction | Optio nal | string(M ax length:5 0) | A group of business terms providing information about the payment. | |||
53 | Credit_Transfer | 0..1 | Optio nal | string(M ax length:5 0) | A group of business terms to specify credit transfer payments. | ||||
54 | Direct_Debit | 0..1 | Optio nal | string(M ax length:5 0) | A group of business terms to specify a direct debit. | ||||
55 | CreditDays | 0..1 | Due date of Credit | Optio nal |
Numeric (Min length:1 Max length:3 ) |
30-11-2019 | The date when the payment is due. Format "DD-MM-YYYY". | ||
56 | Delivery_Inform ation | 1..1 |
Man dator y |
A group of business terms providing information about where and when the goods and services invoiced are delivered. | |||||
57 |
DispatchFromDet ails |
1.. 1 |
DISPATCH from details |
Mand atory | Refer A 1.1 | ||||
58 | ECOM_GSTIN | 0..1 | eCommerce GSTIN | Optio nal |
string( Max length: 15) |
Mention og E commerce operator is supply is made through him | |||
59 | ECOM_POS | 0..1 | State code | Optio nal |
String( Max length: 2) |
29 | Mention og E commerce operator is supply is made through him | ||
60 | Invoice Item Details | 1..n |
Man datory |
||||||
61 | List {items} | Items | Mand atory | Refer A 1.2 | A group of business terms providing information about the goods and services invoiced. | ||||
62 | Document Total | 1..1 |
Man dator y |
||||||
63 | TotalDetails | 1..1 |
Bill TotalDetails |
Mand atory | Refer A 1.3 | 0 | |||
64 | Tax_Total | 1..1 |
Total Tax Amount |
Mand atory | Decima l (10,2) | When tax currency code is provided, two instances of the tax total must be present, but only one with tax subtotal. | |||
65 | Sum_of_Invoice_lin e_net_amount | 0..1 | Item level net amount |
option al |
Decima l (10,2) | Sum of all Invoice line net amounts in the Invoice. Must be rounded to maximum 2 decimals. | |||
66 | Sum_of_allowances _on_document_leve l | 0..1 | total discount |
option al |
Decima l (10,2) | Sum of all allowances on document level in the Invoice. Must be rounded to maximum 2 decimals. | |||
67 | Sum_of_charges_on _document_level | 0..1 | total other charges |
option al |
Decima l (10,2) | Sum of all charges on document level in the Invoice. Must be rounded to maximum 2 decimals. | |||
68 | PreTaxDetails | Break up of the tax rate at invoice level | Optio nal | Refer A 1.3 | The total amount of the Invoice without GST. Must be rounded to maximum 2 decimals. | ||||
69 | Paid_amount | 1..1 | Paid amount | Mand atory | Decima l (10,2) | The sum of amounts which have been paid in advance. Must be rounded to maximum 2 decimals. | |||
70 | Amount_due_for_p ayment | 1..1 | Payment Due | Mand atory | Decima l (10,2) | The outstanding amount that is requested to be paid. Must be rounded to maximum 2 decimals. | |||
71 |
Extra Information |
0..1 | Optio nal | ||||||
72 | Tax_Scheme | 1..1 |
GST, Excise, Custom, VAT eyc. |
Mand atory |
string( Max length: 4) |
GST,CUST, VAT etc.. | Mandatory element. Use “GST” | ||
73 | Remarks | 0..1 |
Remarks/No Te |
Optio nal |
string( Max length: 100) |
New batch Items submitted | A textual note that gives unstructured information that is relevant to the Invoice as a whole.Such as the reason for any correction or assignment note in case the invoice has been factored. | ||
74 | Additional_Supporti ng_Documents | 0..n | optio nal | ||||||
75 | Additional_Supporti ng_Documents_url | 0..1 |
Supporting document URLs |
option al |
string( Max length: 100) |
A group of business terms providing information about additional supporting documents substantiating the claims made in the Invoice. The additional supporting documents can be used for both referencing a document number which is expected to be known by the receiver, an external document (referenced by a URL) or as an embedded document, Base64 encoded (such as a time report). | |||
76 | Additional_Supporti ng_Documents | 0..1 | Supporting document in base64 format. |
option al |
string( Max length: 1000) |
A group of business terms providing information about additional supporting documents substantiating the claims made in the Invoice. The additional supporting documents can be used for both referencing a document number which is expected to be known by the receiver, an external document (referenced by a URL) or as an embedded document, Base64 encoded (such as a time report). | |||
77 | Invoice_Allowances _or_Charges | 0..1 | Total Value of allowances and charges at invoice level |
option al |
Decima l (10,2) | A group of business terms providing information about allowances or charges applicable at invoice level as sometime discount or charges may be applicable on invoice level not on line item level. | |||
78 | Eway Bill Details | 0..1 | Opti onal | ||||||
79 | Transporter ID | 1..1 |
Transporter Id |
Optio nal | Alphan umeric with 15 charact ers | 29AADFV7589C1ZO | GSTIN :: 29AMRPV8729L1Z1 | ||
80 | transMode | 1..1 | Mode of transportati on |
Road / Rail / Air / Ship |
Drop Down - Fixed |
1/2/3/4 | |||
81 | transDistance | 1..1 | Distance of transportati on | Decima l (10,2) | 20 | ||||
82 | transporterName | 0..1 |
Transporter Name |
string( Max length: 100) |
SPURTHI R | ||||
83 | transDocNo | 0..1 | Transporter Doc No | TA120; Mandatory if the mode of transport is other than by Road | |||||
84 | transDocDate | 0..1 | Transporter Doc Date |
string (DD/M M/YYY Y) |
21-07-2019 | 20/9/2017 | |||
85 | vehicleNo | 1..1 | Vehicle No | Optio nal |
string( Max length: 20) |
KA12KA1234 or KA12K1234 or KA123456 or KAR1234 | |||
86 | Signature Detials | 0..1 |
Man dator y |
||||||
87 | DSC | 1..1 |
Digital Signature of the Document |
DSC KEY Hash | an optional field since it is signed by the GSTN Portal also and data travels thry secured platform | ||||
A 1.0 ShipTo Details | 0..1 | ||||||||
S No |
Parameter Name | Description | Field Specifi cations | Sample Value | |||||
1 | ShippingTo_Name | 1..1 | ShippingTo_ Legal_Name | Mand atory |
string( Max length: 60) |
Adarsha | A group of business terms providing information about the address to which goods and services invoiced were or are delivered. | ||
1 | ShippingTo_Name | 1..1 |
ShippingTo_ Trade_Nam E |
Mand atory |
string( Max length: 60) |
Adarsha | A group of business terms providing information about the address to which goods and services invoiced were or are delivered. | ||
2 | ShippingTo_GSTIN | 1..1 | ShippingTo_ GSTIN | Mand atory |
string( Max length: 100) |
36AABCT2223L1ZF | A group of business terms providing information about the address to which goods and services invoiced were or are delivered. | ||
3 |
ShippingTo_Address 1 |
1..1 | ShippingTo_ Address1 | Mand atory |
string( Max length: 50) |
Address | A group of business terms providing information about the address to which goods and services invoiced were or are delivered. | ||
4 |
ShippingTo_Address 2 |
0..1 | ShippingTo_ Address2 | Optio nal |
string( Max length: 50) |
Address | A group of business terms providing information about the address to which goods and services invoiced were or are delivered. | ||
5 | ShippingTo_Place | 0..1 | ShippingTo_ Place | Optio nal |
string( Max length: 50) |
Bangalore | A group of business terms providing information about the address to which goods and services invoiced were or are delivered. | ||
6 | ShippingTo_Pincode | 1..1 | ShippingTo_ Pincode | Mand atory |
string( Max length: 6) |
560001 | A group of business terms providing information about the address to which goods and services invoiced were or are delivered. | ||
7 | ShippintTo_State | 1..1 | ShippintTo_ State | Mand atory |
string( Max length: 100) |
Karnataka | A group of business terms providing information about the address to which goods and services invoiced were or are delivered. | ||
8 | SubsupplyType | Supply Type | Mand atory |
String( Max length: 2) |
Supply/export/Jobwork | A group of business terms providing information about the address to which goods and services invoiced were or are delivered. | |||
9 | TransactionMode |
Transacion Mode |
Mand atory |
String( Max length: 2) |
Regula/BilTo/ShipTo | A group of business terms providing information about the address to which goods and services invoiced were or are delivered. | |||
A 1.1 DispatchFrom Details | |||||||||
S No |
Parameter Name | Description | Field Specifi cations | Sample Value | |||||
1 | Company_Name | 1..1 | Company_N ame | Mand atory |
string( Max length: 60) |
ICAI | Detail of person and address wherefrom goods are dispatched. | ||
2 | Address1 | 1..1 | Address1 | Mand atory |
string( Max length: 100) |
Vasanth Nagar | Detail of person and address wherefrom goods are dispatched. | ||
2 | Address2 | 0..1 | Address2 | Optio nal |
string( Max length: 100) |
Millers Road | Detail of person and address wherefrom goods are dispatched. | ||
3 | City | 1..1 | Place | Optio nal |
string( Max length: 100) |
Bangalore | Detail of person and address wherefrom goods are dispatched. | ||
4 | State | 1..1 | State | Mand atory |
String( Max length: 2) |
Karnataka | Detail of person and address wherefrom goods are dispatched. | ||
5 | Pincode | 1..1 | Pincode | Mand atory |
string( Max length: 6) |
560087 | Detail of person and address wherefrom goods are dispatched. | ||
A 1.2 Item Details | 1..n | ||||||||
S No |
Parameter Name | Description | Field Specifi cations | Sample Value | |||||
1 | SLNO | 1..1 |
Serial Number |
Mand atory | int | 1,2,3 | |||
2 | Item Description | 0..1 | Item description |
option al |
string( Max length: 300) |
Mobile | The identification scheme identifier of the Item classification identifier | ||
3 | ISService | 0..1 | ISService | Optio nal | Charact er | Y/N | Specify whether supply is that of Services or not | ||
4 | HSN code | 0..1 | HSN code | Optio nal |
string( Max length: 8) |
1122 | A code for classifying the item by its type or nature. | ||
5 | Batch | 0..1 | ... | Optio nal | Refer A 1.3.1 | galaxy | Batch number details are important to be mentioned for certain set of manufacturers | ||
6 | Barcode | 0..1 | ItemBarcde | Optio nal |
string( Max length: 30) |
b123 | Barcoding if to be provided need to be specified | ||
7 | Quantity | 1..1 | Quantity | Mand atory | Decima l (13,3) | 10 | The quantity of items (goods or services) that is charged in the Invoice line. | ||
8 | FreeQty | 0..1 | free quantity | Optio nal | Decima l (13,3) | 1 | Detail of any FOC item | ||
9 | UQC | 0..1 | Uom | Optio nal |
string( Max length: 8) |
Box |
The unit of measure that applies to the invoiced quantity. Codes for unit of packaging from UNECE Recommendation No. 21 can be used in accordance with the descriptions in the "Intro" section of UN/ECE Recommendation 20, Revision 11 (2015): The 2 character alphanumeric code values in UNECE Recommendation 21 shall be used. To avoid duplication with existing code values in UNECE Recommendation No. 20, each code value from UNECE Recommendation 21 shall be prefixed with an “X”, resulting in a 3 alphanumeric code when used as a unit of measure. |
||
10 | Rate | 1..1 | Item Rate per quantity | Mand atory | Decima l (10,2) | 500.5 | The number of item units to which the price applies. | ||
11 | GrossAmount | 1..1 | gross amount | Optio nal | Decima l (10,2) | 5000 | The price of an item, exclusive of GST, after subtracting item price discount. The Item net price has to be equal with the Item gross price less the Item price discount, if they are both provided. Item price can not be negative. | ||
12 | DiscountAmount | 0..1 | discount amount | Optio nal | Decima l (10,2) | The total discount subtracted from the Item gross price to calculate the Item net price. | |||
13 | PreTaxAmount | 0..1 | Pretax | Optio nal | Decima l (10,2) | 50 | This is the Value after the Tax. Ideally this would be taxable value in most cases, when ever there is a change in the assesseable value then pretax amount should be used for. | ||
14 | AssesseebleValue | 1..1 | net amount | Mand atory | Decima l (13,2) | 5000 | The unit price, exclusive of GST, before subtracting Item price discount, can not be negative | ||
15 | GST Rate | 1..1 | Rate | Mand atory |
Decima l(3,2) |
5 | The GST rate, represented as percentage that applies to the invoiced item. | ||
16 | Iamt | 0..1 |
IGST Amount as per item |
Mand atory |
Decima l(11,2) |
A group of business terms providing information about GST breakdown by different categories, rates and exemption reasons | |||
17 | Camt | 0..1 | CGST Amount as per item | Mand atory |
Decima l(11,2) |
650.00 | |||
18 | Samt | 0..1 | SGST Amount as per item | Mand atory |
Decima l(11,2) |
650.00 | |||
19 | Csamt | 0..1 | CESS Amount as per item | Optio nal |
Decima l(11,2) |
65.00 | |||
20 | StateCessAmt | 0..1 | State cess amount as per item | Optio nal |
Decima l(11,2) |
65.00 | |||
21 | OtherCharges | 0..1 | Other if any | Optio nal |
Decima l(11,2) |
A group of business terms providing information about allowances applicable to the Invoice as a whole. A group of business terms providing information about charges and taxes other than GST, applicable to the Invoice as a whole. | |||
22 | Invoice_line_net_a mount | 0..1 | Invoice line Net Amount | Optio nal |
Decima l(11,2) |
The total amount of the Invoice line. The amount is “net” without GST, i.e. inclusive of line level allowances and charges as well as other relevant taxes. Must be rounded to maximum 2 decimals. | |||
23 | Order__Line_Refere nce | 0..1 | Reference to purchase order |
option al |
String (50) | Reference of purchase order. | |||
24 | ItemTotal | 1..1 | net amount | Optio nal | Decima l (13,2) | 5000 | A group of business terms providing the monetary totals for the Invoice. | ||
25 | Origin_Country | 0..1 | Origin country of item |
option al |
String( Max length: 2) |
This is to specify item origin country like mobile phone sold in India could be manufactured in China. | |||
26 | SerialNoDetails | 0..1 | ... | Optio nal | Refer A 1.3.2 | ||||
A 1.3 Total Details | 1..1 | Mand atory | |||||||
S No |
Parameter Name | Description | Field Specifi cations | Sample Value | |||||
1 | IGSTValue | 0..1 |
IGST Amount as per invoice |
Optio nal |
Decima l(11,2) |
Appropriate taxes based on rule will be applicable. For example either of CGST& SGST or IGST will be mandatory. As there is no way to show conditional mandatory, optional has been mentionted against all taxes. | |||
2 | CGST Value | 0..1 |
CGST Amount as per invoice |
Optio nal |
Decima l(11,2) |
Taxable value as per Act to be specified | |||
3 | SGST Value | 0..1 |
SGST Amount as per invoice |
Optio nal |
Decima l(11,2) |
Taxable value as per Act to be specified | |||
4 | CESSValue | 0..1 |
cess Amount as per invoice |
Optio nal |
Decima l(11,2) |
Taxable value as per Act to be specified | |||
5 | State Cess Value | 0..1 | State cess Amount as per invoice | Optio nal |
Decima l(11,2) |
Taxable value as per Act to be specified | |||
6 | Rate | 0..1 | Tax Rate | Optio nal |
Decima l(11,2) |
Tax Rate | |||
7 | Freight | 0..1 | Charges | Optio nal |
Decima l(11,2) |
||||
8 | Insurance | 0..1 | Charges | Optio nal |
Decima l(11,2) |
||||
9 | Packaging and Forwarding | 0..1 | Charges | Optio nal |
Decima l(11,2) |
||||
10 | Other Charges | 0..1 | Pretax/post charges | Optio nal |
Decima l(11,2) |
A group of business terms providing information about allowances applicable to the Invoice as a whole. A group of business terms providing information about charges and taxes other than GST, applicable to the Invoice as a whole. | |||
11 | Roundoff | 0..1 | roundoff value | Optio nal |
Decima l(11,2) |
The amount to be added to the invoice total to round the amount to be paid. Must be rounded to maximum 2 decimals. | |||
12 | Total Invoice Value | 1..1 |
Total amount |
Mand atory |
Decima l(11,2) |
The total amount of the Invoice with GST. Must be rounded to maximum 2 decimals. |
|||
A 1.3.1 Batch Details | 1..1 | ||||||||
S No |
Parameter Name | Description | Field Specifi cations | Sample Value | |||||
1 | BatchName | 1..1 | Batch number/na me | Mand atory |
string( Max length: 20) |
Batch number details are important to be mentioned for certain set of manufacturers | |||
2 | BatchExpiry Date | 0..1 | Expiry Date |
option al |
string (DD/M M/YYY Y) |
Expiry Date of the Batch | |||
3 | WarrantyDate | 0..1 | Warranty Date | Optio nal |
string (DD/M M/YYY Y) |
Warranty Date of the ITEM | |||
A 1.3.2 Serial Number Details |
0..1 | ||||||||
S No |
Parameter Name | Description | Field Specifi cations | Sample Value | |||||
1 | SerialNumber | 1..1 |
Serial Number in case of each item having unique number |
Optio nal |
string( Max length: 15) |
0 | |||
2 | OtherDetail1 | 0..1 | other detail of serial number | Optio nal |
string( Max length: 10) |
0 | |||
3 | OtherDetail2 | 0..1 | other detail of serial number | Optio nal |
string( Max length: 10) |
0 | |||
A 1.3.3 PreTax Details | |||||||||
S No |
Parameter Name | Description | Field Specifi cations | Sample Value | |||||
1 | Pretax Particulars | Pretax ledger/parti culars | Optio nal |
string( Max length: 100) |
0 | ||||
2 | TaxOn | Pretax on gross amount or any other | Optio nal |
Decima l(11,2) |
0 | ||||
3 | Amount | Amount | Optio nal |
Decima l(11,2) |
0 | ||||
Signature
Name of the Signatory
Designation or Status]3;"