API для сервера статистики: различия между версиями

Материал из Alta-Soft Wikipedia
Перейти к навигации Перейти к поиску
(мелкая правка)
(Сделал все параметры строчными)
 
(не показано 6 промежуточных версий этого же участника)
Строка 15: Строка 15:
 
Доступ к API предоставляется по URL <nowiki>https://svd.alta.ru/api</nowiki>. Входные параметры передаются с помощью запроса HTTP GET. Для использования сервиса необходима авторизация с помощью логина и пароля. При этом, если использовать основной логин, то доступны данные по всем логинам, если использовать дополнительный логин - только по данному дополнительному логину, если авторизоваться по web-логину - данные по логинам с фильтрацией по ИНН, указанным в настройках.
 
Доступ к API предоставляется по URL <nowiki>https://svd.alta.ru/api</nowiki>. Входные параметры передаются с помощью запроса HTTP GET. Для использования сервиса необходима авторизация с помощью логина и пароля. При этом, если использовать основной логин, то доступны данные по всем логинам, если использовать дополнительный логин - только по данному дополнительному логину, если авторизоваться по web-логину - данные по логинам с фильтрацией по ИНН, указанным в настройках.
  
Для авторизации с помощью пары логин/пароль необходимо в GET-запрос добавить текущее время-дату Timestamp формата Timestamp(14) без разделителей, логин (список логинов), первым всегда указывается основной логин (если он есть в запросе), если нет основного логина, то запрос делается только на один (дополнительный) логин в открытом виде и MD5-хеш от сгенерированной строки текущее время-дата формата Timestamp(14) без разделителей + логин (первый логин списка) + md5-хэш от пароля, разделенных знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword:
+
Для авторизации с помощью пары логин/пароль необходимо в GET-запрос добавить текущее время-дату timestamp формата Timestamp(14) без разделителей, логин (список логинов), первым всегда указывается основной логин (если он есть в запросе), если нет основного логина, то запрос делается только на один (дополнительный) логин в открытом виде и MD5-хеш от сгенерированной строки текущее время-дата формата Timestamp(14) без разделителей + логин (первый логин списка) + md5-хэш от пароля, разделенных знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword:
  
для запроса процедур: Timestamp=20190210124018&login=testlogin,testlogin-03 вычисляем секрет: secret = md5(20190210124018:testlogin:md5(testpassword))
+
для запроса процедур: timestamp=20190210124018&login=testlogin,testlogin-03 вычисляем секрет: secret = md5(20190210124018:testlogin:md5(testpassword))
  
итоговый URL: <nowiki>https://svd.alta.ru/api/procedures/?Timestamp=20190210124018&login=testlogin,testlogin-03&secret=39176d2debbc878d599c07ec8c9b1174</nowiki>
+
итоговый URL: <nowiki>https://svd.alta.ru/api/procedures/?timestamp=20190210124018&login=testlogin,testlogin-03&secret=39176d2debbc878d599c07ec8c9b1174</nowiki>
  
 
Ниже приводится список общих входных параметров:
 
Ниже приводится список общих входных параметров:
Строка 30: Строка 30:
 
| colspan="4" |'''Обязательные'''
 
| colspan="4" |'''Обязательные'''
 
|-
 
|-
|''Login''
+
|''login''
 
|'''string [6,9-11]'''
 
|'''string [6,9-11]'''
 
|Логин или список из основного и/или дополнительных логинов через запятую (см. общее описание о порядке указания логинов)
 
|Логин или список из основного и/или дополнительных логинов через запятую (см. общее описание о порядке указания логинов)
 
|101121,101121-05, web.0123456
 
|101121,101121-05, web.0123456
 
|-
 
|-
|''Secret''
+
|''secret''
 
|'''string'''
 
|'''string'''
 
|Секрет для доступа к сервису (контрольная сумма md5)
 
|Секрет для доступа к сервису (контрольная сумма md5)
Строка 46: Строка 46:
 
Список дополнительных входных параметров данного вида запроса
 
Список дополнительных входных параметров данного вида запроса
 
{| class="wikitable"
 
{| class="wikitable"
|''Customs''
+
|''customs''
 
|'''string'''
 
|'''string'''
  
Строка 59: Строка 59:
 
107
 
107
 
|-
 
|-
|''CustomsWH''
+
|''customswh''
 
|'''string'''
 
|'''string'''
  
Строка 72: Строка 72:
 
107
 
107
 
|-
 
|-
|''Approved''
+
|''approved''
 
|'''boolean'''
 
|'''boolean'''
 
|1- только с решением о выпуске
 
|1- только с решением о выпуске
Строка 79: Строка 79:
 
|
 
|
 
|-
 
|-
|''EndBefore''
+
|''endbefore''
 
|'''Timestamp(8)'''
 
|'''Timestamp(8)'''
 
|Дата закрытия процедур не позднее указанной в формате ГГГГММДД
 
|Дата закрытия процедур не позднее указанной в формате ГГГГММДД
 
|20181211
 
|20181211
 
|-
 
|-
|''EndAfter''
+
|''endafter''
 
|'''Timestamp(8)'''
 
|'''Timestamp(8)'''
 
|Дата закрытия процедур не ранее указанной в формате ГГГГММДД
 
|Дата закрытия процедур не ранее указанной в формате ГГГГММДД
 
|20181211
 
|20181211
 
|-
 
|-
|''BeginBefore''
+
|''beginbefore''
 
|'''Timestamp(8)'''
 
|'''Timestamp(8)'''
 
|Дата открытия процедур не позднее указанной в формате ГГГГММДД
 
|Дата открытия процедур не позднее указанной в формате ГГГГММДД
 
|20181211
 
|20181211
 
|-
 
|-
|''BeginAfter''
+
|''beginafter''
 
|'''Timestamp(8)'''
 
|'''Timestamp(8)'''
 
|Дата открытия процедур не ранее указанной в формате ГГГГММДД
 
|Дата открытия процедур не ранее указанной в формате ГГГГММДД
 
|20181211
 
|20181211
 
|-
 
|-
|''IncludeMsg''
+
|''includemsg''
 
|'''string'''
 
|'''string'''
 
|Передавать только процедуры, содержащие указанный Тип/Типы сообщений. При перечислении через запятую работает логическое ИЛИ, при перечислении через + логическое И
 
|Передавать только процедуры, содержащие указанный Тип/Типы сообщений. При перечислении через запятую работает логическое ИЛИ, при перечислении через + логическое И
 
|CMN.11010+CMN.11140
 
|CMN.11010+CMN.11140
 
|-
 
|-
|''Status''
+
|''status''
 
|'''string'''
 
|'''string'''
 
|Вывод только процедур, находящихся в одном из указанных статусов. Номера статусов перечисляются через запятую.
 
|Вывод только процедур, находящихся в одном из указанных статусов. Номера статусов перечисляются через запятую.
 
|18,22
 
|18,22
 
|-
 
|-
|''Fields''
+
|''fields''
 
|'''boolean'''
 
|'''boolean'''
 
|1- передавать данные полей отправленного документа
 
|1- передавать данные полей отправленного документа
Строка 115: Строка 115:
 
0 - не передавать (по-умолчанию)
 
0 - не передавать (по-умолчанию)
 
|
 
|
 +
|-
 +
|inn
 +
|'''string[10]'''
 +
|Вывод только процедур по ДТ с указанным ИНН отправителя/получателя
 +
|7151023841
 
|}
 
|}
Пример запроса: <nowiki>https://svd.alta.ru/api/procedures/?Timestamp=20190101132111&login=testlogin,testlogin-02&secret=da0249bf66c8c2f31c780f950dddf189&Customs=10005020&Approved=1&EndAfter=20181126</nowiki>
+
Пример запроса: <nowiki>https://svd.alta.ru/api/procedures/?timestamp=20190101132111&login=testlogin,testlogin-02&secret=da0249bf66c8c2f31c780f950dddf189&customs=10005020&approved=1&endafter=20181126</nowiki>
  
  
Строка 204: Строка 209:
 
<ProcAmmount>2</ProcAmmount>
 
<ProcAmmount>2</ProcAmmount>
  
<ProcData>
+
<ProcData><blockquote><Login>testlogin-02</Login></blockquote><blockquote><ProcOpen>2018-10-10 10:32:40</ProcOpen></blockquote><blockquote><ProcEnd>2018-11-27 11:20:10</ProcEnd></blockquote><blockquote><CustomsProcedure>ДТ (ИМ/40)</CustomsProcedure></blockquote><blockquote><RegNumber>10005020/101018/0000001</RegNumber></blockquote><blockquote><ProccessID>2aa1b0ca-3aaa-433c-8f6c-baebf2741687</ProccessID></blockquote><blockquote><Customs>10005020</Customs></blockquote><blockquote><Status>DTDecisionGoodsDecMake</Status></blockquote><blockquote><DeclarantName>Петров Александр Сергеевич</DeclarantName></blockquote></ProcData>
 
 
<Login>testlogin-02</Login>
 
 
 
<ProcOpen>2018-10-10 10:32:40</ProcOpen>
 
 
 
<ProcEnd>2018-11-27 11:20:10</ProcEnd>
 
 
 
<CustomsProcedure>ДТ (ИМ/40)</CustomsProcedure>
 
 
 
<RegNumber>10005020/101018/0000001</RegNumber>
 
 
 
<ProccessID>2aa1b0ca-3aaa-433c-8f6c-baebf2741687</ProccessID>
 
 
 
<Customs>10005020</Customs>
 
 
 
<Status>DTDecisionGoodsDecMake</Status>
 
 
 
<DeclarantName>Петров Александр Сергеевич</DeclarantName>
 
 
 
</ProcData>
 
 
 
<ProcData>
 
 
 
<Login>testlogin</Login>
 
 
 
<ProcOpen>2018-11-01 12:02:34</ProcOpen>
 
 
 
<ProcEnd>2018-11-21 10:12:11</ProcEnd>
 
 
 
<CustomsProcedure>ДТ (ЭК/10)</CustomsProcedure>
 
 
 
<RegNumber>10702040/011118/0000021</RegNumber>
 
 
 
<ProccessID>63d1b231-34b3-427c-9ab1-1a23f274db31</ProccessID>
 
  
<Customs>10702040</Customs>
+
<ProcData><blockquote><Login>testlogin</Login></blockquote><blockquote><ProcOpen>2018-11-01 12:02:34</ProcOpen></blockquote><blockquote><ProcEnd>2018-11-21 10:12:11</ProcEnd></blockquote><blockquote><CustomsProcedure>ДТ (ЭК/10)</CustomsProcedure></blockquote><blockquote><RegNumber>10702040/011118/0000021</RegNumber></blockquote><blockquote><ProccessID>63d1b231-34b3-427c-9ab1-1a23f274db31</ProccessID></blockquote><blockquote><Customs>10702040</Customs></blockquote><blockquote><Status>DTCheckBegin</Status></blockquote><blockquote><DeclarantName>Петров Александр Сергеевич</DeclarantName></blockquote></ProcData>
 
 
<Status>DTCheckBegin</Status>
 
 
 
<DeclarantName>Петров Александр Сергеевич</DeclarantName>
 
 
 
</ProcData>
 
  
 
</SvdData>
 
</SvdData>
Строка 255: Строка 220:
 
Список дополнительных входных параметров данного вида запроса
 
Список дополнительных входных параметров данного вида запроса
 
{| class="wikitable"
 
{| class="wikitable"
|''ProcessID''
+
|''processid''
 
|'''string'''
 
|'''string'''
|ID процедуры (указывается, если не указан рег. номер)
+
|ID процедуры ('''обязательно''' указывается, если не указан рег. номер)
 
|-
 
|-
|''RegNum''
+
|''regnum''
 
|'''string'''
 
|'''string'''
|Регистрационный номер документа (указывается, если не указан ID процедуры)
+
|Регистрационный номер документа ('''обязательно''' указывается, если не указан ID процедуры)
 
|-
 
|-
|''DetailedStatus''
+
|''detailedstatus''
 
|'''boolean'''
 
|'''boolean'''
 
|1 - передавать список всех статусов процедуры со временем их наступления
 
|1 - передавать список всех статусов процедуры со временем их наступления
Строка 269: Строка 234:
 
0 - передавать только текущий статус процедуры (по-умолчанию)
 
0 - передавать только текущий статус процедуры (по-умолчанию)
 
|-
 
|-
|''Fields''
+
|''fields''
 
|'''boolean'''
 
|'''boolean'''
 
|1 - передавать данные полей отправленного документа
 
|1 - передавать данные полей отправленного документа
Строка 275: Строка 240:
 
0 - не передавать (по-умолчанию)
 
0 - не передавать (по-умолчанию)
 
|-
 
|-
|''Messages''
+
|''messages''
 
|'''boolean'''
 
|'''boolean'''
 
|1 - передавать список сообщений по указанной процедуре (по-умолчанию)
 
|1 - передавать список сообщений по указанной процедуре (по-умолчанию)
Строка 281: Строка 246:
 
0 - не передавать
 
0 - не передавать
 
|}
 
|}
Пример запроса: <nowiki>https://svd.alta.ru/api/messages/?Timestamp=20190811080001&login=testlogin&secret=f4db42316ed5322cade898daf56494d6&RegNum=10002010/201018/0000009&Fields=1&DetailedStatus=1</nowiki>
+
Пример запроса: <nowiki>https://svd.alta.ru/api/messages/?timestamp=20190811080001&login=testlogin&secret=f4db42316ed5322cade898daf56494d6&regnum=10002010/201018/0000009&fields=1&detailedstatus=1</nowiki>
  
  
Строка 412: Строка 377:
 
<Declarant>Петров Александр Сергеевич</Declarant>
 
<Declarant>Петров Александр Сергеевич</Declarant>
  
<Fields>
+
<Fields><blockquote><Sender>ООО “Ромашка”</Sender></blockquote><blockquote><Declarant>ООО “Лютик”</Declarant></blockquote><blockquote><Transport>ABC016/ABC019</Transport></blockquote><blockquote><TransportDoc>1234</TransportDoc></blockquote><blockquote><Contract>01/11 AAA</Contract></blockquote><blockquote><Invoice>123/54321</Invoice></blockquote><blockquote><TIR>01292912123</TIR></blockquote></Fields>
 
 
<Sender>ООО “Ромашка”</Sender>
 
 
 
<Declarant>ООО “Лютик”</Declarant>
 
 
 
<Transport>ABC016/ABC019</Transport>
 
 
 
<TransportDoc>1234</TransportDoc>
 
 
 
<Contract>01/11 AAA</Contract>
 
 
 
<Invoice>123/54321</Invoice>
 
 
 
<TIR>01292912123</TIR>
 
 
 
</Fields>
 
 
 
<Messages>
 
 
 
<MessageType>ED.11001</MessageName>
 
 
 
<MessageName>Запрос на открытие процедуры</MessageName>
 
 
 
<MessageTimestamp>2018-10-10 12:20:01</MessageTimestamp>
 
 
 
<Incoming>0</Incoming>
 
 
 
<X509Cert>0110ab1b01b95aaf12e8115ae231b4e40c</X509Cert>
 
 
 
<FIO>Петров Александр Сергеевич</FIO>
 
 
 
</Messages>
 
 
 
<Messages>
 
 
 
<MessageType>CMN.00002</MessageName>
 
 
 
<MessageName>Получено</MessageName>
 
 
 
<MessageTimestamp>2018-10-10 12:20:30</MessageTimestamp>
 
 
 
<Incoming>1</Incoming>
 
 
 
<X509Cert>31a2b2d97ac4012380e81192de47f08352</X509Cert>
 
 
 
<FIO>Иванов Игорь Иванович</FIO>
 
 
 
</Messages>
 
 
 
<Messages>
 
 
 
<MessageType>ED.11002</MessageName>
 
 
 
<MessageName>Начата процедура декларирования</MessageName>
 
 
 
<MessageTimestamp>2018-10-10 12:21:21</MessageTimestamp>
 
 
 
<Incoming>1</Incoming>
 
 
 
<X509Cert>31a2b2d97ac4012380e81192de47f08352</X509Cert>
 
 
 
<FIO>Иванов Игорь Иванович</FIO>
 
 
 
<Messages>
 
 
 
<MessageType>CMN.11023</MessageName>
 
 
 
<MessageName>Передана ДТ (ИМ)</MessageName>
 
 
 
<MessageTimestamp>2018-10-10 12:21:50</MessageTimestamp>
 
 
 
<Incoming>0</Incoming>
 
 
 
<X509Cert>0110ab1b01b95aaf12e8115ae231b4e40c</X509Cert>
 
 
 
<FIO>Петров Александр Сергеевич</FIO>
 
 
 
</Messages>
 
 
 
<Messages>
 
 
 
<MessageType>CMN.00002</MessageName>
 
 
 
<MessageName>Получено</MessageName>
 
 
 
<MessageTimestamp>2018-10-10 12:22:30</MessageTimestamp>
 
 
 
<Incoming>1</Incoming>
 
 
 
<X509Cert>31a2b2d97ac4012380e81192de47f08352</X509Cert>
 
 
 
<FIO>Иванов Игорь Иванович</FIO>
 
 
 
</Messages>
 
 
 
<Messages>
 
 
 
<MessageType>CMN.00004</MessageName>
 
 
 
<MessageName>Обработано</MessageName>
 
 
 
<MessageTimestamp>2018-10-10 12:22:42</MessageTimestamp>
 
 
 
<Incoming>1</Incoming>
 
 
 
<X509Cert>31a2b2d97ac4012380e81192de47f08352</X509Cert>
 
 
 
<FIO>Иванов Игорь Иванович</FIO>
 
 
 
</Messages>
 
 
 
<Messages>
 
 
 
<MessageType>CMN.11072</MessageName>
 
 
 
<MessageName>Уведомление о получении ДТ в таможенном органе</MessageName>
 
 
 
<MessageTimestamp>2018-10-10 12:23:40</MessageTimestamp>
 
 
 
<Incoming>1</Incoming>
 
 
 
<X509Cert>12e1b2d97ac40cd480e3456400aaa8174e</X509Cert>
 
 
 
<FIO>Соловьёв Анатолий Сергеевич</FIO>
 
 
 
</Messages>
 
 
 
<Messages>
 
 
 
<MessageType>CMN.11001</MessageName>
 
 
 
<MessageName>Присвоен номер ДТ</MessageName>
 
 
 
<MessageTimestamp>2018-10-10 12:23:40</MessageTimestamp>
 
 
 
<Incoming>1</Incoming>
 
 
 
<X509Cert>12e1b2d97ac40cd480e3456400aaa8174e</X509Cert>
 
 
 
<FIO>Соловьёв Анатолий Сергеевич</FIO>
 
 
 
</Messages>
 
 
 
<Messages>
 
 
 
<MessageType>CMN.11002</MessageName>
 
 
 
<MessageName>Начато оформление</MessageName>
 
 
 
<MessageTimestamp>2018-10-10 12:30:00</MessageTimestamp>
 
 
 
<Incoming>1</Incoming>
 
 
 
<X509Cert>02a1c2d37a4405d060e711e4a8cedf66ff</X509Cert>
 
 
 
<FIO>Сидоров Андрей Андреевич</FIO>
 
 
 
</Messages>
 
 
 
<Messages>
 
 
 
<MessageType>CMN.11009</MessageName>
 
 
 
<MessageName>Оформление ДТ закончено</MessageName>
 
 
 
<MessageTimestamp>2018-10-10 18:30:00</MessageTimestamp>
 
 
 
<Incoming>1</Incoming>
 
 
 
<X509Cert>02a1c2d37a4405d060e711e4a8cedf66ff</X509Cert>
 
 
 
<FIO>Сидоров Андрей Андреевич</FIO>
 
 
 
</Messages>
 
 
 
<Messages>
 
 
 
<MessageType>CMN.11010</MessageName>
 
 
 
<MessageName>Решение по ДТ</MessageName>
 
 
 
<MessageTimestamp>2018-10-10 18:31:20</MessageTimestamp>
 
 
 
<Incoming>1</Incoming>
 
 
 
<X509Cert>02a1c2d37a4405d060e711e4a8cedf66ff</X509Cert>
 
 
 
<FIO>Сидоров Андрей Андреевич</FIO>
 
 
 
</Messages>
 
 
 
<DetailedStatus>
 
 
 
<StatusName>Открытие процедуры</StatusName>
 
 
 
<StatusTimestamp>2018-10-10 10:32:40</StatusTimestamp>
 
 
 
</DetailedStatus>
 
 
 
<DetailedStatus>
 
 
 
<StatusName>Начато оформление</StatusName>
 
 
 
<StatusTimestamp>2018-10-10 12:20:40</StatusTimestamp>
 
  
</DetailedStatus>
+
<Messages><blockquote><MessageType>ED.11001</MessageName></blockquote><blockquote><MessageName>Запрос на открытие процедуры</MessageName></blockquote><blockquote><MessageTimestamp>2018-10-10 12:20:01</MessageTimestamp></blockquote><blockquote><Incoming>0</Incoming></blockquote><blockquote><X509Cert>0110ab1b01b95aaf12e8115ae231b4e40c</X509Cert></blockquote><blockquote><FIO>Петров Александр Сергеевич</FIO></blockquote></Messages>
  
<DetailedStatus>
+
<Messages><blockquote><MessageType>CMN.00002</MessageName></blockquote><blockquote><MessageName>Получено</MessageName></blockquote><blockquote><MessageTimestamp>2018-10-10 12:20:30</MessageTimestamp></blockquote><blockquote><Incoming>1</Incoming></blockquote><blockquote><X509Cert>31a2b2d97ac4012380e81192de47f08352</X509Cert></blockquote><blockquote><FIO>Иванов Игорь Иванович</FIO></blockquote></Messages>
  
<StatusName>Присвоен номер</StatusName>
+
<Messages><blockquote><MessageType>ED.11002</MessageName></blockquote><blockquote><MessageName>Начата процедура декларирования</MessageName></blockquote><blockquote><MessageTimestamp>2018-10-10 12:21:21</MessageTimestamp></blockquote><blockquote><Incoming>1</Incoming></blockquote><blockquote><X509Cert>31a2b2d97ac4012380e81192de47f08352</X509Cert></blockquote><blockquote><FIO>Иванов Игорь Иванович</FIO></blockquote></Messages>
  
<StatusTimestamp>2018-10-10 12:25:00</StatusTimestamp>
+
<Messages><blockquote><MessageType>CMN.11023</MessageName></blockquote><blockquote><MessageName>Передана ДТ (ИМ)</MessageName></blockquote><blockquote><MessageTimestamp>2018-10-10 12:21:50</MessageTimestamp></blockquote><blockquote><Incoming>0</Incoming></blockquote><blockquote><X509Cert>0110ab1b01b95aaf12e8115ae231b4e40c</X509Cert></blockquote><blockquote><FIO>Петров Александр Сергеевич</FIO></blockquote></Messages>
  
</DetailedStatus>
+
<Messages><blockquote><MessageType>CMN.00002</MessageName></blockquote><blockquote><MessageName>Получено</MessageName></blockquote><blockquote><MessageTimestamp>2018-10-10 12:22:30</MessageTimestamp></blockquote><blockquote><Incoming>1</Incoming></blockquote><blockquote><X509Cert>31a2b2d97ac4012380e81192de47f08352</X509Cert></blockquote><blockquote><FIO>Иванов Игорь Иванович</FIO></blockquote></Messages>
  
<DetailedStatus>
+
<Messages><blockquote><MessageType>CMN.00004</MessageName></blockquote><blockquote><MessageName>Обработано</MessageName></blockquote><blockquote><MessageTimestamp>2018-10-10 12:22:42</MessageTimestamp></blockquote><blockquote><Incoming>1</Incoming></blockquote><blockquote><X509Cert>31a2b2d97ac4012380e81192de47f08352</X509Cert></blockquote><blockquote><FIO>Иванов Игорь Иванович</FIO></blockquote></Messages>
  
<StatusName>Открыт досмотр</StatusName>
+
<Messages><blockquote><MessageType>CMN.11072</MessageName></blockquote><blockquote><MessageName>Уведомление о получении ДТ в таможенном органе</MessageName></blockquote><blockquote><MessageTimestamp>2018-10-10 12:23:40</MessageTimestamp></blockquote><blockquote><Incoming>1</Incoming></blockquote><blockquote><X509Cert>12e1b2d97ac40cd480e3456400aaa8174e</X509Cert></blockquote><blockquote><FIO>Соловьёв Анатолий Сергеевич</FIO></blockquote></Messages>
  
<StatusTimestamp>2018-10-20 09:10:00</StatusTimestamp>
+
<Messages><blockquote><MessageType>CMN.11001</MessageName></blockquote><blockquote><MessageName>Присвоен номер ДТ</MessageName></blockquote><blockquote><MessageTimestamp>2018-10-10 12:23:40</MessageTimestamp></blockquote><blockquote><Incoming>1</Incoming></blockquote><blockquote><X509Cert>12e1b2d97ac40cd480e3456400aaa8174e</X509Cert></blockquote><blockquote><FIO>Соловьёв Анатолий Сергеевич</FIO></blockquote></Messages>
  
</DetailedStatus>
+
<Messages><blockquote><MessageType>CMN.11002</MessageName></blockquote><blockquote><MessageName>Начато оформление</MessageName></blockquote><blockquote><MessageTimestamp>2018-10-10 12:30:00</MessageTimestamp></blockquote><blockquote><Incoming>1</Incoming></blockquote><blockquote><X509Cert>02a1c2d37a4405d060e711e4a8cedf66ff</X509Cert></blockquote><blockquote><FIO>Сидоров Андрей Андреевич</FIO></blockquote></Messages>
  
<DetailedStatus>
+
<Messages><blockquote><MessageType>CMN.11009</MessageName></blockquote><blockquote><MessageName>Оформление ДТ закончено</MessageName></blockquote><blockquote><MessageTimestamp>2018-10-10 18:30:00</MessageTimestamp></blockquote><blockquote><Incoming>1</Incoming></blockquote><blockquote><X509Cert>02a1c2d37a4405d060e711e4a8cedf66ff</X509Cert></blockquote><blockquote><FIO>Сидоров Андрей Андреевич</FIO></blockquote></Messages>
  
<StatusName>Закрыт досмотр</StatusName>
+
<Messages><blockquote><MessageType>CMN.11010</MessageName></blockquote><blockquote><MessageName>Решение по ДТ</MessageName></blockquote><blockquote><MessageTimestamp>2018-10-10 18:31:20</MessageTimestamp></blockquote><blockquote><Incoming>1</Incoming></blockquote><blockquote><X509Cert>02a1c2d37a4405d060e711e4a8cedf66ff</X509Cert></blockquote><blockquote><FIO>Сидоров Андрей Андреевич</FIO></blockquote></Messages>
  
<StatusTimestamp>2018-10-22 10:00:00</StatusTimestamp>
+
<DetailedStatus><blockquote><StatusName>Открытие процедуры</StatusName></blockquote><blockquote><StatusTimestamp>2018-10-10 10:32:40</StatusTimestamp></blockquote></DetailedStatus>
  
</DetailedStatus>
+
<DetailedStatus><blockquote><StatusName>Начато оформление</StatusName></blockquote><blockquote><StatusTimestamp>2018-10-10 12:20:40</StatusTimestamp></blockquote></DetailedStatus>
  
<DetailedStatus>
+
<DetailedStatus><blockquote><StatusName>Присвоен номер</StatusName></blockquote><blockquote><StatusTimestamp>2018-10-10 12:25:00</StatusTimestamp></blockquote></DetailedStatus>
  
<StatusName>Дополнительная проверка</StatusName>
+
<DetailedStatus><blockquote><StatusName>Открыт досмотр</StatusName></blockquote><blockquote><StatusTimestamp>2018-10-20 09:10:00</StatusTimestamp></blockquote></DetailedStatus>
  
<StatusTimestamp>2018-11-02 08:40:40</StatusTimestamp>
+
<DetailedStatus><blockquote><StatusName>Закрыт досмотр</StatusName></blockquote><blockquote><StatusTimestamp>2018-10-22 10:00:00</StatusTimestamp></blockquote></DetailedStatus>
  
</DetailedStatus>
+
<DetailedStatus><blockquote><StatusName>Дополнительная проверка</StatusName></blockquote><blockquote><StatusTimestamp>2018-11-02 08:40:40</StatusTimestamp></blockquote></DetailedStatus>
  
<DetailedStatus>
+
<DetailedStatus><blockquote><StatusName>ДТ выпущена</StatusName></blockquote><blockquote><StatusTimestamp>2018-11-27 11:20:10</StatusTimestamp></blockquote></DetailedStatus>
 
 
<StatusName>ДТ выпущена</StatusName>
 
 
 
<StatusTimestamp>2018-11-27 11:20:10</StatusTimestamp>
 
 
 
</DetailedStatus>
 
  
 
</SvdData>
 
</SvdData>
Строка 667: Строка 422:
 
Список дополнительных входных параметров по запросу:
 
Список дополнительных входных параметров по запросу:
 
{| class="wikitable"
 
{| class="wikitable"
|''Package''
+
|''package''
 
|'''boolean'''
 
|'''boolean'''
 
|1 - таблица действующих пакетов деклараций с текущими остатками и датами окончания
 
|1 - таблица действующих пакетов деклараций с текущими остатками и датами окончания
Строка 673: Строка 428:
 
0 - только текущий остаток ДТ (денежных средств) и дату окончания последнего пакета (по-умолчанию)
 
0 - только текущий остаток ДТ (денежных средств) и дату окончания последнего пакета (по-умолчанию)
 
|-
 
|-
|''Expired''
+
|''expired''
 
|'''boolean'''
 
|'''boolean'''
 
|1 - показывать действующие и закончившиеся пакеты
 
|1 - показывать действующие и закончившиеся пакеты
Строка 679: Строка 434:
 
0 - показывать только действующие пакеты (по-умолчанию)
 
0 - показывать только действующие пакеты (по-умолчанию)
 
|}
 
|}
Пример запроса: <nowiki>https://svd.alta.ru/api/account/?Timestamp=20190115124015&login=testlogin&secret=1798e479bf2170b4b42bda12c709f6f1&Package=1&Expired=1</nowiki>
+
Пример запроса: <nowiki>https://svd.alta.ru/api/account/?timestamp=20190115124015&login=testlogin&secret=1798e479bf2170b4b42bda12c709f6f1&package=1&expired=1</nowiki>
  
  
Строка 732: Строка 487:
 
<ExpirationDate>2019-05-20</ExpirationDate>
 
<ExpirationDate>2019-05-20</ExpirationDate>
  
<Package>
+
<Package><blockquote><Name>10 ДТ или 20 ПИ, срок 6 месяцев</Name></blockquote><blockquote><Price>1500</Price></blockquote><blockquote><DTBalance>10 ДТ или 20 ПИ</DTBalance></blockquote><blockquote><MoneyBalance>1500</MoneyBalance></blockquote><blockquote><ExpirationDate>2019-05-20</ExpirationDate></blockquote><blockquote><Expired>0</Expired></blockquote></Package>
 
 
<Name>10 ДТ или 20 ПИ, срок 6 месяцев</Name>
 
 
 
<Price>1500</Price>
 
 
 
<DTBalance>10 ДТ или 20 ПИ</DTBalance>
 
 
 
<MoneyBalance>1500</MoneyBalance>
 
 
 
<ExpirationDate>2019-05-20</ExpirationDate>
 
 
 
<Expired>0</Expired>
 
 
 
</Package>
 
 
 
<Package>
 
 
 
<Name>200 ДТ или 400 ПИ, срок 6 месяцев</Name>
 
 
 
<Price>10000</Price>
 
 
 
<DTBalance>200 ДТ или 400 ПИ</DTBalance>
 
 
 
<MoneyBalance>10000</MoneyBalance>
 
 
 
<ExpirationDate>2018-08-22</ExpirationDate>
 
  
<Expired>1</Expired>
+
<Package><blockquote><Name>200 ДТ или 400 ПИ, срок 6 месяцев</Name></blockquote><blockquote><Price>10000</Price></blockquote><blockquote><DTBalance>200 ДТ или 400 ПИ</DTBalance></blockquote><blockquote><MoneyBalance>10000</MoneyBalance></blockquote><blockquote><ExpirationDate>2018-08-22</ExpirationDate></blockquote><blockquote><Expired>1</Expired></blockquote></Package>
 
 
</Package>
 
  
 
</SvdData>
 
</SvdData>
Строка 771: Строка 498:
 
Список дополнительных входных параметров по запросу:
 
Список дополнительных входных параметров по запросу:
 
{| class="wikitable"
 
{| class="wikitable"
|''Expired''
+
|''expired''
 
|'''boolean'''
 
|'''boolean'''
 
|1 - показывать действующие и закончившиеся ЭП
 
|1 - показывать действующие и закончившиеся ЭП
Строка 777: Строка 504:
 
0 - показывать только действующие ЭП (по-умолчанию)
 
0 - показывать только действующие ЭП (по-умолчанию)
 
|}
 
|}
Пример запроса: <nowiki>https://svd.alta.ru/api/signatures/?Timestamp=20191125191020&login=testlogin&secret=75c15f0f7f054b80dcc61028b87f3ddb&Expired=1</nowiki>
+
Пример запроса: <nowiki>https://svd.alta.ru/api/signatures/?timestamp=20191125191020&login=testlogin&secret=75c15f0f7f054b80dcc61028b87f3ddb&expired=1</nowiki>
  
  
Строка 823: Строка 550:
 
<CertAmmount>2</CertAmmount>
 
<CertAmmount>2</CertAmmount>
  
<CertData>
+
<CertData><blockquote><CommonName>ООО “Ромашка”</CommonName></blockquote><blockquote><Surname>Петров</Surname></blockquote><blockquote><GivenName>Александр Сергеевич</GivenName></blockquote><blockquote><INN>007728231211</INN></blockquote><blockquote><SerialNumber>0110ab1b01b95aaf12e8115ae231b4e40c</SerialNumber></blockquote><blockquote><Validity>2019-02-08 19:00:23</Validity></blockquote><blockquote><LastUsage>2018-03-12 11:21:11</LastUsage></blockquote><blockquote><Revoked>0</Revoked></blockquote></CertData>
 
 
<CommonName>ООО “Ромашка”</CommonName>
 
 
 
<Surname>Петров</Surname>
 
  
<GivenName>Александр Сергеевич</GivenName>
+
<CertData><blockquote><CommonName>ООО “Ромашка”</CommonName></blockquote><blockquote><Surname>Петров</Surname></blockquote><blockquote><GivenName>Александр Сергеевич</GivenName></blockquote><blockquote><INN>007728231211</INN></blockquote><blockquote><SerialNumber>0123abcd01b95bbc12e4321ae231a2b3c4</SerialNumber></blockquote><blockquote><Validity>2018-06-01 10:21:32</Validity></blockquote><blockquote><LastUsage>2018-05-12 09:01:22</LastUsage></blockquote><blockquote><Revoked>0</Revoked></blockquote></CertData>
 
 
<INN>007728231211</INN>
 
 
 
<SerialNumber>0110ab1b01b95aaf12e8115ae231b4e40c</SerialNumber>
 
 
 
<Validity>2019-02-08 19:00:23</Validity>
 
 
 
<LastUsage>2018-03-12 11:21:11</LastUsage>
 
 
 
<Revoked>0</Revoked>
 
 
 
</CertData>
 
 
 
<CertData>
 
 
 
<CommonName>ООО “Ромашка”</CommonName>
 
 
 
<Surname>Петров</Surname>
 
 
 
<GivenName>Александр Сергеевич</GivenName>
 
 
 
<INN>007728231211</INN>
 
 
 
<SerialNumber>0123abcd01b95bbc12e4321ae231a2b3c4</SerialNumber>
 
 
 
<Validity>2018-06-01 10:21:32</Validity>
 
 
 
<LastUsage>2018-05-12 09:01:22</LastUsage>
 
 
 
<Revoked>0</Revoked>
 
 
 
</CertData>
 
  
 
</SvdData>
 
</SvdData>
Строка 1400: Строка 1091:
 
|некорректное число
 
|некорректное число
 
|}
 
|}
 +
 +
[[Категория:Автоматизация]]

Текущая версия на 12:20, 26 мая 2020

Сервис «Сервер статистики» предоставляет разработчикам возможность получения информации из внешних программ и сайтов в XML-формате. С помощью данного сервиса возможно выгружать следующую информацию об обмене информацией с таможней:

1) Список всех процедур со статусами (Procedures)

2) Список всех сообщений по конкретной процедуре (Messages)

3) Текущий остаток на счету (Account)

4) Список подписей (Signature)


API

Доступ к API предоставляется по URL https://svd.alta.ru/api. Входные параметры передаются с помощью запроса HTTP GET. Для использования сервиса необходима авторизация с помощью логина и пароля. При этом, если использовать основной логин, то доступны данные по всем логинам, если использовать дополнительный логин - только по данному дополнительному логину, если авторизоваться по web-логину - данные по логинам с фильтрацией по ИНН, указанным в настройках.

Для авторизации с помощью пары логин/пароль необходимо в GET-запрос добавить текущее время-дату timestamp формата Timestamp(14) без разделителей, логин (список логинов), первым всегда указывается основной логин (если он есть в запросе), если нет основного логина, то запрос делается только на один (дополнительный) логин в открытом виде и MD5-хеш от сгенерированной строки текущее время-дата формата Timestamp(14) без разделителей + логин (первый логин списка) + md5-хэш от пароля, разделенных знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword:

для запроса процедур: timestamp=20190210124018&login=testlogin,testlogin-03 вычисляем секрет: secret = md5(20190210124018:testlogin:md5(testpassword))

итоговый URL: https://svd.alta.ru/api/procedures/?timestamp=20190210124018&login=testlogin,testlogin-03&secret=39176d2debbc878d599c07ec8c9b1174

Ниже приводится список общих входных параметров:

Параметр Тип Описание Пример
Обязательные
login string [6,9-11] Логин или список из основного и/или дополнительных логинов через запятую (см. общее описание о порядке указания логинов) 101121,101121-05, web.0123456
secret string Секрет для доступа к сервису (контрольная сумма md5) 8fbf66396927d7ba86350c2d16630786


1. Список всех процедур со статусами (Procedures)

Список дополнительных входных параметров данного вида запроса

customs string

[3,6,8]

Список таможен, куда поданы ДТ, через запятую

В случае передачи начальной части номера - все таможни, удовлетворяющие маске номер*

Не заполнено - все таможни

10005020, 100020,

107

customswh string

[3,6,8]

Список таможен местоположения товара гр.30 (для удалённых процедур) через запятую

В случае передачи начальной части номера - все таможни, удовлетворяющие маске номер*  

Не заполнено - все таможни

10005020, 100020,

107

approved boolean 1- только с решением о выпуске

0 - все декларации (по-умолчанию)

endbefore Timestamp(8) Дата закрытия процедур не позднее указанной в формате ГГГГММДД 20181211
endafter Timestamp(8) Дата закрытия процедур не ранее указанной в формате ГГГГММДД 20181211
beginbefore Timestamp(8) Дата открытия процедур не позднее указанной в формате ГГГГММДД 20181211
beginafter Timestamp(8) Дата открытия процедур не ранее указанной в формате ГГГГММДД 20181211
includemsg string Передавать только процедуры, содержащие указанный Тип/Типы сообщений. При перечислении через запятую работает логическое ИЛИ, при перечислении через + логическое И CMN.11010+CMN.11140
status string Вывод только процедур, находящихся в одном из указанных статусов. Номера статусов перечисляются через запятую. 18,22
fields boolean 1- передавать данные полей отправленного документа

0 - не передавать (по-умолчанию)

inn string[10] Вывод только процедур по ДТ с указанным ИНН отправителя/получателя 7151023841

Пример запроса: https://svd.alta.ru/api/procedures/?timestamp=20190101132111&login=testlogin,testlogin-02&secret=da0249bf66c8c2f31c780f950dddf189&customs=10005020&approved=1&endafter=20181126


Структура xml-ответа:

SvdData Корневой элемент
ProcAmmount Количество передаваемых процедур
Список процедур (блок ProcData) Данные по каждой отдельной процедуре
ProcData->Login Логин
ProcData->ProcOpen Дата и время открытия процедуры в формате Timestamp(14)
ProcData->ProcEnd Дата и время завершения процедуры в формате Timestamp(14)
ProcData->CustomsProcedure Таможенный режим (Тип+код)
ProcData->RegNumber Регистрационный номер
ProcData->ProccessID Идентификатор процедуры
ProcData->Customs Код таможни
ProcData->CustomsWH Код удаленного поста
ProcData->Status Код текущего статуса процедуры (см. приложение)
ProcData->DeclarantName ФИО декларанта, подавшего ДТ/ДО/ПИ
Список полей документа (подблок Fields) Данные полей документа по указанной процедуре
ProcData->Fields->Sender Отправитель (гр. 2)
ProcData->Fields->Declarant Декларант (гр. 14)
ProcData->Fields->Transport Номер транспортного средства из гр. 18 ДТ
ProcData->Fields->TransportDoc Номер транспортной накладной код 02013, 02015 из гр. 44 ДТ
ProcData->Fields->Contract Номер договора (контракта) код 03011 из гр. 44 ДТ
ProcData->Fields->Invoice Номер инвойса код 04021 из гр. 44 ДТ
ProcData->Fields->TIR Идентификатор книжки МДП
ProcData->Fields->WayBill Номер индивидуальной накладной
ProcData->Fields->LotAmmount Количество товарных партий реестра ЭГ
ProcData->Fields->PILotAmmount Количество товарных партий по ПИ транзит
ProcData->Fields->PITransport Номер транспортного средства гр. 18 ПИ транзит


Пример ответа:

<SvdData>

<ProcAmmount>2</ProcAmmount>

<ProcData>

<Login>testlogin-02</Login>

<ProcOpen>2018-10-10 10:32:40</ProcOpen>

<ProcEnd>2018-11-27 11:20:10</ProcEnd>

<CustomsProcedure>ДТ (ИМ/40)</CustomsProcedure>

<RegNumber>10005020/101018/0000001</RegNumber>

<ProccessID>2aa1b0ca-3aaa-433c-8f6c-baebf2741687</ProccessID>

<Customs>10005020</Customs>

<Status>DTDecisionGoodsDecMake</Status>

<DeclarantName>Петров Александр Сергеевич</DeclarantName>

</ProcData> <ProcData>

<Login>testlogin</Login>

<ProcOpen>2018-11-01 12:02:34</ProcOpen>

<ProcEnd>2018-11-21 10:12:11</ProcEnd>

<CustomsProcedure>ДТ (ЭК/10)</CustomsProcedure>

<RegNumber>10702040/011118/0000021</RegNumber>

<ProccessID>63d1b231-34b3-427c-9ab1-1a23f274db31</ProccessID>

<Customs>10702040</Customs>

<Status>DTCheckBegin</Status>

<DeclarantName>Петров Александр Сергеевич</DeclarantName>

</ProcData>

</SvdData>


2. Список всех сообщений по указанной процедуре (Messages)

Список дополнительных входных параметров данного вида запроса

processid string ID процедуры (обязательно указывается, если не указан рег. номер)
regnum string Регистрационный номер документа (обязательно указывается, если не указан ID процедуры)
detailedstatus boolean 1 - передавать список всех статусов процедуры со временем их наступления

0 - передавать только текущий статус процедуры (по-умолчанию)

fields boolean 1 - передавать данные полей отправленного документа

0 - не передавать (по-умолчанию)

messages boolean 1 - передавать список сообщений по указанной процедуре (по-умолчанию)

0 - не передавать

Пример запроса: https://svd.alta.ru/api/messages/?timestamp=20190811080001&login=testlogin&secret=f4db42316ed5322cade898daf56494d6&regnum=10002010/201018/0000009&fields=1&detailedstatus=1


Структура xml-ответа:

SvdData Корневой элемент
Данные по процедуре Основные данные по указанной процедуре
Login Логин
ProcOpen Дата и время открытия процедуры в формате Timestamp(14)
ProcEnd Дата и время завершения процедуры в формате Timestamp(14)
CustomsProcedure Таможенный режим (Тип+код)
RegNumber Регистрационный номер
ProccessID Идентификатор процедуры
Customs Код таможни
CustomsWH Код удаленного поста
Status Текущий статус процедуры
Declarant ФИО декларанта, подавшего ДТ/ДО/ПИ
Данные полей документа (блок Fields) Данные полей документа по указанной процедуре
Fields->Sender Отправитель (гр. 2)
Fields->Declarant Декларант (гр. 14)
Fields->Transport Номер транспортного средства из гр. 18 ДТ
Fields->TransportDoc Номер транспортной накладной код 02013, 02015 из гр. 44 ДТ
Fields->Contract Номер договора (контракта) код 03011 из гр. 44 ДТ
Fields->Invoice Номер инвойса код 04021 из гр. 44 ДТ
Fields->TIR Идентификатор книжки МДП
Fields->WayBill Номер индивидуальной накладной
Fields->LotAmmount Количество товарных партий реестра ЭГ
Fields->PILotAmmount Количество товарных партий по ПИ транзит
Fields->PITransport Номер транспортного средства гр. 18 ПИ транзит
Список сообщений (блок Messages) Данные по каждому переданному сообщению
Messages->MessageType Тип сообщения
Messages->MessageName Наименование сообщения
Messages->MessageTimestamp Время и дата сообщения в формате Timestamp(14)
Messages->Incoming 0 - исходящее сообщение, 1 - входящее
Messages->X509Cert 16-ричный номер сертификата ЭП из сообщения
Messages->FIO ФИО владельца сертификата ЭП
Список статусов (подблок DetailedStatus) Данные по каждому полученному статусу
ProcData->DetailedStatus->StatusName Наименование статуса
ProcData->DetailedStatus->StatusTimestamp Время и дата присвоения статуса в формате Timestamp(14)


Пример ответа:

<SvdData>

<Login>testlogin</Login>

<ProcOpen>2018-10-10 12:21:21</ProcOpen>

<ProcEnd>2018-10-11 16:11:00</ProcEnd>

<CustomsProcedure>ДТ (ИМ/40)</CustomsProcedure>

<RegNumber>10002010/101018/0000002</RegNumber>

<ProccessID>33a220ca-3b33-423a-aa6c-b234f2741181</ProccessID>

<Customs>10002010</Customs>

<Status>DTDecisionGoodsDecMake</Status>

<Declarant>Петров Александр Сергеевич</Declarant>

<Fields>

<Sender>ООО “Ромашка”</Sender>

<Declarant>ООО “Лютик”</Declarant>

<Transport>ABC016/ABC019</Transport>

<TransportDoc>1234</TransportDoc>

<Contract>01/11 AAA</Contract>

<Invoice>123/54321</Invoice>

<TIR>01292912123</TIR>

</Fields> <Messages>

<MessageType>ED.11001</MessageName>

<MessageName>Запрос на открытие процедуры</MessageName>

<MessageTimestamp>2018-10-10 12:20:01</MessageTimestamp>

<Incoming>0</Incoming>

<X509Cert>0110ab1b01b95aaf12e8115ae231b4e40c</X509Cert>

<FIO>Петров Александр Сергеевич</FIO>

</Messages> <Messages>

<MessageType>CMN.00002</MessageName>

<MessageName>Получено</MessageName>

<MessageTimestamp>2018-10-10 12:20:30</MessageTimestamp>

<Incoming>1</Incoming>

<X509Cert>31a2b2d97ac4012380e81192de47f08352</X509Cert>

<FIO>Иванов Игорь Иванович</FIO>

</Messages> <Messages>

<MessageType>ED.11002</MessageName>

<MessageName>Начата процедура декларирования</MessageName>

<MessageTimestamp>2018-10-10 12:21:21</MessageTimestamp>

<Incoming>1</Incoming>

<X509Cert>31a2b2d97ac4012380e81192de47f08352</X509Cert>

<FIO>Иванов Игорь Иванович</FIO>

</Messages> <Messages>

<MessageType>CMN.11023</MessageName>

<MessageName>Передана ДТ (ИМ)</MessageName>

<MessageTimestamp>2018-10-10 12:21:50</MessageTimestamp>

<Incoming>0</Incoming>

<X509Cert>0110ab1b01b95aaf12e8115ae231b4e40c</X509Cert>

<FIO>Петров Александр Сергеевич</FIO>

</Messages> <Messages>

<MessageType>CMN.00002</MessageName>

<MessageName>Получено</MessageName>

<MessageTimestamp>2018-10-10 12:22:30</MessageTimestamp>

<Incoming>1</Incoming>

<X509Cert>31a2b2d97ac4012380e81192de47f08352</X509Cert>

<FIO>Иванов Игорь Иванович</FIO>

</Messages> <Messages>

<MessageType>CMN.00004</MessageName>

<MessageName>Обработано</MessageName>

<MessageTimestamp>2018-10-10 12:22:42</MessageTimestamp>

<Incoming>1</Incoming>

<X509Cert>31a2b2d97ac4012380e81192de47f08352</X509Cert>

<FIO>Иванов Игорь Иванович</FIO>

</Messages> <Messages>

<MessageType>CMN.11072</MessageName>

<MessageName>Уведомление о получении ДТ в таможенном органе</MessageName>

<MessageTimestamp>2018-10-10 12:23:40</MessageTimestamp>

<Incoming>1</Incoming>

<X509Cert>12e1b2d97ac40cd480e3456400aaa8174e</X509Cert>

<FIO>Соловьёв Анатолий Сергеевич</FIO>

</Messages> <Messages>

<MessageType>CMN.11001</MessageName>

<MessageName>Присвоен номер ДТ</MessageName>

<MessageTimestamp>2018-10-10 12:23:40</MessageTimestamp>

<Incoming>1</Incoming>

<X509Cert>12e1b2d97ac40cd480e3456400aaa8174e</X509Cert>

<FIO>Соловьёв Анатолий Сергеевич</FIO>

</Messages> <Messages>

<MessageType>CMN.11002</MessageName>

<MessageName>Начато оформление</MessageName>

<MessageTimestamp>2018-10-10 12:30:00</MessageTimestamp>

<Incoming>1</Incoming>

<X509Cert>02a1c2d37a4405d060e711e4a8cedf66ff</X509Cert>

<FIO>Сидоров Андрей Андреевич</FIO>

</Messages> <Messages>

<MessageType>CMN.11009</MessageName>

<MessageName>Оформление ДТ закончено</MessageName>

<MessageTimestamp>2018-10-10 18:30:00</MessageTimestamp>

<Incoming>1</Incoming>

<X509Cert>02a1c2d37a4405d060e711e4a8cedf66ff</X509Cert>

<FIO>Сидоров Андрей Андреевич</FIO>

</Messages> <Messages>

<MessageType>CMN.11010</MessageName>

<MessageName>Решение по ДТ</MessageName>

<MessageTimestamp>2018-10-10 18:31:20</MessageTimestamp>

<Incoming>1</Incoming>

<X509Cert>02a1c2d37a4405d060e711e4a8cedf66ff</X509Cert>

<FIO>Сидоров Андрей Андреевич</FIO>

</Messages> <DetailedStatus>

<StatusName>Открытие процедуры</StatusName>

<StatusTimestamp>2018-10-10 10:32:40</StatusTimestamp>

</DetailedStatus> <DetailedStatus>

<StatusName>Начато оформление</StatusName>

<StatusTimestamp>2018-10-10 12:20:40</StatusTimestamp>

</DetailedStatus> <DetailedStatus>

<StatusName>Присвоен номер</StatusName>

<StatusTimestamp>2018-10-10 12:25:00</StatusTimestamp>

</DetailedStatus> <DetailedStatus>

<StatusName>Открыт досмотр</StatusName>

<StatusTimestamp>2018-10-20 09:10:00</StatusTimestamp>

</DetailedStatus> <DetailedStatus>

<StatusName>Закрыт досмотр</StatusName>

<StatusTimestamp>2018-10-22 10:00:00</StatusTimestamp>

</DetailedStatus> <DetailedStatus>

<StatusName>Дополнительная проверка</StatusName>

<StatusTimestamp>2018-11-02 08:40:40</StatusTimestamp>

</DetailedStatus> <DetailedStatus>

<StatusName>ДТ выпущена</StatusName>

<StatusTimestamp>2018-11-27 11:20:10</StatusTimestamp>

</DetailedStatus>

</SvdData>


3. Текущий остаток на счету (Account)

Список дополнительных входных параметров по запросу:

package boolean 1 - таблица действующих пакетов деклараций с текущими остатками и датами окончания

0 - только текущий остаток ДТ (денежных средств) и дату окончания последнего пакета (по-умолчанию)

expired boolean 1 - показывать действующие и закончившиеся пакеты

0 - показывать только действующие пакеты (по-умолчанию)

Пример запроса: https://svd.alta.ru/api/account/?timestamp=20190115124015&login=testlogin&secret=1798e479bf2170b4b42bda12c709f6f1&package=1&expired=1


Структура xml-ответа:

SvdData Корневой элемент
Текущий остаток Данные по текущему остатку средств на счёте
DTBalance Общее количество оставшихся отправок
MoneyBalance Общее количество оставшихся денежных средств, руб.
ExpirationDate Дата окончания действия самого свежего пакета в формате Timestamp(8)
Список пакетов (блок Package) Данные по всем зачисленным пакетам
Package->Name Наименование пакета отправок
Package->Price Цена пакета, руб.
Package->DTBalance Оставшееся количество отправок по пакету
Package->MoneyBalance Количество оставшихся денежных средств по пакету
Package->ExpirationDate Дата окончания действия пакета в формате Timestamp(8)
Package->Expired 1 - не действующий пакет, 0 - действующий


Пример ответа:

<SvdData>

<DTBalance>10 ДТ или 20 ПИ РФ</DTBalance>

<MoneyBalance>1500</MoneyBalance>

<ExpirationDate>2019-05-20</ExpirationDate>

<Package>

<Name>10 ДТ или 20 ПИ, срок 6 месяцев</Name>

<Price>1500</Price>

<DTBalance>10 ДТ или 20 ПИ</DTBalance>

<MoneyBalance>1500</MoneyBalance>

<ExpirationDate>2019-05-20</ExpirationDate>

<Expired>0</Expired>

</Package> <Package>

<Name>200 ДТ или 400 ПИ, срок 6 месяцев</Name>

<Price>10000</Price>

<DTBalance>200 ДТ или 400 ПИ</DTBalance>

<MoneyBalance>10000</MoneyBalance>

<ExpirationDate>2018-08-22</ExpirationDate>

<Expired>1</Expired>

</Package>

</SvdData>


4. Список электронных подписей по фирме (Signatures)

Список дополнительных входных параметров по запросу:

expired boolean 1 - показывать действующие и закончившиеся ЭП

0 - показывать только действующие ЭП (по-умолчанию)

Пример запроса: https://svd.alta.ru/api/signatures/?timestamp=20191125191020&login=testlogin&secret=75c15f0f7f054b80dcc61028b87f3ddb&expired=1


Структура xml-ответа:

SvdData Корневой элемент
CertAmmount Количество передаваемых данных подписей
Список подписей (блок CertData) Данные по каждой отдельной подписи
CertData->CommonName Наименование фирмы, получившей ЭП
CertData->Surname ФИО владельца ЭП
CertData->GivenName Имя и отчество владельца ЭП
CertData->INN ИНН фирмы, 12 цифр, ведущие - нули
CertData->SerialNumber 16-ричный серийный номер сертификата ЭП
CertData->Validity Дата и время окончания действия ЭП в формате Timestamp(14)
CertData->LastUsage Дата и время последнего использования ЭП в формате Timestamp(14)
CertData->Revoked 1 - отозванная ЭП, 0 - действующая


Пример ответа:

<SvdData>

<CertAmmount>2</CertAmmount>

<CertData>

<CommonName>ООО “Ромашка”</CommonName>

<Surname>Петров</Surname>

<GivenName>Александр Сергеевич</GivenName>

<INN>007728231211</INN>

<SerialNumber>0110ab1b01b95aaf12e8115ae231b4e40c</SerialNumber>

<Validity>2019-02-08 19:00:23</Validity>

<LastUsage>2018-03-12 11:21:11</LastUsage>

<Revoked>0</Revoked>

</CertData> <CertData>

<CommonName>ООО “Ромашка”</CommonName>

<Surname>Петров</Surname>

<GivenName>Александр Сергеевич</GivenName>

<INN>007728231211</INN>

<SerialNumber>0123abcd01b95bbc12e4321ae231a2b3c4</SerialNumber>

<Validity>2018-06-01 10:21:32</Validity>

<LastUsage>2018-05-12 09:01:22</LastUsage>

<Revoked>0</Revoked>

</CertData>

</SvdData>


Статусы

Название Описание Сообщения
ДТ (Type=19200) DT
Статусы ДТ до начала проверки ДТ BeforeCheck
DTBeforeCheckProcOpenReq Запрос на открытие процедуры ED.11001
DTBeforeCheckProcOpen Процедура открыта ED.11002
DTBeforeCheckProcClose Процедура закрыта ED.10004
DTBeforeCheckDTSend Декларация подана в ТО CMN.11023,CMN.11008,CMN.11044,CMN.11057,CMN.11028,CMN.11053,CMN.11024
DTBeforeCheckPayAgree Согласование платежа TP.00010
DTBeforeCheckRegDeny Отказ в регистрации ДТ CMN.11062
DTBeforeCheckErrProtocol Протокол ошибок проверки ДТ ED.11005
DTBeforeCheckDuplDT Уведомление о дублировании ДТ CMN.11073
DTBeforeCheckAssignNum Присвоен номер ДТ CMN.11001
Статусы проверки ДТ Check
DTCheckDocsReq Запрошены документы ED.11003
DTCheckBegin Начата проверка ДТ CMN.11002
DTCheckNotifInspect Уведомление о досмотре CMN.11005
DTCheckInspectActReceive Получен акт досмотра CMN.11007
DTCheckGoodsCostCheck Доп. проверка по стоимости CMN.11065
DTCheckGoodsClassCheck Доп. проверка по классификации CMN.11066
DTCheckOriginCountryCheck Доп. проверка по стране происхождения CMN.11067
DTCheckCustCostChange Получено решение о КТС CMN.11064
DTCheckDTChangeReq Запрос на изменение ДТ CMN.11031,CMN.11269,CMN.11115,CMN.11116
DTCheckNotifGoodsArrive Уведомление о прибытии на СВХ CMN.11015
Статусы решения по ДТ, отзыва ДТ Decision
DTDecisionGoodsDecMake Решение по товарам принято CMN.11010,CMN.11061,CMN.11059,CMN.11051,CMN.11055,CMN.11033
DTDecisionPartRelease Частичный выпуск CMN.11117,CMN.11118
DTDecisionSuspRelease Выпуск приостановлен CMN.11020
DTDecisionPayEnsureRelease Выпуск под обеспечение CMN.11101,CMN.11042
DTDecisionCondRelease Условный выпуск CMN.11043,CMN.11124
DTDecisionPaperDecl Перевод на бумагу CMN.11029
DTDecisionDTRecall ДТ отозвана CMN.11012,CMN.11063,CMN.11060,CMN.11052,CMN.11056,CMN.11034
DTDecisionCheckFinish Проверка закончена CMN.11009
ПИ (Type=92410) PI
Передача и регистрация ПИ (РФ) RF
PIRFSend Подача ПИ CMN.12001,CMN.12038,CMN.12015,CMN.12066,CMN.12068,CMN.12013,CMN.12079
PIRFReg Регистрация ПИ CMN.12002
PIRFChangeApprove Подтверждение изменений CMN.12005
PIRFNotifResult Уведомление об использовании ПИ CMN.12091
PIRFChange Запрос на изменение ПИ CMN.12004,CMN.12041,CMN.12016,CMN.12067,CMN.12069,CMN.12014
Ошибки и отказы при подача ПИ (РФ) RFErr
PIRFErrReg Ошибка регистрации ПИ CMN.12003
PIRFErrChange Ошибка при внесении изменений CMN.12006
Передача и регистрация ПИ (РБ) RB
PIRBSend Предоставление ПИ в ТО (РБ) BY.000.001,BY.200.000
PIRBReg Подтверждение регистрации ПИ (РБ) BY.101.000,BY.200.006
PIRBTransitPermit Выдано св-во на там. транзит (РБ) BY.999.003,BY.200.007
Ошибки и отказы при подача ПИ (РБ) RBErr
PIRBErrorList Список ошибок ФЛК (РБ) BY.101.010,BY.200.001
PIRBRegDeny Отказано в регистрации ПИ (РБ) BY.200.011
PIRBBorderPassDeny Отказано в пропуске т/с через границу (РБ) BY.999.004,BY.200.008
СВХ (Type=19210) SVH
ДО-1 DO1
SVHDO1ProcOpenReq Запрос на открытие процедуры ED.11001
SVHDO1ProcOpen Процедура открыта ED.11002
SVHDO1ProcClose Процедура закрыта ED.10004
SVHDO1Send Отчетность по форме ДО-1 CMN.13009
SVHDO1Reg Регистрация отчетности ДО CMN.13010
SVHDO1RegDeny Отказ в регистрации отчетности CMN.13019
SVHDO1CommActSend Предоставление коммерческого акта CMN.13020
SVHDO1CommActAccept Принятие акта/письма владельца СВХ CMN.13021
SVHDO1CommActDeny Отказ в принятии акта/письма владельца СВХ CMN.13022
ДО-2 DO2
SVHDO2Send Отчетность по форме ДО-2 CMN.13011
SVHDO2Reg Регистрация отчетности ДО CMN.13010
SVHDO2RegDeny Отказ в регистрации отчетности CMN.13019
SVHDO2DocsReceiptApprove Подтверждение о получении документов CMN.13006
ДО-3 DO3
SVHDO3Request Требование о предоставлении ДО-3 CMN.13013
SVHDO3Send Отчетность по форме ДО-3 CMN.13012
SVHDO3Reg Регистрация отчетности ДО CMN.13010
SVHDO3RegDeny Отказ в регистрации отчетности CMN.13019
Реестр ЭГ (Type=19260) EG
До начала проверки Реестра BeforeCheck
EGBeforeCheckProcOpenReq Запрос на открытие процедуры ED.11001
EGBeforeCheckProcOpen Процедура открыта ED.11002
EGBeforeCheckProcClose Процедура закрыта ED.10004
EGBeforeCheckEGSend Передача реестра ЭГ в ТО CMN.11096,CMN.11149,CMN.11151
EGReg Регистрация реестра ЭГ CMN.11097
EGReleaseRegDeny Отказ в регистрации CMN.11145
Проверка Check
EGCheckChangeReq Запрос на изменение Реестра ЭГ CMN.11146
EGCheckChangeAccept Разрешение изменений CMN.11147
EGCheckChangeDeny Запрет на внесение изменений CMN.11148
EGCheckDocsReq Запрошены документы ED.11003
EGCheckPayReceipt Чек об оплате CMN.11139
Окончание проверки - выпуск Release
EGReleaseDecMake Решение по товарам Реестра ЭГ CMN.11098,CMN.11150,CMN.11152
ТД (Type=524000) TD
Статусы ТД до начала проверки ТД BeforeCheck
TDBeforeCheckProcOpenReq Запрос на открытие процедуры ED.11001
TDBeforeCheckProcOpen Процедура открыта ED.11002
TDBeforeCheckProcClose Процедура закрыта ED.10004
TDBeforeCheckTDSend Транзитная декларация и опись CMN.15027,CMN.15035
TDBeforeCheckTDReceive Уведомление о получении ТД ТО CMN.15023
TDBeforeCheckErrProt Перечень ошибок полученных в ходе таможенного контроля ED.11005
TDBeforeCheckReceiveReg Уведомление о регистрации документа CMN.15025
TDBeforeCheckRegDeny Отказ в регистрации ТД CMN.15004
TDBeforeCheckReg Регистрация ТД CMN.15005
Статусы проверки ТД Check
TDCheckDocsReq Запрос дополнительных документов по ТД CMN.15019
TDCheckDocsSend Представление запрашиваемых документов CMN.15022
TDCheckTransitProlong Продление срока таможенного транзита CMN.15008
TDCheckTransitProlongDecision Решение о продлении срока ТТ CMN.15009
TDCheckArrivalConfirm Подтверждение о прибытии CMN.15015
TDCheckUndeliverReq Запрос о розыске недоставленных товаров CMN.15017
TDCheckOperationsWOBreakSeals Уведомление о проведении грузовых операции без снятия пломб CMN.15010
Статусы решения по ТД, отзыва ТД Decision
TDDecisionTDRecallReq Обращение об отзыве от декларанта CMN.15021
TDDecisionTDRecallAccept Разрешение на отзыв CMN.15020
TDDecisionReleaseForbid Выпуск товара запрещен CMN.15006
TDDecisionRelease Выпуск товаров по ТД CMN.15007
TDDecisionTransitEnd Транзит завершен CMN.15016
ПДТ (Type=19230) PassDT
PassDTProcOpenReq Запрос на открытие процедуры ED.11001
PassDTProcOpen Процедура открыта ED.11002
PassDTProcClose Процедура закрыта ED.10004
PassDTSend Пассажирская декларация CMN.11195
PassDTUIN УИН пассажирской декларации CMN.11197
PassDTReg Регистрация пассажирской декларации CMN.11199
PassDTRegDeny Отказ в регистрации пассажирской декларации CMN.11202
PassDTNotifExcept Уведомление об исключении сведений CMN.11198
PassDTDecMake Решение по пассажирской декларации CMN.11201


Ошибки

При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.

При работе с сервисом возможны следующие ошибки:

Код Описание
1000 пользователь не авторизован
1100 несуществующий логин SVD
1200 несуществующий код таможни
1300 некорректное время
1400 некорректная дата
1500 несуществующий ID процедуры
1600 несуществующий регистрационный номер документа
1700 несуществующий статус процедуры
1800 несуществующий тип запрашиваемых процедур
1900 некорректный параметр запроса
2000 некорректное число