Web Services User Manual V 1.0

User Manual:

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

e-Filing Web Services User Manual

Version 1.2

January 2015

Webservice User Manual V1.2

Page 2

REVISION LIST

Document Name: Webservice User Manual

Version Number: 1.2

Version

Date

Revision Details

Section

1.0

11th Nov 2014

Initial Document

1.1

30th Dec 2014

Request for Intimation u/s

143(1)/ 154 is added

1.2

08th Jan 2015

Retrieval of XML/ITR Form is

added

Webservice User Manual V1.2

Page 3

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

Webservice User Manual V1.2

Page 4

TABLE 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

Webservice User Manual V1.2

Page 5

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

Webservice User Manual V1.2

Page 6

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

Webservice User Manual V1.2

Page 7

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

Webservice User Manual V1.2

Page 8

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/ e-

FilingWS/ditws/getTaxCredMismatchRequest.wsdl

End point

https://incometaxindiaefiling.gov.in/e-FilingWS/ditws

Namespace

http://incometaxindiaefiling.gov.in/ditws/TaxCredMismatch/v_1_0

Binding

taxCreditMisMatchSOAP11

SOAP Version

SOAP 1.1

Style

Document

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

Webservice User Manual V1.2

Page 9

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:v="http://incometaxindiaefiling.gov.in/ditws/TaxCredMismatch/v_1_0">

<soapenv:Header/>

<soapenv:Body>

<v:getTaxCredMismatchRequest>

<userName>XXXXXXXXXX</userName>

<password>XXXXXXXXXX</password>

</LoginInfo>

<panNo>XXXXXXXXXX</panNo>

</UserInput>

</v:getTaxCredMismatchRequest>

</soapenv:Body>

</soapenv:Envelope>

Webservice User Manual V1.2

Page 10

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

<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">

<env:Header/>

<env:Body>

<ns3:getTaxCredMismatchResponse

xmlns:ns3="http://incometaxindiaefiling.gov.in/ditws/TaxCredMismatch/v_1_0">

</ChallanDataModel>

</ChallanDataModel>

Webservice User Manual V1.2

Page 11

</ChallanDataModel>

</ChallanDataModel>

<deductorName>DEDUCTOR NAME</deductorName>

</TaxMismatchModel>

<deductorName> DEDUCTOR NAME</deductorName>

</TaxMismatchModel>

<deductorName>DEDUCTOR NAME</deductorName>

</TaxMismatchModel>

</ns3:getTaxCredMismatchResponse>

</env:Body>

</env:Envelope>

Webservice User Manual V1.2

Page 12

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

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

Webservice User Manual V1.2

Page 13

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/e-

FilingWS/ditws/addClientDetails.wsdl

End point

https://incometaxindiaefiling.gov.in/e-FilingWS/ditws

Namespace

http://incometaxindiaefiling.gov.in/ditws/addClientDetails/v_1_0

Binding

addClientPortSoap11

SOAP Version

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

Webservice User Manual V1.2

Page 14

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

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

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

Webservice User Manual V1.2

Page 15

<v:addClientDetails>

<v:panNumber>AAAPA1111A</v:panNumber>

<v:dateOfBirth>1967-05-23</v:dateOfBirth>

<v:email>kum@fmail.com</v:email>

</v:addClientDetails>

</v:addClient>

</v:addClientDetails>

</soapenv:Body>

</soapenv:Envelope>

2.4 RESPONSE

Status of adding Client will be the response.

2.4.1 Response Parameters

Field Name

Description

result

Add Client Status.

Table 9: Add Client - Response Parameters

2.4.2 Sample Response

<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">

<env:Header/>

<env:Body>

<ns2:addClientDetailsResponse

xmlns:ns2="http://incometaxindiaefiling.gov.in/ditws/addClientDetails/v_1_0">

<ns2:result>PAN has been successfully added as your client</ns2:result>

</ns2:addClientDetailsResponse>

</env:Body>

</env:Envelope>

Webservice User Manual V1.2

Page 16

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

Assessment year is not selected

Please provide the Assessment Year

Assessment year entered in wrong format

Enter Valid Assessment Year

No tax paid in the last 2 years' option is

selected but user's tax records are available in

TDS/OLTAS DB

Filing of Tax has been done in the last two years.

Please

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

Webservice User Manual V1.2

Page 17

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

Webservice User Manual V1.2

Page 18

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

Webservice User Manual V1.2

Page 19

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.

Yes

XML File

XML file as SOAP attachment

Yes

Table 13: Bulk PAN Verification - Request Parameters

3.3.2 SAMPLE REQUEST

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:v="http://incometaxindiaefiling.gov.in/bulkPanservice/v_1_0">

<soapenv:Header/>

<soapenv:Body>

<v:submitBulkPan>

<v:LoginInfo>

<v:userName>xxxxxxxxxx</v:userName>

<v:password> xxxxxxxxxx</v:password>

</v:LoginInfo>

</v:submitBulkPan>

</soapenv:Body>

</soapenv:Envelope>

3.4 RESPONSE

Token Number will be the response from the Webservice.

3.4.1 RESPONSE PARAMETERS

Field Name

Description

Result

Token Number

Table 14: Bulk PAN Verification - Response Parameters

Webservice User Manual V1.2

Page 20

3.4.2 SAMPLE RESPONSE

<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">

<env:Header/>

<env:Body>

<ns2:DITWSResponse

xmlns:ns2="http://incometaxindiaefiling.gov.in/bulkPanservice/v_1_0">

<ns2:result>100002134</ns2:result>

</ns2:DITWSResponse>

</env:Body> </env:Envelope>

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

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

Webservice User Manual V1.2

Page 21

SCHEMA FOR BULK PAN UPLOADS

<?xml version="1.0" encoding="UTF-8"?>

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"

elementFormDefault="qualified" targetNamespace="http://bulkpanws.tcs.com/"

xmlns:ns1="http://bulkpanws.tcs.com/">

<xs:element name="getPANInfo">

<xs:complexType>

<xs:sequence>

<xs:element name="pan" maxOccurs="999" minOccurs="1" form="unqualified">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:pattern value="[A-Za-z]{5}[0-9]{4}[A-Za-z]" />

</xs:restriction>

</xs:simpleType>

</xs:element>

</xs:sequence>

</xs:complexType>

</xs:element>

</xs:schema>

Webservice User Manual V1.2

Page 22

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/e-

FilingWS/ditws/GetTaxDemandDetails.wsdl

End point

https://incometaxindiaefiling.gov.in/e-FilingWS/ditws

Namespace

http://incometaxindiaefiling.gov.in/ditws/OutstandingTaxDemand/v_1_0

Binding

OutstandingTaxDemandPortSoap11

SOAP Version

SOAP 1.1

Style

Document

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

Webservice User Manual V1.2

Page 23

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

<soapenv: Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:v="http://incometaxindiaefiling.gov.in/ditws/OutstandingTaxDemand/v_1_0">

<soapenv: Header/>

<Soapenv: Body>

<v: getOutstandingTaxDemandRequest>

</LoginInfo>

</OutstandingTaxDemandInput>

</v:getOutstandingTaxDemandRequest>

</soapenv:Body>

</soapenv:Envelope>

Webservice User Manual V1.2

Page 24

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

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<ns3: getOutstandingTaxDemandResponse

xmlns:ns3="http://incometaxindiaefiling.gov.in/ditws/OutstandingTaxDemand/v_1_0">

</ns3: getOutstandingTaxDemandResponse>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

Webservice User Manual V1.2

Page 25

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:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<SOAP-ENV:Fault>

<faultcode>SOAP-ENV:Client</faultcode>

<faultstring xml:lang="en">Error Message</faultstring>

</SOAP-ENV:Fault>

</SOAP-ENV:Body> </SOAP-ENV:Envelope>

Webservice User Manual V1.2

Page 26

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

Webservice User Manual V1.2

Page 27

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

<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:getITRVStatusRequest>

</v:getITRVStatusRequest>

</soapenv:Body>

</soapenv:Envelope>

Webservice User Manual V1.2

Page 28

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

Description

result

ITR-V Status

Table 24: ITR-V Status - Response Parameters

5.4.2 SAMPLE RESPONSE

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<ns3:getITRVStatusResponsehttp://incometaxindiaefiling.gov.in/ditws/ITRVStatus/v_

1_0">

<result>ITR-V not received</result>

</ns3:getITRVStatusResponse>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

Webservice User Manual V1.2

Page 29

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:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<SOAP-ENV:Fault>

<faultcode>SOAP-ENV:Client</faultcode>

<faultstring xml:lang="en">Error Message</faultstring>

</SOAP-ENV:Fault>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

Webservice User Manual V1.2

Page 30

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

Webservice User Manual V1.2

Page 31

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

<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:getRefundStatusRequest>

</LoginInfo>

</RefundInput>

</v:getRefundStatusRequest>

</soapenv:Body>

</soapenv:Envelope>

Webservice User Manual V1.2

Page 32

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

Description

result

Refund Status

Table 29: Refund/Demand Status - Response Parameters

6.4.2 SAMPLE RESPONSE

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<ns3:getRefundStatusResponse

xmlns:ns3="http://incometaxindiaefiling.gov.in/ditws/ITRVStatus/v_1_0">

<result>Not Determined</result>

</ns3:getRefundStatusResponse>

</SOAP-ENV:Body> </SOAP-ENV:Envelope>

Webservice User Manual V1.2

Page 33

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:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<SOAP-ENV:Fault>

<faultcode>SOAP-ENV:Client</faultcode>

<faultstring xml:lang="en">Error Message</faultstring>

</SOAP-ENV:Fault>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

Webservice User Manual V1.2

Page 34

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

Webservice User Manual V1.2

Page 35

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:v="http://incometaxindiaefiling.gov.in/ws/ds/itrv/v_1_0"

xmlns:v1="http://incometaxindiaefiling.gov.in/ws/ds/common/v_1_0">

<soapenv:Header/>

<soapenv:Body>

<v:itrvAckNoRequestEle>

<v:authInfo>

<v1:userID>XXXXXXXXXX</v1:userID>

<v1:password>xxxxxxxxxx</v1:password>

<v1:certChain>xxxxxxxxxx</v1:certChain>

<v1:signature>xxxxxxxxxx</v1:signature>

</v:authInfo>

<v:acknowledgementNo>xxxxxxxxxx</v:acknowledgementNo>

</v:itrvAckNoRequestEle>

</soapenv:Body>

</soapenv:Envelope>

Webservice User Manual V1.2

Page 36

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

Description

result

Status of ITR processing

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

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

Webservice User Manual V1.2

Page 37

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

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

not provided is not valid

Invalid acknowledgment number

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

7.1.5.2 SAMPLE ERROR

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<SOAP-ENV:Fault>

<faultcode>SOAP-ENV:Client</faultcode>

<faultstring xml:lang="en">Error Message</faultstring>

</SOAP-ENV:Fault>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

Webservice User Manual V1.2

Page 38

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

Webservice User Manual V1.2

Page 39

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.

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

certChain

DSC Certificate Chain

Yes

signature

DSC Signature

Yes

tokenNumber

Token Number of Bulk ITR upload

Yes

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

7.2.3.2 SAMPLE REQUEST

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:v="http://incometaxindiaefiling.gov.in/ws/ds/itrv/v_1_0"

xmlns:v1="http://incometaxindiaefiling.gov.in/ws/ds/common/v_1_0">

<soapenv:Header/>

<soapenv:Body>

<v:itrvTokenNoRequestEle>

<v:authInfo>

<v1:userID>XXXXXXXXXX</v1:userID>

<v1:password>XXXXXXXXXX</v1:password>

<v1:certChain>XXXXXXXXXX</v1:certChain>

<v1:signature>XXXXXXXXXX</v1:signature>

</v:authInfo>

<v:tokenNumber>XXXXXXXXXX</v:tokenNumber>

<v:panID>XXXXXXXXXX</v:panID>

</v:itrvTokenNoRequestEle>

</soapenv:Body>

</soapenv:Envelope>

Webservice User Manual V1.2

Page 40

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

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

Webservice User Manual V1.2

Page 41

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:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<SOAP-ENV:Fault>

<faultcode>SOAP-ENV:Client</faultcode>

<faultstring xml:lang="en">Error Message</faultstring>

</SOAP-ENV:Fault>

</SOAP-ENV:Body> </SOAP-ENV:Envelope>

Webservice User Manual V1.2

Page 42

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

Webservice User Manual V1.2

Page 43

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

<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:getRectificationStatusRequest>

<userName>xxxxxxxxxx</userName>

<password>xxxxxxxxxx</password>

</LoginInfo>

<panNo>xxxxxxxxxx</panNo>

<asseessmentYear>xxxxxxxxxx</asseessmentYear>

</RectificationInput>

</v:getRectificationStatusRequest>

</soapenv:Body>

</soapenv:Envelope>

Webservice User Manual V1.2

Page 44

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

Table 44: Rectification Status - Response Parameters

8.4.2 SAMPLE RESPONSE

<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">

<env:Header/>

<env:Body>

<ns3:getRectificationStatusResponse

xmlns:ns3="http://incometaxindiaefiling.gov.in/ditws/ITRVStatus/v_1_0">

<panNo>xxxxxxxxxx</panNo>

<asseessmentYear>xxxxxxxxxx</asseessmentYear>

<itrName>xxxxxxxxxx</itrName>

<rectificationReferenceNo>xxxxxxxxxx</rectificationReferenceNo>

<date>xxxxxxxxxx</date>

</rectification>

<cpcOrderNo>xxxxxxxxxx</cpcOrderNo>

<date>xxxxxxxxxx</date>

</cpcOrder>

<status>xxxxxxxxxx</status>

Webservice User Manual V1.2

Page 45

</result>

</ns3:getRectificationStatusResponse>

</env:Body>

</env:Envelope>

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

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

Webservice User Manual V1.2

Page 46

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

Webservice User Manual V1.2

Page 47

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:v="http://incometaxindiaefiling.gov.in/ditws/tds/v_1_0">

<soapenv:Header />

<soapenv:Body>

<v:getTDSDetails>

<v:LoginInfo>

<v:userName>xxxxxxxxxx</v:userName>

<v:password>xxxxxxxxxx</v:password>

</v:LoginInfo>

<v:ClientInfo>

<v:pan>xxxxxxxxxx</v:pan>

<v:dob>xxxxxxxxxx</v:dob>

<v:assessmentYear>xxxxxxxxxx</v:assessmentYear>

</v:ClientInfo>

</v:getTDSDetails>

</soapenv:Body>

</soapenv:Envelope>

Webservice User Manual V1.2

Page 48

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

<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">

<env:Header />

<env:Body>

<GetTDSResponse xmlns:ns2="http://incometaxindiaefiling.gov.in/master"

xmlns:ns3="http://incometaxindiaefiling.gov.in/ditws/tds/v_1_0">

<ns3:TDSonSalaries>

<ns2:TDSonSalary>

<ns2:EmployerOrDeductorOrCollectDetl>

<ns2:TAN>xxxxxxxxxx</ns2:TAN>

<ns2:EmployerOrDeductorOrCollecterName>xxxxxxxxxx</ns2:Emplo

yerOrDeductorOrCollecterName>

</ns2:EmployerOrDeductorOrCollectDetl>

<ns2:IncChrgSal>xxxxxxxxxx</ns2:IncChrgSal>

Webservice User Manual V1.2

Page 49

<ns2:TotalTDSSal>xxxxxxxxxx</ns2:TotalTDSSal>

</ns2:TDSonSalary>

</ns3:TDSonSalaries>

<ns3:TDSonOthThanSals>

<ns2:TDSonOthThanSal>

<ns2:EmployerOrDeductorOrCollectDetl>

<ns2:TAN>xxxxxxxxxx</ns2:TAN>

<ns2:EmployerOrDeductorOrCollecterName>xxxxxxxxxx</ns2:Emplo

yerOrDeductorOrCollectDetl>

<ns2:TotTDSOnAmtPaid>xxxxxxxxxx</ns2:TotTDSOnAmtPaid>

<ns2:ClaimOutOfTotTDSOnAmtPaid>xxxxxxxxxx</ns2:ClaimOutOfTot

TDSOnAmtPaid>

</ns2:TDSonOthThanSal>

</ns3:TDSonOthThanSals>

<ns3:ScheduleTCS>

<ns2:TCS>

<ns2:EmployerOrDeductorOrCollectDetl>

<ns2:TAN>xxxxxxxxxx</ns2:TAN>

<ns2:EmployerOrDeductorOrCollecterName>xxxxxxxxxx</ns2:Emplo

yerOrDeductorOrCollecterName>

</ns2:EmployerOrDeductorOrCollectDetl>

<ns2:TotalTCS>xxxxxxxxxx</ns2:TotalTCS>

<ns2:AmtTCSClaimedThisYear>xxxxxxxxxx</ns2:AmtTCSClaimedThi

sYear>

</ns2:TCS>

</ns3:ScheduleTCS>

<ns3:TaxPayments>

<ns2:TaxPayment>

<ns2:BSRCode>xxxxxxxxxx</ns2:BSRCode>

<ns2:DateDep>xxxxxxxxxx</ns2:DateDep>

<ns2:SrlNoOfChaln>xxxxxxxxxx</ns2:SrlNoOfChaln>

<ns2:Amt>xxxxxxxxxx</ns2:Amt>

</ns2:TaxPayment>

</ns3:TaxPayments>

</GetTDSResponse> </env:Body> </env:Envelope>

Webservice User Manual V1.2

Page 50

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

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

Webservice User Manual V1.2

Page 51

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

Webservice User Manual V1.2

Page 52

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

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

<panNo>AAAAA0000A</panNo>

</ReturnInput>

</v:getReturnStatusRequest>

</soapenv:Body>

</soapenv:Envelope>

Webservice User Manual V1.2

Page 53

10.4 RESPONSE

Latest e-Filed return (only ITR) status of the client and their corresponding

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

<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">

<env:Header/>

<env:Body>

<ns2:getReturnStatusResponse

xmlns:ns2="http://incometaxindiaefiling.gov.in/ditws/ITRVStatus/v_1_0">

<ns2:result>Return Processed </ns2:result>

<ns2:ackNo>10000000000000</ns2:ackNo>

</ns2:getReturnStatusResponse>

</env:Body>

</env:Envelope>

Webservice User Manual V1.2

Page 54

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

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

Webservice User Manual V1.2

Page 55

11. KNOW YOUR JURISDICTIONAL A.O.

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

11.1 WSDL DEFINITION

Property

Value

Definition URL

https://incometaxindiaefiling.gov.in/e-

FilingWS/ditws/JurisdictionalAOInfo.wsdl

End point

https://incometaxindiaefiling.gov.in/e-FilingWS/ditws

Namespace

http://incometaxindiaefiling.gov.in/ditws/JurisdictionalAO/v_1_0

Binding

JurisdictionalAOInfoSOAP

SOAP Version

SOAP 1.1

Style

Document

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

Webservice User Manual V1.2

Page 56

11.3 REQUEST

11.3.1 REQUEST PARAMETERS

Field Name

Description

Mandatory

panNum

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:v="http://incometaxindiaefiling.gov.in/ditws/JurisdictionalAO/v_1_0">

<soapenv:Header/>

<soapenv:Body>

<v:getJurisdictionalAORequest>

</panNum>

</v:getJurisdictionalAORequest>

</soapenv:Body>

</soapenv:Envelope>

Webservice User Manual V1.2

Page 57

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

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<ns3:JurisdictionalAOResponse

xmlns:ns3="http://incometaxindiaefiling.gov.in/ditws/JurisdictionalAO/v_1_0">

<buildingName>xxxxxxxxxx</buildingName>

<firstName>xxxxxxxxxx</firstName>

<jurisdiction>xxxxxxxxxx</jurisdiction>

<middleName>xxxxxxxxxx</middleName>

<surName>xxxxxxxxxx</surName>

</jurisdictionalAOInfo>

</ns3:JurisdictionalAOResponse>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

Webservice User Manual V1.2

Page 58

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

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

Webservice User Manual V1.2

Page 59

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

Webservice User Manual V1.2

Page 60

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:pan="http://panws.dit.tcs.com/" xmlns:typ="http://panws.dit.tcs.com/types/">

<soapenv:Header/>

<soapenv:Body>

<pan:getPanInfo>

<login>

<typ:userName>xxxxxxxxxx</typ:userName>

<typ:password>xxxxxxxxxx</typ:password>

</login>

<panNo>

<typ:panNo>xxxxxxxxxx</typ:panNo>

</panNo>

</pan:getPanInfo>

</soapenv:Body>

</soapenv:Envelope>

Webservice User Manual V1.2

Page 61

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

<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">

<env:Header />

<env:Body>

<ns4:getPanInfoResponse xmlns:ns2="http://panws.dit.tcs.com/types/"

xmlns="" xmlns:ns4="http://panws.dit.tcs.com/">

<ns2:pan>xxxxxxxxxx</ns2:pan>

<ns2:ffullname>xxxxxxxxxx</ns2:ffullname>

<ns2:address>xxxxxxxxxx</ns2:address>

<ns2:dob>xxxxxxxxxx</ns2:dob>

<ns2:fullname>xxxxxxxxxx</ns2:fullname>

<ns2:error xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:nil="true" />

</result>

</ns4:getPanInfoResponse>

</env:Body>

</env:Envelope>

Webservice User Manual V1.2

Page 62

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

Table 65: Retrieve PAN - Error Messages

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

Webservice User Manual V1.2

Page 63

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

Webservice User Manual V1.2

Page 64

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:typ="http://tanws.dit.tcs.com/types/">

<soapenv:Header/>

<soapenv:Body>

<typ:getTanInfo>

<userName>xxxxxxxxxx</userName>

<password>xxxxxxxxxx</password>

</LoginInfo>

<tanNo>xxxxxxxxxx</tanNo>

</TanNum>

</typ:getTanInfo>

</soapenv:Body>

</soapenv:Envelope>

Webservice User Manual V1.2

Page 65

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

Pan

PAN

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

<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">

<env:Header/>

<env:Body>

<ns3:TanInfoResponse xmlns:ns3="http://tanws.dit.tcs.com/types/">

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

Webservice User Manual V1.2

Page 66

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

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

Webservice User Manual V1.2

Page 67

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

Webservice User Manual V1.2

Page 68

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

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

Webservice User Manual V1.2

Page 69

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

Description

Result

Token Number

Table 74: Bulk ITR - Response Parameters

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

Webservice User Manual V1.2

Page 70

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 Password Authentication

failed.

Please provide a valid Password.

Certificate chain not provided

Please provide the Certificate Chain

Signature not provided

Please provide a Digital Signature Certificate.

The digital signature certificate 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

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

Webservice User Manual V1.2

Page 71

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

Webservice User Manual V1.2

Page 72

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

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

Web Services User Manual V 1.0

Navigation menu

Versions of this User Manual:

Views

Navigation