1. Get 26AS Information

Size: px

Start display at page:

Download "1. Get 26AS Information"

Nicholas Harrington
6 years ago
Views:

1 1. Get 26AS Information 1.1. Description This Web Service is used to get the 26AS information Authenticated users need to provide PAN, Date of Birth/Incorporation and Assessment Year to get 26AS information. The URL of WSDL is: Request Attributes S. No. Input Fields Description Validation Mandatory 1 username User ID of the user The User ID should be of 10 characters. 2 password Password of the user 3 Pan PAN for which 26AS information is required 4 dob Date Of Birth/Incorporation of the PAN 5 assessmen tyear PAN should be of 10 characters. Example: AAAPA1234A It should be a valid xml date. The format is YYYY-MM-DD. Example: Assessment Year Example: Response Attributes TDS On Salary: i.tds On Salary ii. TDS Other than Salary iii. TCS iv. Taxpayments(OLTAS data) 1 TAN TAN 2 EmployerOrDeductorOrCollecterName TAN Name

2 3 IncChrgSal Income chargeable on salary 4 TotalTDSSal Total TDS Salary TDS On Other Salary: 1 TAN TAN 2 EmployerOrDeductorOrCollecterName TAN Name 3 UniqueTDSCerNo TDS certificate number 4 DeductedYr Deducted year 5 TotTDSOnAmtPaid Total TDS amount paid 6 ClaimOutOfTotTDSOnAmtPaid Total TDS amount claimed TCS: 1 TAN TAN 2 EmployerOrDeductorOrCollecterName TAN Name 3 TotalTCS Total TCS 4 AmtTCSClaimedThisYear Amount claimed for this year Tax Payments: 1 BSRCode BSR Code 2 DateDep Date deposited 3 SrlNoOfChaln Serial Number of Challan 4 Amt Amount If no information is present for the PAN and assessment year then 'No record found for the Assessment Year' will be displayed User-groups with Privilege to access this Web Service 1. ERI (e-return Intermediary Admin) 2. ERU (e-return Intermediary User)

3 1.5. Error Messages Scenario User ID not provided in request Error Message Please provide the User ID. Incorrect User ID Authentication failed. Please provide a valid User ID. Password not provided in request Please provide the Password. Incorrect Password Authentication failed. Please provide a valid Password. PAN field left blank Please provide a PAN. Less number of characters entered in PAN PAN entered in wrong format PAN does not exist PAN does not exist. PAN not added as a client for ERI Assessment year is not selected Date of birth/incorporation field is left blank Date of birth/incorporation is not matching This PAN is not added as a client. Please provide the Assessment Year. Please provide date of birth Date of Birth is not matching

4 2. Get Rectification Status 2.1. Description This web service is used to get the rectification status for the given PAN. The URL of WSDL for getting the PAN information is: Request Attributes S. No. Input Fields Description Validation Mandatory 1 username User ID of the user The User ID should be of 10 characters. 2 password Password of the user 3 Pan PAN of the client PAN should be of 10 characters. Example: AAAPA1234A 4 assessmen tyear Assessment Year EX: Response Attributes 1 panno PAN 2 asseessmentyear Assessment Year 3 itrname ITR name 4 rectificationreferenceno Rectification Reference Number 5 date Rectification Date 6 cpcorderno CPC order number 7 date CPC order date 8 status Status 2.4. User-groupswith Privilege to access this Web Service 1. ERI (e-return Intermediary Admin) 2. ERU (e-return Intermediary User)

5 2.5. Error Messages Scenario User ID not provided in request Error Message Please provide the User ID. Incorrect User ID Authentication failed. Please provide a valid User ID. Password not provided in request Please provide the Password. Incorrect Password Authentication failed. Please provide a valid Password. PAN field left blank Please provide a PAN. Less number of characters entered in PAN PAN entered in wrong format PAN does not exist PAN does not exist. PAN not added as a client for ERI Assessment year is not selected Assessment year entered in wrong format This PAN is not added as a client. Please provide the Assessment Year. Enter Valid Assessment Year

6 3. Get Refund Status Web Service 3.1. Description This web service is used to get the refund status for the given PAN. The URL of the WSDL for getting the refund status is: Request Attributes S. No. Input Fields Description Validation Mandatory 1 username User ID of the user The User ID should be of 10 characters. 2 password Password of the user 3 Pan PAN of the client PAN should be of 10 characters. Example: AAAPA1234A 4 assessmen tyear Assessment Year EX: Response Attributes 1 result Refund Status 3.4. User-groups with Privilege to access this Web Service 1. ERI (e-return Intermediary Admin) 2. ERU (e-return Intermediary User) 3.5. Error Messages Scenario User ID not provided in request Error Message Please provide the User ID.

7 Incorrect User ID Authentication failed. Please provide a valid User ID. Password not provided in request Please provide the Password. Incorrect Password Authentication failed. Please provide a valid Password. PAN field left blank Please provide a PAN. Less number of characters entered in PAN PAN entered in wrong format PAN does not exist PAN does not exist. PAN not added as a client for ERI Assessment year is not selected This PAN is not added as a client. Please provide the Assessment Year.

8 4. Get ITR-V Status Web Service 4.1. Description This web service is used to get the ITR-V status for the given PAN. The URL of the WSDL for getting the ITR-V status is: Request Attributes S. No. Input Fields Description Validation Mandatory 1 Pan PAN PAN should be of 10 characters. Example: AAAPA1234A 2 assessment Year Assessment Year EX: Response Attributes 1 result ITR-V Status 4.4. User-groups with Privilege to access this Web Service 1. All User-groups 4.5. Error Messages Scenario Error Message PAN field left blank Please provide a PAN. Less number of characters entered in PAN PAN entered in wrong format PAN does not exist PAN does not exist.

9 PAN not added as a client for ERI Assessment year is not selected Assessment year entered in wrong format This PAN is not added as a client. Please provide the Assessment Year. Enter Valid Assessment Year

10 5. Add Client Details 5.1. Description This Web Service is used by ERI's to add clients, the URL of WSDL for the same is : Request Attributes S. No. Input Fields Description Validation Mandatory 1 username User ID of the user The User ID should be of 10 characters. 2 password Password of the user 3 Pan PAN of the client PAN should be of 10 characters. Example: AAAPA1234A 4 dob Date Of Birth/Incorporation of the PAN It should be a valid xml date. The format is YYYY-MM-DD. Example: Id of client It should be valid id 6 addclient Option Options for add client It should be either of: tdsoption, advancetaxoption or TaxNotFiledForLastTwoYears 7 tannumber TAN TAN should be of 10 characters. if 'tdsoption' is slected 8 financial Year Financial Year Ex: if 'tdsoption' is slected 9 bsrcode BSR Code It should be 7 digit. if 'advancetaxopti ontype' is slected 10 assessmen tyear 11 amountpai d Assessment Year EX: if 'advancetaxopti ontype' is slected Amount Paid It should be numeric and maximum of 14 digits. if 'advancetaxopti ontype' is

11 slected 5.3. Response Attributes 1 result Add Client Status 5.4. User-groups with Privilege to access this Web Service 1. ERI (e-return Intermediary Admin) 2. ERU (e-return Intermediary User) 5.5. Error Messages Scenario User ID not provided in request Error Message Please provide the User ID. Incorrect User ID Authentication failed. Please provide a valid User ID. Password not provided in request Please provide the Password. Incorrect Password Authentication failed. Please provide a valid Password. PAN field left blank Please provide a PAN. Less number of characters entered in PAN PAN entered in wrong format PAN does not exist PAN does not exist. Assessment year is not selected Assessment year entered in wrong format No tax paid in the last 2 years' option is selected but user's tax records are available in TDS/OLTAS db Details don't match with OLTAS db Amount paid field left blank Less than 7 digits entered in BSR code field Please provide the Assessment Year. Enter Valid Assessment Year Filing of Tax has been done in the last two years. Please enter the details. Incorrect Advance Tax/Self Assessment Tax. Please retry. Please provide the Amount. Please enter a valid 7 digit BSR Code.

12 BSR code field is left blank Details don't match with TDS/TCS db No financial year is entered ID entered in an incorrect format ID of the assesse is not entered Incorrect date of birth entered Date of birth field left blank PAN already added as a client with the same ERI Please provide the BSR Code. Incorrect TDS/TCS information. Please retry. Please provide the Financial Year. Invalid ID. Please retry. Please provide the ID. Invalid Date of Birth. Please retry. Please provide a Date of Birth. This PAN is already added as a client.

13 6. Submit Bulk ITR 6.1. Description This Web Service is provided to ERI users for bulk submission of ITR, a.zip file containing ITR XML will be passed while invoking this Web Service. The URL of the WSDL to submit bulk ITR is: Request Attributes S. No. Input Fields Description Validation Mandatory 1 userid User ID of the user The User ID should be of 10 characters. 2 password Password of the user 3 certchain Certification chain 4 signature Signature 5 Zip Attachment Zip attachment which contains ITR xml files 6.3. Response Attributes 1 result Token Number 6.4. User-groups with Privilege to access this Web Service 1. ERI (e-return Intermediary Admin) 2. ERU (e-return Intermediary User) 6.5. Error Messages Scenario User ID not provided in request Error Message Please provide the User ID.

14 Incorrect User ID Authentication failed. Please provide a valid User ID. Password not provided in request Please provide the Password. Incorrect Password Authentication failed. Please provide a valid Password. Certificate chain not provided Signature not provided The digital signature certificate does not match with the one registered Invalid Digital signature certificate. The trusted parent certificate could not be verified Please provide the Certificate Chain Please provide a Digital Signature Certificate. Invalid Digital Signature Certificate. Please retry. Invalid Digital Signature Certificate. Please contact your Certificate Provider. Invalid Digital Signature Certificate. The trusted parent certificate could not be verified.

15 7. Submit Bulk PAN XML 7.1. Description This Web Service is used to get the PAN details. ERIs submit a file ( in XML format) containing PAN, as a response ERI will get a Token Number, which they use to retrieve the PAN details from portal at later point of time. The URL of the WSDL to invoke submit bulk PAN is: Request Attributes S. No. Input Fields Description Validation Mandatory 1 username User ID of the user The User ID should be of 10 characters. 2 password Password of the user 3 Xml file XML file as SOAP attachment 7.3. Response Attributes 1 result Token Number 7.4. User-groups with Privilege to access this Web Service 1. ERI (e-return Intermediary Admin) 2. ERU (e-return Intermediary User) 7.5. Error Messages Scenario User ID not provided in request Error Message Please provide the User ID.

16 Incorrect User ID Authentication failed. Please provide a valid User ID. Password not provided in request Please provide the Password. Incorrect Password Authentication failed. Please provide a valid Password. XML not provided Two XML files provided Please provide an XML file. Please provide only one XML file. Non XML file is selected Please provide a valid XML. Incorrect XML schema The XML Schema is invalid. Please provide the XML in the correct schema.

17 8. Get PAN Information Web Service 8.1. Description This web service is used to get the details of given PAN. The URL of WSDL for getting the PAN information is: Request Attributes S. No. Input Fields Description Validation Mandatory 1 username User ID of the user The User ID should be of 10 characters. 2 password Password of the user 3 Pan PAN of the client PAN should be of 10 characters. Example: AAAPA1234A 8.3. Response Attributes 1 Pan PAN 2 Ffullname Father's full name 3 Address Address of the 4 Dob Date of Birth of 5 Fullname Assess full name 6 Error Error if any 8.4. User-groups with Privilege to access this Web Service 1. External Agency 2. ERI (e-return Intermediary Admin) 3. ERU (e-return Intermediary User)

18 8.5. Error Messages Scenario User ID not provided in request Error Message Please provide the User ID. Incorrect User ID Authentication failed. Please provide a valid User ID. Password not provided in request Please provide the Password. Incorrect Password Authentication failed. Please provide a valid Password. PAN field left blank Please provide a PAN. Less number of characters entered in PAN PAN entered in wrong format PAN does not exist PAN does not exist.

19 9. Get TAN Information Web Service 9.1. Description This web service is used to get the details of given TAN. The URL of the WSDL for getting the TAN information is: Request Attributes S. No. Input Fields Description Validation Mandatory 1 username User ID of the user The User ID should be of 10 characters. 2 password Password of the user 3 Tan TAN of the client TAN should be of 10 characters. Example: AAAPA1234A 9.3. Response Attributes 1 tan TAN 2 categoryofd eductor Category of deductor 3 address Address 4 pan PAN 5 status Status 6 id1 Id 7 id2 Alternate Id 8 areacode Area code 9 AOType AO type

20 10 rangecode Range code 11 AONumber AO number 9.4. User-groups with Privilege to access this Web Service 1. ERI (e-return Intermediary Admin) 2. ERU (e-return Intermediary User) 9.5. Error Messages Scenario User ID not provided in request Error Message Please provide the User ID. Incorrect User ID Authentication failed. Please provide a valid User ID. Password not provided in request Please provide the Password. Incorrect Password Authentication failed. Please provide a valid Password. TAN field left blank Please provide a TAN. Less number of characters entered in TAN Invalid TAN. Please retry. TAN entered in wrong format Invalid TAN. Please retry. TAN does not exist TAN does not exist.

e-tutorial Online Correction-Add Challan to the statement

e-tutorial Online Correction-Add Challan to the statement 1 Important Information on Online Correction All type of corrections like Personal information, Deductee details and Challan correction can be