1 DIT Web Services

This section provides the details of Web Services provided by DIT including data types
and required user privileges. DIT offers following Web Services.
i. Retrieve PA Infor!ation
ii. Sub!it "ul# ITR
iii. Retrieve $%AS Infor!ation
iv. Retrieve Rectification Status
v. Retrieve Refund Status
vi. Retrieve ITR&' Status
vii. Add (lient Details
viii.Sub!it "ul# PA
i). Retrieve TA Infor!ation
). Retrieve ITR&'
1.1 Retrieve PA Infor!ation

https*++inco!eta)indiaefiling.gov.in+e&,ilingWS+ditws+PanWS.wsdl
This web service is only for "ul# Pan -uery user./)ternal Agency0.
1.1.1 Parameters
Request
S. No. Input
Fields
Description Validation Mandatory
1 userName
User ID of the user The User ID should be of 10
characters.
Yes
2 password
Password of the user Yes
3 Pan
PAN of the client PAN should be of 10 characters.
Examle! AAAPA0000A
Yes
Response
S. No. Output Fields Description
1 Pan
PAN
2 Ffullname
"ather#s full name
3 Address
Address of the
4 Dob
Date of $irth of
5 Fullname
Assess full name
6 Error
Error if an%
1.1.2 SOAP
Request
&soaen'!En'eloe xmlns!soaen'()htt!**schemas.xmlsoa.or+*soa*en'eloe*)
xmlns!an()htt!**anws.dit.tcs.com*) xmlns!t%()htt!**anws.dit.tcs.com*t%es*),
&soaen'!-eader*,
&soaen'!$od%,
&an!+etPanInfo,
&lo+in,
&t%!userName,xxxxxxxxxx&*t%!userName,
&t%!assword,xxxxxxxxxx&*t%!assword,
&*lo+in,
&anNo,
&t%!anNo,xxxxxxxxxx&*t%!anNo,
&*anNo,
&*an!+etPanInfo,
&*soaen'!$od%,
&*soaen'!En'eloe,
Response:
&en'!En'eloe xmlns!en'()htt!**schemas.xmlsoa.or+*soa*en'eloe*),
&en'!-eader *,
&en'!$od%,
&ns.!+etPanInfo/esonse xmlns!ns0()htt!**anws.dit.tcs.com*t%es*)
xmlns()) xmlns!ns.()htt!**anws.dit.tcs.com*),
&result,
&ns0!an,xxxxxxxxxx&*ns0!an,
&ns0!ffullname,xxxxxxxxxx&*ns0!ffullname,
&ns0!address,xxxxxxxxxx&*ns0!address,
&ns0!dob,xxxxxxxxxx&*ns0!dob,
&ns0!fullname,xxxxxxxxxx&*ns0!fullname,
&ns0!error xmlns!xsi()htt!**www.w1.or+*0001*2345chema6instance)
xsi!nil()true) *,
&*result,
&*ns.!+etPanInfo/esonse,
&*en'!$od%,
&*en'!En'eloe,
Error
1env*/nvelope )!lns*env23http*++sche!as.)!lsoap.org+soap+envelope+34
1env*5eader+4
1env*"ody4
1env*,ault )!lns*ns623http*++sche!as.)!lsoap.org+soap+envelope+34
1faultcode4ns6*(lient+Server1+faultcode4
1faultstring )!l*lang23en34/rror 7essage1+faultstring4
1+env*,ault4
1+env*"ody4
1+env*/nvelope4
1.1.3 Error Messages
Scenario
Error Message
8ser ID not provided in request Please provide the 8ser ID.
Incorrect 8ser ID Authentication failed. Please provide a valid 8ser ID.
Password not provided in request Please provide the Password.
Incorrect Password Authentication failed. Please provide a valid Password.
PA field left blan# Please provide a PA .
9ess nu!ber of characters entered in PA Invalid PA. Please retry.
PA entered in wrong for!at Invalid PA. Please retry.
PA does not e)ist PA does not e)ist.
1.2 Submit Bul IT!
https*++inco!eta)indiaefiling.gov.in+e&,ilingWS+ditws+sub!itITR.wsdl
1.2.1 Parameters
Request
S. No. Input Fields Description Validation Mandatory
1 userID
User ID of the user The User ID should be
of 10 characters.
Yes
2 password
Password of the user Yes
3 certChan
7ertification chain Yes
4 s!nature
5i+nature Yes
5 "p
Attachment
8i attachment which contains
IT/ xml files
Yes
Response
S. No. Output Fields Description
1 result To#en u!ber
1.2.2 SOAP
Request
&soaen'!En'eloe xmlns!soaen'()htt!**schemas.xmlsoa.or+*soa*en'eloe*)
xmlns!'()htt!**incometaxindiaefilin+.+o'.in*ws*ds*common*'9190),
&soaen'!-eader*,
&soaen'!$od%,
&'!DIT:5AuthInfoEle,
&'!userID,xxxxxxxxxx&*'!userID,
&'!assword,xxxxxxxxxx&*'!assword,
&'!cert7hain,xxxxxxxxxx&*'!cert7hain,
&'!si+nature,xxxxxxxxxx&*'!si+nature,
&*'!DIT:5AuthInfoEle,
&*soaen'!$od%,
&*soaen'!En'eloe,
Response
&en'!En'eloe xmlns!en'()htt!**schemas.xmlsoa.or+*soa*en'eloe*),
&en'!-eader*,
&en'!$od%,
&ns0!DIT:5/esonseEle xmlns!ns0()htt!**incometaxindiaefilin+.+o'.in*ws*ds*common*'9190),
&ns0!result,xxxxxxxxxx&*ns0!result,
&*ns0!DIT:5/esonseEle,
&*en'!$od%,
&*en'!En'eloe,
Error
1env*/nvelope )!lns*env23http*++sche!as.)!lsoap.org+soap+envelope+34
1env*5eader+4
1env*"ody4
1env*,ault )!lns*ns623http*++sche!as.)!lsoap.org+soap+envelope+34
1faultcode4ns6*(lient+Server1+faultcode4
1faultstring )!l*lang23en34/rror 7essage1+faultstring4
1+env*,ault4
1+env*"ody4
1+env*/nvelope4
1.2.3 Error Messages
Scenario
Error Message
8ser ID not provided in request Please provide the 8ser ID.
Incorrect 8ser ID Authentication failed. Please provide a valid 8ser ID.
Password not provided in request Please provide the Password.
Incorrect Password Authentication failed. Please provide a valid Password.
(ertificate chain not provided Please provide the (ertificate (hain
Signature not provided Please provide a Digital Signature (ertificate.
The digital signature certificate does not !atch with the
one registered
Invalid Digital Signature (ertificate. Please retry.
Invalid Digital signature certificate. Invalid Digital Signature (ertificate. Please contact your
(ertificate Provider.
The trusted parent certificate could not be verified Invalid Digital Signature (ertificate. The trusted parent
certificate could not be verified.
1.2." IT! #M$ %I$E %ormat
The /nd user ITR :79 file consists of the Ta) returns data which the Service provider prepared for the
/nd user.
This :79 file should be a valid 8T,&; /ncoding )!l file and should adhere to the sche!a provided by the
Depart!ent of Inco!e Ta).
In case the /nd user needs to sign the file with his class ll Digital (ertificate< SP should provide an
interface to the /nd user to sign his :79 using the /nveloping :79 digital Signature API described below.
1.2.4.1 XML Signature Representation
= :79 Signature is identified by the root 1Signature4 ele!ent.
$ Infor!ation about the original data ob>ect that is signed is represented in the 1Signature4 ele!ent via 8ri?s.
ITRService interface is supporting below given type of signature
Envelo&ing signature* where the data ob>ect is e!bedded within the :79 Signature.
1.2.".1.1 Basic #M$ Signature Structure
&5i+nature ID;,
&5i+nedInfo,
&7anonicali<atoin3ethod*,
&5i+natue3ethod*,
=&/eference U/I;,
&Di+est3ethod*,
&Di+est>alue*,
&*/eference,?@
&*5i+nedInfo,
&5i+nature>alue*,
=&Ae%Info*,?;
=&BbCect ID; *,?D
&*5i+nature,
;!<ero or one occurrence.
D! <ero or more occurrences.
@!one or more occurrences
1.2.".1.2 #M$ Signature 'eneration
1.2.".1.3 #M$ Signature S(nta)
(ore Synta)* these are !andatory and are required to be supported by the confir!ing
i!ple!entations.
@ptional Signature Synta)* these ele!ents are optional to i!ple!ent. (an only appear
as a child of the 1@b>ect4 ele!ent.
*ore S(nta)+
The 1Signature4 /le!ent* is the !ain ele!ent of :79 Signature. It can e)ist as a
standalone docu!ent< can envelop the data ob>ect that it signs< or it can be enveloped
by the data ob>ect.
The 1Signature4 has the following child ele!ents in order in which they appear*
ds*SignedInfo.
ds*Signature'alue.
ds*AeyInfo.
ds*@b>ect.
Apply
Transforms
Calc
Digest
<Digest
Value>
Add Digest
Algorithm
<DigestMethod>
Add Transform
Algorithm
<Transform>
<Reference> <SignedInfo>
Add
<SignatureMethod>
XM Data
Apply
Canonicli!ation Algorithm
Add
<Canonicli!ationMethod>
Apply
Signature Algorithm
<SignatureValue>
"ptional
#eyInformation
<#eyInfo> <Signature>
T,e -Signature.alue/ Element* contains the actual value of the digital signature. It
does not have any child ele!ents
and has one Id attribute.
T,e -Signe0In1o/ Element* it contains references to the original data ob>ect and
includes the canonincaliBation and signature algorith!s. The encrypted digest of the
canonical for! of the 1SignedInfo4represents the value of the :79 signature. And it has
an Id attribute and the following child ele!ents*
ds*(anonicaliBation7ethod.
ds*Signature7ethod.
ds*Reference.
T,e -*anonicali2ationMet,o0/* specifies the canonicaliBation algorith!
applied to the 1SignedInfo4< the algorith! used is identified by the Algorith!
attribute< and it per!it one child ele!ent which can be fro! any na!espace.
T,e -SignatureMet,o0/ Element+ specifies the algorith! used for signature
generation< this algorith! identifies all cryptographic functions involved in the
signature generation< and it has one attribute algorith!< and includes this
ele!ent*
T,e Signature met,o0 s,oul0 be RSA-SHA1 as
1Signature7ethod Algorith!23http*++www.wC.org+$666+6D+)!ldsigErsa&sha=3+4
T,e -!e1erence/ Element+ it carries the digest value of the data ob>ect and
optionally references to the original data ob>ect. It !ay include a 1Transfor!s4< it
has the following child ele!ents*
ds* Digest7et>hod.
ds* Digest'alue.
And it has three attributes*
o Id.
o 8RI.
o Type.
T,e !e1erence element 3!I s,oul0 be t,e PA4 o1 t,e 3SE! as
&/eference U/I()E2222211112),
T,e -DigestMet,o0/ Element* specifies the digest algorith! to be used for
the original data ob>ect or transfor!ed if any 1Transfor!s4 e)ists.
The Di+est3ethod should follow the sha1 Al+orithm
&Di+est3ethod Al+orithm()htt!**www.w1.or+*0000*0F*xmldsi+Esha1)*,
T,e -Digest.alue/ Element* contains the value of the digest.
T,e -5e(In1o/ Element* is an optional ele!ent that enables #ey infor!ation to
be pac#aged along with the :79 Signature. It can contain #eys< #eys na!es<
certificates. It has !any child ele!ents such as*
ds* Aeya!e
ds* Aey'alue
ds* Retrieval7ethod
The Aeya!e< Aey'alue and Retrieval7ethod are the optional
/le!ents and need not be included for this Web Service
ds* :F6DData&Should be included in the :79
Signature
The :F6DData should have $ children type.
o The :F6DSub>ecta!e of the /nd 8ser (ertificate
o The :F6D(ertificate G This is the co!plete chain of the
:F6D(ertificate of the /nd user certificate and should
have all the certificate chains
.
The -Ob6ect/ /le!ent* is an child ele!ent of 1Signature4< and typically used
for enveloping signature where the data ob>ect being signed is included in the
1Signature4 ele!ent. It can have any child ele!ents and it has tree attributes*
ID< 7i!e Type< and /ncoding.
The ID attribute should be the PA nu!ber of the 8ser as 1@b>ect
Id23:::::====:34 and the @b>ect /le!ent contains the 8ser IT Return :79
/le!ents.
1.2.".1." Algorit,m Su&&orte0
:79 Signature specification defines a standard usage !odel for a set of algorith!s that can
be used with the specification.
7essage Digest*
o S5A&=.
Signature Algorith!s*
o PA(S= .RSAHS5A=0.
(anonicaliBation Algorith!s*
o (anonical :79 with co!!ents.
The SP has to Iip all the Signed and unsigned :79 together as one IIP file and upload it through the Web
Service.
The SP shall not !erge the signed :79 together as one bul# :79.
The SP shall !erge the 8nsigned :79 together as one bul# :!l but he has to Iip the file together
1.3 !etrieve 27AS In1ormation
https*++inco!eta)indiaefiling.gov.in+e&,ilingWS+ditws+Jet$%asInfo.wsdl
1.3.1 Parameters
Request
S. No. Input
Fields
Description Validation Mandatory
1 userName
User ID of the user The User ID should be
of 10 characters.
Yes
2 password
Password of the user Yes
3 Pan
PAN for which 0GA5 information is
reHuired
PAN should be of 10
characters.
Examle!
AAAPA0000A
Yes
4 dob
Date Bf $irth*Incororation of the
PAN
It should be a 'alid
xml date. The format
is YYYY6336DD.
Examle! 1F.I60J61K
Yes
5 assessmen
t$ear
Assessment Year Examle! 0011610 Yes
Response
TDS @n Salary
TDS @ther than Salary
T(S
Ta)pay!ents.@9TAS data0
TDS @n Salary*
S. No. Output Fields Description
1 TAN TAN
0 Emlo%erBrDeductorBr7ollecterName TAN Name
1 Inc7hr+5al Income char+eable on salar%
. TotalTD55al Total TD5 5alar%
TDS @n @ther than Salary*
S. No. Output Fields Description
1 TAN TAN
0 Emlo%erBrDeductorBr7ollecterName TAN Name
1 TotTD5BnAmtPaid Total TD5 amount aid
. 7laimButBfTotTD5BnAmtPaid Total TD5 amount claimed
T(S*
S. No. Output Fields Description
1 TAN TAN
0 Emlo%erBrDeductorBr7ollecterName TAN Name
1 TotalT75 Total T75
. AmtT757laimedThisYear Amount claimed for this %ear
Ta) Pay!ents*
S. No. Output Fields Description
1 $5/7ode $5/ 7ode
0 DateDe Date deosited
1 5rlNoBf7haln 5erial Number of 7hallan
. Amt Amount
If no infor!ation is present for the PA and assess!ent year then Ko record found for the
Assess!ent LearK will be displayed.
1.3.2 SOAP
Request
&soaen'!En'eloe xmlns!soaen'()htt!**schemas.xmlsoa.or+*soa*en'eloe*)
xmlns!'()htt!**incometaxindiaefilin+.+o'.in*ditws*tds*'9190),
&soaen'!-eader*,
&soaen'!$od%,
&'!+etTD5Details,
&'!4o+inInfo,
&'!userName,xxxxxxxxxx&*'!userName,
&'!assword,xxxxxxxxxx&*'!assword,
&*'!4o+inInfo,
&'!7lientInfo,
&'!an,xxxxxxxxxx&*'!an,
&'!dob,xxxxxxxxxx&*'!dob,
&'!assessmentYear,xxxxxxxxxx&*'!assessmentYear,
&*'!7lientInfo,
&*'!+etTD5Details,
&*soaen'!$od%,
&*soaen'!En'eloe,
Response
1env*/nvelope )!lns*env23http*++sche!as.)!lsoap.org+soap+envelope+34
1env*5eader+4
1env*"ody4
1JetTDSResponse )!lns*ns$23http*++inco!eta)indiaefiling.gov.in+!aster3
)!lns*nsC23http*++inco!eta)indiaefiling.gov.in+ditws+tds+vH=H634
1nsC*TDSonSalaries4
1ns$*TDSonSalary4
1ns$*/!ployer@rDeductor@r(ollectDetl4
1ns$*TA4))))))))))1+ns$*TA4
1ns$*/!ployer@rDeductor@r(ollectera!e4))))))))))1+ns$*/!ployer@rDeduct
or@r(ollectera!e4
1+ns$*/!ployer@rDeductor@r(ollectDetl4
1ns$*Inc(hrgSal4))))))))))1+ns$*Inc(hrgSal4
1ns$*TotalTDSSal4))))))))))1+ns$*TotalTDSSal4
1+ns$*TDSonSalary4
1+nsC*TDSonSalaries4
1nsC*TDSon@thThanSals4
1ns$*TDSon@thThanSal4
1ns$*/!ployer@rDeductor@r(ollectDetl4
1ns$*TA4))))))))))1+ns$*TA4
1ns$*/!ployer@rDeductor@r(ollectera!e4))))))))))S1+ns$*/!ployer@rDedu
ctor@r(ollectera!e4
1+ns$*/!ployer@rDeductor@r(ollectDetl4
1ns$*TotTDS@nA!tPaid4))))))))))1+ns$*TotTDS@nA!tPaid4
1ns$*(lai!@ut@fTotTDS@nA!tPaid4))))))))))1+ns$*(lai!@ut@fTotTDS@nA!tPa
id4
1+ns$*TDSon@thThanSal4
1+nsC*TDSon@thThanSals4
1nsC*ScheduleT(S4
1ns$*T(S4
1ns$*/!ployer@rDeductor@r(ollectDetl4
1ns$*TA4))))))))))1+ns$*TA4
1ns$*/!ployer@rDeductor@r(ollectera!e4))))))))))1+ns$*/!ployer@rDeduct
or@r(ollectera!e4
1+ns$*/!ployer@rDeductor@r(ollectDetl4
1ns$*TotalT(S4))))))))))1+ns$*TotalT(S4
1ns$*A!tT(S(lai!edThisLear4))))))))))1+ns$*A!tT(S(lai!edThisLear4
1+ns$*T(S4

1+nsC*ScheduleT(S4
1nsC*Ta)Pay!ents4
1ns$*Ta)Pay!ent4
1ns$*"SR(ode4))))))))))1+ns$*"SR(ode4
1ns$*DateDep4))))))))))1+ns$*DateDep4
1ns$*Srlo@f(haln4))))))))))1+ns$*Srlo@f(haln4
1ns$*A!t4))))))))))1+ns$*A!t4
1+ns$*Ta)Pay!ent4
1+nsC*Ta)Pay!ents4
1+JetTDSResponse4
1+env*"ody4
1+env*/nvelope4
Error
1env*/nvelope )!lns*env23http*++sche!as.)!lsoap.org+soap+envelope+34
1env*5eader+4
1env*"ody4
1env*,ault )!lns*ns623http*++sche!as.)!lsoap.org+soap+envelope+34
1faultcode4ns6*(lient+Server1+faultcode4
1faultstring )!l*lang23en34/rror 7essage1+faultstring4
1+env*,ault4
1+env*"ody4
1+env*/nvelope4
1.3.3 Error Messages
Scenario
Error Message
8ser ID not provided in request Please provide the 8ser ID.
Incorrect 8ser ID Authentication failed. Please provide a valid 8ser ID.
Password not provided in request Please provide the Password.
Incorrect Password Authentication failed. Please provide a valid Password.
PA field left blan# Please provide a PA.
9ess nu!ber of characters entered in PA Invalid PA. Please retry.
PA entered in wrong for!at Invalid PA. Please retry.
PA does not e)ist PA does not e)ist.
PA not added as a client for /RI This PA is not added as a client.
Assess!ent year is not selected Please provide the Assess!ent Lear.
Date of birth+incorporation field is left blan# Please provide date of birth
Date of birth+incorporation is not !atching Date of "irth is not !atching
1." !etrieve !ecti1ication Status
https*++inco!eta)indiaefiling.gov.in+e&,ilingWS+ditws+rectificationstatus.wsdl
1.".1 Parameters
Request
S. No. Input
Fields
Description Validation Mandatory
1 userName
User ID of the user The User ID should be of 10
characters.
Yes
2 password
Password of the user Yes
3 Pan
PAN of the client PAN should be of 10 characters.
Examle! AAAPA0000A
Yes
4 assessmen
t$ear
Assessment Year E2!0011610 Yes
Response
S. No. Output Fields Description
1 pano PA
0 asseess!entLear Assess!ent Lear
1 itra!e ITR na!e
. rectificationReferenceo Rectification Reference u!ber
K date Rectification Date
G cpc@rdero (P( order nu!ber
I date (P( order date
J status Status
1.".2 SOAP
Request
&soaen'!En'eloe xmlns!soaen'()htt!**schemas.xmlsoa.or+*soa*en'eloe*)
xmlns!'()htt!**incometaxindiaefilin+.+o'.in*ditws*IT/>5tatus*'9190),
&soaen'!-eader*,
&soaen'!$od%,
&'!+et/ectification5tatus/eHuest,
&4o+inInfo,
&userName,xxxxxxxxxx&*userName,
&assword,xxxxxxxxxx&*assword,
&*4o+inInfo,
&/ectificationInut,
&anNo,xxxxxxxxxx&*anNo,
&asseessmentYear,xxxxxxxxxx&*asseessmentYear,
&*/ectificationInut,
&*'!+et/ectification5tatus/eHuest,
&*soaen'!$od%,
&*soaen'!En'eloe,
Response
&en'!En'eloe xmlns!en'()htt!**schemas.xmlsoa.or+*soa*en'eloe*),
&en'!-eader*,
&en'!$od%,
&ns1!+et/ectification5tatus/esonse
xmlns!ns1()htt!**incometaxindiaefilin+.+o'.in*ditws*IT/>5tatus*'9190),
&result,
&anNo,xxxxxxxxxx&*anNo,
&asseessmentYear,xxxxxxxxxx&*asseessmentYear,
&itrName,xxxxxxxxxx&*itrName,
&rectification,
&rectification/eferenceNo,xxxxxxxxxx&*rectification/eferenceNo,
&date,xxxxxxxxxx&*date,
&*rectification,
&ccBrder,
&ccBrderNo,xxxxxxxxxx&*ccBrderNo,
&date,xxxxxxxxxx&*date,
&*ccBrder,
&details xsi!nil()true) xmlns!xsi()htt!**www.w1.or+*0001*2345chema6instance)*,
&status,xxxxxxxxxx&*status,
&*result,
&*ns1!+et/ectification5tatus/esonse,
&*en'!$od%,
&*en'!En'eloe,
Error
1env*/nvelope )!lns*env23http*++sche!as.)!lsoap.org+soap+envelope+34
1env*5eader+4
1env*"ody4
1env*,ault )!lns*ns623http*++sche!as.)!lsoap.org+soap+envelope+34
1faultcode4ns6*(lient+Server1+faultcode4
1faultstring )!l*lang23en34/rror 7essage1+faultstring4
1+env*,ault4
1+env*"ody4
1+env*/nvelope4
1.".3 Error Messages
Scenario
Error Message
8ser ID not provided in request Please provide the 8ser ID.
Incorrect 8ser ID Authentication failed. Please provide a valid 8ser ID.
Password not provided in request Please provide the Password.
Incorrect Password Authentication failed. Please provide a valid Password.
PA field left blan# Please provide a PA .
9ess nu!ber of characters entered in PA Invalid PA. Please retry.
PA entered in wrong for!at Invalid PA. Please retry.
PA does not e)ist PA does not e)ist.
PA not added as a client for /RI This PA is not added as a client.
Assess!ent year is not selected Please provide the Assess!ent Lear.
Assess!ent year entered in wrong for!at /nter 'alid Assess!ent Lear
1.8 !etrieve !e1un0 Status
https*++inco!eta)indiaefiling.gov.in+e&,ilingWS+ditws+refundstatus.wsdl
1.8.1 Parameters
Request
S. No. Input
Fields
Description Validation Mandatory
1 userName
User ID of the user The User ID should be of 10
characters.
Yes
2 password
Password of the user Yes
3 Pan
PAN of the client PAN should be of 10 characters.
Examle! AAAPA0000A
Yes
4 assessmen
t$ear
Assessment Year E2!0011610 Yes
Response
S. No. Output Fields Description
1 result Refund Status
1.8.2 SOAP
Request
&soaen'!En'eloe xmlns!soaen'()htt!**schemas.xmlsoa.or+*soa*en'eloe*)
xmlns!'()htt!**incometaxindiaefilin+.+o'.in*ditws*IT/>5tatus*'9190),
&soaen'!-eader*,
&soaen'!$od%,
&'!+et/efund5tatus/eHuest,
&4o+inInfo,
&userName,xxxxxxxxxx&*userName,
&assword,xxxxxxxxxx&*assword,
&*4o+inInfo,
&/efundInut,
&anNo,xxxxxxxxxx&*anNo,
&asseessment%ear,xxxxxxxxxx&*asseessment%ear,
&*/efundInut,
&*'!+et/efund5tatus/eHuest,
&*soaen'!$od%,
&*soaen'!En'eloe,
Response
&en'!En'eloe xmlns!en'()htt!**schemas.xmlsoa.or+*soa*en'eloe*),
&en'!-eader*,
&en'!$od%,
&ns1!+et/efund5tatus/esonse
xmlns!ns1()htt!**incometaxindiaefilin+.+o'.in*ditws*IT/>5tatus*'9190),
&result,xxxxxxxxxx&*result,
&*ns1!+et/efund5tatus/esonse,
&*en'!$od%,
&*en'!En'eloe,
Error
1env*/nvelope )!lns*env23http*++sche!as.)!lsoap.org+soap+envelope+34
1env*5eader+4
1env*"ody4
1env*,ault )!lns*ns623http*++sche!as.)!lsoap.org+soap+envelope+34
1faultcode4ns6*(lient+Server1+faultcode4
1faultstring )!l*lang23en34/rror 7essage1+faultstring4
1+env*,ault4
1+env*"ody4
1+env*/nvelope4
1.8.3 Error Messages
Scenario
Error Message
8ser ID not provided in request Please provide the 8ser ID.
Incorrect 8ser ID Authentication failed. Please provide a valid 8ser ID.
Password not provided in request Please provide the Password.
Incorrect Password Authentication failed. Please provide a valid Password.
PA field left blan# Please provide a PA.
9ess nu!ber of characters entered in PA Invalid PA. Please retry.
PA entered in wrong for!at Invalid PA. Please retry.
PA does not e)ist PA does not e)ist.
PA not added as a client for /RI This PA is not added as a client.
Assess!ent year is not selected Please provide the Assess!ent Lear.
1.7 !etrieve IT!9. Status
htts!**incometaxindiaefilin+.+o'.in*e6"ilin+:5*ditws*itr'status.wsdl
1.7.1 Parameters
Request
S. No. Input
Fields
Description Validation Mandatory
1 Pan
PAN PAN should be of 10 characters.
Examle! AAAPA0000A
Yes
2
assessment
Year
Assessment Year E2!0011610
$es
Response
S. No. Output Fields Description
1 result ITR&' Status
1.7.2 SOAP
Request
&soaen'!En'eloe xmlns!soaen'()htt!**schemas.xmlsoa.or+*soa*en'eloe*)
xmlns!'()htt!**incometaxindiaefilin+.+o'.in*ditws*IT/>5tatus*'9190),
&soaen'!-eader*,
&soaen'!$od%,
&'!+etIT/>5tatus/eHuest,
&PAN,xxxxxxxxxx&*PAN,
&AssessmentYear,xxxxxxxxxx&*AssessmentYear,
&*'!+etIT/>5tatus/eHuest,
&*soaen'!$od%,
&*soaen'!En'eloe,
Response
&en'!En'eloe xmlns!en'()htt!**schemas.xmlsoa.or+*soa*en'eloe*),
&en'!-eader *,
&en'!$od%,
&ns1!+etIT/>5tatus/esonse xmlns())
xmlns!ns1()htt!**incometaxindiaefilin+.+o'.in*ditws*IT/>5tatus*'9190),
&result,xxxxxxxxxx&*result,
&*ns1!+etIT/>5tatus/esonse,
&*en'!$od%,
&*en'!En'eloe,
Error
1env*/nvelope )!lns*env23http*++sche!as.)!lsoap.org+soap+envelope+34
1env*5eader+4
1env*"ody4
1env*,ault )!lns*ns623http*++sche!as.)!lsoap.org+soap+envelope+34
1faultcode4ns6*(lient+Server1+faultcode4
1faultstring )!l*lang23en34/rror 7essage1+faultstring4
1+env*,ault4
1+env*"ody4
1+env*/nvelope4
1.7.3 Error Messages
Scenario
Error Message
PA field left blan# Please provide a PA .
9ess nu!ber of characters entered in PA Invalid PA. Please retry.
PA entered in wrong for!at Invalid PA. Please retry.
PA does not e)ist PA does not e)ist.
PA not added as a client for /RI This PA is not added as a client.
Assess!ent year is not selected Please provide the Assess!ent Lear.
Assess!ent year entered in wrong for!at /nter 'alid Assess!ent Lear
1.: A00 *lient Details
htts!**incometaxindiaefilin+.+o'.in*e6"ilin+:5*ditws*add7lientDetails.wsdl
1.:.1 Parameters
Request
S. No. Input
Fields
Description Validation Mandatory
1 userName
User ID of the user The User ID should be of 10
characters.
Yes
2 password
Password of the user Yes
3 Pan
PAN of the client PAN should be of 10 characters.
Examle! AAAPA0000A
Yes
4 dob
Date Bf
$irth*Incororation of
the PAN
It should be a 'alid xml date.
The format is YYYY6336DD.
Examle! 1F.I60J61K
Yes
5 emal
E6mail Id of client It should be 'alid e6mail id Yes
6 addClent
%pton
Btions for add client It should be either of!
tdsBtion L ad'anceTaxBtion
or
TaxNot"iled"or4astTwoYears
Yes
& tanNumber
TAN TAN should be of 10 characters. Yes if #tdsBtion#
is slected
' fnancal
$ear
"inancial Year Ex! 0011610 Yes if #tdsBtion#
is slected
( bsrCode
$5/ 7ode It should be I di+it. Yes if
#ad'anceTaxBti
onT%e# is
slected
1) assessmen
t$ear
Assessment Year E2!0011610 Yes if
#ad'anceTaxBti
onT%e# is
slected
11 amountPa
d
Amount Paid It should be numeric and
maximum of 1. di+its.
Yes if
#ad'anceTaxBti
onT%e# is
slected
Response
S. No. Output Fields Description
1 result Add (lient Status
1.:.2 SOAP
Request
&soaen'!En'eloe xmlns!soaen'()htt!**schemas.xmlsoa.or+*soa*en'eloe*)
xmlns!'()htt!**incometaxindiaefilin+.+o'.in*ditws*add7lientDetails*'9190),
&soaen'!-eader*,
&soaen'!$od%,
&'!add7lientDetails,
&'!4o+inInfo,
&'!userName,xxxxxxxxxx&*'!userName,
&'!assword,xxxxxxxxxx&*'!assword,
&*'!4o+inInfo,
&'!add7lient,
&'!add7lientDetails,
&'!anNumber,xxxxxxxxxx&*'!anNumber,
&'!dateBf$irth,xxxxxxxxxx&*'!dateBf$irth,
&'!email,xxxxxxxxxx&*'!email,
&'!add7lientBtion,xxxxxxxxxx&*'!add7lientBtion,
&'!add7lientBtionDetails,
&'!tdsBtion,
&'!tanNumber,xxxxxxxxxx&*'!tanNumber,
&'!financialYear,xxxxxxxxxx&*'!financialYear,
&*'!tdsBtion,
&'!ad'anceTaxBtion,
&'!bsr7ode,xxxxxxxxxx&*'!bsr7ode,
&'!assessmentYear,xxxxxxxxxx&*'!assessmentYear,
&'!amountPaid,xxxxxxxxxx&*'!amountPaid,
&*'!ad'anceTaxBtion,
&*'!add7lientBtionDetails,
&*'!add7lientDetails,
&*'!add7lient,
&*'!add7lientDetails,
&*soaen'!$od%,
&*soaen'!En'eloe,
Response
&en'!En'eloe xmlns!en'()htt!**schemas.xmlsoa.or+*soa*en'eloe*),
&en'!-eader*,
&en'!$od%,
&ns0!add7lientDetails/esonse
xmlns!ns0()htt!**incometaxindiaefilin+.+o'.in*ditws*add7lientDetails*'9190),
&ns0!result,xxxxxxxxxx&*ns0!result,
&*ns0!add7lientDetails/esonse,
&*en'!$od%,
&*en'!En'eloe,
Error
1env*/nvelope )!lns*env23http*++sche!as.)!lsoap.org+soap+envelope+34
1env*5eader+4
1env*"ody4
1env*,ault )!lns*ns623http*++sche!as.)!lsoap.org+soap+envelope+34
1faultcode4ns6*(lient+Server1+faultcode4
1faultstring )!l*lang23en34/rror 7essage1+faultstring4
1+env*,ault4
1+env*"ody4
1+env*/nvelope4
1.:.3 Error Messages
Scenario
Error Message
8ser ID not provided in request Please provide the 8ser ID.
Incorrect 8ser ID Authentication failed. Please provide a valid 8ser ID.
Password not provided in request Please provide the Password.
Incorrect Password Authentication failed. Please provide a valid Password.
PA field left blan# Please provide a PA .
9ess nu!ber of characters entered in PA Invalid PA. Please retry.
PA entered in wrong for!at Invalid PA. Please retry.
PA does not e)ist PA does not e)ist.
Assess!ent year is not selected Please provide the Assess!ent Lear.
Assess!ent year entered in wrong for!at /nter 'alid Assess!ent Lear
o ta) paid in the last $ yearsK option is selected but userKs
ta) records are available in TDS+@9TAS db
,iling of Ta) has been done in the last two years. Please
enter the details.
Details donKt !atch with @9TAS db Incorrect Advance Ta)+Self Assess!ent Ta). Please retry.
A!ount paid field left blan# Please provide the A!ount.
9ess than M digits entered in "SR code field Please enter a valid M digit "SR (ode.
"SR code field is left blan# Please provide the "SR (ode.
Details donKt !atch with TDS+T(S db Incorrect TDS+T(S infor!ation. Please retry.
o financial year is entered Please provide the ,inancial Lear.
/&!ail ID entered in an incorrect for!at Invalid /&!ail ID. Please retry.
/&!ail ID of the assesse is not entered Please provide the /&!ail ID.
Incorrect date of birth entered Invalid Date of "irth. Please retry.
Date of birth field left blan# Please provide a Date of "irth.
PA already added as a client with the sa!e /RI This PA is already added as a client.
1.; Submit Bul PA4
htts!**incometaxindiaefilin+.+o'.in*e6"ilin+:5*ditws*submit$ulMPan.wsdl
1.;.1 Parameters
Request
S. No. Input
Fields
Description Validation Mandatory
1 userName
User ID of the user The User ID should be of 10
characters.
Yes
2 password
Password of the user Yes
3 *ml fle
:79 file as S@AP
attach!ent
Yes
Response
S. No. Output Fields Description
1 result To#en u!ber
1.;.2 SOAP
Request
&soaen'!En'eloe xmlns!soaen'()htt!**schemas.xmlsoa.or+*soa*en'eloe*)
xmlns!'()htt!**incometaxindiaefilin+.+o'.in*bulMPanser'ice*'9190),
&soaen'!-eader*,
&soaen'!$od%,
&'!submit$ulMPan,
&'!4o+inInfo,
&'!userName,xxxxxxxxxx&*'!userName,
&'!assword,xxxxxxxxxx&*'!assword,
&*'!4o+inInfo,
&*'!submit$ulMPan,
&*soaen'!$od%,
&*soaen'!En'eloe,
Response
&en'!En'eloe xmlns!en'()htt!**schemas.xmlsoa.or+*soa*en'eloe*),
&en'!-eader*,
&en'!$od%,
&ns0!DIT:5/esonse xmlns!ns0()htt!**incometaxindiaefilin+.+o'.in*bulMPanser'ice*'9190),
&ns0!result,xxxxxxxxxx&*ns0!result,
&*ns0!DIT:5/esonse,
&*en'!$od%,
&*en'!En'eloe,
Error
1env*/nvelope )!lns*env23http*++sche!as.)!lsoap.org+soap+envelope+34
1env*5eader+4
1env*"ody4
1env*,ault )!lns*ns623http*++sche!as.)!lsoap.org+soap+envelope+34
1faultcode4ns6*(lient+Server1+faultcode4
1faultstring )!l*lang23en34/rror 7essage1+faultstring4
1+env*,ault4
1+env*"ody4
1+env*/nvelope4
1.;.3 Error Messages
Scenario
Error Message
8ser ID not provided in request Please provide the 8ser ID.
Incorrect 8ser ID Authentication failed. Please provide a valid 8ser ID.
Password not provided in request Please provide the Password.
Incorrect Password Authentication failed. Please provide a valid Password.
:79 not provided Please provide an :79 file.
Two :79 files provided Please provide only one :79 file.
on :79 file is selected Please provide a valid :79.
Incorrect :79 sche!a The :79 Sche!a is invalid. Please provide the :79 in the
correct sche!a.
1.< !etrieve TA4 In1ormation
htts!**incometaxindiaefilin+.+o'.in*e6"ilin+:5*ditws*NetTAN.wsdl
1.<.1 Parameters
Request
S. No. Input
Fields
Description Validation Mandatory
1 userName
User ID of the user The User ID should be of 10
characters.
Yes
2 password
Password of the user Yes
3 +an
TAN of the client TAN should be of 10 characters.
Examle! AAAPA0000A
Yes
Response
S. No. Output Fields Description
1 tan
TA
2 cate!or,%fD
eductor
(ategory of deductor
3 address
Address
4 pan
PA
5 status
Status
6 emalId1
/&!ail Id
& emalId2
Alternate /&!ail Id
' areaCode
Area code
( A%+,pe
A@ type
1) ran!eCode
Range code
11 A%Number
A@ nu!ber
1.<.2 SOAP
Request
&soaen'!En'eloe xmlns!soaen'()htt!**schemas.xmlsoa.or+*soa*en'eloe*)
xmlns!t%()htt!**tanws.dit.tcs.com*t%es*),
&soaen'!-eader*,
&soaen'!$od%,
&t%!+etTanInfo,
&4o+inInfo,
&userName,xxxxxxxxxx&*userName,
&assword,xxxxxxxxxx&*assword,
&*4o+inInfo,
&TanNum,
&tanNo,xxxxxxxxxx&*tanNo,
&*TanNum,
&*t%!+etTanInfo,
&*soaen'!$od%,
&*soaen'!En'eloe,
Response
&en'!En'eloe xmlns!en'()htt!**schemas.xmlsoa.or+*soa*en'eloe*),
&en'!-eader*,
&en'!$od%,
&ns1!TanInfo/esonse xmlns!ns1()htt!**tanws.dit.tcs.com*t%es*),
&TanInfo,
&tan,xxxxxxxxxx&*tan,
&cate+or%BfDeductor,xxxxxxxxxx&*cate+or%BfDeductor,
&fullname,xxxxxxxxxx&*fullname,
&address,xxxxxxxxxx&*address,
&an,xxxxxxxxxx&*an,
&status,xxxxxxxxxx&*status,
&emailId1,xxxxxxxxxx&*emailId1,
&emailId0,xxxxxxxxxx&*emailId0,
&area7ode,xxxxxxxxxx&*area7ode,
&ABT%e,xxxxxxxxxx&*ABT%e,
&ran+e7ode,xxxxxxxxxx&*ran+e7ode,
&ABNumber,xxxxxxxxxx&*ABNumber,
&*TanInfo,
&*ns1!TanInfo/esonse,
&*en'!$od%,
&*en'!En'eloe,
Error
1env*/nvelope )!lns*env23http*++sche!as.)!lsoap.org+soap+envelope+34
1env*5eader+4
1env*"ody4
1env*,ault )!lns*ns623http*++sche!as.)!lsoap.org+soap+envelope+34
1faultcode4ns6*(lient+Server1+faultcode4
1faultstring )!l*lang23en34/rror 7essage1+faultstring4
1+env*,ault4
1+env*"ody4
1+env*/nvelope4
1.<.3 Error Messages
Scenario
Error Message
8ser ID not provided in request Please provide the 8ser ID.
Incorrect 8ser ID Authentication failed. Please provide a valid 8ser ID.
Password not provided in request Please provide the Password.
Incorrect Password Authentication failed. Please provide a valid Password.
TA field left blan# Please provide a TA .
9ess nu!ber of characters entered in TA Invalid TA. Please retry.
TA entered in wrong for!at Invalid TA. Please retry.
1.1= !etrieve IT!9.
htts!**incometaxindiaefilin+.+o'.in*e6"ilin+:5*ditws*+etIT/>.wsdl
1.1=.1 !etrieve IT!9. >it, Acno>le0gment 4umber
1.10.1.1 Parameters
Request
S. No. Input
Fields
Description Validation Mandatory
1 userID
User ID of the user The User ID should be of 10
characters.
Yes
2 password
Password of the user Yes
3 certChan
Yes
4 s!nature
Yes
5 ac-nowled
!ementNo
Efilin+
AcMnowled+ment
Number
Yes
Response
S. No. Output Fields Description
1 result
Status of ITR processing
1.10.1.2 SOAP
Request
&soaen'!En'eloe xmlns!soaen'()htt!**schemas.xmlsoa.or+*soa*en'eloe*)
xmlns!'()htt!**incometaxindiaefilin+.+o'.in*ws*ds*itr'*'9190)
xmlns!'1()htt!**incometaxindiaefilin+.+o'.in*ws*ds*common*'9190),
&soaen'!-eader*,
&soaen'!$od%,
&'!itr'AcMNo/eHuestEle,
&'!authInfo,
&'1!userID,2222222222&*'1!userID,
&'1!assword,xxxxxxxxxx&*'1!assword,
&'1!cert7hain,xxxxxxxxxx&*'1!cert7hain,
&'1!si+nature,xxxxxxxxxx&*'1!si+nature,
&*'!authInfo,
&'!acMnowled+ementNo,xxxxxxxxxx&*'!acMnowled+ementNo,
&*'!itr'AcMNo/eHuestEle,
&*soaen'!$od%,
&*soaen'!En'eloe,
Response
&en'!En'eloe xmlns!en'()htt!**schemas.xmlsoa.or+*soa*en'eloe*),
&en'!-eader*,
&en'!$od%,
&ns0!DIT:5/esonseEle xmlns!ns0()htt!**incometaxindiaefilin+.+o'.in*ws*ds*common*'9190),
&ns0!result,xxxxxxxxxx&*ns0!result,
&*ns0!DIT:5/esonseEle,
&*en'!$od%,
&*en'!En'eloe,
Error
1env*/nvelope )!lns*env23http*++sche!as.)!lsoap.org+soap+envelope+34
1env*5eader+4
1env*"ody4
1env*,ault )!lns*ns623http*++sche!as.)!lsoap.org+soap+envelope+34
1faultcode4ns6*(lient1+faultcode4
1faultstring )!l*lang23en34/rror 7essage1+faultstring4
1+env*,ault4
1+env*"ody4
1+env*/nvelope4
1.10.1.3 Error Messages
Scenario
Error Message
8ser ID not provided in request Please provide the 8ser ID.
Incorrect 8ser ID Authentication failed. Please provide a valid 8ser ID.
Password not provided in request Please provide the Password.
Incorrect Password Authentication failed. Please provide a valid Password.
(ertificate chain not provided Please provide the (ertificate (hain
Signature not provided Please provide a Digital Signature (ertificate.
The digital signature certificate does not !atch with the
one registered
Invalid Digital Signature (ertificate. Please retry.
Invalid Digital signature certificate. Invalid Digital Signature (ertificate. Please contact your
(ertificate Provider.
The trusted parent certificate could not be verified Invalid Digital Signature (ertificate. The trusted parent
certificate could not be verified.
Ac#nowledg!ent u!ber not provided in request Please provide Ac#nowledg!ent u!ber
Ac#nowledg!ent u!ber not provided is not valid Invalid ac#nowledg!ent nu!ber
1.1=.2 !etrieve IT!9. >it, Toen 4umber an0 PA4
1.10.2.1 Parameters
Request
S. No. Input Fields Description Validation Mandatory
1 userID
User ID of the user The User ID should be of 10
characters.
Yes
2 password
Password of the
user
Yes
3 certChan
Yes
4 s!nature
Yes
5 to-enNumber
ToMen Number of
$ulM IT/ uload
Yes
6 panID
PAN of client The anID should be of 10
characters.
Yes
Response
S. No. Output Fields Description
1 result
Status of ITR processing
1.10.2.2 SOAP
Request
&soaen'!En'eloe xmlns!soaen'()htt!**schemas.xmlsoa.or+*soa*en'eloe*)
xmlns!'()htt!**incometaxindiaefilin+.+o'.in*ws*ds*itr'*'9190)
xmlns!'1()htt!**incometaxindiaefilin+.+o'.in*ws*ds*common*'9190),
&soaen'!-eader*,
&soaen'!$od%,
&'!itr'ToMenNo/eHuestEle,
&'!authInfo,
&'1!userID,2222222222&*'1!userID,
&'1!assword,2222222222&*'1!assword,
&'1!cert7hain,2222222222&*'1!cert7hain,
&'1!si+nature,2222222222&*'1!si+nature,
&*'!authInfo,
&'!toMenNumber,2222222222&*'!toMenNumber,
&'!anID,2222222222&*'!anID,
&*'!itr'ToMenNo/eHuestEle,
&*soaen'!$od%,
&*soaen'!En'eloe,
Response
&en'!En'eloe xmlns!en'()htt!**schemas.xmlsoa.or+*soa*en'eloe*),
&en'!-eader*,
&en'!$od%,
&ns0!DIT:5/esonseEle xmlns!ns0()htt!**incometaxindiaefilin+.+o'.in*ws*ds*common*'9190),
&ns0!result,xxxxxxxxxx&*ns0!result,
&*ns0!DIT:5/esonseEle,
&*en'!$od%,
&*en'!En'eloe,
Error
1env*/nvelope )!lns*env23http*++sche!as.)!lsoap.org+soap+envelope+34
1env*5eader+4
1env*"ody4
1env*,ault )!lns*ns623http*++sche!as.)!lsoap.org+soap+envelope+34
1faultcode4ns6*(lient1+faultcode4
1faultstring )!l*lang23en34/rror 7essage1+faultstring4
1+env*,ault4
1+env*"ody4
1+env*/nvelope4
1.10.2.3 Error Messages
Scenario
Error Message
8ser ID not provided in request Please provide the 8ser ID.
Incorrect 8ser ID Authentication failed. Please provide a valid 8ser ID.
Password not provided in request Please provide the Password.
Incorrect Password Authentication failed. Please provide a valid Password.
(ertificate chain not provided Please provide the (ertificate (hain
Signature not provided Please provide a Digital Signature (ertificate.
The digital signature certificate does not !atch with the
one registered
Invalid Digital Signature (ertificate. Please retry.
Invalid Digital signature certificate. Invalid Digital Signature (ertificate. Please contact your
(ertificate Provider.
The trusted parent certificate could not be verified Invalid Digital Signature (ertificate. The trusted parent
certificate could not be verified.
To#en u!ber not provided in request Please provide To#en u!ber
To#en u!ber not provided is not valid Invalid to#en
Specified To#en not yet processed To#en not yet processed
PA not provided in request Please provide a PA
Invalid PA Invalid PA. Please retry.
ITR for PA provided was not uploaded with To#en
provided
Pan not in to#en