WebServices_Manual.pdf

8/20/2019 WebServices_Manual.pdf

1/69

Web Services User Manual

Page 1

e-Filing Web Service User Manual


2/69


Page 2

CONTENTS

1 TAX CREDIT MISMATCH ............................................................................... 5

2 ADD CLIENT DETAILS ................................................................................. 10

3 BULK PAN VERIFICATION .......................................................................... 14

4 OUTSTANDING TAX DEMAND ..................................................................... 18

5 ITR-V STATUS ............................................................................................ 22

6 REFUND/DEMAND STATUS ......................................................................... 25

7 RETRIEVE ITR-V STATUS ............................................................................ 28

8 RETRIEVE RECTIFICATION STATUS ............................................................ 36

9 RETRIEVE 26AS INFORMATION .................................................................. 40

10 E-FILED RETURN STATUS ........................................................................ 45

11 KNOW YOUR JURISDICTIONAL A.O ......................................................... 48

12 RETRIEVE PAN INFORMATION ................................................................ 51

13 RETRIEVE TAN INFORMATION ................................................................ 54

14 BULK ITR................................................................................................. 58

15 REQUEST FOR INTIMATION U/S 143(1)/154 .......................................... 61

16 REQUEST OF XML/ITR FORM/RECEIPT(PDF) .......................................... 65


3/69


Page 3

Abbreviations

Abbreviation Expanded Form

26AS 26 Annual Statement

A.O Assessing Officer

A.Y Assessment Year

DIT Department of Income Tax

ERI e-Return Intermediary

HTTP Hypertext Transfer Protocol

ITR Income Tax Return

PAN Permanent Account Number

TAN Tax Deduction Account Number

XML Extensible Markup Language


4/69


Page 4

Introduction

The World Wide Web is increasingly being used for communication between applications.

The programmatic interfaces made available over the Web for application-to-application

communication are often referred to as Web services. There are many types of

applications that can be considered Web services but interoperability between

applications is enhanced mostly by the use of familiar technologies such as XML and

HTTP. These technologies allow applications using differing languages and platforms to

interface in a familiar way.

This section provides the details of Web services provided by e-Filing including data

types and required user privileges.


5/69


Page 5

1 Tax Credit MismatchThis Web service can be used to view the tax credit mismatch for the PAN and theassessment year mentioned. This is applicable for the ERI users.

Pre-requisite: The PAN user must be added as a client of the respective ERI

Note: Details are available for A.Y 2013-14 and 2014-15.

1.1 WSDL Definition

The following table provides details on Tax Credit Mismatch- Interface properties:

Tax Credit Mismatch - Interface Properties

Property Value

Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/getTaxCredMismatchRequest.wsdl

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

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

Binding taxCreditMisMatchSOAP11

SOAP Version SOAP 1.1

Style Document

1.2 Operations

The following table provides details on Tax Credit Mismatch- Operation properties:

Tax Credit Mismatch - Operation Properties

Property Value

Operation getTaxCredMisMatch

Style Document

Type Request-Response

Input getTaxCredMismatchRequest

Output getTaxCredMismatchResponse

Send Attachments False

Receive Attachments False

1.3 Request

The user id and password are required for authenticating the user. Once authenticated,then the user will be authorised to invoke the Web service.

1.3.1 Request Parameters

The following table provides details on Tax Credit Mismatch- Request Parameters:


6/69


Page 6

Tax Credit Mismatch - Request Parameters

Field Name Description Mandatory

userName Valid e-Filing User ID. Yes

password Valid e-Filing password for the user. YesPan Valid PAN of the client Yes

assessmentYear Assessment Year Yes

1.3.2 Sample Request

The following is the sample request:

XXXXXXXXXX

XXXXXXXXXX

XXXXXXXXXX

XXXX-XX

1.4 Response

List of Challan Data and Tax Mismatch is the response.

1.4.1 Response Parameters

The following table provides details on Tax Credit Mismatch- Response Parameters:


7/69


Page 7

Tax Credit Mismatch - Response Parameters

Field Name Description

recBsrCode Count of the transaction.

recChallanAmount Challan Amount

recChallanDate Challan Date

recChallanNo Challan Number

amountIn26As Amount in 26AS

amountRecorded Amount Recorded

deductorName Deductor Name

tanNo TAN

1.4.2 Sample Response

The following is the sample response:

3453453

2342

2014-01-09T00:00:00+05:30

34345

3542345

234

2014-01-08T00:00:00+05:30

43543

4352345

23423

2014-01-11T00:00:00+05:30

34534

6546523


8/69


Page 8

23422

2014-01-10T00:00:00+05:30

34534

0

1212

DEDUCTOR NAME

AAAA12345A

0

320

DEDUCTOR NAME

AAAA12345A

0

3573

DEDUCTOR NAME

AAAA12345A

1.5 Error

1.5.1 Error Messages

The following table provides details on Tax Credit Mismatch - Error Messages:

Tax Credit Mismatch - Error Messages

Scenario Error Message

User ID not provided in the request Please provide the User ID.

Incorrect User ID Authentication failed. Please provide a valid User ID.

Password not provided in the request Please provide the password

Incorrect Password Authentication failed. Please provide a valid Password.


9/69


Page 9

1.5.2 Sample Error

The following is the sample error:

ns0:Client

Error Message< /faultstring>


10/69


Page 10

2 Add Client DetailsThis Web service can be used to add a PAN as client by the ERI user.

2.1 WSDL Definition

The following table provides details on Add Client - Interface Properties:

Add Client - Interface Properties

Property Value

Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/addClientDetails.wsdl


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

Binding addClientPortSoap11

SOAP Version SOAP 1.1Style Document

2.2 OperationsThe following table provides details on Add Client - Operation Properties:

Add Client - Operation Properties

Property Value

Operation addClientDetails

Style DocumentType Request-Response

Input addClientDetailsRequest

Output addClientDetailsResponse



2.3 Request

The user id and password are required for authenticating the user. Once authenticated,the user will be authorised to invoke the Web service.


11/69


Page 11


The following table provides details on Add Client - Request Parameters:

Add Client - Request Parameters



password Valid e-Filing password for the user. Yes

Pan Valid PAN of the client Yes

dob Date Of Birth/Incorporation of the PAN Yes

email E-mail Id of client Yes

addClient Options for add client

tanNumber TAN Yes if 'tdsOption' is selected

FinancialYear Financial Year Yes if 'tdsOption' is selected

bsrCode BSR Code Yes if

'advanceTaxOptionType' isselected

assessmentYear Assessment Year Yes if


amountPaid Amount Paid Yes if




UserName

password

AAAPA1111A

1967-05-23

[email protected]


12/69


Page 12

2.4 Response

Status of adding client is the response.


The following table provides details on Add Client - Response Parameters:

Add Client - Response Parameters


result Add Client Status.



PAN has been successfully added as your client

2.5 Error


The following table lists the error messages

Add Client - Error Messages



Incorrect User ID Authentication failed. Please provide a validUser ID.


Incorrect Password Authentication failed. Please provide a validPassword.

PAN field left blank Please provide a PAN


13/69


Page 13

Less number of characters entered in PAN Invalid PAN. Please retry.

PAN entered in wrong format Invalid PAN. Please retry

PAN does not exist PAN does not exist

Assessment year is not selected Please provide the Assessment Year

Assessment year entered in wrong format Enter Valid Assessment Year

No tax paid in the last 2 years' option is

selected but users tax records are available

in TDS/OLTAS DB

Filing of Tax has been done in the last two

years. Please

Details don't match with OLTAS DB Incorrect Advance Tax/Self-Assessment Tax.Please retry

Amount paid field left blank Please provide the Amount.

Less than 7 digits entered in BSR code field Please enter a valid 7 digit BSR Code

BSR code field is left blank Please provide the BSR Code

Details don't match with TDS/TCS DB Incorrect TDS/TCS information. Please retry

No financial year is entered Please provide the Financial Year.

E-mail ID entered in an incorrect format Invalid E-mail ID. Please retry

E-mail ID of the assesse is not entered Please provide the E-mail ID

Incorrect date of birth entered Invalid Date of Birth. Please retry

Date of birth field left blank Please provide a Date of Birth

PAN already added as a client with the same This PAN is already added as a client

2.6.2 Sample Error


ns0:Client



14/69


Page 14

3 Bulk PAN Verification

This web service is used to upload multiple PAN for verification. This is applicable for ERIand External Agency users.

3.1 WSDL Definition

The following table provides details on Bulk PAN Verification - Interface Properties:

Bulk PAN Verification - Interface Properties

Property Value

Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/submitBulkPan.wsdl


Namespace http://incometaxindiaefiling.gov.in/bulkPanservice/v_1_0

Binding BulkPanServiceSoapBindingSOAP Version SOAP 1.1

Style Document

3.2 Operations

The following table provides details on Bulk PAN Verification - Operation Properties:Bulk PAN Verification - Operation Properties

Property Value

Operation submitBulkPanStyle Document


Input SubmitBulkPanRequest

Output SubmitBulkPanResponse

Send Attachments True


3.3

Request



15/69


Page 15


The following table provides details on Bulk PAN Verification - Request Parameters:

Bulk PAN Verification - Request Parameters




XML File XML file as SOAP attachment Yes



xxxxxxxxxx

xxxxxxxxxx

Note:The user has to submit the attachment ofBulk PAN xml to get the verifications of

PANs and should be in the below format.

AAAPA0000A

AAAPA0000B

AAAPA0000C

AAAPA0000D

3.4 Response

Token Number is the response from the Webservice. To check the status of the Bulk PAN

upload, use the Token number.

Note: To View the status or details of Uploaded XML’s Login to e-Filing Application then

Go to Bulk PAN Query Token Status/Token Details.


16/69


Page 16


The following table provides details on Bulk PAN Verification - Response Parameters:

Bulk PAN Verification - Response Parameters


Result Token Number



100002134

3.5 Error



Bulk PAN Verification - Error Messages






XML not provided Please provide an XML file

Two XML files provided Please provide only one XML file

Two XML files provided Please provide only one XML file

Non XML file is selected Please provide a valid XML

Incorrect XML schema The XML Schema is invalid. Please provide the XML inthe correct schema


17/69


Page 17

3.5.2 Sample Error


ns0:Client



18/69


Page 18

4 Outstanding Tax Demand

This Web service can be used to view the outstanding tax demand for the PAN andassessment year. This is applicable for the ERI users.

Pre-requisite: PAN user must be added as client of the respective ERI

4.1 WSDL DefinitionThe following table provides details on Outstanding Tax Demand- Interface Properties:

Outstanding Tax Demand- Interface Properties

Property Value

Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/GetTaxDemandDetails.wsdl


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

Binding OutstandingTaxDemandPortSoap11


Style Document

4.2 Operations

The following table provides details on Outstanding Tax Demand- Operation Properties:

Outstanding Tax Demand- Operation Properties

Property Value

Operation Outstanding Tax Demand

Style Document


Input OutstandingTaxDemandRequest

Output OutstandingTaxDemandResponse




19/69


Page 19

4.3 Request

The user id and password are required for authenticating the user. Once authenticated,

then the user will be authorised to invoke the Web service.


The following table provides details on Outstanding Tax Demand- Request Parameters:

Outstanding Tax Demand- Request Parameters


username Valid e-Filing User ID. Yes


pan No Should be client of the username Yes

Assessment Year Should be valid and consecutive Yes



?

?

?

?

4.4 Response

Assessment Year ,Section Code, Demand Identification Number, Date on which demandis raised and Outstanding demand amount will be the response. And the response willvary based on the request details provided.


20/69


Page 20


The following table provides details on Outstanding Tax Demand - Response Parameters:

Outstanding Tax Demand - Response Parameters


asstYear Assessment Year

section Section Code

DIN Demand Identification Number

demandDate Date on which demand is raised

outstandDemand Outstanding demand amount



2013

1000

2011200837000000000T

2011-07-10T00:00:00+05:30

2222


21/69


Page 21

4.5 Error



Outstanding Tax Demand - Error Messages


User ID not provided inthe request

Please provide the User ID.

Incorrect User ID Authentication failed. Please provide a valid User ID and Password

Password not provided inthe request

Please provide the password

Incorrect Password Authentication failed. Please provide a valid User ID and Password

4.5.2 Sample Error


SOAP-ENV:Client

Error Message


22/69


Page 22

5 ITR-V Status

This Web service can be used to view status of ITR-V for the assessment year

mentioned.

5.1

WSDL DefinitionThe following table provides details on ITR-V Status - Interface Properties:

ITR-V Status - Interface Properties

Property Value

Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws /itrvstatus.wsdl


Namespace http://incometaxindiaefiling.gov.in/ditws/ITRVStatus/v_1_0

Binding itrvstatusPortSoap11


Style Document

5.2 Operations

The following table provides details on ITR-V Status - Operation Properties:ITR-V Status - Operation Properties

Property Value

Operation ITR-V Status

Style Document


Input GetITRVStatusRequest

Output GetITRVStatusResponse



5.3 RequestThe user id and password are required for authenticating the user. Once authenticated,

then the user will be authorised to invoke the Web service.


23/69


Page 23


The following table provides details on ITR-V Status - Request Parameters:

ITR-V Status - Request Parameters



password Valid e-Filing password for the Yes

panNo Should be client of the userName Yes

asseessmentYear Should be valid and consecutive Yes



?

?

5.4 ResponseITR-V status is the response. And the response will vary based on the request details

provided.


The following table provides details on ITR-V Status - Response Parameters:

ITR-V Status - Response Parameters


result ITR-V Status


24/69


Page 24




25/69


Page 25

6 Refund/Demand Status

This Web service can be used to refund/demand status for the PAN and assessment year

mentioned. This is applicable for ERI users.


6.1 WSDL DefinitionThe following table provides details on Refund/Demand Status - Interface Properties:

Refund/Demand Status - Interface Properties

Property Value

Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws /refundstatus.wsdl



Binding refundstatusPortSoap11


Style Document

6.2 Operations

The following table provides details on Refund/Demand Status - Operation Properties:

Refund/Demand Status - Operation Properties

Property Value

Operation Refund Status

Style Document


Input GetRefundStatusRequest

Output GetRefundStatusResponse

Send AttachmentsFalse

Receive AttachmentsFalse

6.3 Request



26/69


Page 26


The following table provides details on Refund/Demand Status - Request Parameters:

Refund/Demand Status - Request Parameters




panNo Should be client of the user Name Yes

asseessmentYear Should be valid and consecutive Yes



?

?

?

?

6.4

ResponseRefund/Demand Status is the response. And the response will vary based on the request

details provided.


The following table provides details on Refund/Demand Status - Response Parameters:

Refund/Demand Status - Response Parameters


result Refund Status


27/69


Page 27



Not Determined

6.5

Error



Refund/Demand Status - Error Messages


User ID not provided in therequest


Incorrect User ID Authentication failed. Please provide a valid User ID andPassword

Password not provided in therequest


Incorrect Password Authentication failed. Please provide a valid User ID andPassword

6.5.2 Sample Error


SOAP-ENV:Client

Error Message


28/69


Page 28

7 Retrieve ITR-V Status

A. Retrieve ITR-V with Acknowledgment Number

This web service can be used to retrieve the ITR-V for the Acknowledgment numbermentioned. This is applicable for ERI users.


7.1 WSDL DefinitionThe following table provides details on Retrieve ITR-V with Acknowledgment No -

Interface Properties:

Retrieve ITR-V with Acknowledgment No - Interface Properties

Property Value

Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/getITRV.wsdl


Namespace http://incometaxindiaefiling.gov.in/itrvservice/v_1_0

Binding ITRVServiceBinding


Style Document

7.2 Operations

The following table provides details on Retrieve ITR-V with Acknowledgment No -Operation Properties:

Retrieve ITR-V with Acknowledgment No - Operation Properties

Property Value

Operation getITRVByAckNo

Style Document


Input getITRVByAckNoRequest

Output getITRVResponse




29/69


Page 29

7.3 Request



The following table provides details on Retrieve ITR-V with Acknowledgment No -

Request Parameters:

Retrieve ITR-V with Acknowledgment No - Request Parameters



password Valid e-Filing password for the user Yes

certChain DSC Certificate Chain Yes

signature DSC Signature Yes

acknowledgementNo Efiling Acknowledgment Number Yes



XXXXXXXXXX

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx


30/69


Page 30

7.4 Response

ITR-V for the corresponding Acknowledgment number is sent to the registered email IDis the response.


The following table provides details on Retrieve ITR-V with Acknowledgment No -

Response Parameters:

Retrieve ITR-V with Ack. No - Response Parameters


result Status of ITR processing



xxxxxxxxxx


31/69


Page 31

7.5 Error



Retrieve ITR-V with Acknowledgment No - Error Messages


User ID not provided in therequest


Incorrect User ID Authentication failed. Please provide a valid User ID andPassword

Password not provided in therequest


Incorrect Password Authentication failed. Please provide a valid User ID andPassword

Certificate chain not provided Please provide the Certificate Chain

Signature not provided Please provide a Digital Signature Certificate

The digital signature certificate

does not match with the oneInvalid Digital Signature Certificate. Please retry

Invalid Digital signature certificate Invalid Digital Signature Certificate. Please contact your

Certificate Provider

The trusted parent certificatecould not be verified

Invalid Digital Signature Certificate. The trusted parent

Certificate could not be verified.

Acknowledgment Number notprovided in request

Please provide Acknowledgment Number

Acknowledgment Number not

provided is not validInvalid acknowledgment number

7.5.2 Sample Error


SOAP-ENV:Client

Error Message


32/69


Page 32

B. Retrieve ITR-V with Token Number and PAN

This Web service can be used to retrieve the ITR-V for the PAN and Token numbermentioned. This is applicable for ERI users.


7.1

WSDL Definition

The following table provides details on Retrieve ITR-V with Token No - Interface

Properties:

Retrieve ITR-V with Token No - Interface Properties

Property Value

Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/getITRV.wsdl


Namespace http://incometaxindiaefiling.gov.in/itrvservice/v_1_0

Binding ITRVServiceBinding


Style Document

7.2 Operations

The following table provides details on Retrieve ITR-V with Token No - OperationProperties:

Retrieve ITR-V with Token No - Operation Properties

Property Value

Operation getITRVByTokenNo

Style Document


Input getITRVByTokenNoRequest

Output getITRVResponse



7.3 Request



33/69


Page 33


The following table provides details on Retrieve ITR-V with Token No - Request

Parameters:

Retrieve ITR-V with Token No - Request Parameters





signature DSC Signature Yes

tokenNumber Token Number of Bulk ITR upload Yes



XXXXXXXXXX

XXXXXXXXXX

XXXXXXXXXX

XXXXXXXXXX

XXXXXXXXXX

XXXXXXXXXX

7.4 Response

ITR-V for the corresponding Token number and PAN is sent to registered Email ID isthe response.


34/69


Page 34


The following table provides details on Retrieve ITR-V with Token No - Response

Parameters:

Retrieve ITR-V with Token No - Response Parameters


result Status of ITR processing



xxxxxxxxxx

7.5 Error



Retrieve ITR-V with Token No - Error Messages



Incorrect User ID Authentication failed. Please provide a valid User ID

and Password


Incorrect Password Authentication failed. Please provide a valid User IDand Password


Signature not provided Please provide a Digital Signature Certificate

The digital signature certificate does

not match with the one registeredInvalid Digital Signature Certificate. Please retry


35/69


Page 35

Invalid Digital signature certificate Invalid Digital Signature Certificate. Please contact

your

The trusted parent certificate couldnot be verified

Invalid Digital Signature Certificate. The trusted parent

Certificate could not be verified.

Token Number not provided inrequest

Please provide Token Number

Token Number not provided is notvalid

Invalid token

Specified Token not yet processed Token not yet processed

PAN not provided in request Please provide a PAN

Invalid PAN Invalid PAN. Please retry

ITR for PAN provided was not

uploaded with Token provided

Pan not in token

7.5.2 Sample Error


SOAP-ENV:Client

Error Message


36/69


Page 36

8 Retrieve Rectification Status

This web service can be used to view Rectification status for the PAN and assessmentyear mentioned. This is applicable for ERI users.

Pre-requisite: PAN user should be added as client of the respective ERI

8.1 WSDL Definition

The following table provides details on Rectification Status - Interface Properties:

Rectification Status - Interface Properties

Property Value

Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/rectificationstatus.wsdl



Binding rectificationstatusPortSoap11


Style Document

8.2 Operations

The following table provides details on Rectification Status - Operation Properties:

Rectification Status - Operation Properties

Property Value

Operation getRectificationStatus

Style Document


Input getRectificationStatusRequest

Output getRectificationStatusResponse



8.3 Request



37/69


Page 37


The following table provides details on Rectification Status - Request Parameters:

Rectification Status - Request Parameters



password Valid e-Filing password for theuser.

Yes





xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

8.4 Response

List of transactions and their details like PAN, A.Y, ITR Name, Rectification Reference No

and Date of rectification is the response.


38/69


Page 38


The following table provides details on Rectification Status - Response Parameters:

Rectification Status - Response Parameters


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



xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx


39/69


Page 39

8.5 Error



Rectification Status - Error Messages


User ID not provided in request Please provide the User ID.




PAN field left blank Please provide a PAN.

Less number of characters entered inPAN

Invalid PAN. Please retry.

PAN entered in wrong format Invalid PAN. Please retry.

PAN does not exist PAN does not exist.

PAN not added as a client for ERI This PAN is not added as a client.

Assessment year is not selected Please provide the Assessment Year.

Assessment year entered in wrong

format

Enter Valid Assessment Year

8.5.2 Sample Error


ns0:ClientError Message< /faultstring>


40/69


Page 40

9 Retrieve 26AS Information

This web service can be used to view 26AS information for the PAN, assessment year,DOB mentioned. This is applicable for ERI users.


9.1 WSDL Definition

The following table provides details on View 26AS - Interface Properties:

View 26AS - Interface Properties

Property Value

Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/Get26asInfo.wsdl


Namespace http://incometaxindiaefiling.gov.in/ditws /tds/v_1_0

Binding GetTDSPortSoap11


Style Document

9.2 Operations

The following table provides details on View 26AS - Operation Properties:

View 26AS - Operation Properties

Property Value

Operation getTDSDetails

Style Document


Input GetTDSRequest

Output GetTDSResponse



9.3 Request



41/69


Page 41


The following table provides details on View 26AS - Request Parameters:

View 26AS - Request Parameters





Dob Should be a valid Date of Birth Yes




xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

9.4 Response

Form 26AS details like Tax Deducted at Source (TDS), Tax Collected at Source (TCS),Advance Tax/ Self-Assessment Tax deposited in the bank by tax payers, and Refunddetails for an Assessment Year will be the response.


42/69


Page 42


The following table provides details on View 26AS - Response Parameters:

View 26AS - Response Parameters


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



xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx


43/69


Page 43

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxxxxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx


44/69


Page 44

9.5 Error


The following table provides details on View 26AS - Error Messages:

View 26AS - Error Messages







Incorrect Client Pan Invalid Pan

Incorrect Client Dob Invalid Date of Birth/Incorporation.

Incorrect Assessment Year. Invalid Assessment Year

9.5.2 Sample Error


ns0:Client



45/69


Page 45

10 e-Filed Return Status

This web service can be used to view the latest e-Filed Return status for the PAN andassessment year mentioned. This is applicable for ERI users.


10.1 WSDL DefinitionThe following table provides details on e-Filed Return Status - Interface Properties:

e-Filed Return Status - Interface Properties

Property Value

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


Namespace http://incometaxindiaefiling.gov.in/ditws /tds/v_1_0

Binding GetTDSPortSoap11


Style Document

10.2 Operations

The following table provides details on e-Filed Return Status - Operation Properties:

e-Filed Return Status - Operation Properties

Property Value

Operation getReturnStatus

Style Document


Input getReturnStatusRequest

Output getReturnStatusResponse



10.3 Request

The user id and password of ERI are required for authenticating the user. Onceauthenticated, then the user will be authorised to invoke the Web service.


46/69


Page 46


The following table provides details on e-Filed Return Status - Request Parameters:

e-Filed Return Status - Request Parameters



password Valid e-Filing password forthe user.

Yes

Pan Should be a valid Pan Yes

assessmentYear Should be an assessmentyear

Yes



ERIA000000

*********

AAAAA0000A

YYYY-YY

10.4 Response

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

acknowledgement is the response.


The following table provides details on e-Filed Return Status - Response Parameters:

e-Filed Return Status - Response Parameters


result Collector/Deductor Name

ackNo Income From salary


47/69


Page 47



Return Processed

10000000000000

10.5 Error



e-Filed Return Status - Error Messages



Incorrect User ID Authentication failed. Please provide a valid User


Incorrect Password Authentication failed. Please provide a validPassword.

Incorrect Client Pan Invalid Pan

Incorrect Assessment Year. Invalid Assessment Year

10.5.2 Sample Error


ns0:Client



48/69


Page 48

11 Know Your Jurisdictional A.O

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

11.1 WSDL DefinitionThe following table provides details on Know Your Jurisdictional A.O - Interface

Properties:

Know Your Jurisdictional A.O - Interface Properties

Property Value

Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/JurisdictionalAOInfo.wsdl


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

Binding JurisdictionalAOInfoSOAP


Style Document

11.2 Operations

The following table provides details on Know Your Jurisdictional A.O. - OperationProperties:

Know Your Jurisdictional A.O. - Operation Properties

Property Value

Operation getJurisdictionalAOStyle Document


Input getJurisdictionalAORequest

Output getJurisdictionalAOResponse



11.3 Request

11.3.1

Request Parameters

The following table provides details on Know Your Jurisdictional A.O. - RequestParameters:

Know Your Jurisdictional A.O. - Request Parameters


panNum Valid PAN Yes

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

service.


49/69


Page 49



?

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


The following table provides details on Know Your Jurisdictional A.O - Response

Parameters:

Know Your Jurisdictional A.O - Response Parameters


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




50/69


51/69


Page 51

12 Retrieve PAN Information

This web service can be used to retrieve pan information for the PAN mentioned. This isapplicable for External Agency users.

12.1 WSDL Definition

The following table provides details on Retrieve PAN - Interface Properties:

Retrieve PAN - Interface Properties

Property Value

Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/PanWS.wsdl


Namespace http://panws.dit.tcs.com/types/

Binding GetPanInfoSoapHttp

SOAP Version SOAP 1.1Style Document

12.2 Operations

The following table provides details on Retrieve PAN - Operation Properties:Retrieve PAN - Operation Properties

Property Value

Operation getPanInfo

Style DocumentType Request-Response

Input LoginInfo

Output PanInfo



12.3 Request



The following table provides details on Retrieve PAN - Request Parameters:

Retrieve PAN - Request Parameters



password Valid e-Filing password for the User. Yes



52/69


Page 52



xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

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


The following table provides details on Retrieve PAN - Response Parameters:

Retrieve PAN - Response Parameters


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




53/69


Page 53

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

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx


12.5 Error

12.5.1

Error Messages

The following table provides details on Retrieve PAN - Error Messages:

Retrieve PAN - Error Messages



Incorrect User ID Authentication Please provide a valid User ID.

Password not provided in request Please provide the Password.

Incorrect Password Authenticationfailed. Please provide a valid Password.






12.5.2 Sample Error


ns0:Client



54/69


Page 54

13 Retrieve TAN Information

This web service can be used to retrieve tan information for the TAN mentioned.

13.1 WSDL DefinitionThe following table provides details on Retrieve TAN - Interface Properties:

Retrieve TAN - Interface Properties

Property Value

Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/GetTAN.wsdl


Namespace http://tanws.dit.tcs.com/types/

Binding GetTANInfoPortSoap11


Style Document

13.2 Operations

The following table provides details on Retrieve TAN - Operation Properties:

Retrieve TAN - Operation Properties

Property Value

Operation getTanInfo

Style Document


Input getTanInfo

Output TanInfoResponse



13.3 RequestThe user id and password are required for authenticating the user. Once authenticated,then the user will be authorised to invoke the Web service.


55/69


Page 55


The following table provides details on Retrieve TAN - Request Parameters:

Retrieve TAN - Request Parameters




tanNo TAN of the client Yes



xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

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


The following table provides details on Retrieve TAN - Response Parameters:

Retrieve TAN - Response Parameters


Tan TAN

categoryOfDeductor Category of Deductor

Address Address

Pan PAN

Status Status


56/69


Page 56

emailId1 E-mail Id

emailId2 Alternate E-mail Id

areaCode Area code

AOType AO type

rangeCode Range code

AONumber AO number



xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx

xxxxxxxxxx


57/69


Page 57

13.5 Error


The following table provides details on Retrieve TAN - Error Messages:

Retrieve TAN - Error Messages




Password not provided in request Please provide the password


TAN field left blank Please provide a TAN.

Less number of characters entered in TAN Invalid TAN. Please retry.

TAN entered in wrong format Invalid TAN. Please retry.

13.5.2 Sample Error


ns0:Client



58/69


Page 58

14 Bulk ITR

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

14.1 WSDL DefinitionThe following table provides details on Bulk ITR - Interface Properties:

Bulk ITR - Interface Properties

Property Value

Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/submitITR.wsdl


Namespace http://incometaxindiaefiling.gov.in/itrservice/v_1_0

Binding ITRServiceSoapBinding


Style Document

14.2 Operations

The following table provides details on Bulk ITR - Operation Properties:Bulk ITR - Operation Properties

Property Value

Operation submitITR

Style Document


Input DITWSAuthInfoEle

Output DITWSResponseEle



14.3

RequestThe user id and password are required for authenticating the user. Once authenticated,then the user will be authorised to invoke the Web service.


The following table provides details on Bulk ITR - Request Parameters:

Bulk ITR - Request Parameters


userID Valid e-Filing User ID. Yes



59/69


Page 59

certChain Certification chain Yes

signature Signature Yes

Zip Attachment Zip attachment whichcontains ITR xml files

Yes




xxxxxxxxxx

xxxxxxxxxx

Note:The attachmentZip contains the ITR xml files.

14.4

ResponseThe Token number for the Submit BULK ITR will be displayed as a response in the aboveformat.


The following table provides details on Bulk ITR - Response Parameters:

Bulk ITR - Response Parameters


Result Token Number



xxxxxxxxxx


60/69


Page 60

14.5 Error



Bulk ITR - Error Messages



Incorrect User ID Authenticationfailed.

Please provide a valid User ID.

Password not provided in request Please provide the password

Incorrect Password Authenticationfailed.

Please provide a valid Password.


Signature not provided Please provide a Digital Signature Certificate.

The digital signature certificate doesnot match with the one registered

Invalid Digital Signature Certificate. Please retry.

Invalid Digital signature certificate. Invalid Digital Signature Certificate. Pleasecontact your Certificate Provider.


Invalid Digital Signature Certificate. The trustedparent certificate could not be verified.

14.5.2

Sample ErrorThe following is the sample error:

ns0:Client



61/69


Page 61

15 Request for Intimation U/S 143(1)/154

This web service can be used to request the Intimation u/s 143(1)/154. This is applicablefor ERI users.


15.1 WSDL DefinitionThe following table provides details on Request for intimation u/s 143(1)/154 - Interface

Properties:

Request for intimation u/s 143(1)/154 - Interface Properties

Property Value

Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/RequestForIntimationInfo.wsdl


Namespace http://incometaxindiaefiling.gov.in/ditws/ReqForIntimation/v_1_0

Binding ReqForIntimationInfoSOAP


Style Document

15.2 Operations

The following table provides details on Request for intimation u/s 143(1)/154 -

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

Property Value

Operation getReqForIntimation

Style Document


Input getReqForIntimationRequest

Output getReqForIntimationResponse





62/69


Page 62


The following table provides details on Request for intimation u/s 143(1)/154 - Request

Parameters:

Request for intimation u/s 143(1)/154 - Request Parameters




pan Valid PAN of the client Yes


category C101 for Rectification order u/s

154C103 for Intimation u/s 143(1)

Yes



XXXXXXXXXXXXXXX

XXXXXXXXXXXXXXX

XXXXXXXXXXXXXXX

XXXXXXXXXXXXXXX

XXXXXXXXXXXXXXX

15.4 ResponseThe result for the Request for intimation u/s 143(1)/154 for given PAN, assessment yearand category will be displayed as a response in the below format.


63/69


Page 63


The following table provides details on Request for intimation u/s 143(1)/154 - ResponseParameters:

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


result The success message with the Transaction ID will bedisplayed to the assesse.



XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

15.5 Error

15.5.1

Error Messages


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












AssessmentYear in wrong format Should be valid and consecutive


64/69


Page 64

15.5.2 Sample Error


ns0:Client



65/69


Page 65

16 Request of XML/ITR Form/Receipt (PDF)

This web service can be used to retrieve XML/ITR Form/Receipt (PDF). This is applicablefor ERI users.


16.1 WSDL DefinitionThe following table provides details on Retrieval of XML/ITR Form (PDF) - Interface

Properties:

Retrieval of XML/ITR Form/Receipt (PDF) - Interface Properties

Property Value

Definition URL https://incometaxindiaefiling.gov.in/e-FilingWS/ditws/MailFiledReturns.wsdl


Namespace http://incometaxindiaefiling.gov.in/ws/ds/itr/v_1_0

Binding FiledReturnsPortSoap11


Style Document

16.2 Operations

The following table provides details on Retrieval of XML/ITR Form (PDF) - Operation

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

Property Value

Operation ITRByAckNo

Style Document


Input itrAckNoRequestEle, itrTokenNoRequestEle

Output ITRByAckNoResponse, ITRByTokenNoResponse




66/69


Page 66



Retrieval of XML/ITR Form/Receipt (PDF) - Request Parameters


userID Valid e-Filing User ID. Yes



fileType XML or FORM or RECEIPT Yes

acknowledgementNo e-Filing Acknowledgment Number Yes

panID Valid PAN Yes

tokenNumber Token Number of Bulk ITR upload Yes


The following is the sample request for ITR by acknowledgement number:

Request for ITR using acknowledgement number.

XXXXXXXXXXXXXXX

XXXXXXXXXXXXXXX

XXXXXXXXXXXXXXX

XXXXXXXXXXXXXXX

XXXXXXXXXXXXXXX


67/69


68/69


Page 68

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Response for ITR using Token number.

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

16.5 Error



Retrieval of XML/ITR Form/Receipt (PDF) - Error Messages













The digital signature certificate doesnot match with the one registered

Invalid Digital Signature Certificate. Please retry


69/69


Invalid Digital signature certificate Invalid Digital Signature Certificate. Please

contact yourCertificate Provider


Invalid Digital Signature Certificate. The trusted

parentCertificate could not be verified.

Acknowledgment Number notprovided in request

Please provide Acknowledgment Number.

Acknowledgment Number provided isnot valid

Invalid acknowledgment number

16.5.2 Sample Error


ns0:Client


Date post:	07-Aug-2018
Category:	Documents
Upload:	rajrudrapaa
View:	214 times
Download:	0 times

WebServices_Manual.pdf

Documents