Irn Errors

Error Code Error Messege Reason for Error Resolution
2140 Error while validating invoice The request JSON payload is not as per the currently used eInvoice request schema Please refer to the API developer portal for details https://einv-apisandbox.nic.in
2141 Error while cancelling invoice Some unexpected error has occurred while cancelling the eInvoice Please check the request payload and header and try again. If issue is unresolved, contact helpdesk with complete details of the request.
2142 Incomplete request parameters
2143 Invoice does not belongs to the user GSTIN User is attempting to perform some operations on IRN which does not belong to the currently logged in user Certain operations can not be carried out on other’s IRNs such as cancel etc
2146 Unable to create IRN, Pls. try after some time Due to some unexpected scenario, IRN could not be generated at the moment Please try after some time. If issue persists, contact helpdesk with complete details of the issue
2147 Unable to sign invoice, Pl try after some time Some unexpected error has occurred while signing the Invoice Please try after some time. If issue persists, contact helpdesk with complete details of the issue
2148 Requested IRN data is not available User is trying to do some operation on an IRN which is not available in the eInvoice system Please check whether IRN is correct or the operation is being carried out within permitted time duration.
2150 Duplicate IRN Attempting to register a document again which is already registered and IRN is generated Don't fire the same request siimultaneously. This results in one request giving the error as 'Duplicate IRN request'. Best way to avoid firing of IRN request repeatedly for the same request, is update in your system with IRN number when the response comes back. Next time check the IRN, if it is not there, then fire for IRN.
2154 IRN details are not found Attempting to register a document again which is already registered and IRN is generated. Don't fire the same request simultaneously. This results in one request giving the error as 'Duplicate IRN request'. Best way to avoid firing of IRN request repeatedly for the same request, is update in your system with IRN number when the response comes back. Next time check the IRN, if it is not there, then fire for IRN.
2155 Supplier GSTIN is required Request payload dos not have supplier GSTIN Supplier GSTIN is mandatory
2156 Invalid format - fromDate(The correct format is dd/MM/yyyy) User is passing wrong date format for fromDate Date format should be in dd/MM/yyyy. Please refer to the request JSON schema
2157 Invalid format - toDate (The correct format is dd/MM/yyyy) User is passing wrong date format for toDate Date format should be in dd/MM/yyyy. Please refer to the request JSON schema
2159 Invalid value for reverse charge applicable field Invalid value has been sent for the attribute to pass whether reverse charge applicable Please refer to the request JSON schema
2162 Reverse Charge is not applicable for this transaction Trying to set ‘Reverse Charges applicable’ for transactions other than B2B transaction Check the ‘Reverse Charges Applicable’ parameter as per the current type of transaction
2163 The document date should not be future date . Attempting to set future date for the document date Check the document date being passed
2169 Request for IRN is neither from supplier GSTIN or e-Commerce GSTIN Logged in user GSTIN does not match with either the supplier GSTIN or eCommerce GSTIN If a supplier is registering the Invoice, GSTIN passed in the request header should match with the supplier GSTIN. If an eCommerce operator is registering the Invoice, GSTIN in header should match with the eCommerce operator’s GSTIN in the request payload
2172 For Intra-state transaction, IGST amount is not applicable; only CGST and SGST amounts are applicable IGST amount is being passed for Intra State transaction where as CGST and SGST are applicable. Please check the applicable taxes for current transaction. If the State code of Point of Supply (POS) of recipient is same is state code of Supplier, then CSGT and SGST applies. However, under exception circumstances as per rule if IGST is applicable for intrastate transaction, then pass the ‘IGST_on_IntraState_Supply’ flag as ‘Y’ with IGST value so that system can process your request.
2173 You have exceeded the limit of number of items User has passed the requests payload with more number of li Please check the number of line items being passed. Please refer to the specific API for large number of items. If limit for that API is also exceeded, contact helpdesk with invoice details
2174 For inter-state transaction, CGST and SGST amounts are not applicable; only IGST amount is applicable CGST and SGST taxes are being passed for inter state transactions Please check the applicable taxes for current transaction. If the State code of Point of Supply (POS) of recipient is different than the state code of Supplier, then IGST applies. Pl check the details.
2176 HSN code(s)-{0} is invalid Wrong HSN code is being passed Pl check the HSN code being passed and Cross-check the correctness of HSN code on e-invoice portal. Still, if you feel it is correct, then please send the details to the helpdesk for verification at e-invoice system side.
2177 Unit Quantity Code(s)-{0} is/are not as per master Invalid unit code has been passed Please pass the correct unit code as per the master provided for e-invoice. Check the correct unit code in the portal under Search -> Master codes. If the unit code is not matching with your required unit, you may have to convert unit to one existing in the master list of unit code.
2182 Taxable value of all items is not equal to total taxable value Sum of taxable amounts of all items should be equal to invoice level taxable amount. Please check the request payload for the taxable value validation. Total Taxable Value = Taxable value of all line items
2183 SGST value of all items is not equal to total SGST Value Sum of SGST amounts of all items should be equal to invoice level SGST amount Please check the request payload for the SGST value validation.
2184 CGST value of all items must be equal to total CGST value Sum of CGST amounts of all items should be equal to invoice level CGST amount Please check the request payload for the CGST value validation.
2185 IGST value of all items must be equal to total IGST Value Sum of IGST amounts of all items should be equal to invoice level IGST amount Please check the request payload for the IGST value validation.
2186 Cess value of all items must be equal to total Cess Value Sum of Cess amounts of all items should be equal to invoice level Cess amount Please check the request payload for the Cess value validation.
2187 State Cess Value of all items must be equal to total State CessValue Sum of State Cess amounts of all items should be equal to invoice level State Cess amount Please check the request payload for the State Cess value validation.
2189 Total Invoice Value is not matching with calculated value Invoice level total value has not been calculated as per the passed values. Invoice level total value is equal to totals of all the total item value plus other charges minus discount with tolerance limit of +/- One. Pl refer to the validations in sandbox portal.
2192 TotAmt value should be equal to (Qty * UnitPrice) for HSN {0} Total amount for the specified item is incorrect Item level total amount should be the product of quantity and unit price
2193 For Sl. No. {0}, Taxable Value (AssAmt) value is not equal to (TotAmt - Discount) Incorrect assessable amount is passed for the specified item. For the specific item, assessable amount should be arrived at by deducting discount from total amount
2194 For Sl. No {0}, Total item value does not match with taxable and tax values of that item Total item value passed is incorrect. Total item value should be sum of assessable value, all tax and cess values, other charges with tolerance limit of +/- One. Please refer to the validations in the portal.
2195 e-Commerce GSTIN is not registered as TCS-GSTIN The eCommerce GSTIN passed does not belong to the type Tax Collector Please check the GSTIN type at the common portal. If it is TCS in common portal still it is showing the error, contact the helpdesk with GSTIN details
2200 State code {0} is invalid for dispatch details or ship details Wrong state code is passed in dispatch or ship details Please refer to the state codes in the portal at Search -> Master Codes
2201 Invalid Port Code Wrong port code is passed in dispatch or ship details Please refer to the port codes in the portal at Search -> Master Codes
2202 Invalid Country Code Wrong country code is passed in dispatch or ship details Please refer to the country codes in the portal at Search -> Master Codes
2203 Invalid Foreign Currency Wrong foreign currency code is passed in dispatch or ship details Please refer to the foreign currency codes in the portal at Search -> Master Codes
2211 Supplier and recipient GSTIN should not be the same. Same GSTIN has been passed for Supplier and Buyer GSTIN. Self generated Invoice are not allowed for e-invoice generation.
2212 The recipient GSTIN cannot be URP for supply type {0} Un Registered Person (URP) is passed wrongly for B2B type of transaction. For this type of transaction, actual GSTIN needs to be passed.
2213 The supplier GSTIN cannot be URP URP has been set as the Supplier GSTIN Supplier GSTIN can not be URP
2218 The date must be lesser or equal to todays date (or) please check the date format Date is passed which is not in the expected range Date passed should be of today or yesterday
2219 The from date should be equal or earlier than the to date From date is set as future date From date can not be future date
2225 Incorrect date format in document details Document date format is wrong Provide the document date in the format dd/MM/yyyy
2226 You are not authorised to get IRN data User is trying to get IRN details which he is not supposed to
2227 For Sl. No {0}, SGST and CGST amounts are not equal For the specified item, CGST and SGST amounts are not equal CGST and SGST amounts should be same for the specified item.
2228 Item list cannot be empty There are no items in the item list There should be at least one item in the item list
2230 This IRN cannot be cancelled because e-way bill has been generated , you can cancel e-way bill and then try cancelling IRN User has tempted to cancel an IRN which has an active E Way Bill IRN can not be cancelled unless the associated E Way Bill is cancelled. Cancel the E Way Bill first and then cancel the IRN
2231 Cannot generate e-Invoice as the supplier GSTIN - {0} is SEZ SEZ GSTIN user is trying to generate the eInvoice eInvoice is not applicable for SEZ supplier
2232 POS is incorrect for {0} transaction POS is sent other than 96 for the specified type of transaction Send Other Country code (96) for POS state code for the specified transaction type
2233 Duplicate SI numbers are not allowed in line items Duplicate serial number for the items has been sent in the item list. The serial number of the items in the item list should be unique in an invoice.
2234 For Sl. No {0}, SGST and CGST amount passed does not match with taxable value and tax rate Wrong SGST and CGST amounts are passed for the specified item in the item list. Correct values for the SGST and CGST amounts have to be passed. SGST and CGST values should be equal to [taxable value X tax rate / 2] for that line item with tolerance limit of +/- One.
2235 For Sl. No {0}, IGST amount passed is not matching with taxable value and tax rate Wrong IGST amount is passed for the specified item in the item list. Correct value for the IGST amount has to be passed. IGST value should be equal to [taxable value X tax rate] for that line item with tolerance limit of +/- One.
2238 For Sl. No {0}, Quantity is not passed Value for quantity is missing for the specified item in the item list Send the quantity for the specified item
2239 For Sl. No {0}, Unit Quantity Code (UQC) is not passed Value for unit is missing for the specified item in the item list Send the value for unit for the specified item
2240 For Sl. No {0}, GST rate of tax is incorrect or not as notified Wrong GST rate is passed for the specified item in the item list. Correct value for the GST rate has to be passed. Standard tax Rates are 0, 0.5, 1, 2, 3, 5, 12, 18, 28
2242 Recipient POS is incorrect for transaction type {0} For the specified type of transaction, POS passed is 96 – Other Country For the specified transaction type, POS can not be 96, pass a valid state code. Please refer to the State Codes in the portal under Search -> Master Codes
2243 POS code is invalid Invalid State code has been passed for the POS Pass correct State code for POS. Please refer to the State Codes in the portal under Search -> Master Codes
2244 Recipient pincode is not provided for the transaction - {0} Recipient PIN code is missing for the specified transaction type. For the specified type of transaction, PIN code is mandatory under Recipient details.
2246 Recepient cannot be SEZ for - {0} transaction SEZ GSTIN has been passed as GSTIN in Recipient details for the specified type of transaction For the specified type of transaction, GSTIN of SEZ can not be passed as GSTIN in Recipient details
2247 Recepient should be SEZ for transaction {0} Non SEZ GSTIN has been passed as the GSTIN in Recipient details for the given type of transaction. For the given type of transaction GSTIN in Recipient details should be of SEZ
2248 Recepient has to be URP in case of Export transactions In case of export, Recipient GSTIN has not been set to ‘URP’ In case of export , GSTIN in Recipient details should be ‘URP’
2255 Requested Payload is empty Empty payload is received Pass proper payload in the request
2256 Invalid Signature The data is altered or improper public key is used for verification of the signed content Make sure that the correct public key is used for verification of the signed content. The public keys are available for download from the portal, which are used in specific time periods.
2257 Invalid Credentials for respective IRN
2258 Supplier GSTIN state codedoes not match with the state code passed in supplier details The state code passed and first two digits of the GSTIN passed in the Supplier details do not match In the Supplier details, first two digits of the GSTIN should match the state code passed
2259 Invalid supplier state code State code passed in the Supplier Details is incorrect Pass the correct State code in the Supplier Details. For State code master, visit the portal under Search -> Master Codes
2260 The recipient state code is invalid State code passed in the Recipient Details is incorrect Pass the correct State code in the Recipient Details. For State code master, visit the portal under Search -> Master Codes
2261 The recipient state code is incorrect for {0} transaction State code under Recipient Details is sent other than 96, for the specified type of transaction Send Other Country code (96) for State code under Recipient Details, for the specified transaction type
2262 For Intra-state supply, IGST cannot be charged IGSTonIntra value is set as ‘Y’ but different state codes are mentioned under Supplier Details and POS When IGSTonIntra value is set as ‘Y’, it should be an intra state transaction and hence State code under Supplier Details should be same as POS under Recipient Details
2265 Recipient GSTIN state code does not match with the state code passed in recipient details The state code passed and first two digits of the GSTIN passed in the Recipient details do not match. In the Recipient details, first two digits of the GSTIN should match the state code passed.
2266 For Sl. No {0}, Cess amount passed does not match with the calculated value Incorrect Cess amount is passed for the specified line item Correct Cess amount may be passed for the specified line item
2267 For Sl. No {0}, State Cess amount passed is not as per calculated value Incorrect State Cess amount is passed for the specified line item Correct State Cess amount may be passed for the specified line item
2268 IGST on instra state supply is not applicable to export/SEZ transactions IGSTonIntra has been set for export and SEZ transactions IGSTonIntra value can not be ‘Y’ for export and SEZ transactions
2269 Recipient state code is incorrect for transaction type {0} For the specified type of transaction, State code in Recipient Details passed is 96 – Other Country For the specified transaction type, State code passed in Recipient details can not be 96, pass a valid state code. Please refer to the State Codes in the portal under Search -> Master Codes
2270 The allowed cancellation time limit is crossed, you cannot cancel the IRN Attempted to cancel the IRN after the time limit IRN can be cancelled only within the time limit
2271 SHIP TO - state code is not valid statecode for B2B, SEZ and Deemed Export transactions Invalid State code is passed under Ship To details for B2B, SEZ and Deemed export transaction Correct state code should be passed under Ship To Details for B2B, SEZ and Deemed export transactions. For valid State codes, may visit the portal under Search -> Master Codes
2272 SHIP TO - PIN code cannot be 999999 for B2B, SEZ and Deemed Export transactions PIN code under ShipTo Details has been passed as 999999 for B2B, SEZ and Deemed Export transactions Correct PIN code should be passed under Ship To Details for B2B, SEZ and Deemed export transactions. For valid PIN codes, may visit the portal under Search -> Master Codes
2273 Dispatch from PIN code cannot be 999999 PIN code under Dispatch From Details has been passed as 999999 for B2B, SEZ and Deemed Export transactions Correct PIN code should be passed under Dispatch From Details for B2B, SEZ and Deemed export transactions. For valid PIN codes, may visit the portal under Search -> Master Codes
2274 Recipient PIN code cannot be 999999 for {0} transaction. PIN code under Recipient Details has been passed as 999999 for specified type of transactions Correct PIN code should be passed under Recipient Details for specified type of transactions. For valid PIN codes, may visit the portal under Search -> Master Codes
2275 Recipient PIN code should be 999999 for Direct Export PIN code under Recipient Details has been passed as other than 999999 for specified type of transactions 999999 as PIN code should be passed under Recipient Details for specified type of transactions.
2276 Supplier PIN code cannot be 999999 PIN code under Supplier Details has been passed as 999999 Correct PIN code should be passed under Supplier Details. For valid PIN codes, may visit the portal under Search -> Master Codes
2277 E-Commerce Opertaor has to pass supplier GSTIN in header to cancel the IRN in header, supplier GSTIN is missing while eCommerce operator is cancelling the IRN While eCommerce operator is cancelling the IRN, Supplier GSTIN should be passed in the request header
2278 IRN is already generated and is cancelled for this Document number. The duplicate IRN cannot be generated for the same number.
2279 Invalid schema version
2280 Invalid document type
2281 Inavalid document number
2282 Invalid document date format
2283 IRN details cannot be provided as it is generated more than {0} days prior
2284 IRN cannot be generated for the document date which is prior to {0}
2285 Invalid value for IGST on intra field
2286 Cannot generate the ewaybill for cancelled IRN
2287 Ewaybill already exists for the given IRN
2288 Invalid Recipient GSTIN
2289 Invalid IRN Generated Date
2290 Invalid Total Invoice Value
2291 Invalid Supplier GSTIN
2292 Invalid document date
2293 Invalid date format -(The correct format is dd/MM/yyyy)
2294 Reverse charge is mandatory if IGST on intra is applicable
2297 Reverse charge supply is not allowed for ISD recipients
2298 Recipient cannot be composition/UIN taxpayer for Deemed Exports
3026 E-Invoice Options are not enabled for this GSTIN -{0}
3028 GSTIN -{0} is invalid. Recipient GSTIN is invalid or does not exist in e-invoice system Check the correctness of the GSTIN. If you are sure that it is valid, Pl use the 'Sync GSTIN from GST CP' API to get it pulled from the GST Portal. If it is available in GST portal, it will return you with the details. If you get the details, then you can re-fire your request to generate the IRN. If you are not able to verify through API, you can go to einvocie1.gst.gov.in portal and use the 'Tax Payer / GSTIN' option in search menu to check the status manually from GST Portal and use 'Update' button to get it updated from GST Common Portal. If you are satisfied with result, you can re-fire the request.
3029 GSTIN -{0} is inactive or cancelled
3038 {0} details Details:Pincode-{1} does not exists
3039 Pincode -{1} of {0} does not belong to his/her State - {2}
3040 Buyer or Ship Details:Pincode - {0} does not exists
3041 Buyer or Ship Details:Pincode -{0} does not belong to the state-{1}
3047 The HSN - {0} does not belong to Goods
3048 The HSN - {0} does not belong to Service
3074 GSTIN - {0} is cancelled and document date - {1} is later than DRegistration Date
3075 GSTIN- {0} is cancelled and DRegistration Date is not available
3076 GSTIN - {0} is inactive
3077 GSTIN - {0} is cancelled and document date - {1} is earlier than registration date
3078 GSTIN- {0} is cancelled and registration date is not available
3079 For active GSTINs the document date should not be earlier than registration date
SYS_5001 Application error, issue with application while processing the request. Please try again. If error persists kindly raise a ticket along with request JSON, error details and timestamp of the error occurrence.