General description

voraciousdrabΛογισμικό & κατασκευή λογ/κού

14 Δεκ 2013 (πριν από 3 χρόνια και 5 μήνες)

55 εμφανίσεις

L
oad XML files with lists of regist
ered
taxpayers in the inspectorate

of the day
.


P
reface
.


Every day at
12
:00
PM

local time in all time zones of the Russian Federation is the generation
two files
for

all inspections with recorded taxpayers

for tomorrow
:



MS Excel
file that is sent by e
-
mail to the inspect
orate



xml

file that stored in database and ready for download by this service

Thus, xml file is ready for
download via this

web service after the
overall
procedure, at about 01:00
AM

local time.


A
ccess
point
.


There are two access points to the service
:



From Internet



From the departmental network FTS Russia

(Intranet)

For backward compatibility, each version has its own URL. Each version
from

the official release does
not change and will continue to work

as well as at the time of the official release.

Access from the Internet
.

The current version of the service is located at
:
http
://
order
.
nalog
.
ru
/
services
/
v
01.
asmx

WSDL is located at
:
http
://
order
.
nalog
.
ru
/
services
/
v
01.
asmx
?
WSDL

The service
domain
name
(
order.nalog.ru
)
must resolve to IP address 81.177.34.245
.

Access should be on port 80. This port is open to all Internet networ
ks
.

Access f
rom the departmental network
.

The current version of the service is located at
:
http
://
order
.
tax
.
nalog
.
ru
/
services
/
v
01.
asmx

WSDL is located at
:
http
://
order
.
tax
.
nalog
.
ru
/
services
/
v
01.
asmx
?
WSDL

The service
domain
name
(
order
.
tax
.
nalog
.
ru
)
must resolve to IP address
10.251.1.89.

Access should be on port 80
.

General description

If you
browse

at the service

location
, the service description page appears. It shows that the service
name


OrderService
_v01
, and that the service has three types of methods
:



LoadXML_
***
-

I
nformation about taxpayers
ordered

the next day



Load
Reference
_
***

-

Ref
erence loading



***Version***
-

Version control
.

If you go to the link in any of the methods that you can see detailed examples of queries to the service
of two versions of the SOAP protocol
.


LoadXML

Input parameters

In all methods
LoadXML_***
input

parameters is equal
:



FNSCodeSOUN


string identifier of inspect
orate
, it appears as a four
-
digit code (the code of the
inspectorate

in accordance with the Directory code designations of the tax authorities for the
purposes of taxpayers). For example, "343
5." The list of possible codes can be obtained from
method
LoadReference_FNS
of this web service



FileDate


file date in form of xs:
d
ateTime

(
for example

"
2012
-
07
-
05T00:00:00
"
)

Output parameters

The first output parameter is the same for all methods
of this type
-

ResultCode

It may contain the following values
:



Ok
-

File successfully loaded. You can collect data from the second output parameter
-

XMLFile



UnexpectedError
-

An unexpected error occurred. It is necessary to contact the developer



NoSuchFi
le


Requested file is missing. You

must ask for another file or the file that has not yet
been generated.



FileDateIsWrong
-

File date is incorrect. So
it less

2012
.07.04

or
in future
.



FNSCodeSOUNIsWrong
-

Code of
Inspectorate is

incorrect. It does not satisfy the regular
expression
^
\
d{4}$

The second return parameter for all methods


XMLFile
.

Different methods
will
return a different type
:

For LoadXML_AsByteArray method parameter type
is

a
a
rray

of bytes

(file)

(in windows
-
1251 encoding)

For
LoadXML_As
String

method parameter type
is Unicode string (ignoring windows
-
1251 in markup)

For

LoadXML_As
Object

method parameter type

is nested objects,
which are obtained by deserializing
the XML file from the first two met
hods

Load
Reference


LoadReference
_
FNS


Returns a two
-
level
list

of the
S
ervice
s
.

F
irst level are the
Regional
Office
s
. At the second level

there are

inspect
orates

related to the selected
Regional
Office.
Information of FNSCodeSOUN
for the function call
LoadXML_ *** located in the CodeSOUN on the second level directory. At th
is

moment
, following codes
available for usage i
n functions LoadXML_ ***

:

3401,

3407,

3411,

3414,

3417,

3418,

3419,

3420,

3422,

3423,

3425,

3435,

3439,

3443,

3444,

3452,

3453,

3454,

3455,

3456,

3457,

3458,

3459,

3460,

3461,

4801,

4802,

4804,

4807,

4808,

4811,

4813,

4815,

4816,

4821,

4823,

4824,

4825,

4826
.


LoadReference
_
Region

Returns the IDs and names of possible regions in which lie the
Regional
Office and the Inspectorate
s

of
the
reference
FNS (
field

Region_ID).


LoadReference_Service

Returns a two
-
level directory of the Service, provided
by
inspect
orates
.

The first level is the grouping of
services, the second
-

a detailed description of the service. Service names may be duplicated, because are
different types of entities (juridical person; physical person, private businessman).
F
ace is contained in the
Fa
ce_ID

field
,
related to reference Face
.

LoadReference
_
Face

Returns a reference to
person types

those fields in the
field

Face_ID

in reference

Service
.

Version


LoadAvailableVersions

Returns a list of currently available versions of the service with the spe
cific addresses of access points
.


LoadVersion

Returns the current version of the service

Feedback

Head developer


Akse
nov
Alex
.

Phone

+7 (495) 913 0000
additional
3019

Email
:
aksenov
@
gnivc
.
ru