Vital Errors

Error Code Error Messege Reason for Error Resolution
1004 Header GSTIN is required
1005 Invalid Token 1. Token has expired 2. While calling other APIs, wrong GSTIN / User Id/ Token passed in the request header 1. 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
1006 User Name is required
1007 Authentication failed. Pls. inform the helpdesk Wrong formation of request payload Prepare the request payload as per the API documentation
1008 Invalid login credentials Either UserId or Password are wrong Pass the correct UserId and Password
1010 Invalid Client-ID/Client-Secret Either the ClientId or the ClientSecret passed in the request header is wrong Pass the correct ClientId and the ClientSecret
1011 Client Id is required
1012 Client Secret is required
1013 Decryption of password failed Auth.API is not able to decrypt the password Use 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.
1014 Inactive User Status of the GSTIN is inactive or not enabled for E Invoice Please verify whether the GSTIN is active and enabled for E Invoice from the E Invoice portal
1015 Invalid GSTIN for this user The GSTIN of the user who has generated the auth token is different from the GSTIN being passed in the request header Send the correct GSTIN in the header for APIs other than Auth API
1016 Decryption of App Key failed Auth.API is not able to decrypt the password Use 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.
1017 Incorrect user id/User does not exists User id passed in request payload is incorrect Pass the correct user id. If not available, please log in to the portal using the main user id (the one without '
1018 Client Id is not mapped to this user The UserId is not mapped to the ClientId that is being sent as request header Please 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
1019 Incorrect Password Password is wrong Use the correct password, if forgotten, may use forgot password option in the portal
3001 Requested data is not available
3002 Invalid login credentials
3003 Password should contains atleast one upper case, one lower case, one number and one special characters like [%,$,#,@,_,!,*] Password being set is very simple Password should contains atleast one upper case, one lower case, one number and one special characters like [%,$,
3004 This username is already registered. Please choose a different username. User id is already available in the system Use a different user id
3005 Requested data is not found
3006 Invalid Mobile Number The Mobile number provided is incorrect Provide the correct mobile number, Incase the number has changed, may update it in GSTN Common Portal and try after some time. If issue still persists, contact helpdesk with complete details of the issue.
3007 You have exceeded the limit of creating sub-users The number of sub user creation limit is exceeded Up to 10 subusers for each of the main GSTIN and additional places of business can be created
3008 Sub user exists for this user id There is already a subuser with the same user id is already created Use a different user id for the sub user creation
3009 Pls provide the required parameter or payload
3010 The suffix login id should contain 4 or lesser than 4 characters
3011 Data not Found
3012 Mobile No. is blank for this GSTIN ..Pl use update from GST Common Portal option to get the mobile number, if updated in GST Common Portal. The GSTIN master data does not have mobile number in eInvoice System Please get the mobile number updated at the GSTN common portal
3013 Your registration under GST has been cancelled , however if you are a transporter then use the Enrollment option.
3014 Gstin Not Allowed
3015 Sorry, your GSTIN is deregistered in GST Common Portal Attempting to use a GSTIN which is cancelled Please check the status of the GSTIN on the GSTN common portal. If it is active, contact the helpdesk with GSTIN details
3016 Your registration under GST is inactive and hence you cannot register, however if you are a transporter then use the Enrollment option.
3017 You were given provisional ID which was not activated till the last date. Hence your details are not available with GST portal. However if you are a transporter then use the Enrollment option.
3019 subuser details are not saved please try again
3020 Internal Server Error pls try after sometime
3021 There are no subusers for this gstin Some user action has failed due to internal server issue or unexpected user data Try after some time, if issue still persists, report to helpdesk with complete details of the issue
3022 The Given Details Already Exists
3023 The New PassWord And Old PassWord Cannot Be Same While changing the password, new password can not be same as old password The New and Ols password should be different while changing the password
3024 Change of password unsuccessfull,pls check the existing password Password could not be changed since the current password provided is incorrect Provide the correct current password while changing the password
3025 Already This Account Has Been Freezed Trying to freeze an account which is already frozen You can freeze only active account
3027 You are already registered Pl. use already created username and password to login to the system.If you have forgotten username or password,then use Forgot Username or Forgot Passowrd options to get the username and password!!" Attempting to create another account which is already created Use forgot password option to retrieve the user name or password in case currently not available
3029 GSTIN is inactive or cancelled GSTIN is inactive or cancelled by department or tax payer . Check the correctness of the GSTIN and its status. If you are sure that it is active, Pl use the 'Sync GSTIN from GST CP' API to get it verified from the GST Portal. If it is active at GST portal, it will return you with the new status. If you get the status as 'Active', 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 required. If you are satisfied with result, you can re-fire the request.
3030 Invalid Gstin GSTIN provided is incorrect Provide the correct GSTIN
3031 Invalid User Name Attempting to login with wrong user id Use the correct user id
3032 Enrolled Transporter cannot login to e-Invoice Portal. You need to be GST registered. For more clarifications , please read the FAQs under Web Login section . The user who is not registered with GSTN but enrolled as transporter in E Way Bill portal is trying to login to eInvoice system This is not allowed
3033 Your account has been Freezed as GSTIN is inactive User is trying to login with an account which is freezed since the GSTIN is not active Check the status of the GSTIN on the GSTN common portal. If active in common portal, report the same to helpdesk
3034 Your account has been cancelled as GSTIN is inactive User is trying to login with an account which is cancelled since the GSTIN is not active Check the status of the GSTIN on the GSTN common portal. If active in common portal, report the same to helpdesk
3035 Your account has been suspended as GSTIN is inactive User is trying to login with an account which is suspended since the GSTIN is not active Check the status of the GSTIN on the GSTN common portal. If active in common portal, report the same to helpdesk
3036 Your account has been inactive Attempting to logging with a user id which is not active Check the status of the user id, if in freeze state, create a new account
3037 CommonEnrolled Transporter not allowed this site A user with common enrolled opting is trying to use the eInvoice system eInvoice system can not be used by the GSTIN which has opted for common enrolment under E Way Bill
3042 Invalid From Pincode or To Pincode PIN code passed is wrong Pass the correct PIN code. Check the PIN code on the portal under Search -> Master Codes
3043 Something went wrong, please try again after sometime Attempting to carryout some on the system or passing some data which is not expected Please check the data or the operation which you have just performed. If issue still persists, please share the complete details to the helpdesk
3044 This registration only for tax payers not GSP. The option is available for the the Taxpayers and not for GSPs This option is not available / applicable for GSP
3045 Sorry you are not registered, Please use the registration option.
3046 Sorry you are not enabled for e-Invoicing System on Production. Ineligible taxpayer is trying to register for the eInvoice system In case the turnover is above 500crores in any of the financial years in GST regime, use the enrol option in eInvoice portal
3052 Transporter Id {0} is cancelled or invalid.
3053 Unauthorised access
3058 Data not Saved
3059 Client-Id for this PAN is not generated check your IP-Whitelisting status.
3060 Please wait for officer approval
3061 Your Request has been rejected, please register again
3062 Already Registered
3063 You are already enabled for e-invoicing
3064 Sorry, This GSTIN is deregistered
3065 You are not allowed to use this feature.
3066 There is no pin codes availables for this state.
3067 Client secret unsuccessfull,pls check the existing client secret.
3068 There is no Api user.
3069 Sorry,you have not directly integrated with E-invoice API.
3070 Sorry,you have not registered.
3071 Sorry,you have already linked this Gstin to your Client Id.
3072 Sorry,Your GSTIN not enabled by the Direct Integrator.
3073 You are already registered.
3074 GSTIN - {0} is cancelled and document date - {1} is later than de-registration date
3075 GSTIN- {0} is cancelled and de-registration 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
3080 Sorry, e-Invoicing cannot be enabled.
3081 Error while sending OTP, Please try again later.
3082 You have exceeded the OTP attempts. Please Re-Send OTP again.
3083 OTP Time Expried.
3084 Invalid OTP.
3085 Your PAN has Enabled with 500 Cr. Please enter turn over 500Cr
3086 Your PAN has Enabled with 100 Cr. Please enter turn over 100Cr
3087 Your PAN has Enabled with 50 Cr. Please enter turn over 50Cr