Validation Rules

Error CodeError TypeMessageReasonRsnWithError
1004VitalHeader GSTIN is required
1005VitalInvalid Token1. Token has expired 2. While calling other APIs, wrong GSTIN / User Id/ Token passed in the request header1. Token is valid for 6 hours , if it has expired, call the Auth. API again and get new token 2. Pass correct values for GSTIN, User Id and Auth Token in the request headers while calling APIs other than Auth API
1006VitalHeader User Name is required
1007VitalAuthentication failed. Pls. inform the helpdeskWrong formation of request payloadPrepare the request payload as per the API documentation
1010VitalInvalid Client-ID/Client-SecretEither the ClientId or the ClientSecret passed in the request header is wrongPass the correct ClientId and the ClientSecret
1011VitalClient Id is required
1012VitalClient Secret is required
1013VitalDecryption of password failedAuth.API is not able to decrypt the passwordUse the correct public key for encrypting the password while calling the Auth API. The public key is sent by mail while providing the access to Production environment as well as available for download from the portal under API user management. This public key is different on Sandbox and Production and it is different from the one used for verification of the signed content.Refer to the developer portal for encryption method used and sample code.
1015VitalInvalid GSTIN for this userThe GSTIN of the user who has generated the auth token is different from the GSTIN being passed in the request headerSend the correct GSTIN in the header for APIs other than Auth API
1016VitalDecryption of App Key failedAuth.API is not able to decrypt the passwordUse the correct public key for encrypting the appkey while calling the Auth API. The public key is sent by mail while providing the access to Production environment as well as available for download from the portal under API user management. This public key is different on Sandbox and Production and it is different from the one used for verification of the signed content.Refer to the developer portal for encryption method used and sample code.
1017VitalIncorrect user id/User does not existsUser id passed in request payload is incorrectPass the correct user id. If not available, please log in to the portal using the main user id (the one without ‘
1018VitalClient Id is not mapped to this userThe UserId is not mapped to the ClientId that is being sent as request headerPlease send the correct userId for the respective clientId. If using direct integration as well as through GSP or through multiple GSPs, please pass the correct set of ClientId
1019VitalIncorrect PasswordPassword is wrongUse the correct password, if forgotten, may use forgot password option in the portal
2143InvoiceInvoice does not belongs to the user GSTINUser is attempting to perform some operations on IRN which does not belong to the currently logged in userCertain operations can not be carried out on other’s IRNs such as cancel etc
2148InvoiceRequested IRN data is not availableUser is trying to do some operation on an IRN which is not available in the eInvoice systemPlease check whether IRN is correct or the operation is being carried out within permitted time duration.
2150InvoiceDuplicate IRNAttempting to register a document again which is already registered and IRN is generatedDon’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.
2154InvoiceIRN details are not foundAttempting 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.
2155InvoiceSupplier GSTIN is requiredRequest payload dos not have supplier GSTINSupplier GSTIN is mandatory
2159InvoiceInvalid value for reverse charge applicable fieldInvalid value has been sent for the attribute to pass whether reverse charge applicablePlease refer to the request JSON schema
2162InvoiceReverse Charge is not applicable for this transactionTrying to set ‘Reverse Charges applicable’ for transactions other than B2B transactionCheck the ‘Reverse Charges Applicable’ parameter as per the current type of transaction
2163InvoiceThe document date should not be future date .Attempting to set future date for the document dateCheck the document date being passed
2169InvoiceRequest for IRN is neither from supplier GSTIN or e-Commerce GSTINLogged in user GSTIN does not match with either the supplier GSTIN or eCommerce GSTINIf 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
2172InvoiceFor Intra-state transaction, IGST amount is not applicable; only CGST and SGST amounts are applicableIGST 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.
2173InvoiceYou have exceeded the limit of number of itemsUser has passed the requests payload with more number of liPlease 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
2174InvoiceFor inter-state transaction, CGST and SGST amounts are not applicable; only IGST amount is applicableCGST and SGST taxes are being passed for inter state transactionsPlease 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.
2176InvoiceHSN code(s)-{0} is invalidWrong HSN code is being passedPl 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.
2177InvoiceUnit Quantity Code(s)-{0} is/are not as per masterInvalid unit code has been passedPlease 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.
2182InvoiceTaxable value of all items is not equal to total taxable valueSum 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
2183InvoiceSGST value of all items is not equal to total SGST ValueSum of SGST amounts of all items should be equal to invoice level SGST amountPlease check the request payload for the SGST value validation.
2184InvoiceCGST value of all items must be equal to total CGST valueSum of CGST amounts of all items should be equal to invoice level CGST amountPlease check the request payload for the CGST value validation.
2185InvoiceIGST value of all items must be equal to total IGST ValueSum of IGST amounts of all items should be equal to invoice level IGST amountPlease check the request payload for the IGST value validation.
2186InvoiceCess value of all items must be equal to total Cess ValueSum of Cess amounts of all items should be equal to invoice level Cess amountPlease check the request payload for the Cess value validation.
2187InvoiceState Cess Value of all items must be equal to total State CessValueSum of State Cess amounts of all items should be equal to invoice level State Cess amountPlease check the request payload for the State Cess value validation.
2189InvoiceTotal Invoice Value is not matching with calculated valueInvoice 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.
2193InvoiceFor 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
2194InvoiceFor Sl. No {0}, Total item value does not match with taxable and tax values of that itemTotal 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.
2195Invoicee-Commerce GSTIN is not registered as TCS-GSTINThe eCommerce GSTIN passed does not belong to the type Tax CollectorPlease 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
2200InvoiceState code {0} is invalid for dispatch details or ship detailsWrong state code is passed in dispatch or ship detailsPlease refer to the state codes in the portal at Search -> Master Codes
2201InvoiceInvalid Port CodeWrong port code is passed in dispatch or ship detailsPlease refer to the port codes in the portal at Search -> Master Codes
2202InvoiceInvalid Country CodeWrong country code is passed in dispatch or ship detailsPlease refer to the country codes in the portal at Search -> Master Codes
2203InvoiceInvalid Foreign CurrencyWrong foreign currency code is passed in dispatch or ship detailsPlease refer to the foreign currency codes in the portal at Search -> Master Codes
2211InvoiceSupplier 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.
2212InvoiceThe 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.
2213InvoiceThe supplier GSTIN cannot be URPURP has been set as the Supplier GSTINSupplier GSTIN can not be URP
2227InvoiceFor Sl. No {0}, SGST and CGST amounts are not equalFor the specified item, CGST and SGST amounts are not equalCGST and SGST amounts should be same for the specified item.
2228InvoiceItem list cannot be emptyThere are no items in the item listThere should be at least one item in the item list
2231InvoiceCannot generate e-Invoice as the supplier GSTIN – {0} is SEZSEZ GSTIN user is trying to generate the eInvoiceeInvoice is not applicable for SEZ supplier
2232InvoicePOS is incorrect for {0} transactionPOS is sent other than 96 for the specified type of transactionSend Other Country code (96) for POS state code for the specified transaction type
2233InvoiceDuplicate SI numbers are not allowed in line itemsDuplicate 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.
2234InvoiceFor Sl. No {0}, SGST and CGST amount passed does not match with taxable value and tax rateWrong 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.
2235InvoiceFor Sl. No {0}, IGST amount passed is not matching with taxable value and tax rateWrong 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.
2238InvoiceFor Sl. No {0}, Quantity is not passedValue for quantity is missing for the specified item in the item listSend the quantity for the specified item
2239InvoiceFor Sl. No {0}, Unit Quantity Code (UQC) is not passedValue for unit is missing for the specified item in the item listSend the value for unit for the specified item
2240InvoiceFor Sl. No {0}, GST rate of tax is incorrect or not as notifiedWrong 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
2242InvoiceRecipient POS is incorrect for transaction type {0}For the specified type of transaction, POS passed is 96 – Other CountryFor 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
2243InvoicePOS code is invalidInvalid State code has been passed for the POSPass correct State code for POS. Please refer to the State Codes in the portal under Search -> Master Codes
2246InvoiceRecepient cannot be SEZ for – {0} transactionSEZ GSTIN has been passed as GSTIN in Recipient details for the specified type of transactionFor the specified type of transaction, GSTIN of SEZ can not be passed as GSTIN in Recipient details
2247InvoiceRecepient 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
2248InvoiceRecepient has to be URP in case of Export transactionsIn case of export, Recipient GSTIN has not been set to ‘URP’In case of export , GSTIN in Recipient details should be ‘URP’
2256InvoiceInvalid SignatureThe data is altered or improper public key is used for verification of the signed contentMake 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.
2258InvoiceSupplier GSTIN state code does not match with the state code passed in supplier detailsThe state code passed and first two digits of the GSTIN passed in the Supplier details do not matchIn the Supplier details, first two digits of the GSTIN should match the state code passed
2259InvoiceInvalid supplier state codeState code passed in the Supplier Details is incorrectPass the correct State code in the Supplier Details. For State code master, visit the portal under Search -> Master Codes
2260InvoiceThe recipient state code is invalidState code passed in the Recipient Details is incorrectPass the correct State code in the Recipient Details. For State code master, visit the portal under Search -> Master Codes
2261InvoiceThe recipient state code is incorrect for {0} transactionState code under Recipient Details is sent other than 96, for the specified type of transactionSend Other Country code (96) for State code under Recipient Details, for the specified transaction type
2262InvoiceFor Intra-state supply, IGST cannot be chargedIGSTonIntra value is set as ‘Y’ but different state codes are mentioned under Supplier Details and POSWhen 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
2265InvoiceRecipient GSTIN state code does not match with the state code passed in recipient detailsThe 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.
2266InvoiceFor Sl. No {0}, Cess amount passed does not match with the calculated valueIncorrect Cess amount is passed for the specified line itemCorrect Cess amount may be passed for the specified line item
2267InvoiceFor Sl. No {0}, State Cess amount passed is not as per calculated valueIncorrect State Cess amount is passed for the specified line itemCorrect State Cess amount may be passed for the specified line item
2268InvoiceIGST on instra state supply is not applicable to export/SEZ transactionsIGSTonIntra has been set for export and SEZ transactionsIGSTonIntra value can not be ‘Y’ for export and SEZ transactions
2270InvoiceThe allowed cancellation time limit is crossed, you cannot cancel the IRNAttempted to cancel the IRN after the time limitIRN can be cancelled only within the time limit
2271InvoiceSHIP TO – state code is not valid statecode for B2B, SEZ and Deemed Export transactionsInvalid State code is passed under Ship To details for B2B, SEZ and Deemed export transactionCorrect 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
2272InvoiceSHIP TO – PIN code cannot be 999999 for B2B, SEZ and Deemed Export transactionsPIN code under ShipTo Details has been passed as 999999 for B2B, SEZ and Deemed Export transactionsCorrect 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
2273InvoiceDispatch from PIN code cannot be 999999PIN code under Dispatch From Details has been passed as 999999 for B2B, SEZ and Deemed Export transactionsCorrect 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
2274InvoiceRecipient PIN code cannot be 999999 for {0} transaction.PIN code under Recipient Details has been passed as 999999 for specified type of transactionsCorrect 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
2275InvoiceRecipient PIN code should be 999999 for Direct ExportPIN code under Recipient Details has been passed as other than 999999 for specified type of transactions999999 as PIN code should be passed under Recipient Details for specified type of transactions.
2276InvoiceSupplier PIN code cannot be 999999PIN code under Supplier Details has been passed as 999999Correct PIN code should be passed under Supplier Details. For valid PIN codes, may visit the portal under Search -> Master Codes
2277InvoiceE-Commerce Opertaor has to pass supplier GSTIN in header to cancel the IRNin header, supplier GSTIN is missing while eCommerce operator is cancelling the IRNWhile eCommerce operator is cancelling the IRN, Supplier GSTIN should be passed in the request header
2278InvoiceIRN is already generated and is cancelled for this Document number. The duplicate IRN cannot be generated for the same number.
2279InvoiceInvalid schema version
2280InvoiceInvalid document type
2283InvoiceIRN details cannot be provided as it is generated more than {0} days prior
2284InvoiceIRN cannot be generated for the document date which is prior to {0}
2285InvoiceInvalid value for IGST on intra field
2288InvoiceInvalid Recipient GSTIN
2291InvoiceInvalid Supplier GSTIN
2294InvoiceReverse charge is mandatory if IGST on intra is applicable
2295InvoiceIRN is already generated and registered with GSTN Lookup Portal by other IRP
2297InvoiceReverse charge supply is not allowed for ISD recipients
2298InvoiceRecipient cannot be composition/UIN taxpayer for Deemed Exports
2299InvoiceE-Commerce Operator GSTIN field should be empty when Tax Payer generates e-Invoice
2300InvoiceSupplier GSTIN should be of type Regular or SED
2301InvoiceE-Commerce Operator GSTIN field should not be empty when e-Commerce operator generates e-Invoice
2305InvoiceIRN cannot be generated with document date prior to 7 days from today for suppliers with turnover above <TP Turnover slab>
9999InvoiceInvoice is not active
3026InvoiceE-Invoice Options are not enabled for this GSTIN -{0}
3038Invoice{0} details Details:Pincode-{1} does not exists
3039InvoicePincode -{1} of {0} does not belong to his/her State – {2}
3047InvoiceThe HSN – {0} does not belong to Goods
3048InvoiceThe HSN – {0} does not belong to Service
3074InvoiceGSTIN – {0} is cancelled and document date – {1} is later than de-registration date
3075InvoiceGSTIN- {0} is cancelled and de-registration date is not available
3076InvoiceGSTIN – {0} is inactive
3077InvoiceGSTIN – {0} is cancelled and document date – {1} is earlier than registration date
3078InvoiceGSTIN- {0} is cancelled and registration date is not available
3079InvoiceFor active GSTINs the document date should not be earlier than registration date