TMI BlogGeneration of Invoice Reference NumberX X X X Extracts X X X X X X X X Extracts X X X X ..... atory 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 Li ..... X X X X Extracts X X X X X X X X Extracts X X X X ..... 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 menti ..... X X X X Extracts X X X X X X X X Extracts X X X X ..... 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, ..... X X X X Extracts X X X X X X X X Extracts X X X X ..... ring (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. ..... X X X X Extracts X X X X X X X X Extracts X X X X ..... nal 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) 29A ..... X X X X Extracts X X X X X X X X Extracts X X X X ..... om 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 ..... X X X X Extracts X X X X X X X X Extracts X X X X ..... datory 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 manda ..... X X X X Extracts X X X X X X X X Extracts X X X X ..... ing (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 good ..... X X X X Extracts X X X X X X X X Extracts X X X X ..... ith 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 ..... X X X X Extracts X X X X X X X X Extracts X X X X ..... d 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 ..... X X X X Extracts X X X X X X X X Extracts X X X X ..... r 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 Attribut ..... X X X X Extracts X X X X X X X X Extracts X X X X ..... tituted vide NOTIFICATION No. 60/2020-Central Tax dated 30-7-2020 before it was read as "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 ..... X X X X Extracts X X X X X X X X Extracts X X X X ..... nd 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 Con ..... X X X X Extracts X X X X X X X X Extracts X X X X ..... ength: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 informatio ..... X X X X Extracts X X X X X X X X Extracts X X X X ..... l 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 ..... X X X X Extracts X X X X X X X X Extracts X X X X ..... 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. ..... X X X X Extracts X X X X X X X X Extracts X X X X ..... ing( 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( M ..... X X X X Extracts X X X X X X X X Extracts X X X X ..... he 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. ..... X X X X Extracts X X X X X X X X Extracts X X X X
|