Professional Documents
Culture Documents
Page 1
10
11
12
13
14
BULK ITR................................................................................................. 58
15
16
Page 2
Expanded Form
26AS
26 Annual Statement
A.O
Assessing Officer
A.Y
Assessment Year
DIT
ERI
e-Return Intermediary
HTTP
ITR
PAN
TAN
XML
Page 3
Page 4
Value
Definition URL
https://incometaxindiaefiling.gov.in/eFilingWS/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:
Page 5
Description
Mandatory
userName
Yes
password
Yes
Pan
Yes
assessmentYear
Assessment Year
Yes
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:
Page 6
Description
recBsrCode
recChallanAmount
Challan Amount
recChallanDate
Challan Date
recChallanNo
Challan Number
amountIn26As
Amount in 26AS
amountRecorded
Amount Recorded
deductorName
Deductor Name
tanNo
TAN
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
Incorrect User ID
Incorrect Password
Page 8
Page 9
Value
Definition URL
https://incometaxindiaefiling.gov.in/eFilingWS/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.1
Style
Document
2.2 Operations
The following table provides details on Add Client - Operation Properties:
Add Client - Operation Properties
Property
Value
Operation
addClientDetails
Style
Document
Type
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.
Page 10
Description
Mandatory
userName
Yes
password
Yes
Pan
Yes
dob
Yes
E-mail Id of client
Yes
addClient
tanNumber
TAN
FinancialYear
Financial Year
bsrCode
BSR Code
Yes if
Assessment Year
'advanceTaxOptionType' is
selected
Yes if
Amount Paid
'advanceTaxOptionType' is
selected
Yes if
assessmentYear
amountPaid
'advanceTaxOptionType' is
selected
2.3.2 Sample Request
The following is the sample request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:v="http://incometaxindiaefiling.gov.in/ditws/addClientDetails/v_1_0">
<soapenv:Header/>
<soapenv:Body>
<v:addClientDetails>
<v:LoginInfo>
<v:userName>UserName</v:userName>
<v:password>password</v:password>
</v:LoginInfo>
<v:addClient>
<v:addClientDetails>
<v:panNumber>AAAPA1111A</v:panNumber>
<v:dateOfBirth>1967-05-23</v:dateOfBirth>
<v:email>kum@fmail.com</v:email>
</v:addClientDetails>
Page 11
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
2.5 Error
2.6.1 Error Messages
The following table lists the error messages
Add Client - Error Messages
Scenario
Error Message
Incorrect User ID
Incorrect Password
Page 13
Value
End point
https://incometaxindiaefiling.gov.in/eFilingWS/ditws/submitBulkPan.wsdl
https://incometaxindiaefiling.gov.in/e-FilingWS/ditws
Namespace
http://incometaxindiaefiling.gov.in/bulkPanservice/v_1_0
Binding
BulkPanServiceSoapBinding
SOAP 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
submitBulkPan
Style
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.
Page 14
Description
Mandatory
userName
Yes
password
Yes
XML File
Yes
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 XMLs Login to e-Filing Application then
Go to Bulk PAN Query Token Status/Token Details.
Page 15
Description
Token Number
3.5 Error
3.5.1 Error Messages
The following table lists the error messages
Bulk PAN Verification - Error Messages
Scenario
Error Message
Incorrect User ID
Incorrect Password
Page 16
Page 17
The following table provides details on Outstanding Tax Demand- Interface Properties:
Outstanding Tax Demand- Interface Properties
Property
Value
Definition URL
https://incometaxindiaefiling.gov.in/eFilingWS/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
Style
Document
Type
Request-Response
Input
OutstandingTaxDemandRequest
Output
OutstandingTaxDemandResponse
Send Attachments
False
Receive Attachments
False
Page 18
Description
Mandatory
username
Yes
password
Yes
pan No
Yes
Assessment Year
Yes
4.4 Response
Assessment Year ,Section Code, Demand Identification Number, Date on which demand
is raised and Outstanding demand amount will be the response. And the response will
vary based on the request details provided.
Page 19
Description
asstYear
Assessment Year
section
Section Code
DIN
demandDate
outstandDemand
Page 20
Error Message
Incorrect User ID
Incorrect Password
Page 21
Value
Definition URL
https://incometaxindiaefiling.gov.in/eFilingWS/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 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.
Page 22
Description
Mandatory
userName
Yes
password
Yes
panNo
asseessmentYear
Yes
Yes
5.4 Response
ITR-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
result
Description
ITR-V Status
Page 23
5.5 Error
5.5.1 Error Messages
The following table provides details on ITR-V Status - Error Messages:
ITR-V Status - Error Messages
Scenario
Error Message
Incorrect User ID
Incorrect Password
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 Attachments
Receive Attachments
False
False
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.
Page 25
Description
Mandatory
userName
Yes
password
Yes
panNo
Yes
asseessmentYear
Yes
6.4 Response
Refund/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
result
Description
Refund Status
Page 26
6.5 Error
6.5.1 Error Messages
The following table lists the error messages
Refund/Demand Status - Error Messages
Scenario
Error Message
Incorrect User ID
Incorrect Password
Page 27
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
Page 28
Description
Mandatory
userName
Yes
password
Yes
certChain
Yes
signature
DSC Signature
Yes
acknowledgementNo
Yes
Page 29
Description
Status of ITR processing
Page 30
Error Message
Incorrect User ID
Incorrect Password
Page 31
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 - Operation
Properties:
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.
Page 32
Description
Mandatory
userName
Yes
password
Yes
certChain
signature
DSC Signature
Yes
tokenNumber
Yes
Yes
7.4 Response
ITR-V for the corresponding Token number and PAN is sent to registered Email ID is
the response.
Page 33
Description
result
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
Incorrect User ID
Incorrect Password
Page 34
Invalid token
Invalid PAN
Page 35
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.
Page 36
Description
Mandatory
userName
Yes
password
Yes
Pan
Yes
assessmentYear
Assessment Year
Yes
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.
Page 37
Description
panNo
PAN
asseessmentYear
Assessment Year
itrName
ITR name
rectificationReferenceNo
Date
Rectification Date
cpcOrderNo
Date
Status
Status
Page 38
8.5 Error
8.5.1 Error Messages
The following table lists the error messages
Rectification Status - Error Messages
Scenario
Error Message
Incorrect User ID
Incorrect Password
Page 39
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.
Page 40
Description
Mandatory
userName
Yes
password
Yes
Pan
Dob
Yes
assessmentYear
Assessment Year
Yes
Yes
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 Refund
details for an Assessment Year will be the response.
Page 41
Description
TAN
EmployerOrDeductorOrCollecterName
Collector/Deductor Name
IncChrgSal
TotalTDSSal
TDS on salary
TotTDSOnAmtPaid
ClaimOutOfTotTDSOnAmtPaid
TotalTCS
AmtTCSClaimedThisYear
BSRCode
BSR Code
DateDep
Date of Deposit
SrlNoOfChaln
Sl.No of Challan
Amt
Deposited Amount
Page 42
Page 43
Error Message
Incorrect User ID
Incorrect Password
Invalid Pan
Page 44
Value
Definition URL
End point
https://incometaxindiaefiling.gov.in/eFilingWS/ditws/returnstatus.wsdl
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. Once
authenticated, then the user will be authorised to invoke the Web service.
Page 45
Description
Mandatory
userName
Yes
password
Yes
Pan
Yes
assessmentYear
Should be an assessment
year
Yes
10.3.2Sample Request
The following is the sample request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:v="http://incometaxindiaefiling.gov.in/ditws/ITRVStatus/v_1_0">
<soapenv:Header/>
<soapenv:Body>
<v:getReturnStatusRequest>
<LoginInfo>
<userName>ERIA000000</userName>
<password>********* </password>
</LoginInfo>
<ReturnInput>
<panNo>AAAAA0000A</panNo>
<asseessmentyear>YYYY-YY</asseessmentyear>
</ReturnInput>
</v:getReturnStatusRequest>
</soapenv:Body>
</soapenv:Envelope>
10.4 Response
Latest
e-Filed return
(only
ITR) status
of
the client
and
their
corresponding
Description
result
Collector/Deductor Name
ackNo
Page 46
10.5 Error
10.5.1Error Messages
The following table lists the error messages
e-Filed Return Status - Error Messages
Scenario
Error Message
Incorrect User ID
Invalid Pan
10.5.2Sample Error
The following is the sample error:
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header/>
<env:Body>
<env:Fault xmlns:ns0="http://schemas.xmlsoap.org/soap/envelope/">
<faultcode>ns0:Client</faultcode>
<faultstring xml:lang="en">Error Message< /faultstring>
</env:Fault>
</env:Body>
</env:Envelope>
Page 47
The 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/eFilingWS/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. - Operation
Properties:
Know Your Jurisdictional A.O. - Operation Properties
Property
Value
Operation
getJurisdictionalAO
Style
Document
Type
Request-Response
Input
getJurisdictionalAORequest
Output
getJurisdictionalAOResponse
Send Attachments
False
Receive Attachments
False
11.3 Request
11.3.1Request Parameters
The following table provides details on Know Your Jurisdictional A.O. - Request
Parameters:
Know Your Jurisdictional A.O. - Request Parameters
Field Name
panNum
Description
Valid PAN
Mandatory
Yes
Once the user gives a valid PAN then the user will be authorized to invoke the web
service.
Page 48
11.4 Response
The Jurisdiction details of the given PAN will be displayed as a response.
11.4.1Response 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
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.2Sample Response
The following is the sample response:
<SOAP-ENV:Envelope xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
Page 49
11.5 Error
11.5.1Error Messages
The following table lists the error messages
Know Your Jurisdictional A.O - Error Messages
Scenario
Error Message
Incorrect PAN
11.5.2Sample Error
The following is the sample error:
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header/>
<env:Body>
<env:Fault xmlns:ns0="http://schemas.xmlsoap.org/soap/envelope/">
<faultcode>ns0:Client</faultcode>
<faultstring xml:lang="en">Error Message< /faultstring>
</env:Fault>
</env:Body>
</env:Envelope>
Page 50
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.1
Style
Document
12.2 Operations
The following table provides details on Retrieve PAN - Operation Properties:
Retrieve PAN - Operation Properties
Property
Value
Operation
getPanInfo
Style
Document
Type
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.1Request Parameters
The following table provides details on Retrieve PAN - Request Parameters:
Retrieve PAN - Request Parameters
Field Name
Description
Mandatory
userName
Yes
password
Yes
Pan
Yes
Page 51
12.4 Response
Details of the given PAN will be displayed as a response in the above format.
12.4.1Response Parameters
The following table provides details on Retrieve PAN - Response Parameters:
Retrieve PAN - Response Parameters
Field Name
Description
Pan
PAN
Ffullname
Address
Dob
Fullname
Error
Error if any
12.4.2Sample Response
The following is the sample response:
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header />
<env:Body>
<ns4:getPanInfoResponse xmlns:ns2="http://panws.dit.tcs.com/types/"
Page 52
12.5 Error
12.5.1Error Messages
The following table provides details on Retrieve PAN - Error Messages:
Retrieve PAN - Error Messages
Scenario
Error Message
12.5.2Sample Error
The following is the sample error:
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header/>
<env:Body>
<env:Fault xmlns:ns0="http://schemas.xmlsoap.org/soap/envelope/">
<faultcode>ns0:Client</faultcode>
<faultstring xml:lang="en">Error Message< /faultstring>
</env:Fault>
</env:Body>
</env:Envelope>
Page 53
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 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.
Page 54
Description
Mandatory
userName
Yes
password
Yes
tanNo
Yes
13.3.2Sample Request
The following is the sample request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:typ="http://tanws.dit.tcs.com/types/">
<soapenv:Header/>
<soapenv:Body>
<typ:getTanInfo>
<LoginInfo>
<userName>xxxxxxxxxx</userName>
<password>xxxxxxxxxx</password>
</LoginInfo>
<TanNum>
<tanNo>xxxxxxxxxx</tanNo>
</TanNum>
</typ:getTanInfo>
</soapenv:Body>
</soapenv:Envelope>
13.4 Response
The TAN details of the given TAN will be displayed as a response in the above format.
13.4.1Response 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
Page 55
E-mail Id
emailId2
Alternate E-mail Id
areaCode
Area code
AOType
AO type
rangeCode
Range code
AONumber
AO number
13.4.2Sample Response
The following is the sample response:
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header/>
<env:Body>
<ns3:TanInfoResponse xmlns:ns3="http://tanws.dit.tcs.com/types/">
<TanInfo>
<tan>xxxxxxxxxx</tan>
<categoryOfDeductor>xxxxxxxxxx</categoryOfDeductor>
<fullname>xxxxxxxxxx</fullname>
<address>xxxxxxxxxx</address>
<pan>xxxxxxxxxx</pan>
<status>xxxxxxxxxx</status>
<emailId1>xxxxxxxxxx</emailId1>
<emailId2>xxxxxxxxxx</emailId2>
<areaCode>xxxxxxxxxx</areaCode>
<AOType>xxxxxxxxxx</AOType>
<rangeCode>xxxxxxxxxx</rangeCode>
<AONumber>xxxxxxxxxx</AONumber>
</TanInfo>
</ns3:TanInfoResponse>
</env:Body>
</env:Envelope>
Page 56
Error Message
13.5.2Sample Error
The following is the sample error:
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header/>
<env:Body>
<env:Fault xmlns:ns0="http://schemas.xmlsoap.org/soap/envelope/">
<faultcode>ns0:Client</faultcode>
<faultstring xml:lang="en">Error Message< /faultstring>
</env:Fault>
</env:Body></env:Envelope>
Page 57
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 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.
14.3.1Request Parameters
The following table provides details on Bulk ITR - Request Parameters:
Bulk ITR - Request Parameters
Field Name
Description
Mandatory
userID
Yes
password
Yes
Page 58
Certification chain
Yes
signature
Signature
Yes
Zip
Yes
14.3.2Sample Request
The following is the sample request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:v="http://incometaxindiaefiling.gov.in/ws/ds/common/v_1_0">
<soapenv:Header/>
<soapenv:Body>
<v:DITWSAuthInfoEle>
<v:userID>xxxxxxxxxx</v:userID>
<v:password>xxxxxxxxxx</v:password>
<v:certChain>xxxxxxxxxx</v:certChain>
<v:signature>xxxxxxxxxx</v:signature>
</v:DITWSAuthInfoEle>
</soapenv:Body>
</soapenv:Envelope>
Note:The attachmentZip contains the ITR xml files.
14.4 Response
The Token number for the Submit BULK ITR will be displayed as a response in the above
format.
14.4.1Response Parameters
The following table provides details on Bulk ITR - Response Parameters:
Bulk ITR - Response Parameters
Field Name
Result
Description
Token Number
14.4.2Sample Response
The following is the sample response:
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header/>
<env:Body>
<ns2:DITWSResponseEle
xmlns:ns2="http://incometaxindiaefiling.gov.in/ws/ds/common/v_1_0">
<ns2:result>xxxxxxxxxx</ns2:result>
</ns2:DITWSResponseEle>
</env:Body>
</env:Envelope>
Page 59
Error Message
Incorrect
failed.
User
ID
Authentication
Incorrect
failed.
Password
Authentication
14.5.2Sample Error
The following is the sample error:
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header/>
<env:Body>
<env:Fault xmlns:ns0="http://schemas.xmlsoap.org/soap/envelope/">
<faultcode>ns0:Client</faultcode>
<faultstring xml:lang="en">Error Message< /faultstring>
</env:Fault>
</env:Body>
</env:Envelope>
Page 60
The 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/eFilingWS/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 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.
Page 61
Description
Mandatory
userName
Yes
password
Yes
pan
Yes
assessmentYear
Assessment Year
Yes
category
Yes
15.3.2Sample Request
The following is the sample request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:v="http://incometaxindiaefiling.gov.in/ditws/ReqForIntimation/v_1_0">
<soapenv:Header/>
<soapenv:Body>
<v:getReqForIntimationRequest>
<LoginInfo>
<userName>XXXXXXXXXXXXXXX</userName>
<password>XXXXXXXXXXXXXXX</password>
</LoginInfo>
<intimationDtls>
<pan>XXXXXXXXXXXXXXX</pan>
<assessmentYear>XXXXXXXXXXXXXXX</assessmentYear>
<category>XXXXXXXXXXXXXXX</category>
</intimationDtls>
</v:getReqForIntimationRequest>
</soapenv:Body>
</soapenv:Envelope>
15.4 Response
The result for the Request for intimation u/s 143(1)/154 for given PAN, assessment year
and category will be displayed as a response in the below format.
Page 62
Description
The success message with the Transaction ID will be
displayed to the assesse.
15.4.2Sample Response
The following is the sample response:
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header/>
<env:Body>
<ns3:getReqForIntimationResponse
xmlns:ns3="http://incometaxindiaefiling.gov.in/ditws/ReqForIntimation/v_1_0">
<result>XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</result>
</ns3:getReqForIntimationResponse>
</env:Body>
</env:Envelope>
15.5 Error
15.5.1Error Messages
The following table lists the error messages
Request for intimation u/s 143(1)/154 - Error Messages
Scenario
Error Message
Page 63
Page 64
The 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/eFilingWS/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
Page 65
Description
Mandatory
userID
Yes
password
Yes
certChain
Yes
fileType
Yes
acknowledgementNo
Yes
panID
Valid PAN
Yes
tokenNumber
Yes
16.3.2Sample Request
The following is the sample request for ITR by acknowledgement number:
Request for ITR using acknowledgement number.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:v="http://incometaxindiaefiling.gov.in/ws/ds/itr/v_1_0"
xmlns:v1="http://incometaxindiaefiling.gov.in/ws/ds/common/v_1_0">
<soapenv:Header/>
<soapenv:Body>
<v:ITRByAckNoRequest>
<v:authInfo>
<v1:userID>XXXXXXXXXXXXXXX</v1:userID>
<v1:password>XXXXXXXXXXXXXXX</v1:password>
<v1:certChain>XXXXXXXXXXXXXXX</v1:certChain>
</v:authInfo>
<v:fileType>XXXXXXXXXXXXXXX</v:fileType>
<v:acknowledgementNo>XXXXXXXXXXXXXXX</v:acknowledgementNo>
</v:ITRByAckNoRequest>
</soapenv:Body>
</soapenv:Envelope>
Page 66
16.4 Response
The result message for the Retrieval of XML/ITR Form will be displayed as a response in
the below format.
16.4.1Response Parameters
The following table provides details on Retrieval of XML/ITR Form (PDF) - Response
Parameters:
Retrieval of XML/ITR Form/Receipt (PDF) - Response Parameters
Field Name
result
Description
The success message with the Acknowledgement
number will be displayed to the user.
16.4.2Sample Response
The following is the sample response for ITR by acknowledgement number:
Response for ITR using acknowledgement number.
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header/>
<env:Body>
Page 67
16.5 Error
16.5.1Error Messages
The following table lists the error messages
Retrieval of XML/ITR Form/Receipt (PDF) - Error Messages
Scenario
Error Message
Page 68
16.5.2Sample Error
The following is the sample error:
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header/>
<env:Body>
<env:Fault xmlns:ns0="http://schemas.xmlsoap.org/soap/envelope/">
<faultcode>ns0:Client</faultcode>
<faultstring xml:lang="en">Error Message< /faultstring>
</env:Fault>
</env:Body>
</env:Envelope>
Page 69