API для сервера статистики: различия между версиями
Gorkin (обсуждение | вклад) (мелкая правка) |
Gorkin (обсуждение | вклад) (Сделал все параметры строчными) |
||
| (не показано 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-запрос добавить текущее время-дату | + | Для авторизации с помощью пары логин/пароль необходимо в GET-запрос добавить текущее время-дату timestamp формата Timestamp(14) без разделителей, логин (список логинов), первым всегда указывается основной логин (если он есть в запросе), если нет основного логина, то запрос делается только на один (дополнительный) логин в открытом виде и MD5-хеш от сгенерированной строки текущее время-дата формата Timestamp(14) без разделителей + логин (первый логин списка) + md5-хэш от пароля, разделенных знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword: |
| − | для запроса процедур: | + | для запроса процедур: timestamp=20190210124018&login=testlogin,testlogin-03 вычисляем секрет: secret = md5(20190210124018:testlogin:md5(testpassword)) |
| − | итоговый URL: <nowiki>https://svd.alta.ru/api/procedures/? | + | итоговый URL: <nowiki>https://svd.alta.ru/api/procedures/?timestamp=20190210124018&login=testlogin,testlogin-03&secret=39176d2debbc878d599c07ec8c9b1174</nowiki> |
Ниже приводится список общих входных параметров: | Ниже приводится список общих входных параметров: | ||
| Строка 30: | Строка 30: | ||
| colspan="4" |'''Обязательные''' | | colspan="4" |'''Обязательные''' | ||
|- | |- | ||
| − | |'' | + | |''login'' |
|'''string [6,9-11]''' | |'''string [6,9-11]''' | ||
|Логин или список из основного и/или дополнительных логинов через запятую (см. общее описание о порядке указания логинов) | |Логин или список из основного и/или дополнительных логинов через запятую (см. общее описание о порядке указания логинов) | ||
|101121,101121-05, web.0123456 | |101121,101121-05, web.0123456 | ||
|- | |- | ||
| − | |'' | + | |''secret'' |
|'''string''' | |'''string''' | ||
|Секрет для доступа к сервису (контрольная сумма md5) | |Секрет для доступа к сервису (контрольная сумма md5) | ||
| Строка 46: | Строка 46: | ||
Список дополнительных входных параметров данного вида запроса | Список дополнительных входных параметров данного вида запроса | ||
{| class="wikitable" | {| class="wikitable" | ||
| − | |'' | + | |''customs'' |
|'''string''' | |'''string''' | ||
| Строка 59: | Строка 59: | ||
107 | 107 | ||
|- | |- | ||
| − | |'' | + | |''customswh'' |
|'''string''' | |'''string''' | ||
| Строка 72: | Строка 72: | ||
107 | 107 | ||
|- | |- | ||
| − | |'' | + | |''approved'' |
|'''boolean''' | |'''boolean''' | ||
|1- только с решением о выпуске | |1- только с решением о выпуске | ||
| Строка 79: | Строка 79: | ||
| | | | ||
|- | |- | ||
| − | |'' | + | |''endbefore'' |
|'''Timestamp(8)''' | |'''Timestamp(8)''' | ||
|Дата закрытия процедур не позднее указанной в формате ГГГГММДД | |Дата закрытия процедур не позднее указанной в формате ГГГГММДД | ||
|20181211 | |20181211 | ||
|- | |- | ||
| − | |'' | + | |''endafter'' |
|'''Timestamp(8)''' | |'''Timestamp(8)''' | ||
|Дата закрытия процедур не ранее указанной в формате ГГГГММДД | |Дата закрытия процедур не ранее указанной в формате ГГГГММДД | ||
|20181211 | |20181211 | ||
|- | |- | ||
| − | |'' | + | |''beginbefore'' |
|'''Timestamp(8)''' | |'''Timestamp(8)''' | ||
|Дата открытия процедур не позднее указанной в формате ГГГГММДД | |Дата открытия процедур не позднее указанной в формате ГГГГММДД | ||
|20181211 | |20181211 | ||
|- | |- | ||
| − | |'' | + | |''beginafter'' |
|'''Timestamp(8)''' | |'''Timestamp(8)''' | ||
|Дата открытия процедур не ранее указанной в формате ГГГГММДД | |Дата открытия процедур не ранее указанной в формате ГГГГММДД | ||
|20181211 | |20181211 | ||
|- | |- | ||
| − | |'' | + | |''includemsg'' |
|'''string''' | |'''string''' | ||
|Передавать только процедуры, содержащие указанный Тип/Типы сообщений. При перечислении через запятую работает логическое ИЛИ, при перечислении через + логическое И | |Передавать только процедуры, содержащие указанный Тип/Типы сообщений. При перечислении через запятую работает логическое ИЛИ, при перечислении через + логическое И | ||
|CMN.11010+CMN.11140 | |CMN.11010+CMN.11140 | ||
|- | |- | ||
| − | |'' | + | |''status'' |
|'''string''' | |'''string''' | ||
|Вывод только процедур, находящихся в одном из указанных статусов. Номера статусов перечисляются через запятую. | |Вывод только процедур, находящихся в одном из указанных статусов. Номера статусов перечисляются через запятую. | ||
|18,22 | |18,22 | ||
|- | |- | ||
| − | |'' | + | |''fields'' |
|'''boolean''' | |'''boolean''' | ||
|1- передавать данные полей отправленного документа | |1- передавать данные полей отправленного документа | ||
| Строка 115: | Строка 115: | ||
0 - не передавать (по-умолчанию) | 0 - не передавать (по-умолчанию) | ||
| | | | ||
| + | |- | ||
| + | |inn | ||
| + | |'''string[10]''' | ||
| + | |Вывод только процедур по ДТ с указанным ИНН отправителя/получателя | ||
| + | |7151023841 | ||
|} | |} | ||
| − | Пример запроса: <nowiki>https://svd.alta.ru/api/procedures/? | + | Пример запроса: <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>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'' |
|'''string''' | |'''string''' | ||
| − | |ID процедуры (указывается, если не указан рег. номер) | + | |ID процедуры ('''обязательно''' указывается, если не указан рег. номер) |
|- | |- | ||
| − | |'' | + | |''regnum'' |
|'''string''' | |'''string''' | ||
| − | |Регистрационный номер документа (указывается, если не указан ID процедуры) | + | |Регистрационный номер документа ('''обязательно''' указывается, если не указан ID процедуры) |
|- | |- | ||
| − | |'' | + | |''detailedstatus'' |
|'''boolean''' | |'''boolean''' | ||
|1 - передавать список всех статусов процедуры со временем их наступления | |1 - передавать список всех статусов процедуры со временем их наступления | ||
| Строка 269: | Строка 234: | ||
0 - передавать только текущий статус процедуры (по-умолчанию) | 0 - передавать только текущий статус процедуры (по-умолчанию) | ||
|- | |- | ||
| − | |'' | + | |''fields'' |
|'''boolean''' | |'''boolean''' | ||
|1 - передавать данные полей отправленного документа | |1 - передавать данные полей отправленного документа | ||
| Строка 275: | Строка 240: | ||
0 - не передавать (по-умолчанию) | 0 - не передавать (по-умолчанию) | ||
|- | |- | ||
| − | |'' | + | |''messages'' |
|'''boolean''' | |'''boolean''' | ||
|1 - передавать список сообщений по указанной процедуре (по-умолчанию) | |1 - передавать список сообщений по указанной процедуре (по-умолчанию) | ||
| Строка 281: | Строка 246: | ||
0 - не передавать | 0 - не передавать | ||
|} | |} | ||
| − | Пример запроса: <nowiki>https://svd.alta.ru/api/messages/? | + | Пример запроса: <nowiki>https://svd.alta.ru/api/messages/?timestamp=20190811080001&login=testlogin&secret=f4db42316ed5322cade898daf56494d6®num=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> | ||
| − | |||
| − | < | ||
| − | |||
| − | < | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | < | ||
| − | |||
| − | </ | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | < | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | < | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | < | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | </ | + | <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> |
| − | < | + | <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> |
| − | < | + | <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> |
| − | < | + | <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> |
| − | </ | + | <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> |
| − | < | + | <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> |
| − | < | + | <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> |
| − | < | + | <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> |
| − | </ | + | <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> |
| − | < | + | <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> |
| − | < | + | <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- | + | <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> | + | <DetailedStatus><blockquote><StatusName>Открыт досмотр</StatusName></blockquote><blockquote><StatusTimestamp>2018-10-20 09:10:00</StatusTimestamp></blockquote></DetailedStatus> |
| − | <StatusTimestamp>2018- | + | <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'' |
|'''boolean''' | |'''boolean''' | ||
|1 - таблица действующих пакетов деклараций с текущими остатками и датами окончания | |1 - таблица действующих пакетов деклараций с текущими остатками и датами окончания | ||
| Строка 673: | Строка 428: | ||
0 - только текущий остаток ДТ (денежных средств) и дату окончания последнего пакета (по-умолчанию) | 0 - только текущий остаток ДТ (денежных средств) и дату окончания последнего пакета (по-умолчанию) | ||
|- | |- | ||
| − | |'' | + | |''expired'' |
|'''boolean''' | |'''boolean''' | ||
|1 - показывать действующие и закончившиеся пакеты | |1 - показывать действующие и закончившиеся пакеты | ||
| Строка 679: | Строка 434: | ||
0 - показывать только действующие пакеты (по-умолчанию) | 0 - показывать только действующие пакеты (по-умолчанию) | ||
|} | |} | ||
| − | Пример запроса: <nowiki>https://svd.alta.ru/api/account/? | + | Пример запроса: <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>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'' |
|'''boolean''' | |'''boolean''' | ||
|1 - показывать действующие и закончившиеся ЭП | |1 - показывать действующие и закончившиеся ЭП | ||
| Строка 777: | Строка 504: | ||
0 - показывать только действующие ЭП (по-умолчанию) | 0 - показывать только действующие ЭП (по-умолчанию) | ||
|} | |} | ||
| − | Пример запроса: <nowiki>https://svd.alta.ru/api/signatures/? | + | Пример запроса: <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> | ||
| − | < | + | <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> |
| − | |||
| − | < | ||
| − | |||
| − | < | ||
| − | |||
| − | < | ||
| − | |||
| − | < | ||
| − | |||
| − | < | ||
| − | |||
| − | </ | ||
| − | |||
| − | < | ||
| − | |||
| − | < | ||
| − | |||
| − | < | ||
| − | |||
| − | < | ||
| − | |||
| − | |||
| − | |||
| − | < | ||
| − | |||
| − | <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®num=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 | некорректное число |
