Web Services User Manual V 1.0

User Manual:

Open the PDF directly: View PDF .
Page Count: 80

Download
Open PDF In Browser	View PDF

e-Filing Web Services User Manual
Version 1.2

January 2015

Webservice User Manual V1.2

REVISION LIST
Document Name: Webservice User Manual
Version Number: 1.2
Version

Date

1.0

11th Nov 2014

1.1

30th Dec 2014

1.2

08th Jan 2015

Revision Details
Initial Document
Request for Intimation u/s
143(1)/ 154 is added
Retrieval of XML/ITR Form is
added

Page

2

Section

Webservice User Manual V1.2

LIST OF ABBREVIATIONS
Abbreviation

Expanded Form

PAN

Permanent Account Number

TAN

Tax Deduction Account Number

DIT

Department of Income Tax

XML

Extensible Markup Language

HTTP

Hypertext Transfer Protocol

ITR

Income Tax Return

26AS

26 Annual Statement

A.O

Assessing Officer

A.Y

Assessment Year

Page

3

Webservice User Manual V1.2

T ABLE OF CONTENTS
Introduction ................................................................................................................... 6
1. Tax Credit Mismatch ................................................................................................ 8
2. Add Client Details .................................................................................................. 13
3. Bulk PAN verification ............................................................................................. 18
4. Outstanding tax demand ....................................................................................... 22
5. ITR-V Status ............................................................................................................ 26
6. Refund/Demand Status ......................................................................................... 30
7. Retrieve ITR-V ......................................................................................................... 34
8. Retrieve Rectification Status ................................................................................ 42
9. Retrieve 26AS Information .................................................................................... 46
10. e-FIled Return Status ........................................................................................... 51
11. KnowYour Jurisdictional A.O. ............................................................................ 55
12. Retrive PAN Information...................................................................................... 59
13. Retrive TAN Information ...................................................................................... 63
14. Bulk ITR ................................................................................................................. 67
15. Request For Intimation U/S 143(1)/154.............................................................. 71
16. Retrieval of XML/ITR Form .................................................................................. 71

Page

4

Webservice User Manual V1.2

LIST OF TABLES
Table 1: Tax Credit Mismatch - Interface Properties ................................................................. 8
Table 2: Tax Credit Mismatch - Operation Properties ............................................................... 8
Table 3: Tax Credit Mismatch - Request Parameters ................................................................. 9
Table 4: Tax Credit Mismatch - Response Parameters ............................................................ 10
Table 5: Tax Credit Mismatch - Error Messages ..................................................................... 12
Table 6: Add Client - Interface Properties ............................................................................... 13
Table 7: Add Client - Operation Properties .............................................................................. 13
Table 8: Add Client - Request Parameters ............................................................................... 14
Table 9: Add Client - Response Parameters ............................................................................. 15
Table 10: Add Client - Error Messages .................................................................................... 16
Table 11: Bulk PAN Verification - Interface Properties ........................................................... 18
Table 12: Bulk PAN Verification - Operation Properties ......................................................... 18
Table 13: Bulk PAN Verification - Request Parameters .......................................................... 19
Table 14: Bulk PAN Verification - Response Parameters ........................................................ 19
Table 15: Bulk PAN Verification - Error Messages ................................................................. 20
Table 16: Outstanding Tax Demand- Interface Properties ....................................................... 22
Table 17: Outstanding Tax Demand- Operation Properties ..................................................... 22
Table 18: Outstanding Tax Demand- Request Parameters....................................................... 23
Table 19: Outstanding Tax Demand - Response Parameters ................................................... 24
Table 20: Outstanding Tax Demand - Error Messages ............................................................ 25
Table 21: ITR-V Status - Interface Properties ......................................................................... 26
Table 22: ITR-V Status - Operation Properties ........................................................................ 26
Table 23: ITR-V Status - Request Parameters ......................................................................... 27
Table 24: ITR-V Status - Response Parameters ....................................................................... 28
Table 25: ITR-V Status - Error Messages ................................................................................ 29
Table 26: Refund/Demand Status - Interface Properties .......................................................... 30
Table 27: Refund/Demand Status - Operation Properties ........................................................ 30
Table 28: Refund/Demand Status - Request Parameters ......................................................... 31
Table 29: Refund/Demand Status - Response Parameters ....................................................... 32
Table 30: Refund/Demand Status - Error Messages ................................................................ 33
Table 31: Retrieve ITR-V with Acknowledgment No - Interface Properties .......................... 34
Table 32: Retrieve ITR-V with Acknowledgment No - Operation Properties ......................... 34
Table 33: Retrieve ITR-V with Acknowledgment No - Request Parameters .......................... 35
Table 34: Retrieve ITR-V with Acknowledgment No - Response Parameters ........................ 36
Table 35: Retrieve ITR-V with Acknowledgment No - Error Messages ................................. 37
Table 36: Retrieve ITR-V with Token No - Interface Properties ............................................. 38
Table 37: Retrieve ITR-V with Token No - Operation Properties ........................................... 38
Table 38: Retrieve ITR-V with Token No - Request Parameters............................................. 39
Table 39: Retrieve ITR-V with Token No - Response Parameters .......................................... 40
Table 40: Retrieve ITR-V with Token No - Error Messages ................................................... 41
Table 41: Rectification Status - Interface Properties ............................................................... 42
Table 42: Rectification Status - Operation Properties .............................................................. 42
Table 43: Rectification Status - Request Parameters ............................................................... 43
Table 44: Rectification Status - Response Parameters ............................................................. 44
Table 45: Rectification Status - Error Messages ...................................................................... 45
Table 46: View 26AS - Interface Properties ............................................................................ 46
Table 47: View 26AS - Operation Properties........................................................................... 46
Table 48: View 26AS - Request Parameters ............................................................................ 47
Page

5

Webservice User Manual V1.2

Table 49: View 26AS - Response Parameters .......................................................................... 48
Table 50: View 26AS - Error Messages ................................................................................... 50
Table 51: e-Filed Return Status - Interface Properties ............................................................. 51
Table 52: e-Filed Return Status - Operation Properties ........................................................... 51
Table 53: e-Filed Return Status - Request Parameters............................................................. 52
Table 54: e-Filed Return Status - Response Parameters .......................................................... 53
Table 55: e-Filed Return Status - Error Messages ................................................................... 54
Table 56: Know Your Jurisdictional A.O - Interface Properties .............................................. 55
Table 57: Know Your Jurisdictional A.O. - Operation Properties ........................................... 55
Table 58: Know Your Jurisdictional A.O. - Request Parameters ............................................. 56
Table 59: Know Your Jurisdictional A.O - Response Parameters............................................ 57
Table 60: Know Your Jurisdictional A.O - Error Messages ..................................................... 58
Table 61: Retrieve PAN - Interface Properties ......................................................................... 59
Table 62: Retrieve PAN - Operation Properties ...................................................................... 59
Table 63: Retrieve PAN - Request Parameters ........................................................................ 60
Table 64: Retrieve PAN - Response Parameters ...................................................................... 61
Table 65: Retrieve PAN - Error Messages ............................................................................... 62
Table 66: Retrieve TAN - Interface Properties ........................................................................ 63
Table 67: Retrieve TAN - Operation Properties ....................................................................... 63
Table 68: Retrieve TAN - Request Parameters ........................................................................ 64
Table 69: Retrieve TAN - Response Parameters ...................................................................... 65
Table 70: Retrieve TAN - Error Messages ............................................................................... 66
Table 71: Bulk ITR - Interface Properties ................................................................................ 67
Table 72: Bulk ITR - Operation Properties .............................................................................. 67
Table 73: Bulk ITR - Request Parameters ............................................................................... 68
Table 74: Bulk ITR - Response Parameters ............................................................................. 69
Table 75: Bulk ITR - Error Messages ...................................................................................... 70
Table 76: Request for intimation u/s 143(1)/154 - Interface Properties .................................. 71
Table 77: Request for intimation u/s 143(1)/154 - Operation Properties................................ 71
Table 78: Request for intimation u/s 143(1)/154 - Request Parameters .................................. 72
Table 79: Request for intimation u/s 143(1)/154 - Response Parameters ................................ 73
Table 80: Request for intimation u/s 143(1)/154 - Error Messages ......................................... 73
Table 81: Retrieval of XML/ITR Form (PDF) - Interface Properties ...................................... 75
Table 82: Retrieval of XML/ITR Form (PDF) - Operation Properties ................................... 75
Table 83: Retrieval of XML/ITR Form (PDF) - Request Parameters ..................................... 76
Table 84: Retrieval of XML/ITR Form (PDF) - Response Parameters ................................... 78
Table 85: Retrieval of XML/ITR Form (PDF) - Error Messages ............................................ 79

Page

6

Webservice User Manual V1.2

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
most 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.
e-Filing offers following list of Web Services
1. Tax Credit Mismatch
2. Add client details
3. Submit bulk PAN
4. Outstanding tax demand
5. ITR-V status
6. Refund status
7. Retrieve ITR-V Status
8. Retrieve rectification status
9. Retrieve 26AS information
10. Return status
11. Know your jurisdictional A.O.
12. Retrieve PAN information
13. Retrieve TAN information
14. Submit bulk ITR
15. Request for Intimation u/s 143(1)/154
16. Retrieval of XML/ITR Form

Page

7

Webservice User Manual V1.2

1. TAX CREDIT MISMATCH
This web service can be used to view the tax credit mismatch for the PAN and assessment
year mentioned. This is applicable for ERI users.
Pre-requisite: PAN user should be added as client of the respective ERI
Note: Details are available for A.Y 2013-14 and 2014-15.

1.1 WSDL DEFINITION
Property

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
Table 1: Tax Credit Mismatch - Interface Properties

1.2 OPERATIONS
Property

Value

Operation

getTaxCredMisMatch

Style

Document

Type

Request-Response

Input

getTaxCredMismatchRequest

Output

getTaxCredMismatchResponse

Send Attachments

false

Receive Attachments

false

Table 2: Tax Credit Mismatch - Operation Properties

Page

8

Webservice User Manual V1.2

1.3 REQUEST
The user id and password will be used for authenticating the user. Once authenticated, then
the user will be authorized to invoke the web service.

1.3.1 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

Table 3: Tax Credit Mismatch - Request Parameters

1.3.2 SAMPLE REQUEST





XXXXXXXXXX
XXXXXXXXXX


XXXXXXXXXX
XXXX-XX





Page

9

Webservice User Manual V1.2

1.4 RESPONSE
List of Challan Data and Tax Mismatch will be the response.

1.4.1 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
Table 4: Tax Credit Mismatch - Response Parameters

1.4.2 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

Page

10

Webservice User Manual V1.2

34534


6546523
23422
2014-01-10T00:00:00+05:30
34534


0
1212
DEDUCTOR NAME
AAAA12345A


0
320
 DEDUCTOR NAME
AAAA12345A


0
3573
DEDUCTOR NAME
AAAA12345A





Page

11

Webservice User Manual V1.2

1.5 ERROR
1.5.1 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.
Table 5: Tax Credit Mismatch - Error Messages

1.5.2 SAMPLE ERROR




ns0:Client
Error Message< /faultstring>




Page

12

Webservice User Manual V1.2

2. ADD CLIENT DETAILS
This web service can be used to add a PAN as client by ERI user.

2.1 WSDL DEFINITION
Property

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
Table 6: Add Client - Interface Properties

2.2 OPERATIONS
Property

Value

Operation

addClientDetails

Style

Document

Type

Request-Response

Input

addClientDetailsRequest

Output

addClientDetailsResponse

Send Attachments

false

Receive Attachments

false
Table 7: Add Client - Operation Properties

Page

13

Webservice User Manual V1.2

2.3 REQUEST
The user id and password will be used for authenticating the user. Once the user is
authenticated, the user will be authorized to invoke the web service.

2.3.1 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
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

Table 8: Add Client - Request Parameters

2.3.2 Sample Request





UserName
password


Page

14

Webservice User Manual V1.2


AAAPA1111A
1967-05-23
kum@fmail.com






2.4 RESPONSE
Status of adding Client will be the response.

2.4.1 Response Parameters
Field Name
result

Description
Add Client Status.
Table 9: Add Client - Response Parameters

2.4.2 Sample Response




PAN has been successfully added as your client




Page

15

Webservice User Manual V1.2

2.5 ERROR
2.5.1 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.

PAN field left blank

Please provide a PAN

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 Filing of Tax has been done in the last two years.
selected but user's tax records are available in Please
TDS/OLTAS DB
enter the details
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
ERI

This PAN is already added as a client

Table 10: Add Client - Error Messages

Page

16

Webservice User Manual V1.2

2.5.2 Sample Error




ns0:Client
Error Message< /faultstring>




Page

17

Webservice User Manual V1.2

3. BULK PAN VERIFICATION
This web service is used to upload the multiple PAN for verification. This is applicable for
ERI and External Agency users.

3.1 WSDL DEFINITION
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

BulkPanServiceSoapBinding

SOAP Version

SOAP 1.1

Style

Document
Table 11: Bulk PAN Verification - Interface Properties

3.2 OPERATIONS
Property

Value

Operation

submitBulkPan

Style

Document

Type

Request-Response

Input

SubmitBulkPanRequest

Output

SubmitBulkPanResponse

Send Attachments

True

Receive Attachments

false

Table 12: Bulk PAN Verification - Operation Properties

Page

18

Webservice User Manual V1.2

3.3 REQUEST
The user id and password will be used for authenticating the user. Once the user is
authenticated then the user will be authorized to invoke the web service

3.3.1 REQUEST PARAMETERS
Field Name

Description

Mandatory

userName

Valid e-Filing User ID.

Yes

password

Valid e-Filing password for the
user.
XML file as SOAP attachment

Yes

XML File

Yes

Table 13: Bulk PAN Verification - Request Parameters

3.3.2 SAMPLE REQUEST





xxxxxxxxxx
 xxxxxxxxxx





3.4 RESPONSE
Token Number will be the response from the Webservice.

3.4.1 RESPONSE PARAMETERS
Field Name
Result

Description
Token Number

Table 14: Bulk PAN Verification - Response Parameters

Page

19

Webservice User Manual V1.2

3.4.2 SAMPLE RESPONSE




100002134

 

3.5 ERROR
3.5.1ERROR 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 in the
correct schema
Table 15: Bulk PAN Verification - Error Messages

3.5.2 SAMPLE ERROR




ns0:Client
Error Message< /faultstring>




Page

20

Webservice User Manual V1.2

SCHEMA FOR BULK PAN UPLOADS

















Page

21

Webservice User Manual V1.2

4. OUTSTANDING TAX DEMAND
This web service can be used to view the outstanding tax demand for the PAN and
assessment year. This is applicable for ERI users.
Pre-requisite: PAN user should be added as client of the respective ERI

4.1 WSDL DEFINITION
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
Table 16: Outstanding Tax Demand- Interface Properties

4.2 OPERATIONS
Property

Value

Operation

Outstanding Tax Demand

Style

Document

Type

Request-Response

Input

OutstandingTaxDemandRequest

Output

OutstandingTaxDemandResponse

Send Attachments

false

Receive Attachments

false

Table 17: Outstanding Tax Demand- Operation Properties

Page

22

Webservice User Manual V1.2

4.3 REQUEST
The user id and password will be used for authenticating the user. Once the user is
authenticated then the user will be authorized to invoke the web service.

4.3.1 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

Table 18: Outstanding Tax Demand- Request Parameters

4.3.2 SAMPLE REQUEST





? 
? 


? 
?





Page

23

Webservice User Manual V1.2

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.

4.4.1 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
Table 19: Outstanding Tax Demand - Response Parameters

4.4.2 SAMPLE RESPONSE




2013
1000
2011200837000000000T
2011-07-10T00:00:00+05:30
2222




Page

24

Webservice User Manual V1.2

4.5 ERROR
4.5.1 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 ID and Password
Table 20: Outstanding Tax Demand - Error Messages

4.5.2 SAMPLE ERROR




SOAP-ENV:Client
Error Message

 

Page

25

Webservice User Manual V1.2

5. ITR-V STATUS
This web service can be used to view status of ITR-V for the assessment year mentioned.

5.1 WSDL DEFINITION
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
Table 21: ITR-V Status - Interface Properties

5.2 OPERATIONS
Property

Value

Operation

ITR-V Status

Style

Document

Type

Request-Response

Input

GetITRVStatusRequest

Output

GetITRVStatusResponse

Send Attachments

false

Receive Attachments

false
Table 22: ITR-V Status - Operation Properties

Page

26

Webservice User Manual V1.2

5.3 REQUEST
The user id and password will be used for authenticating the user. Once the user is
authenticated then the user will be authorized to invoke the web service.

5.3.1 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 userName

Yes

asseessmentYear

Should be valid and consecutive

Yes

Table 23: ITR-V Status - Request Parameters

5.3.2 SAMPLE REQUEST




? 
? 




Page

27

Webservice User Manual V1.2

5.4 RESPONSE
ITR-V Status will be the response. And the response will vary based on the request details
provided.

5.4.1 RESPONSE PARAMETERS
Field Name
result

Description
ITR-V Status
Table 24: ITR-V Status - Response Parameters

5.4.2 SAMPLE RESPONSE




ITR-V not received




Page

28

Webservice User Manual V1.2

5.5 ERROR
5.5.1 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 ID and
Password
Table 25: ITR-V Status - Error Messages

5.5.2 SAMPLE ERROR




SOAP-ENV:Client
Error Message




Page

29

Webservice User Manual V1.2

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 should be added as client of the respective ERI

6.1 WSDL DEFINITION
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
Table 26: Refund/Demand Status - Interface Properties

6.2 OPERATIONS
Property

Value

Operation

Refund Status

Style

Document

Type

Request-Response

Input

GetRefundStatusRequest

Output

GetRefundStatusResponse

Send Attachments

false

Receive Attachments

false

Table 27: Refund/Demand Status - Operation Properties

Page

30

Webservice User Manual V1.2

6.3 REQUEST
The user id and password will be used for authenticating the user. Once the user is
authenticated then the user will be authorized to invoke the web service.

6.3.1 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 userName

Yes

asseessmentYear

Should be valid and consecutive

Yes

Table 28: Refund/Demand Status - Request Parameters

6.3.2 SAMPLE REQUEST





?
?


?
?





Page

31

Webservice User Manual V1.2

6.4 RESPONSE
Refund/Demand Status will be the response. And the response will vary based on the
request details provided.

6.4.1 RESPONSE PARAMETERS
Field Name
result

Description
Refund Status
Table 29: Refund/Demand Status - Response Parameters

6.4.2 SAMPLE RESPONSE




Not Determined

 

Page

32

Webservice User Manual V1.2

6.5 ERROR
6.5.1 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 ID and Password
Table 30: Refund/Demand Status - Error Messages

6.5.2 SAMPLE ERROR




SOAP-ENV:Client
Error Message




Page

33

Webservice User Manual V1.2

7. RETRIEVE ITR-V
7.1 RETRIEVE ITR-V WITH ACKNOWLEDGMENT NUMBER
This web service can be used to retrieve the ITR-V for the Acknowledgment number
mentioned. This is applicable for ERI users.
Pre-requisite: PAN user should be added as client of the respective ERI

7.1.1 WSDL DEFINITION
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
Table 31: Retrieve ITR-V with Acknowledgment No - Interface Properties

7.1.2 OPERATIONS
Property

Value

Operation

getITRVByAckNo

Style

Document

Type

Request-Response

Input

getITRVByAckNoRequest

Output

getITRVResponse

Send Attachments

false

Receive Attachments

false

Table 32: Retrieve ITR-V with Acknowledgment No - Operation Properties

Page

34

Webservice User Manual V1.2

7.1.3 REQUEST
The user id and password will be used for authenticating the user. Once the user is
authenticated then the user will be authorized to invoke the web service.

7.1.3.1

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

Table 33: Retrieve ITR-V with Acknowledgment No - Request Parameters

7.1.3.2

SAMPLE REQUEST






XXXXXXXXXX
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx

xxxxxxxxxx




Page

35

Webservice User Manual V1.2

7.1.4 RESPONSE
ITR-V for the corresponding Acknowledgment number is sent to registered Email ID will be
the response.

7.1.4.1

RESPONSE PARAMETERS

Field Name
result

Description
Status of ITR processing

Table 34: Retrieve ITR-V with Acknowledgment No - Response Parameters

7.1.4.2

SAMPLE RESPONSE





xxxxxxxxxx




Page

36

Webservice User Manual V1.2

7.1.5 ERROR
7.1.5.1

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 ID and
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 registered

Invalid Digital Signature Certificate. Please retry

Invalid Digital signature certificate

Invalid Digital Signature Certificate. Please contact your
Certificate Provider
Invalid Digital Signature Certificate. The trusted parent
Certificate could not be verified.

The trusted parent certificate could
not be verified
Acknowledgment Number
not provided in request
Acknowledgment Number
not provided is not valid

Please provide Acknowledgment Number
Invalid acknowledgment number

Table 35: Retrieve ITR-V with Acknowledgment No - Error Messages

7.1.5.2

SAMPLE ERROR





SOAP-ENV:Client
Error Message




Page

37

Webservice User Manual V1.2

2. RETRIEVE ITR-V WITH TOKEN NUMBER AND PAN- This web service can be used to
retrieve the ITR-V for the PAN and Token number mentioned. This is applicable for
ERI users.
Pre-requisite: PAN user should be added as client of the respective ERI

7.2.1 WSDL DEFINITION
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
Table 36: Retrieve ITR-V with Token No - Interface Properties

7.2.2 OPERATIONS
Property

Value

Operation

getITRVByTokenNo

Style

Document

Type

Request-Response

Input

getITRVByTokenNoRequest

Output

getITRVResponse

Send Attachments

False

Receive Attachments

False

Table 37: Retrieve ITR-V with Token No - Operation Properties

Page

38

Webservice User Manual V1.2

7.2.3 REQUEST
The user id and password will be used for authenticating the user. Once the user is
authenticated then the user will be authorized to invoke the web service.

REQUEST PARAMETERS

7.2.3.1

Field Name

Description

Mandatory

userName

Valid e-Filing User ID.

Yes

password

Yes

certChain

Valid e-Filing password for the
user.
DSC Certificate Chain

signature

DSC Signature

Yes

tokenNumber

Token Number of Bulk ITR upload

Yes

Yes

Table 38: Retrieve ITR-V with Token No - Request Parameters

7.2.3.2

SAMPLE REQUEST






XXXXXXXXXX
XXXXXXXXXX
XXXXXXXXXX
XXXXXXXXXX

XXXXXXXXXX
XXXXXXXXXX





Page

39

Webservice User Manual V1.2

7.2.4 RESPONSE
ITR-V for the corresponding Token number and PAN is sent to registered Email ID will be
the response.

7.2.4.1

RESPONSE PARAMETERS

Field Name

Description

result

Status of ITR processing
Table 39: Retrieve ITR-V with Token No - Response Parameters

7.2.4.2

SAMPLE RESPONSE





xxxxxxxxxx




Page

40

Webservice User Manual V1.2

7.2.5 ERROR
7.2.5.1

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 ID and
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 registered

Invalid Digital Signature Certificate. Please retry

Invalid Digital signature certificate

Invalid Digital Signature Certificate. Please contact your
Certificate Provider

The trusted parent certificate could
not be verified

Invalid Digital Signature Certificate. The trusted parent
Certificate could not be verified.

Token Number not provided in
request

Please provide Token Number

Token Number not provided is not
valid

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

Table 40: Retrieve ITR-V with Token No - Error Messages

7.2.5.2

SAMPLE ERROR





SOAP-ENV:Client
Error Message

 
Page

41

Webservice User Manual V1.2

8. RETRIEVE RECTIFICATION STATUS
This web service can be used to view Rectification status for the PAN and assessment year
mentioned. This is applicable for ERI users.
Pre-requisite: PAN user should be added as client of the respective ERI

8.1 WSDL DEFINITION
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
Table 41: Rectification Status - Interface Properties

8.2 OPERATIONS
Property

Value

Operation

getRectificationStatus

Style

Document

Type

Request-Response

Input

getRectificationStatusRequest

Output

getRectificationStatusResponse

Send Attachments

false

Receive Attachments

false
Table 42: Rectification Status - Operation Properties

Page

42

Webservice User Manual V1.2

8.3 REQUEST
The user id and password will be used for authenticating the user. Once the user is
authenticated then the user will be authorized to invoke the web service.

8.3.1 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

Table 43: Rectification Status - Request Parameters

8.3.2 SAMPLE REQUEST





xxxxxxxxxx
xxxxxxxxxx


xxxxxxxxxx
xxxxxxxxxx





Page

43

Webservice User Manual V1.2

8.4 RESPONSE
List of transactions and their details like PAN, A.Y, ITR Name, Rectification Reference No
and Date of rectification will be the response.

8.4.1 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
Table 44: Rectification Status - Response Parameters

8.4.2 SAMPLE RESPONSE





xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx

xxxxxxxxxx
xxxxxxxxxx


xxxxxxxxxx
xxxxxxxxxx


xxxxxxxxxx

Page

44

Webservice User Manual V1.2






8.5 ERROR
8.5.1 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 in
PAN

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

Table 45: Rectification Status - Error Messages

8.5.2 SAMPLE ERROR




ns0:Client
Error Message< /faultstring>




Page

45

Webservice User Manual V1.2

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
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
Table 46: View 26AS - Interface Properties

9.2 OPERATIONS
Property

Value

Operation

getTDSDetails

Style

Document

Type

Request-Response

Input

GetTDSRequest

Output

GetTDSResponse

Send Attachments

False

Receive Attachments

False
Table 47: View 26AS - Operation Properties

Page

46

Webservice User Manual V1.2

9.3 REQUEST
The user id and password of will be used for authenticating the user. Once the user is
authenticated then the user will be authorized to invoke the web service.

9.3.1 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

Should be a valid Date of Birth

Yes

assessmentYear

Assessment Year

Yes

Table 48: View 26AS - Request Parameters

9.3.2 SAMPLE REQUEST





xxxxxxxxxx
xxxxxxxxxx


xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx





Page

47

Webservice User Manual V1.2

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.

9.4.1 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
Table 49: View 26AS - Response Parameters

9.4.2 SAMPLE RESPONSE







xxxxxxxxxx
xxxxxxxxxx

xxxxxxxxxx

Page

48

Webservice User Manual V1.2

xxxxxxxxxx





xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx





xxxxxxxxxx
xxxxxxxxxx

xxxxxxxxxx
xxxxxxxxxx




xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx


  
Page

49

Webservice User Manual V1.2

9.5 ERROR
9.5.1 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
Table 50: View 26AS - Error Messages

9.5.2 SAMPLE ERROR




ns0:Client
Error Message< /faultstring>




Page

50

Webservice User Manual V1.2

10. E-FILED RETURN STATUS
This web service can be used to view the latest e-Filed Return status for the PAN and
assessment year mentioned. This is applicable for ERI users.
Pre-requisite: PAN user should be added as client of the respective ERI

10.1

WSDL DEFINITION
Property

Value

Definition URL

https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/returnstatus.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
Table 51: e-Filed Return Status - Interface Properties

10.2

OPERATIONS
Property

Value

Operation

getReturnStatus

Style

Document

Type

Request-Response

Input

getReturnStatusRequest

Output

getReturnStatusResponse

Send Attachments

false

Receive Attachments

false

Table 52: e-Filed Return Status - Operation Properties

Page

51

Webservice User Manual V1.2

10.3

REQUEST

The user id and password of ERI will be used for authenticating the user. Once the user is
authenticated then the user will be authorized to invoke the web service.

10.3.1 REQUEST PARAMETERS
Field Name

Description

Mandatory

userName

Valid e-Filing User ID.

Yes

password

Valid e-Filing password for the
user.

Yes

Pan

Should be a valid Pan

Yes

assessmentYear

Should be an assessment
year

Yes

Table 53: e-Filed Return Status - Request Parameters

10.3.2 SAMPLE REQUEST





ERIA000000
********* 


AAAAA0000A
YYYY-YY





Page

52

Webservice User Manual V1.2

10.4
Latest

RESPONSE
e-Filed

return

(only

ITR)

status

of

the

client

and

their

acknowledgement will be the response.

10.4.1 RESPONSE PARAMETERS
Field Name

Description

result

Collector/Deductor Name

ackNo

Income From salary
Table 54: e-Filed Return Status - Response Parameters

10.4.2 SAMPLE RESPONSE




Return Processed 
10000000000000




Page

53

corresponding

Webservice User Manual V1.2

10.5

ERROR

10.5.1 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.

Incorrect Client Pan

Invalid Pan

Incorrect Assessment Year.

Invalid Assessment Year

Table 55: e-Filed Return Status - Error Messages

10.5.2 SAMPLE ERROR




ns0:Client
Error Message< /faultstring>




Page

54

Webservice User Manual V1.2

11. KNOW YOUR JURISDICTIONAL A.O.
This web service can be used to view JURISDICTIONAL A.O. details for the PAN mentioned.

WSDL DEFINITION

11.1

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
Table 56: Know Your Jurisdictional A.O - Interface Properties

11.2

OPERATIONS
Property

Value

Operation

getJurisdictionalAO

Style

Document

Type

Request-Response

Input

getJurisdictionalAORequest

Output

getJurisdictionalAOResponse

Send Attachments

false

Receive Attachments

false

Table 57: Know Your Jurisdictional A.O. - Operation Properties

Page

55

Webservice User Manual V1.2

11.3

REQUEST

11.3.1 REQUEST PARAMETERS
Field Name
panNum

Description

Mandatory

Valid PAN

Yes

Table 58: Know Your Jurisdictional A.O. - Request Parameters

Once the user gives a valid PAN then the user will be authorized to invoke the web service.

11.3.2 SAMPLE REQUEST





?





Page

56

Webservice User Manual V1.2

11.4

RESPONSE

The Jurisdiction details of the given PAN will be displayed as a response.

11.4.1 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
Table 59: Know Your Jurisdictional A.O - Response Parameters

11.4.2 SAMPLE RESPONSE





xx
x
xxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxx
xxxxxxxxxx





Page

57

Webservice User Manual V1.2

11.5

ERROR

11.5.1 ERROR MESSAGES
Scenario

Error Message

PAN not provided in the request

Please provide the PAN.

Incorrect PAN

Please provide a valid PAN.
Table 60: Know Your Jurisdictional A.O - Error Messages

11.5.2 SAMPLE ERROR




ns0:Client
Error Message< /faultstring>




Page

58

Webservice User Manual V1.2

12. RETRIVE PAN INFORMATION
This web service can be used to retrieve pan information for the PAN mentioned. This is
applicable for External Agency users.

12.1

WSDL DEFINITION

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.1

Style

Document
Table 61: Retrieve PAN - Interface Properties

12.2

OPERATIONS

Property

Value

Operation

getPanInfo

Style

Document

Type

Request-Response

Input

LoginInfo

Output

PanInfo

Send Attachments

false

Receive Attachments

false
Table 62: Retrieve PAN - Operation Properties

Page

59

Webservice User Manual V1.2

12.3

REQUEST

The user id and password of will be used for authenticating the user. Once the user is
authenticated then the user will be authorized to invoke the web service.

12.3.1 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

Table 63: Retrieve PAN - Request Parameters

12.3.2 SAMPLE REQUEST





xxxxxxxxxx
xxxxxxxxxx


xxxxxxxxxx





Page

60

Webservice User Manual V1.2

12.4

RESPONSE

Details of the given PAN will be displayed as a response in the above format.

12.4.1 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
Table 64: Retrieve PAN - Response Parameters

12.4.2 SAMPLE RESPONSE





xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx






Page

61

Webservice User Manual V1.2

12.5

ERROR

12.5.1 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.

PAN field left blank

Please provide a PAN.

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
Table 65: Retrieve PAN - Error Messages

12.5.2 SAMPLE ERROR




ns0:Client
Error Message< /faultstring>




Page

62

Webservice User Manual V1.2

13. RETRIEVE TAN INFORMATION
This web service can be used to retrieve tan informationfor the TAN mentioned.

13.1

WSDL DEFINITION

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
Table 66: Retrieve TAN - Interface Properties

13.2

OPERATIONS

Property

Value

Operation

getTanInfo

Style

Document

Type

Request-Response

Input

getTanInfo

Output

TanInfoResponse

Send Attachments

False

Receive Attachments

False
Table 67: Retrieve TAN - Operation Properties

Page

63

Webservice User Manual V1.2

13.3

REQUEST

The user id and password of will be used for authenticating the user. Once the user is
authenticated then the user will be authorized to invoke the web service.

13.3.1 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

Table 68: Retrieve TAN - Request Parameters

13.3.2 SAMPLE REQUEST





xxxxxxxxxx
xxxxxxxxxx


xxxxxxxxxx





Page

64

Webservice User Manual V1.2

13.4

RESPONSE

The TAN details of the given TAN will be displayed as a response in the above format.

13.4.1 RESPONSE PARAMETERS
Field Name

Description

Tan

TAN

categoryOfDeductor

Category of Deductor

Address

Address

Pan

PAN

Status

Status

emailId1

E-mail Id

emailId2

Alternate E-mail Id

areaCode

Area code

AOType

AO type

rangeCode

Range code

AONumber

AO number
Table 69: Retrieve TAN - Response Parameters

13.4.2 SAMPLE RESPONSE





xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx





Page

65

Webservice User Manual V1.2

13.5

ERROR

13.5.1 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.

Table 70: Retrieve TAN - Error Messages

13.5.2 SAMPLE ERROR




ns0:Client
Error Message< /faultstring>

 

Page

66

Webservice User Manual V1.2

14. BULK ITR
This web service can be used to submit ITR in bulk. This is applicable for ERI users.

14.1

WSDL DEFINITION

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
Table 71: Bulk ITR - Interface Properties

14.2

OPERATIONS

Property

Value

Operation

submitITR

Style

Document

Type

Request-Response

Input

DITWSAuthInfoEle

Output

DITWSResponseEle

Send Attachments

false

Receive Attachments

false
Table 72: Bulk ITR - Operation Properties

Page

67

Webservice User Manual V1.2

14.3

REQUEST

The user id and password of will be used for authenticating the user. Once the user is
authenticated then the user will be authorized to invoke the web service.

14.3.1 REQUEST PARAMETERS
Field Name

Description

Mandatory

userID

Valid e-Filing User ID.

Yes

password

Valid e-Filing password for the user.

Yes

certChain

Certification chain

Yes

signature

Signature

Yes

Zip

Attachment Zip attachment which
contains ITR xml files

Yes

Table 73: Bulk ITR - Request Parameters

14.3.2 SAMPLE REQUEST




xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxx




Page

68

Webservice User Manual V1.2

14.4

RESPONSE

The Token number for the Submit BULK ITR will be displayed as a response in the above
format.

14.4.1 RESPONSE PARAMETERS
Field Name
Result

Description
Token Number
Table 74: Bulk ITR - Response Parameters

14.4.2 SAMPLE RESPONSE




xxxxxxxxxx




Page

69

Webservice User Manual V1.2

14.5

ERROR

14.5.1 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
failed.

Please provide a valid Password.

Password

Authentication

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 registered

Invalid Digital Signature Certificate. Please retry.

Invalid Digital signature certificate.

Invalid Digital Signature Certificate. Please contact
your Certificate Provider.

The trusted parent certificate could not
be verified

Invalid Digital Signature Certificate. The trusted
parent certificate could not be verified.

Table 75: Bulk ITR - Error Messages

14.5.2 SAMPLE ERROR




ns0:Client
Error Message< /faultstring>




Page

70

Webservice User Manual V1.2

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 applicable for
ERI users.
Pre-requisite: PAN user should be added as client of the respective ERI

15.1 WSDL Definition
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
Table 76: Request for intimation u/s 143(1)/154 - Interface Properties

15.2

OPERATIONS

Property

Value

Operation

getReqForIntimation

Style

Document

Type

Request-Response

Input

getReqForIntimationRequest

Output

getReqForIntimationResponse

Send Attachments

false

Receive Attachments

false

Table 77: Request for intimation u/s 143(1)/154 - Operation Properties

Page

71

Webservice User Manual V1.2

REQUEST

15.3

The user id and password will be used for authenticating the user. Once the user is
authenticated then the user will be authorized to invoke the web service.

15.3.1 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 154

Yes

C103 for Intimation u/s 143(1)
Table 78: Request for intimation u/s 143(1)/154 - Request Parameters

15.3.2 SAMPLE REQUEST





XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX


XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX





Page

72

Webservice User Manual V1.2

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.

15.4.1 RESPONSE PARAMETERS
Field Name
result

Description
The success message with the Transaction ID will be
displayed to the assesse.

Table 79: Request for intimation u/s 143(1)/154 - Response Parameters

15.4.2 SAMPLE RESPONSE




XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX




15.5

ERROR

15.5.1 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.

PAN field left blank

Please provide a PAN.

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 in wrong format

Should be valid and consecutive

Table 80: Request for intimation u/s 143(1)/154 - Error Messages

Page

73

Webservice User Manual V1.2

15.5.2 SAMPLE ERROR




ns0:Client
Error Message< /faultstring>




Page

74

Webservice User Manual V1.2

16 RETRIEVAL OF XML/ITR FORM (PDF)
This web service can be used to retrieve XML/ITR Form (PDF). This is applicable for ERI
users.
Pre-requisite: PAN user should be added as client of the respective ERI

16.1 WSDL Definition
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
Table 81: Retrieval of XML/ITR Form (PDF) - Interface Properties

16.2

OPERATIONS

Property

Value

Operation

ITRByAckNo

Style

Document

Type

Request-Response

Input

itrAckNoRequestEle, itrTokenNoRequestEle

Output

ITRByAckNoResponse, ITRByTokenNoResponse

Send Attachments

false

Receive Attachments

false

Table 82: Retrieval of XML/ITR Form (PDF) - Operation Properties

Page

75

Webservice User Manual V1.2

REQUEST

16.3

The user id and password of will be used for authenticating the user. Once the user is
authenticated then the user will be authorized to invoke the web service.

16.3.1 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

signature

DSC Signature

Yes

fileType

XML or FORM

Yes

acknowledgementNo

Efiling Acknowledgment Number

Yes

panID

Valid PAN

Yes

tokenNumber

Token Number of Bulk ITR upload

Yes

Table 83: Retrieval of XML/ITR Form (PDF) - Request Parameters

16.3.2 SAMPLE REQUEST
Request for ITR by acknowledgement number.





XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX

XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX

Page

76

Webservice User Manual V1.2





Request for ITR by Token number.





XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX

XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX
XXXXXXXXXXXXXXX




Page

77

Webservice User Manual V1.2

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.1 RESPONSE PARAMETERS
Field Name
result

Description
The success message with the Acknowledgement
number will be displayed to the user.

Table 84: Retrieval of XML/ITR Form (PDF) - Response Parameters

16.4.2 SAMPLE RESPONSE
Response for ITR by acknowledgement number.




XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX




Response for ITR by Token number.




XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX




Page

78

Webservice User Manual V1.2

16.5

ERROR

16.5.1 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.

PAN field left blank

Please provide a PAN.

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

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 registered

Invalid Digital Signature Certificate. Please retry

Invalid Digital signature certificate

Invalid Digital Signature Certificate. Please contact
your Certificate Provider

The trusted parent certificate could not
be verified

Invalid Digital Signature Certificate. The trusted
parent Certificate could not be verified.

Acknowledgment Number not provided
in request

Please provide Acknowledgment Number.

Acknowledgment Number provided is
not valid

Invalid acknowledgment number

Table 85: Retrieval of XML/ITR Form (PDF) - Error Messages

Page

79

Webservice User Manual V1.2

16.5.2 SAMPLE ERROR




ns0:Client
Error Message< /faultstring>




Page

80



---

Source Exif Data:

File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.5
Linearized                      : No
Page Count                      : 80
Language                        : en-IN
Tagged PDF                      : Yes
Title                           : Web Services User Manual V 1.0
Author                          : Sreevidya M.B
Creator                         : Microsoft® Word 2013
Create Date                     : 2015:01:19 17:19:05+05:30
Modify Date                     : 2015:01:19 17:19:05+05:30
Producer                        : Microsoft® Word 2013

EXIF Metadata provided by EXIF.tools