8/20/2019 WebServices_Manual.pdf
1/69
Web Services User Manual
Page 1
e-Filing Web Service User Manual
8/20/2019 WebServices_Manual.pdf
2/69
Web Services User Manual
Page 2
CONTENTS
1 TAX CREDIT MISMATCH ............................................................................... 5
2 ADD CLIENT DETAILS ................................................................................. 10
3 BULK PAN VERIFICATION .......................................................................... 14
4 OUTSTANDING TAX DEMAND ..................................................................... 18
5 ITR-V STATUS ............................................................................................ 22
6 REFUND/DEMAND STATUS ......................................................................... 25
7 RETRIEVE ITR-V STATUS ............................................................................ 28
8 RETRIEVE RECTIFICATION STATUS ............................................................ 36
9 RETRIEVE 26AS INFORMATION .................................................................. 40
10 E-FILED RETURN STATUS ........................................................................ 45
11 KNOW YOUR JURISDICTIONAL A.O ......................................................... 48
12 RETRIEVE PAN INFORMATION ................................................................ 51
13 RETRIEVE TAN INFORMATION ................................................................ 54
14 BULK ITR................................................................................................. 58
15 REQUEST FOR INTIMATION U/S 143(1)/154 .......................................... 61
16 REQUEST OF XML/ITR FORM/RECEIPT(PDF) .......................................... 65
8/20/2019 WebServices_Manual.pdf
3/69
Web Services User Manual
Page 3
Abbreviations
Abbreviation Expanded Form
26AS 26 Annual Statement
A.O Assessing Officer
A.Y Assessment Year
DIT Department of Income Tax
ERI e-Return Intermediary
HTTP Hypertext Transfer Protocol
ITR Income Tax Return
PAN Permanent Account Number
TAN Tax Deduction Account Number
XML Extensible Markup Language
8/20/2019 WebServices_Manual.pdf
4/69
Web Services User Manual
Page 4
Introduction
The World Wide Web is increasingly being used for communication between applications.
The programmatic interfaces made available over the Web for application-to-application
communication are often referred to as Web services. There are many types of
applications that can be considered Web services but interoperability between
applications is enhanced mostly by the use of familiar technologies such as XML and
HTTP. These technologies allow applications using differing languages and platforms to
interface in a familiar way.
This section provides the details of Web services provided by e-Filing including data
types and required user privileges.
8/20/2019 WebServices_Manual.pdf
5/69
Web Services User Manual
Page 5
1 Tax Credit MismatchThis Web service can be used to view the tax credit mismatch for the PAN and theassessment year mentioned. This is applicable for the ERI users.
Pre-requisite: The PAN user must be added as a client of the respective ERI
Note: Details are available for A.Y 2013-14 and 2014-15.
1.1 WSDL Definition
The following table provides details on Tax Credit Mismatch- Interface properties:
Tax Credit Mismatch - Interface Properties
Property Value
Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/getTaxCredMismatchRequest.wsdl
End point https://incometaxindiaefiling.gov.in/e-FilingWS/ditws
Namespace http://incometaxindiaefiling.gov.in/ditws/TaxCredMismatch/v_1_0
Binding taxCreditMisMatchSOAP11
SOAP Version SOAP 1.1
Style Document
1.2 Operations
The following table provides details on Tax Credit Mismatch- Operation properties:
Tax Credit Mismatch - Operation Properties
Property Value
Operation getTaxCredMisMatch
Style Document
Type Request-Response
Input getTaxCredMismatchRequest
Output getTaxCredMismatchResponse
Send Attachments False
Receive Attachments False
1.3 Request
The user id and password are required for authenticating the user. Once authenticated,then the user will be authorised to invoke the Web service.
1.3.1 Request Parameters
The following table provides details on Tax Credit Mismatch- Request Parameters:
8/20/2019 WebServices_Manual.pdf
6/69
Web Services User Manual
Page 6
Tax Credit Mismatch - Request Parameters
Field Name Description Mandatory
userName Valid e-Filing User ID. Yes
password Valid e-Filing password for the user. YesPan Valid PAN of the client Yes
assessmentYear Assessment Year Yes
1.3.2 Sample Request
The following is the sample request:
XXXXXXXXXX
XXXXXXXXXX
XXXXXXXXXX
XXXX-XX
1.4 Response
List of Challan Data and Tax Mismatch is the response.
1.4.1 Response Parameters
The following table provides details on Tax Credit Mismatch- Response Parameters:
8/20/2019 WebServices_Manual.pdf
7/69
Web Services User Manual
Page 7
Tax Credit Mismatch - Response Parameters
Field Name Description
recBsrCode Count of the transaction.
recChallanAmount Challan Amount
recChallanDate Challan Date
recChallanNo Challan Number
amountIn26As Amount in 26AS
amountRecorded Amount Recorded
deductorName Deductor Name
tanNo TAN
1.4.2 Sample Response
The following is the sample response:
3453453
2342
2014-01-09T00:00:00+05:30
34345
3542345
234
2014-01-08T00:00:00+05:30
43543
4352345
23423
2014-01-11T00:00:00+05:30
34534
6546523
8/20/2019 WebServices_Manual.pdf
8/69
Web Services User Manual
Page 8
23422
2014-01-10T00:00:00+05:30
34534
0
1212
DEDUCTOR NAME
AAAA12345A
0
320
DEDUCTOR NAME
AAAA12345A
0
3573
DEDUCTOR NAME
AAAA12345A
1.5 Error
1.5.1 Error Messages
The following table provides details on Tax Credit Mismatch - Error Messages:
Tax Credit Mismatch - Error Messages
Scenario Error Message
User ID not provided in the request Please provide the User ID.
Incorrect User ID Authentication failed. Please provide a valid User ID.
Password not provided in the request Please provide the password
Incorrect Password Authentication failed. Please provide a valid Password.
8/20/2019 WebServices_Manual.pdf
9/69
Web Services User Manual
Page 9
1.5.2 Sample Error
The following is the sample error:
ns0:Client
Error Message< /faultstring>
8/20/2019 WebServices_Manual.pdf
10/69
Web Services User Manual
Page 10
2 Add Client DetailsThis Web service can be used to add a PAN as client by the ERI user.
2.1 WSDL Definition
The following table provides details on Add Client - Interface Properties:
Add Client - Interface Properties
Property Value
Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/addClientDetails.wsdl
End point https://incometaxindiaefiling.gov.in/e-FilingWS/ditws
Namespace http://incometaxindiaefiling.gov.in/ditws/addClientDetails/v_1_0
Binding addClientPortSoap11
SOAP Version SOAP 1.1Style Document
2.2 OperationsThe following table provides details on Add Client - Operation Properties:
Add Client - Operation Properties
Property Value
Operation addClientDetails
Style DocumentType Request-Response
Input addClientDetailsRequest
Output addClientDetailsResponse
Send Attachments False
Receive Attachments False
2.3 Request
The user id and password are required for authenticating the user. Once authenticated,the user will be authorised to invoke the Web service.
8/20/2019 WebServices_Manual.pdf
11/69
Web Services User Manual
Page 11
2.3.1 Request Parameters
The following table provides details on Add Client - Request Parameters:
Add Client - Request Parameters
Field Name Description Mandatory
userName Valid e-Filing User ID. Yes
password Valid e-Filing password for the user. Yes
Pan Valid PAN of the client Yes
dob Date Of Birth/Incorporation of the PAN Yes
email E-mail Id of client Yes
addClient Options for add client
tanNumber TAN Yes if 'tdsOption' is selected
FinancialYear Financial Year Yes if 'tdsOption' is selected
bsrCode BSR Code Yes if
'advanceTaxOptionType' isselected
assessmentYear Assessment Year Yes if
'advanceTaxOptionType' isselected
amountPaid Amount Paid Yes if
'advanceTaxOptionType' isselected
2.3.2 Sample Request
The following is the sample request:
UserName
password
AAAPA1111A
1967-05-23
8/20/2019 WebServices_Manual.pdf
12/69
Web Services User Manual
Page 12
2.4 Response
Status of adding client is the response.
2.4.1 Response Parameters
The following table provides details on Add Client - Response Parameters:
Add Client - Response Parameters
Field Name Description
result Add Client Status.
2.4.2 Sample Response
The following is the sample response:
PAN has been successfully added as your client
2.5 Error
2.6.1 Error Messages
The following table lists the error messages
Add Client - Error Messages
Scenario Error Message
User ID not provided in the request Please provide the User ID.
Incorrect User ID Authentication failed. Please provide a validUser ID.
Password not provided in the request Please provide the password
Incorrect Password Authentication failed. Please provide a validPassword.
PAN field left blank Please provide a PAN
8/20/2019 WebServices_Manual.pdf
13/69
Web Services User Manual
Page 13
Less number of characters entered in PAN Invalid PAN. Please retry.
PAN entered in wrong format Invalid PAN. Please retry
PAN does not exist PAN does not exist
Assessment year is not selected Please provide the Assessment Year
Assessment year entered in wrong format Enter Valid Assessment Year
No tax paid in the last 2 years' option is
selected but users tax records are available
in TDS/OLTAS DB
Filing of Tax has been done in the last two
years. Please
Details don't match with OLTAS DB Incorrect Advance Tax/Self-Assessment Tax.Please retry
Amount paid field left blank Please provide the Amount.
Less than 7 digits entered in BSR code field Please enter a valid 7 digit BSR Code
BSR code field is left blank Please provide the BSR Code
Details don't match with TDS/TCS DB Incorrect TDS/TCS information. Please retry
No financial year is entered Please provide the Financial Year.
E-mail ID entered in an incorrect format Invalid E-mail ID. Please retry
E-mail ID of the assesse is not entered Please provide the E-mail ID
Incorrect date of birth entered Invalid Date of Birth. Please retry
Date of birth field left blank Please provide a Date of Birth
PAN already added as a client with the same This PAN is already added as a client
2.6.2 Sample Error
The following is the sample error:
ns0:Client
Error Message< /faultstring>
8/20/2019 WebServices_Manual.pdf
14/69
Web Services User Manual
Page 14
3 Bulk PAN Verification
This web service is used to upload multiple PAN for verification. This is applicable for ERIand External Agency users.
3.1 WSDL Definition
The following table provides details on Bulk PAN Verification - Interface Properties:
Bulk PAN Verification - Interface Properties
Property Value
Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/submitBulkPan.wsdl
End point https://incometaxindiaefiling.gov.in/e-FilingWS/ditws
Namespace http://incometaxindiaefiling.gov.in/bulkPanservice/v_1_0
Binding BulkPanServiceSoapBindingSOAP Version SOAP 1.1
Style Document
3.2 Operations
The following table provides details on Bulk PAN Verification - Operation Properties:Bulk PAN Verification - Operation Properties
Property Value
Operation submitBulkPanStyle Document
Type Request-Response
Input SubmitBulkPanRequest
Output SubmitBulkPanResponse
Send Attachments True
Receive Attachments False
3.3
Request
The user id and password are required for authenticating the user. Once authenticated,then the user will be authorised to invoke the Web service.
8/20/2019 WebServices_Manual.pdf
15/69
Web Services User Manual
Page 15
3.3.1 Request Parameters
The following table provides details on Bulk PAN Verification - Request Parameters:
Bulk PAN Verification - Request Parameters
Field Name Description Mandatory
userName Valid e-Filing User ID. Yes
password Valid e-Filing password for the user. Yes
XML File XML file as SOAP attachment Yes
3.3.2 Sample Request
The following is the sample request:
xxxxxxxxxx
xxxxxxxxxx
Note:The user has to submit the attachment ofBulk PAN xml to get the verifications of
PANs and should be in the below format.
AAAPA0000A
AAAPA0000B
AAAPA0000C
AAAPA0000D
3.4 Response
Token Number is the response from the Webservice. To check the status of the Bulk PAN
upload, use the Token number.
Note: To View the status or details of Uploaded XML’s Login to e-Filing Application then
Go to Bulk PAN Query Token Status/Token Details.
8/20/2019 WebServices_Manual.pdf
16/69
Web Services User Manual
Page 16
3.4.1 Response Parameters
The following table provides details on Bulk PAN Verification - Response Parameters:
Bulk PAN Verification - Response Parameters
Field Name Description
Result Token Number
3.4.2 Sample Response
The following is the sample response:
100002134
3.5 Error
3.5.1 Error Messages
The following table lists the error messages
Bulk PAN Verification - Error Messages
Scenario Error Message
User ID not provided in the request Please provide the User ID.
Incorrect User ID Authentication failed. Please provide a valid User ID.
Password not provided in the request Please provide the password
Incorrect Password Authentication failed. Please provide a valid Password.
XML not provided Please provide an XML file
Two XML files provided Please provide only one XML file
Two XML files provided 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 inthe correct schema
8/20/2019 WebServices_Manual.pdf
17/69
Web Services User Manual
Page 17
3.5.2 Sample Error
The following is the sample error:
ns0:Client
Error Message< /faultstring>
8/20/2019 WebServices_Manual.pdf
18/69
Web Services User Manual
Page 18
4 Outstanding Tax Demand
This Web service can be used to view the outstanding tax demand for the PAN andassessment year. This is applicable for the ERI users.
Pre-requisite: PAN user must be added as client of the respective ERI
4.1 WSDL DefinitionThe following table provides details on Outstanding Tax Demand- Interface Properties:
Outstanding Tax Demand- Interface Properties
Property Value
Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/GetTaxDemandDetails.wsdl
End point https://incometaxindiaefiling.gov.in/e-FilingWS/ditws
Namespace http://incometaxindiaefiling.gov.in/ditws/OutstandingTaxDemand/v_1_0
Binding OutstandingTaxDemandPortSoap11
SOAP Version SOAP 1.1
Style Document
4.2 Operations
The following table provides details on Outstanding Tax Demand- Operation Properties:
Outstanding Tax Demand- Operation Properties
Property Value
Operation Outstanding Tax Demand
Style Document
Type Request-Response
Input OutstandingTaxDemandRequest
Output OutstandingTaxDemandResponse
Send Attachments False
Receive Attachments False
8/20/2019 WebServices_Manual.pdf
19/69
Web Services User Manual
Page 19
4.3 Request
The user id and password are required for authenticating the user. Once authenticated,
then the user will be authorised to invoke the Web service.
4.3.1 Request Parameters
The following table provides details on Outstanding Tax Demand- Request Parameters:
Outstanding Tax Demand- Request Parameters
Field Name Description Mandatory
username Valid e-Filing User ID. Yes
password Valid e-Filing password for the user. Yes
pan No Should be client of the username Yes
Assessment Year Should be valid and consecutive Yes
4.3.2 Sample Request
The following is the sample request:
?
?
?
?
4.4 Response
Assessment Year ,Section Code, Demand Identification Number, Date on which demandis raised and Outstanding demand amount will be the response. And the response willvary based on the request details provided.
8/20/2019 WebServices_Manual.pdf
20/69
Web Services User Manual
Page 20
4.4.1 Response Parameters
The following table provides details on Outstanding Tax Demand - Response Parameters:
Outstanding Tax Demand - Response Parameters
Field Name Description
asstYear Assessment Year
section Section Code
DIN Demand Identification Number
demandDate Date on which demand is raised
outstandDemand Outstanding demand amount
4.4.2 Sample Response
The following is the sample response:
2013
1000
2011200837000000000T
2011-07-10T00:00:00+05:30
2222
8/20/2019 WebServices_Manual.pdf
21/69
Web Services User Manual
Page 21
4.5 Error
4.5.1 Error Messages
The following table lists the error messages
Outstanding Tax Demand - Error Messages
Scenario Error Message
User ID not provided inthe request
Please provide the User ID.
Incorrect User ID Authentication failed. Please provide a valid User ID and Password
Password not provided inthe request
Please provide the password
Incorrect Password Authentication failed. Please provide a valid User ID and Password
4.5.2 Sample Error
The following is the sample error:
SOAP-ENV:Client
Error Message
8/20/2019 WebServices_Manual.pdf
22/69
Web Services User Manual
Page 22
5 ITR-V Status
This Web service can be used to view status of ITR-V for the assessment year
mentioned.
5.1
WSDL DefinitionThe following table provides details on ITR-V Status - Interface Properties:
ITR-V Status - Interface Properties
Property Value
Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws /itrvstatus.wsdl
End point https://incometaxindiaefiling.gov.in/e-FilingWS/ditws
Namespace http://incometaxindiaefiling.gov.in/ditws/ITRVStatus/v_1_0
Binding itrvstatusPortSoap11
SOAP Version SOAP 1.1
Style Document
5.2 Operations
The following table provides details on ITR-V Status - Operation Properties:ITR-V Status - Operation Properties
Property Value
Operation ITR-V Status
Style Document
Type Request-Response
Input GetITRVStatusRequest
Output GetITRVStatusResponse
Send Attachments False
Receive Attachments False
5.3 RequestThe user id and password are required for authenticating the user. Once authenticated,
then the user will be authorised to invoke the Web service.
8/20/2019 WebServices_Manual.pdf
23/69
Web Services User Manual
Page 23
5.3.1 Request Parameters
The following table provides details on ITR-V Status - Request Parameters:
ITR-V Status - Request Parameters
Field Name Description Mandatory
userName Valid e-Filing User ID. Yes
password Valid e-Filing password for the Yes
panNo Should be client of the userName Yes
asseessmentYear Should be valid and consecutive Yes
5.3.2 Sample Request
The following is the sample request:
?
?
5.4 ResponseITR-V status is the response. And the response will vary based on the request details
provided.
5.4.1 Response Parameters
The following table provides details on ITR-V Status - Response Parameters:
ITR-V Status - Response Parameters
Field Name Description
result ITR-V Status
8/20/2019 WebServices_Manual.pdf
24/69
Web Services User Manual
Page 24
5.4.2 Sample Response
The following is the sample response:
8/20/2019 WebServices_Manual.pdf
25/69
Web Services User Manual
Page 25
6 Refund/Demand Status
This Web service can be used to refund/demand status for the PAN and assessment year
mentioned. This is applicable for ERI users.
Pre-requisite: PAN user must be added as client of the respective ERI
6.1 WSDL DefinitionThe following table provides details on Refund/Demand Status - Interface Properties:
Refund/Demand Status - Interface Properties
Property Value
Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws /refundstatus.wsdl
End point https://incometaxindiaefiling.gov.in/e-FilingWS/ditws
Namespace http://incometaxindiaefiling.gov.in/ditws/ITRVStatus/v_1_0
Binding refundstatusPortSoap11
SOAP Version SOAP 1.1
Style Document
6.2 Operations
The following table provides details on Refund/Demand Status - Operation Properties:
Refund/Demand Status - Operation Properties
Property Value
Operation Refund Status
Style Document
Type Request-Response
Input GetRefundStatusRequest
Output GetRefundStatusResponse
Send AttachmentsFalse
Receive AttachmentsFalse
6.3 Request
The user id and password are required for authenticating the user. Once authenticated,then the user will be authorised to invoke the Web service.
8/20/2019 WebServices_Manual.pdf
26/69
Web Services User Manual
Page 26
6.3.1 Request Parameters
The following table provides details on Refund/Demand Status - Request Parameters:
Refund/Demand Status - Request Parameters
Field Name Description Mandatory
userName Valid e-Filing User ID. Yes
password Valid e-Filing password for the user. Yes
panNo Should be client of the user Name Yes
asseessmentYear Should be valid and consecutive Yes
6.3.2 Sample Request
The following is the sample request:
?
?
?
?
6.4
ResponseRefund/Demand Status is the response. And the response will vary based on the request
details provided.
6.4.1 Response Parameters
The following table provides details on Refund/Demand Status - Response Parameters:
Refund/Demand Status - Response Parameters
Field Name Description
result Refund Status
8/20/2019 WebServices_Manual.pdf
27/69
Web Services User Manual
Page 27
6.4.2 Sample Response
The following is the sample response:
Not Determined
6.5
Error
6.5.1 Error Messages
The following table lists the error messages
Refund/Demand Status - Error Messages
Scenario Error Message
User ID not provided in therequest
Please provide the User ID.
Incorrect User ID Authentication failed. Please provide a valid User ID andPassword
Password not provided in therequest
Please provide the password
Incorrect Password Authentication failed. Please provide a valid User ID andPassword
6.5.2 Sample Error
The following is the sample error:
SOAP-ENV:Client
Error Message
8/20/2019 WebServices_Manual.pdf
28/69
Web Services User Manual
Page 28
7 Retrieve ITR-V Status
A. Retrieve ITR-V with Acknowledgment Number
This web service can be used to retrieve the ITR-V for the Acknowledgment numbermentioned. This is applicable for ERI users.
Pre-requisite: PAN user must be added as client of the respective ERI
7.1 WSDL DefinitionThe following table provides details on Retrieve ITR-V with Acknowledgment No -
Interface Properties:
Retrieve ITR-V with Acknowledgment No - Interface Properties
Property Value
Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/getITRV.wsdl
End point https://incometaxindiaefiling.gov.in/e-FilingWS/ditws
Namespace http://incometaxindiaefiling.gov.in/itrvservice/v_1_0
Binding ITRVServiceBinding
SOAP Version SOAP 1.1
Style Document
7.2 Operations
The following table provides details on Retrieve ITR-V with Acknowledgment No -Operation Properties:
Retrieve ITR-V with Acknowledgment No - Operation Properties
Property Value
Operation getITRVByAckNo
Style Document
Type Request-Response
Input getITRVByAckNoRequest
Output getITRVResponse
Send Attachments False
Receive Attachments False
8/20/2019 WebServices_Manual.pdf
29/69
Web Services User Manual
Page 29
7.3 Request
The user id and password are required for authenticating the user. Once authenticated,then the user will be authorised to invoke the Web service.
7.3.1 Request Parameters
The following table provides details on Retrieve ITR-V with Acknowledgment No -
Request Parameters:
Retrieve ITR-V with Acknowledgment No - Request Parameters
Field Name Description Mandatory
userName Valid e-Filing User ID. Yes
password Valid e-Filing password for the user Yes
certChain DSC Certificate Chain Yes
signature DSC Signature Yes
acknowledgementNo Efiling Acknowledgment Number Yes
7.3.2 Sample Request
The following is the sample request:
XXXXXXXXXX
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
8/20/2019 WebServices_Manual.pdf
30/69
Web Services User Manual
Page 30
7.4 Response
ITR-V for the corresponding Acknowledgment number is sent to the registered email IDis the response.
7.4.1 Response Parameters
The following table provides details on Retrieve ITR-V with Acknowledgment No -
Response Parameters:
Retrieve ITR-V with Ack. No - Response Parameters
Field Name Description
result Status of ITR processing
7.4.2 Sample Response
The following is the sample response:
xxxxxxxxxx
8/20/2019 WebServices_Manual.pdf
31/69
Web Services User Manual
Page 31
7.5 Error
7.5.1 Error Messages
The following table lists the error messages
Retrieve ITR-V with Acknowledgment No - Error Messages
Scenario Error Message
User ID not provided in therequest
Please provide the User ID.
Incorrect User ID Authentication failed. Please provide a valid User ID andPassword
Password not provided in therequest
Please provide the password
Incorrect Password Authentication failed. Please provide a valid User ID andPassword
Certificate chain not provided Please provide the Certificate Chain
Signature not provided Please provide a Digital Signature Certificate
The digital signature certificate
does not match with the oneInvalid Digital Signature Certificate. Please retry
Invalid Digital signature certificate Invalid Digital Signature Certificate. Please contact your
Certificate Provider
The trusted parent certificatecould not be verified
Invalid Digital Signature Certificate. The trusted parent
Certificate could not be verified.
Acknowledgment Number notprovided in request
Please provide Acknowledgment Number
Acknowledgment Number not
provided is not validInvalid acknowledgment number
7.5.2 Sample Error
The following is the sample error:
SOAP-ENV:Client
Error Message
8/20/2019 WebServices_Manual.pdf
32/69
Web Services User Manual
Page 32
B. Retrieve ITR-V with Token Number and PAN
This Web service can be used to retrieve the ITR-V for the PAN and Token numbermentioned. This is applicable for ERI users.
Pre-requisite: PAN user must be added as client of the respective ERI
7.1
WSDL Definition
The following table provides details on Retrieve ITR-V with Token No - Interface
Properties:
Retrieve ITR-V with Token No - Interface Properties
Property Value
Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/getITRV.wsdl
End point https://incometaxindiaefiling.gov.in/e-FilingWS/ditws
Namespace http://incometaxindiaefiling.gov.in/itrvservice/v_1_0
Binding ITRVServiceBinding
SOAP Version SOAP 1.1
Style Document
7.2 Operations
The following table provides details on Retrieve ITR-V with Token No - OperationProperties:
Retrieve ITR-V with Token No - Operation Properties
Property Value
Operation getITRVByTokenNo
Style Document
Type Request-Response
Input getITRVByTokenNoRequest
Output getITRVResponse
Send Attachments False
Receive Attachments False
7.3 Request
The user id and password are required for authenticating the user. Once authenticated,then the user will be authorised to invoke the Web service.
8/20/2019 WebServices_Manual.pdf
33/69
Web Services User Manual
Page 33
7.3.1 Request Parameters
The following table provides details on Retrieve ITR-V with Token No - Request
Parameters:
Retrieve ITR-V with Token No - Request Parameters
Field Name Description Mandatory
userName Valid e-Filing User ID. Yes
password Valid e-Filing password for the Yes
certChain DSC Certificate Chain Yes
signature DSC Signature Yes
tokenNumber Token Number of Bulk ITR upload Yes
7.3.2 Sample Request
The following is the sample request:
XXXXXXXXXX
XXXXXXXXXX
XXXXXXXXXX
XXXXXXXXXX
XXXXXXXXXX
XXXXXXXXXX
7.4 Response
ITR-V for the corresponding Token number and PAN is sent to registered Email ID isthe response.
8/20/2019 WebServices_Manual.pdf
34/69
Web Services User Manual
Page 34
7.4.1 Response Parameters
The following table provides details on Retrieve ITR-V with Token No - Response
Parameters:
Retrieve ITR-V with Token No - Response Parameters
Field Name Description
result Status of ITR processing
7.4.2 Sample Response
The following is the sample response:
xxxxxxxxxx
7.5 Error
7.5.1 Error Messages
The following table lists the error messages
Retrieve ITR-V with Token No - Error Messages
Scenario Error Message
User ID not provided in the request Please provide the User ID.
Incorrect User ID Authentication failed. Please provide a valid User ID
and Password
Password not provided in the request Please provide the password
Incorrect Password Authentication failed. Please provide a valid User IDand Password
Certificate chain not provided Please provide the Certificate Chain
Signature not provided Please provide a Digital Signature Certificate
The digital signature certificate does
not match with the one registeredInvalid Digital Signature Certificate. Please retry
8/20/2019 WebServices_Manual.pdf
35/69
Web Services User Manual
Page 35
Invalid Digital signature certificate Invalid Digital Signature Certificate. Please contact
your
The trusted parent certificate couldnot be verified
Invalid Digital Signature Certificate. The trusted parent
Certificate could not be verified.
Token Number not provided inrequest
Please provide Token Number
Token Number not provided is notvalid
Invalid token
Specified Token not yet processed Token not yet processed
PAN not provided in request Please provide a PAN
Invalid PAN Invalid PAN. Please retry
ITR for PAN provided was not
uploaded with Token provided
Pan not in token
7.5.2 Sample Error
The following is the sample error:
SOAP-ENV:Client
Error Message
8/20/2019 WebServices_Manual.pdf
36/69
Web Services User Manual
Page 36
8 Retrieve Rectification Status
This web service can be used to view Rectification status for the PAN and assessmentyear mentioned. This is applicable for ERI users.
Pre-requisite: PAN user should be added as client of the respective ERI
8.1 WSDL Definition
The following table provides details on Rectification Status - Interface Properties:
Rectification Status - Interface Properties
Property Value
Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/rectificationstatus.wsdl
End point https://incometaxindiaefiling.gov.in/e-FilingWS/ditws
Namespace http://incometaxindiaefiling.gov.in/ditws/ITRVStatus/v_1_0
Binding rectificationstatusPortSoap11
SOAP Version SOAP 1.1
Style Document
8.2 Operations
The following table provides details on Rectification Status - Operation Properties:
Rectification Status - Operation Properties
Property Value
Operation getRectificationStatus
Style Document
Type Request-Response
Input getRectificationStatusRequest
Output getRectificationStatusResponse
Send Attachments False
Receive Attachments False
8.3 Request
The user id and password are required for authenticating the user. Once authenticated,then the user will be authorised to invoke the Web service.
8/20/2019 WebServices_Manual.pdf
37/69
Web Services User Manual
Page 37
8.3.1 Request Parameters
The following table provides details on Rectification Status - Request Parameters:
Rectification Status - Request Parameters
Field Name Description Mandatory
userName Valid e-Filing User ID. Yes
password Valid e-Filing password for theuser.
Yes
Pan Valid PAN of the client Yes
assessmentYear Assessment Year Yes
8.3.2 Sample Request
The following is the sample request:
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
8.4 Response
List of transactions and their details like PAN, A.Y, ITR Name, Rectification Reference No
and Date of rectification is the response.
8/20/2019 WebServices_Manual.pdf
38/69
Web Services User Manual
Page 38
8.4.1 Response Parameters
The following table provides details on Rectification Status - Response Parameters:
Rectification Status - Response Parameters
Field Name Description
panNo PAN
asseessmentYear Assessment Year
itrName ITR name
rectificationReferenceNo Rectification Reference Number
Date Rectification Date
cpcOrderNo CPC order number
Date CPC order date
Status Status
8.4.2 Sample Response
The following is the sample response:
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
8/20/2019 WebServices_Manual.pdf
39/69
Web Services User Manual
Page 39
8.5 Error
8.5.1 Error Messages
The following table lists the error messages
Rectification Status - Error Messages
Scenario Error Message
User ID not provided in request Please provide the User ID.
Incorrect User ID Authentication failed. Please provide a valid User ID.
Password not provided in the 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 inPAN
Invalid PAN. Please retry.
PAN entered in wrong format Invalid PAN. Please retry.
PAN does not exist PAN does not exist.
PAN not added as a client for ERI This PAN is not added as a client.
Assessment year is not selected Please provide the Assessment Year.
Assessment year entered in wrong
format
Enter Valid Assessment Year
8.5.2 Sample Error
The following is the sample error:
ns0:ClientError Message< /faultstring>
8/20/2019 WebServices_Manual.pdf
40/69
Web Services User Manual
Page 40
9 Retrieve 26AS Information
This web service can be used to view 26AS information for the PAN, assessment year,DOB mentioned. This is applicable for ERI users.
Pre-requisite: PAN user should be added as client of the respective ERI
9.1 WSDL Definition
The following table provides details on View 26AS - Interface Properties:
View 26AS - Interface Properties
Property Value
Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/Get26asInfo.wsdl
End point https://incometaxindiaefiling.gov.in/e-FilingWS/ditws
Namespace http://incometaxindiaefiling.gov.in/ditws /tds/v_1_0
Binding GetTDSPortSoap11
SOAP Version SOAP 1.1
Style Document
9.2 Operations
The following table provides details on View 26AS - Operation Properties:
View 26AS - Operation Properties
Property Value
Operation getTDSDetails
Style Document
Type Request-Response
Input GetTDSRequest
Output GetTDSResponse
Send Attachments False
Receive Attachments False
9.3 Request
The user id and password are required for authenticating the user. Once authenticated,then the user will be authorised to invoke the Web service.
8/20/2019 WebServices_Manual.pdf
41/69
Web Services User Manual
Page 41
9.3.1 Request Parameters
The following table provides details on View 26AS - Request Parameters:
View 26AS - Request Parameters
Field Name Description Mandatory
userName Valid e-Filing User ID. Yes
password Valid e-Filing password for the Yes
Pan Valid PAN of the client Yes
Dob Should be a valid Date of Birth Yes
assessmentYear Assessment Year Yes
9.3.2 Sample Request
The following is the sample request:
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
9.4 Response
Form 26AS details like Tax Deducted at Source (TDS), Tax Collected at Source (TCS),Advance Tax/ Self-Assessment Tax deposited in the bank by tax payers, and Refunddetails for an Assessment Year will be the response.
8/20/2019 WebServices_Manual.pdf
42/69
Web Services User Manual
Page 42
9.4.1 Response Parameters
The following table provides details on View 26AS - Response Parameters:
View 26AS - Response Parameters
Field Name Description
TAN TAN of the Deductor/Collector
EmployerOrDeductorOrCollecterName Collector/Deductor Name
IncChrgSal Income From salary
TotalTDSSal TDS on salary
TotTDSOnAmtPaid Total TDS paid on salary
ClaimOutOfTotTDSOnAmtPaid Claimed out of TDS Paid Amount
TotalTCS Total TCS Amount
AmtTCSClaimedThisYear Claimed out of TCS Paid Amount
BSRCode BSR Code
DateDep Date of Deposit
SrlNoOfChaln Sl.No of Challan
Amt Deposited Amount
9.4.2 Sample Response
The following is the sample response:
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
8/20/2019 WebServices_Manual.pdf
43/69
Web Services User Manual
Page 43
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxxxxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
8/20/2019 WebServices_Manual.pdf
44/69
Web Services User Manual
Page 44
9.5 Error
9.5.1 Error Messages
The following table provides details on View 26AS - Error Messages:
View 26AS - Error Messages
Scenario Error Message
User ID not provided in the request Please provide the User ID.
User ID not provided in the request Please provide the User ID.
Incorrect User ID Authentication failed. Please provide a valid User ID.
Password not provided in the request Please provide the password
Incorrect Password Authentication failed. Please provide a valid Password.
Incorrect Client Pan Invalid Pan
Incorrect Client Dob Invalid Date of Birth/Incorporation.
Incorrect Assessment Year. Invalid Assessment Year
9.5.2 Sample Error
The following is the sample error:
ns0:Client
Error Message< /faultstring>
8/20/2019 WebServices_Manual.pdf
45/69
Web Services User Manual
Page 45
10 e-Filed Return Status
This web service can be used to view the latest e-Filed Return status for the PAN andassessment year mentioned. This is applicable for ERI users.
Pre-requisite: PAN user should be added as client of the respective ERI
10.1 WSDL DefinitionThe following table provides details on e-Filed Return Status - Interface Properties:
e-Filed Return Status - Interface Properties
Property Value
Definition URL https://incometaxindiaefiling.gov.in/e-
End point https://incometaxindiaefiling.gov.in/e-FilingWS/ditws
Namespace http://incometaxindiaefiling.gov.in/ditws /tds/v_1_0
Binding GetTDSPortSoap11
SOAP Version SOAP 1.1
Style Document
10.2 Operations
The following table provides details on e-Filed Return Status - Operation Properties:
e-Filed Return Status - Operation Properties
Property Value
Operation getReturnStatus
Style Document
Type Request-Response
Input getReturnStatusRequest
Output getReturnStatusResponse
Send Attachments False
Receive Attachments False
10.3 Request
The user id and password of ERI are required for authenticating the user. Onceauthenticated, then the user will be authorised to invoke the Web service.
8/20/2019 WebServices_Manual.pdf
46/69
Web Services User Manual
Page 46
10.3.1 Request Parameters
The following table provides details on e-Filed Return Status - Request Parameters:
e-Filed Return Status - Request Parameters
Field Name Description Mandatory
userName Valid e-Filing User ID. Yes
password Valid e-Filing password forthe user.
Yes
Pan Should be a valid Pan Yes
assessmentYear Should be an assessmentyear
Yes
10.3.2 Sample Request
The following is the sample request:
ERIA000000
*********
AAAAA0000A
YYYY-YY
10.4 Response
Latest e-Filed return (only ITR) status of the client and their corresponding
acknowledgement is the response.
10.4.1 Response Parameters
The following table provides details on e-Filed Return Status - Response Parameters:
e-Filed Return Status - Response Parameters
Field Name Description
result Collector/Deductor Name
ackNo Income From salary
8/20/2019 WebServices_Manual.pdf
47/69
Web Services User Manual
Page 47
10.4.2 Sample Response
The following is the sample response:
Return Processed
10000000000000
10.5 Error
10.5.1 Error Messages
The following table lists the error messages
e-Filed Return Status - Error Messages
Scenario Error Message
User ID not provided in the request Please provide the User ID.
Incorrect User ID Authentication failed. Please provide a valid User
Password not provided in the request Please provide the password
Incorrect Password Authentication failed. Please provide a validPassword.
Incorrect Client Pan Invalid Pan
Incorrect Assessment Year. Invalid Assessment Year
10.5.2 Sample Error
The following is the sample error:
ns0:Client
Error Message< /faultstring>
8/20/2019 WebServices_Manual.pdf
48/69
Web Services User Manual
Page 48
11 Know Your Jurisdictional A.O
This web service can be used to view Jurisdictional A.O. details for the PAN mentioned.
11.1 WSDL DefinitionThe following table provides details on Know Your Jurisdictional A.O - Interface
Properties:
Know Your Jurisdictional A.O - Interface Properties
Property Value
Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/JurisdictionalAOInfo.wsdl
End point https://incometaxindiaefiling.gov.in/e-FilingWS/ditws
Namespace http://incometaxindiaefiling.gov.in/ditws/JurisdictionalAO/v_1_0
Binding JurisdictionalAOInfoSOAP
SOAP Version SOAP 1.1
Style Document
11.2 Operations
The following table provides details on Know Your Jurisdictional A.O. - OperationProperties:
Know Your Jurisdictional A.O. - Operation Properties
Property Value
Operation getJurisdictionalAOStyle Document
Type Request-Response
Input getJurisdictionalAORequest
Output getJurisdictionalAOResponse
Send Attachments False
Receive Attachments False
11.3 Request
11.3.1
Request Parameters
The following table provides details on Know Your Jurisdictional A.O. - RequestParameters:
Know Your Jurisdictional A.O. - Request Parameters
Field Name Description Mandatory
panNum Valid PAN Yes
Once the user gives a valid PAN then the user will be authorized to invoke the web
service.
8/20/2019 WebServices_Manual.pdf
49/69
Web Services User Manual
Page 49
11.3.2 Sample Request
The following is the sample request:
?
11.4 ResponseThe Jurisdiction details of the given PAN will be displayed as a response.
11.4.1 Response Parameters
The following table provides details on Know Your Jurisdictional A.O - Response
Parameters:
Know Your Jurisdictional A.O - Response Parameters
Field Name Description
areaCode Area Code of the PAN
aoType AO Type
rangeCode Range Code
aoNumber AO Number
Jurisdiction Jurisdiction details
buildingName Building name
firstName First Name
middleName Middle Name
surName Sur Name
11.4.2 Sample Response
The following is the sample response:
8/20/2019 WebServices_Manual.pdf
50/69
8/20/2019 WebServices_Manual.pdf
51/69
Web Services User Manual
Page 51
12 Retrieve PAN Information
This web service can be used to retrieve pan information for the PAN mentioned. This isapplicable for External Agency users.
12.1 WSDL Definition
The following table provides details on Retrieve PAN - Interface Properties:
Retrieve PAN - Interface Properties
Property Value
Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/PanWS.wsdl
End point https://incometaxindiaefiling.gov.in/e-FilingWS/ditws
Namespace http://panws.dit.tcs.com/types/
Binding GetPanInfoSoapHttp
SOAP Version SOAP 1.1Style Document
12.2 Operations
The following table provides details on Retrieve PAN - Operation Properties:Retrieve PAN - Operation Properties
Property Value
Operation getPanInfo
Style DocumentType Request-Response
Input LoginInfo
Output PanInfo
Send Attachments False
Receive Attachments False
12.3 Request
The user id and password are required for authenticating the user. Once authenticated,then the user will be authorised to invoke the Web service.
12.3.1 Request Parameters
The following table provides details on Retrieve PAN - Request Parameters:
Retrieve PAN - Request Parameters
Field Name Description Mandatory
userName Valid e-Filing User ID. Yes
password Valid e-Filing password for the User. Yes
Pan Valid PAN of the client Yes
8/20/2019 WebServices_Manual.pdf
52/69
Web Services User Manual
Page 52
12.3.2 Sample Request
The following is the sample request:
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
12.4 ResponseDetails of the given PAN will be displayed as a response in the above format.
12.4.1 Response Parameters
The following table provides details on Retrieve PAN - Response Parameters:
Retrieve PAN - Response Parameters
Field Name Description
Pan PAN
Ffullname Father's full name
Address Address of the PAN
Dob Date of Birth of PAN
Fullname Assessee full name
Error Error if any
12.4.2 Sample Response
The following is the sample response:
8/20/2019 WebServices_Manual.pdf
53/69
Web Services User Manual
Page 53
xmlns="" xmlns:ns4="http://panws.dit.tcs.com/">
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxxxxxxxxxxxx
12.5 Error
12.5.1
Error Messages
The following table provides details on Retrieve PAN - Error Messages:
Retrieve PAN - Error Messages
Scenario Error Message
User ID not provided in request Please provide the User ID.
Incorrect User ID Authentication Please provide a valid User ID.
Password not provided in request Please provide the Password.
Incorrect Password Authenticationfailed. Please provide a valid Password.
PAN field left blank Please provide a PAN.
Less number of characters entered inPAN
Invalid PAN. Please retry.
PAN entered in wrong format Invalid PAN. Please retry.
PAN does not exist PAN does not exist
12.5.2 Sample Error
The following is the sample error:
ns0:Client
Error Message< /faultstring>
8/20/2019 WebServices_Manual.pdf
54/69
Web Services User Manual
Page 54
13 Retrieve TAN Information
This web service can be used to retrieve tan information for the TAN mentioned.
13.1 WSDL DefinitionThe following table provides details on Retrieve TAN - Interface Properties:
Retrieve TAN - Interface Properties
Property Value
Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/GetTAN.wsdl
End point https://incometaxindiaefiling.gov.in/e-FilingWS/ditws
Namespace http://tanws.dit.tcs.com/types/
Binding GetTANInfoPortSoap11
SOAP Version SOAP 1.1
Style Document
13.2 Operations
The following table provides details on Retrieve TAN - Operation Properties:
Retrieve TAN - Operation Properties
Property Value
Operation getTanInfo
Style Document
Type Request-Response
Input getTanInfo
Output TanInfoResponse
Send Attachments False
Receive Attachments False
13.3 RequestThe user id and password are required for authenticating the user. Once authenticated,then the user will be authorised to invoke the Web service.
8/20/2019 WebServices_Manual.pdf
55/69
Web Services User Manual
Page 55
13.3.1 Request Parameters
The following table provides details on Retrieve TAN - Request Parameters:
Retrieve TAN - Request Parameters
Field Name Description Mandatory
userName Valid e-Filing User ID. Yes
password Valid e-Filing password for the user. Yes
tanNo TAN of the client Yes
13.3.2 Sample Request
The following is the sample request:
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
13.4 ResponseThe TAN details of the given TAN will be displayed as a response in the above format.
13.4.1 Response Parameters
The following table provides details on Retrieve TAN - Response Parameters:
Retrieve TAN - Response Parameters
Field Name Description
Tan TAN
categoryOfDeductor Category of Deductor
Address Address
Pan PAN
Status Status
8/20/2019 WebServices_Manual.pdf
56/69
Web Services User Manual
Page 56
emailId1 E-mail Id
emailId2 Alternate E-mail Id
areaCode Area code
AOType AO type
rangeCode Range code
AONumber AO number
13.4.2 Sample Response
The following is the sample response:
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
8/20/2019 WebServices_Manual.pdf
57/69
Web Services User Manual
Page 57
13.5 Error
13.5.1 Error Messages
The following table provides details on Retrieve TAN - Error Messages:
Retrieve TAN - Error Messages
Scenario Error Message
User ID not provided in request 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.
13.5.2 Sample Error
The following is the sample error:
ns0:Client
Error Message< /faultstring>
8/20/2019 WebServices_Manual.pdf
58/69
Web Services User Manual
Page 58
14 Bulk ITR
This web service can be used to submit ITR in bulk. This is applicable for ERI users.
14.1 WSDL DefinitionThe following table provides details on Bulk ITR - Interface Properties:
Bulk ITR - Interface Properties
Property Value
Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/submitITR.wsdl
End point https://incometaxindiaefiling.gov.in/e-FilingWS/ditws
Namespace http://incometaxindiaefiling.gov.in/itrservice/v_1_0
Binding ITRServiceSoapBinding
SOAP Version SOAP 1.1
Style Document
14.2 Operations
The following table provides details on Bulk ITR - Operation Properties:Bulk ITR - Operation Properties
Property Value
Operation submitITR
Style Document
Type Request-Response
Input DITWSAuthInfoEle
Output DITWSResponseEle
Send Attachments False
Receive Attachments False
14.3
RequestThe user id and password are required for authenticating the user. Once authenticated,then the user will be authorised to invoke the Web service.
14.3.1 Request Parameters
The following table provides details on Bulk ITR - Request Parameters:
Bulk ITR - Request Parameters
Field Name Description Mandatory
userID Valid e-Filing User ID. Yes
password Valid e-Filing password for the user. Yes
8/20/2019 WebServices_Manual.pdf
59/69
Web Services User Manual
Page 59
certChain Certification chain Yes
signature Signature Yes
Zip Attachment Zip attachment whichcontains ITR xml files
Yes
14.3.2 Sample Request
The following is the sample request:
xxxxxxxxxxxxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
Note:The attachmentZip contains the ITR xml files.
14.4
ResponseThe Token number for the Submit BULK ITR will be displayed as a response in the aboveformat.
14.4.1 Response Parameters
The following table provides details on Bulk ITR - Response Parameters:
Bulk ITR - Response Parameters
Field Name Description
Result Token Number
14.4.2 Sample Response
The following is the sample response:
xxxxxxxxxx
8/20/2019 WebServices_Manual.pdf
60/69
Web Services User Manual
Page 60
14.5 Error
14.5.1 Error Messages
The following table lists the error messages
Bulk ITR - Error Messages
Scenario Error Message
User ID not provided in request Please provide the User ID.
Incorrect User ID Authenticationfailed.
Please provide a valid User ID.
Password not provided in request Please provide the password
Incorrect Password Authenticationfailed.
Please provide a valid Password.
Certificate chain not provided Please provide the Certificate Chain
Signature not provided Please provide a Digital Signature Certificate.
The digital signature certificate doesnot match with the one registered
Invalid Digital Signature Certificate. Please retry.
Invalid Digital signature certificate. Invalid Digital Signature Certificate. Pleasecontact your Certificate Provider.
The trusted parent certificate couldnot be verified
Invalid Digital Signature Certificate. The trustedparent certificate could not be verified.
14.5.2
Sample ErrorThe following is the sample error:
ns0:Client
Error Message< /faultstring>
8/20/2019 WebServices_Manual.pdf
61/69
Web Services User Manual
Page 61
15 Request for Intimation U/S 143(1)/154
This web service can be used to request the Intimation u/s 143(1)/154. This is applicablefor ERI users.
Pre-requisite: PAN user should be added as client of the respective ERI
15.1 WSDL DefinitionThe following table provides details on Request for intimation u/s 143(1)/154 - Interface
Properties:
Request for intimation u/s 143(1)/154 - Interface Properties
Property Value
Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/RequestForIntimationInfo.wsdl
End point https://incometaxindiaefiling.gov.in/e-FilingWS/ditws
Namespace http://incometaxindiaefiling.gov.in/ditws/ReqForIntimation/v_1_0
Binding ReqForIntimationInfoSOAP
SOAP Version SOAP 1.1
Style Document
15.2 Operations
The following table provides details on Request for intimation u/s 143(1)/154 -
Operation Properties:Request for intimation u/s 143(1)/154 - Operation Properties
Property Value
Operation getReqForIntimation
Style Document
Type Request-Response
Input getReqForIntimationRequest
Output getReqForIntimationResponse
Send Attachments False
Receive Attachments False
15.3 RequestThe user id and password are required for authenticating the user. Once authenticated,then the user will be authorised to invoke the Web service.
8/20/2019 WebServices_Manual.pdf
62/69
Web Services User Manual
Page 62
15.3.1 Request Parameters
The following table provides details on Request for intimation u/s 143(1)/154 - Request
Parameters:
Request for intimation u/s 143(1)/154 - Request Parameters
Field Name Description Mandatory
userName Valid e-Filing User ID. Yes
password Valid e-Filing password for the User. Yes
pan Valid PAN of the client Yes
assessmentYear Assessment Year Yes
category C101 for Rectification order u/s
154C103 for Intimation u/s 143(1)
Yes
15.3.2 Sample Request
The following is the sample request:
XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX
15.4 ResponseThe result for the Request for intimation u/s 143(1)/154 for given PAN, assessment yearand category will be displayed as a response in the below format.
8/20/2019 WebServices_Manual.pdf
63/69
Web Services User Manual
Page 63
15.4.1 Response Parameters
The following table provides details on Request for intimation u/s 143(1)/154 - ResponseParameters:
Request for intimation u/s 143(1)/154 - Response Parameters
Field Name Description
result The success message with the Transaction ID will bedisplayed to the assesse.
15.4.2 Sample Response
The following is the sample response:
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
15.5 Error
15.5.1
Error Messages
The following table lists the error messages
Request for intimation u/s 143(1)/154 - Error Messages
Scenario Error Message
User ID not provided in request Please provide the User ID.
Incorrect User ID Authentication Please provide a valid User ID.
Password not provided in request Please provide the Password.
Incorrect Password Authenticationfailed.
Please provide a valid Password.
PAN field left blank Please provide a PAN.
Less number of characters entered inPAN
Invalid PAN. Please retry.
PAN entered in wrong format Invalid PAN. Please retry.
PAN does not exist PAN does not exist
AssessmentYear in wrong format Should be valid and consecutive
8/20/2019 WebServices_Manual.pdf
64/69
Web Services User Manual
Page 64
15.5.2 Sample Error
The following is the sample error:
ns0:Client
Error Message< /faultstring>
8/20/2019 WebServices_Manual.pdf
65/69
Web Services User Manual
Page 65
16 Request of XML/ITR Form/Receipt (PDF)
This web service can be used to retrieve XML/ITR Form/Receipt (PDF). This is applicablefor ERI users.
Pre-requisite: PAN user should be added as client of the respective ERI
16.1 WSDL DefinitionThe following table provides details on Retrieval of XML/ITR Form (PDF) - Interface
Properties:
Retrieval of XML/ITR Form/Receipt (PDF) - Interface Properties
Property Value
Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/MailFiledReturns.wsdl
End point https://incometaxindiaefiling.gov.in/e-FilingWS/ditws
Namespace http://incometaxindiaefiling.gov.in/ws/ds/itr/v_1_0
Binding FiledReturnsPortSoap11
SOAP Version SOAP 1.1
Style Document
16.2 Operations
The following table provides details on Retrieval of XML/ITR Form (PDF) - Operation
Properties:Retrieval of XML/ITR Form/Receipt (PDF) - Operation Properties
Property Value
Operation ITRByAckNo
Style Document
Type Request-Response
Input itrAckNoRequestEle, itrTokenNoRequestEle
Output ITRByAckNoResponse, ITRByTokenNoResponse
Send Attachments False
Receive Attachments False
8/20/2019 WebServices_Manual.pdf
66/69
Web Services User Manual
Page 66
16.3 RequestThe user id and password are required for authenticating the user. Once authenticated,then the user will be authorised to invoke the Web service.
16.3.1 Request Parameters
Retrieval of XML/ITR Form/Receipt (PDF) - Request Parameters
Field Name Description Mandatory
userID Valid e-Filing User ID. Yes
password Valid e-Filing password for the User. Yes
certChain DSC Certificate Chain Yes
fileType XML or FORM or RECEIPT Yes
acknowledgementNo e-Filing Acknowledgment Number Yes
panID Valid PAN Yes
tokenNumber Token Number of Bulk ITR upload Yes
16.3.2 Sample Request
The following is the sample request for ITR by acknowledgement number:
Request for ITR using acknowledgement number.
XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX
8/20/2019 WebServices_Manual.pdf
67/69
8/20/2019 WebServices_Manual.pdf
68/69
Web Services User Manual
Page 68
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Response for ITR using Token number.
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
16.5 Error
16.5.1 Error Messages
The following table lists the error messages
Retrieval of XML/ITR Form/Receipt (PDF) - Error Messages
Scenario Error Message
User ID not provided in request Please provide the User ID.
Incorrect User ID Authentication Please provide a valid User ID.
Password not provided in request Please provide the Password.
Incorrect Password Authenticationfailed.
Please provide a valid Password.
PAN field left blank Please provide a PAN.
Less number of characters entered inPAN
Invalid PAN. Please retry.
PAN entered in wrong format Invalid PAN. Please retry.
PAN does not exist PAN does not exist
Certificate chain not provided Please provide the Certificate Chain
The digital signature certificate doesnot match with the one registered
Invalid Digital Signature Certificate. Please retry
8/20/2019 WebServices_Manual.pdf
69/69
Web Services User Manual
Invalid Digital signature certificate Invalid Digital Signature Certificate. Please
contact yourCertificate Provider
The trusted parent certificate couldnot be verified
Invalid Digital Signature Certificate. The trusted
parentCertificate could not be verified.
Acknowledgment Number notprovided in request
Please provide Acknowledgment Number.
Acknowledgment Number provided isnot valid
Invalid acknowledgment number
16.5.2 Sample Error
The following is the sample error:
ns0:Client
Error Message< /faultstring>