https://wiki.alta.ru/api.php?action=feedcontributions&feedformat=atom&user=Vetoshkin
Alta-Soft Wikipedia - Вклад участника [ru]
2026-10-01T01:52:50Z
Вклад участника
MediaWiki 1.32.0
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1401
API для сервиса report.alta.ru
2026-07-15T09:55:30Z
<p>Vetoshkin: /* Получение документов */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ, ТД, Пассажирских ТД, Заявлений о выпуске до подачи<br />
# Получение привязанных документов (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, messages, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение списка поддерживаемых видов документов ===<br />
<br />
<code>/docs/types/</code> <br />
<br />
{| class="wikitable"<br />
!Параметр || Описание || Пример<br />
|-<br />
|title || Краткое наименование документа || ДТ<br />
|-<br />
|toolTip || Полное наименование документа || Декларация на товары<br />
|-<br />
|maxDatePeriod || Максимальное кол-во месяцев в периоде, за который можно запрашивать документы || 3<br />
|-<br />
|filters || Список возможных фильтров для запроса списка документов || <br />
|}<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''doctype=gtd&regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|'''doctype''' || '''string''' || Вид документа (gtd, td1, arg, passd) || doctype=gtd (по умолчанию, можно не указывать)<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10T10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10T10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|-<br />
|cmn || '''array''' || Тип ЭД сообщения, можно несколько || cmn[]=CMN.11005<br/>cmn[]=CMN.11252<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
Список столбцов с их описанием и примерами можно получить отдельным запросом апи <code>/docs/fields/</code><br />
<br />
==== Получение, Печать документа, Просмотр документа ====<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
==== Получение полей (заголовки столбцов) ====<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов с их описанием и примерами<br />
<br />
==== Получение списка привязанных ЭД документов ====<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
==== Получение привязанного ЭД документа ====<br />
<br />
Запрос похож на предыдущий, добавляем только ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Массив messages ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|messagetype|| '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|messagename || '''string''' || Наименование сообщения || Регистрационный номер ДТ<br />
|-<br />
|priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин, с которого пришло сообщение || 123456-01<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|softversion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|participantid || '''string''' || ID декларанта <br />
|-<br />
|customscode || '''string''' || Код таможни сообщения || <br />
|-<br />
|initialenvelopeid || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|preparationdatetime || '''string''' || Дата и время сообщения || <br />
|-<br />
|exchtype || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|proccessid || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|mainproccessid || '''string''' || ID основной процедуры (если есть) || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|senderinformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|receiverinformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|archid || '''string''' || ID архива таможни || <br />
|-<br />
|archdocid || '''string''' || ID документа в архиве таможни || <br />
|-<br />
|objects|| '''array''' || массив xml-объектов, содержащихся в данном сообщении (в т.ч. дата из поля DateLimit, если есть указан срок ответа) || <br />
|}<br />
<br />
==== Получение сообщения ====<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен <br />
|-<br />
|'''210''' || Необходимо принять оферту на сайте<br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1383
API для сервиса report.alta.ru
2025-05-30T11:23:42Z
<p>Vetoshkin: /* Массив messages */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ, ТД, Пассажирских ТД, Заявлений о выпуске до подачи<br />
# Получение привязанных документов (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, messages, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение списка поддерживаемых видов документов ===<br />
<br />
<code>/docs/types/</code> <br />
<br />
{| class="wikitable"<br />
!Параметр || Описание || Пример<br />
|-<br />
|title || Краткое наименование документа || ДТ<br />
|-<br />
|toolTip || Полное наименование документа || Декларация на товары<br />
|-<br />
|maxDatePeriod || Максимальное кол-во месяцев в периоде, за который можно запрашивать документы || 3<br />
|-<br />
|filters || Список возможных фильтров для запроса списка документов || <br />
|}<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''doctype=gtd&regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|'''doctype''' || '''string''' || Вид документа (gtd, td1, arg, passd) || doctype=gtd (по умолчанию, можно не указывать)<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10T10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10T10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|-<br />
|cmn || '''array''' || Тип ЭД сообщения, можно несколько || cmn[]=CMN.11005<br/>decl[]=CMN.11252<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
Список столбцов с их описанием и примерами можно получить отдельным запросом апи <code>/docs/fields/</code><br />
<br />
==== Получение, Печать документа, Просмотр документа ====<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
==== Получение полей (заголовки столбцов) ====<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов с их описанием и примерами<br />
<br />
==== Получение списка привязанных ЭД документов ====<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
==== Получение привязанного ЭД документа ====<br />
<br />
Запрос похож на предыдущий, добавляем только ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Массив messages ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|messagetype|| '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|messagename || '''string''' || Наименование сообщения || Регистрационный номер ДТ<br />
|-<br />
|priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин, с которого пришло сообщение || 123456-01<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|softversion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|participantid || '''string''' || ID декларанта <br />
|-<br />
|customscode || '''string''' || Код таможни сообщения || <br />
|-<br />
|initialenvelopeid || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|preparationdatetime || '''string''' || Дата и время сообщения || <br />
|-<br />
|exchtype || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|proccessid || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|mainproccessid || '''string''' || ID основной процедуры (если есть) || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|senderinformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|receiverinformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|archid || '''string''' || ID архива таможни || <br />
|-<br />
|archdocid || '''string''' || ID документа в архиве таможни || <br />
|-<br />
|objects|| '''array''' || массив xml-объектов, содержащихся в данном сообщении (в т.ч. дата из поля DateLimit, если есть указан срок ответа) || <br />
|}<br />
<br />
==== Получение сообщения ====<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен <br />
|-<br />
|'''210''' || Необходимо принять оферту на сайте<br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1382
API для сервиса report.alta.ru
2025-05-23T11:19:42Z
<p>Vetoshkin: /* Описание параметров */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ, ТД, Пассажирских ТД, Заявлений о выпуске до подачи<br />
# Получение привязанных документов (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, messages, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение списка поддерживаемых видов документов ===<br />
<br />
<code>/docs/types/</code> <br />
<br />
{| class="wikitable"<br />
!Параметр || Описание || Пример<br />
|-<br />
|title || Краткое наименование документа || ДТ<br />
|-<br />
|toolTip || Полное наименование документа || Декларация на товары<br />
|-<br />
|maxDatePeriod || Максимальное кол-во месяцев в периоде, за который можно запрашивать документы || 3<br />
|-<br />
|filters || Список возможных фильтров для запроса списка документов || <br />
|}<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''doctype=gtd&regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|'''doctype''' || '''string''' || Вид документа (gtd, td1, arg, passd) || doctype=gtd (по умолчанию, можно не указывать)<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10T10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10T10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|-<br />
|cmn || '''array''' || Тип ЭД сообщения, можно несколько || cmn[]=CMN.11005<br/>decl[]=CMN.11252<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
Список столбцов с их описанием и примерами можно получить отдельным запросом апи <code>/docs/fields/</code><br />
<br />
==== Получение, Печать документа, Просмотр документа ====<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
==== Получение полей (заголовки столбцов) ====<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов с их описанием и примерами<br />
<br />
==== Получение списка привязанных ЭД документов ====<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
==== Получение привязанного ЭД документа ====<br />
<br />
Запрос похож на предыдущий, добавляем только ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Массив messages ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|messagetype|| '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|messagename || '''string''' || Наименование сообщения || Регистрационный номер ДТ<br />
|-<br />
|priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин, с которого пришло сообщение || 123456-01<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|softversion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|participantid || '''string''' || ID декларанта <br />
|-<br />
|customscode || '''string''' || Код таможни сообщения || <br />
|-<br />
|initialenvelopeid || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|preparationdatetime || '''string''' || Дата и время сообщения || <br />
|-<br />
|exchtype || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|proccessid || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|mainproccessid || '''string''' || ID основной процедуры (если есть) || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|senderinformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|receiverinformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|archid || '''string''' || ID архива таможни || <br />
|-<br />
|archdocid || '''string''' || ID документа в архиве таможни || <br />
|-<br />
|objects|| '''array''' || массив xml-объектов, содержащихся в данном сообщении || <br />
|}<br />
<br />
==== Получение сообщения ====<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен <br />
|-<br />
|'''210''' || Необходимо принять оферту на сайте<br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1381
API для сервиса report.alta.ru
2025-05-22T10:35:19Z
<p>Vetoshkin: /* Список всех функций API */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ, ТД, Пассажирских ТД, Заявлений о выпуске до подачи<br />
# Получение привязанных документов (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение списка поддерживаемых видов документов ===<br />
<br />
<code>/docs/types/</code> <br />
<br />
{| class="wikitable"<br />
!Параметр || Описание || Пример<br />
|-<br />
|title || Краткое наименование документа || ДТ<br />
|-<br />
|toolTip || Полное наименование документа || Декларация на товары<br />
|-<br />
|maxDatePeriod || Максимальное кол-во месяцев в периоде, за который можно запрашивать документы || 3<br />
|-<br />
|filters || Список возможных фильтров для запроса списка документов || <br />
|}<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''doctype=gtd&regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|'''doctype''' || '''string''' || Вид документа (gtd, td1, arg, passd) || doctype=gtd (по умолчанию, можно не указывать)<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10T10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10T10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|-<br />
|cmn || '''array''' || Тип ЭД сообщения, можно несколько || cmn[]=CMN.11005<br/>decl[]=CMN.11252<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
Список столбцов с их описанием и примерами можно получить отдельным запросом апи <code>/docs/fields/</code><br />
<br />
==== Получение, Печать документа, Просмотр документа ====<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
==== Получение полей (заголовки столбцов) ====<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов с их описанием и примерами<br />
<br />
==== Получение списка привязанных ЭД документов ====<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
==== Получение привязанного ЭД документа ====<br />
<br />
Запрос похож на предыдущий, добавляем только ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Массив messages ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|messagetype|| '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|messagename || '''string''' || Наименование сообщения || Регистрационный номер ДТ<br />
|-<br />
|priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин, с которого пришло сообщение || 123456-01<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|softversion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|participantid || '''string''' || ID декларанта <br />
|-<br />
|customscode || '''string''' || Код таможни сообщения || <br />
|-<br />
|initialenvelopeid || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|preparationdatetime || '''string''' || Дата и время сообщения || <br />
|-<br />
|exchtype || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|proccessid || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|mainproccessid || '''string''' || ID основной процедуры (если есть) || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|senderinformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|receiverinformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|archid || '''string''' || ID архива таможни || <br />
|-<br />
|archdocid || '''string''' || ID документа в архиве таможни || <br />
|-<br />
|objects|| '''array''' || массив xml-объектов, содержащихся в данном сообщении || <br />
|}<br />
<br />
==== Получение сообщения ====<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен <br />
|-<br />
|'''210''' || Необходимо принять оферту на сайте<br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1380
API для сервиса report.alta.ru
2025-05-22T10:30:56Z
<p>Vetoshkin: /* Список всех функций API */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ, ТД, Пассажирских ТД, Заявлений о выпуске до подачи<br />
# Получение привязанных документов (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение списка поддерживаемых видов документов ===<br />
<br />
<code>/docs/types/</code> <br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''doctype=gtd&regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|'''doctype''' || '''string''' || Вид документа (gtd, td1, arg, passd) || doctype=gtd (по умолчанию, можно не указывать)<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10T10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10T10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|-<br />
|cmn || '''array''' || Тип ЭД сообщения, можно несколько || cmn[]=CMN.11005<br/>decl[]=CMN.11252<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
Список столбцов с их описанием и примерами можно получить отдельным запросом апи <code>/docs/fields/</code><br />
<br />
==== Получение, Печать документа, Просмотр документа ====<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
==== Получение полей (заголовки столбцов) ====<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов с их описанием и примерами<br />
<br />
==== Получение списка привязанных ЭД документов ====<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
==== Получение привязанного ЭД документа ====<br />
<br />
Запрос похож на предыдущий, добавляем только ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Массив messages ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|messagetype|| '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|messagename || '''string''' || Наименование сообщения || Регистрационный номер ДТ<br />
|-<br />
|priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин, с которого пришло сообщение || 123456-01<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|softversion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|participantid || '''string''' || ID декларанта <br />
|-<br />
|customscode || '''string''' || Код таможни сообщения || <br />
|-<br />
|initialenvelopeid || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|preparationdatetime || '''string''' || Дата и время сообщения || <br />
|-<br />
|exchtype || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|proccessid || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|mainproccessid || '''string''' || ID основной процедуры (если есть) || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|senderinformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|receiverinformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|archid || '''string''' || ID архива таможни || <br />
|-<br />
|archdocid || '''string''' || ID документа в архиве таможни || <br />
|-<br />
|objects|| '''array''' || массив xml-объектов, содержащихся в данном сообщении || <br />
|}<br />
<br />
==== Получение сообщения ====<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен <br />
|-<br />
|'''210''' || Необходимо принять оферту на сайте<br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1379
API для сервиса report.alta.ru
2025-05-22T09:59:04Z
<p>Vetoshkin: </p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ, ТД, Пассажирских ТД, Заявлений о выпуске до подачи<br />
# Получение привязанных документов (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10T10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10T10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
из выдачи убрали заголовки столбцов, для их получения есть запрос апи <code>/docs/fields/</code><br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
<br />
==== Объект doc ====<br />
<br />
{| class="wikitable"<br />
|login || '''string''' || Catchall Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин СВД || 123456-01<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID текущего сообщения с ДТ || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|messagetype || '''string''' || Тип текущего ЭД сообщения с ДТ || CMN.11010<br />
|-<br />
|status || '''string''' || Статус процедуры в числовом виде || 3<br />
|-<br />
|softver || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ver || '''string''' || Системная версия списка колонок || 1.06<br />
|-<br />
|ProccessID || '''string''' || ID процедуры || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|ExProccessID || '''string''' || Список дополнительных ID процедур по основной || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|LastMessageDate || '''string''' || Дата последнего сообщения по процедуре || <br />
|-<br />
|DeclarantOrganizationName || '''string''' || Наименование организациии || ООО \"Альта-Софт\"<br />
|-<br />
|DeclarantINN || '''string''' || ИНН декларанта || 1234567890<br />
|-<br />
|DeclarantOGRN || '''string''' || ОГРН декларанта || <br />
|-<br />
|DeclarantFIO || '''string''' || ФИО декларанта из гр.54 || <br />
|-<br />
|consignorName || '''string''' || Отправитель || <br />
|-<br />
|consignorAddres || '''string''' || Адрес отправителя || <br />
|-<br />
|consigneeName || '''string''' || Получатель || <br />
|-<br />
|consigneeAddres || '''string''' || Адрес получателя || <br />
|-<br />
|sellerName || '''string''' || Продавец (ДТС) || <br />
|-<br />
|Transp || '''string''' || Номера транспортных средств || <br />
|-<br />
|TrCount || '''string''' || Количество транспортных средств || <br />
|-<br />
|Contract || '''string''' || Номер контракта || <br />
|-<br />
|TrDoc || '''string''' || Номер транспортных документов || <br />
|-<br />
|Cont || '''string''' || Номера контейнеров <br />
|-<br />
|NetWeightQuantity || '''string''' || Нетто || 20160.00<br />
|-<br />
|GrossWeightQuantity || '''string''' || Брутто || 20640.00<br />
|-<br />
|CustomsCost || '''string''' || Таможенная стоимость || 1989792.00<br />
|-<br />
|InvoicedCost || '''string''' || Фактурная стоимость || 1989792.00<br />
|-<br />
|ContractCurrencyCode || '''string''' || Валюта контракта || RUB<br />
|-<br />
|sborSum || '''string''' || Сумма таможенных сборов || 30000.00<br />
|-<br />
|poshSum || '''string''' || Сумма таможенных пошлин || 1989792.00<br />
|-<br />
|ndsSum || '''string''' || Сумма НДС || 1989792.00<br />
|-<br />
|akcizSum || '''string''' || Сумма акциза || 1989792.00<br />
|-<br />
|platSum || '''string''' || Сумма платежей || 1989792.00<br />
|-<br />
|REGNUM || '''string''' || Номер ДТ || 10000000/010121/0123456 <br />
|-<br />
|PackageNumber || '''string''' || Кол-во мест || <br />
|-<br />
|GoodsCount || '''string''' || Кол-во товаров || 1<br />
|-<br />
|BorderCustoms || '''string''' || Код поста гр.29 || 10000000<br />
|-<br />
|UD || '''string''' || Код поста гр.30 || 10000000<br />
|-<br />
|UDName || '''string''' || Наименование поста гр.30 || ФТС России<br />
|-<br />
|CustomsProcedure || '''string''' || Режим || ИМ<br />
|-<br />
|CustomsModeCode || '''string''' || Процедура || 40<br />
|-<br />
|DeclarationKind || '''string''' || Особенности процедуры || ПТД<br />
|-<br />
|DocUsageCode|| '''string''' || Признак использования товаросопроводительного документа в качестве ДТ || СД<br />
|}<br />
<br />
=== Наименования статусов ===<br />
{| class="wikitable"<br />
|1 || Открытие процедуры<br />
|-<br />
|2 || Присвоен номер<br />
|-<br />
|3 || Идет проверка<br />
|-<br />
|4 || Идет досмотр<br />
|-<br />
|5 || Проверка закончена<br />
|-<br />
|6 || Условно выпущена<br />
|-<br />
|7 || Выпуск разрешен<br />
|-<br />
|10 || Отказано в выпуске<br />
|-<br />
|11 || Товар прибыл (ПТД)<br />
|-<br />
|12 || Выпуск с обеспечением<br />
|-<br />
|13 || Отзыв<br />
|-<br />
|14 || Считается не поданной<br />
|-<br />
|15 || Выпуск приостановлен<br />
|-<br />
|17 || Частично выпущена<br />
|-<br />
|26 || Выпуск под обеспечение<br />
|-<br />
|27 || Идет осмотр<br />
|-<br />
|28 || Идет экспертиза<br />
|-<br />
|8192 || Отказано в приеме<br />
|-<br />
|16384 || Переход на "бумагу"<br />
|-<br />
|32768 || Запрошен отзыв<br />
|}<br />
<br />
=== Получение, Печать документа, Просмотр документа ===<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
=== Получение полей (заголовки столбцов) ===<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов вынесли в отдельный запрос<br />
<br />
=== Получение вложенных документов из графы 44 ===<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
=== Получение тела документа 44. Печать в html ===<br />
<br />
Запрос похож на предыдущий, добавляем только спереди ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Ответные параметры ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|MessageType || '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|Priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|Incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин, с которого пришло сообщение || 123456-01<br />
|-<br />
|EnvelopeID || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|SoftVersion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ParticipantID || '''string''' || ID декларанта <br />
|-<br />
|CustomsCode || '''string''' || Код таможни сообщения || <br />
|-<br />
|InitialEnvelopeID || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|PreparationDateTime || '''string''' || Дата и время сообщения || <br />
|-<br />
|ExchType || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|ProccessID || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|MainProccessID || '''string''' || ID основной процедуры (если есть) || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|SenderInformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|ReceiverInformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|Sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|ArchID || '''string''' || ID архива таможни || <br />
|-<br />
|ArchDocID || '''string''' || ID документа в архиве таможни || <br />
|}<br />
<br />
запрос также проверяет доступ к ИНН, если не прописан доступ к ИНН, то вернет ошибку<br />
<br />
=== Получение сообщения. ===<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен <br />
|-<br />
|'''210''' || Необходимо принять оферту на сайте<br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1375
API для сервиса report.alta.ru
2025-03-03T12:58:07Z
<p>Vetoshkin: /* Объект doc */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ<br />
# Получение документов гр.44 (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10T10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10T10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
из выдачи убрали заголовки столбцов, для их получения есть запрос апи <code>/docs/fields/</code><br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
<br />
==== Объект doc ====<br />
<br />
{| class="wikitable"<br />
|login || '''string''' || Catchall Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин СВД || 123456-01<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID текущего сообщения с ДТ || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|messagetype || '''string''' || Тип текущего ЭД сообщения с ДТ || CMN.11010<br />
|-<br />
|status || '''string''' || Статус процедуры в числовом виде || 3<br />
|-<br />
|softver || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ver || '''string''' || Системная версия списка колонок || 1.06<br />
|-<br />
|ProccessID || '''string''' || ID процедуры || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|ExProccessID || '''string''' || Список дополнительных ID процедур по основной || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|LastMessageDate || '''string''' || Дата последнего сообщения по процедуре || <br />
|-<br />
|DeclarantOrganizationName || '''string''' || Наименование организациии || ООО \"Альта-Софт\"<br />
|-<br />
|DeclarantINN || '''string''' || ИНН декларанта || 1234567890<br />
|-<br />
|DeclarantOGRN || '''string''' || ОГРН декларанта || <br />
|-<br />
|DeclarantFIO || '''string''' || ФИО декларанта из гр.54 || <br />
|-<br />
|consignorName || '''string''' || Отправитель || <br />
|-<br />
|consignorAddres || '''string''' || Адрес отправителя || <br />
|-<br />
|consigneeName || '''string''' || Получатель || <br />
|-<br />
|consigneeAddres || '''string''' || Адрес получателя || <br />
|-<br />
|sellerName || '''string''' || Продавец (ДТС) || <br />
|-<br />
|Transp || '''string''' || Номера транспортных средств || <br />
|-<br />
|TrCount || '''string''' || Количество транспортных средств || <br />
|-<br />
|Contract || '''string''' || Номер контракта || <br />
|-<br />
|TrDoc || '''string''' || Номер транспортных документов || <br />
|-<br />
|Cont || '''string''' || Номера контейнеров <br />
|-<br />
|NetWeightQuantity || '''string''' || Нетто || 20160.00<br />
|-<br />
|GrossWeightQuantity || '''string''' || Брутто || 20640.00<br />
|-<br />
|CustomsCost || '''string''' || Таможенная стоимость || 1989792.00<br />
|-<br />
|InvoicedCost || '''string''' || Фактурная стоимость || 1989792.00<br />
|-<br />
|ContractCurrencyCode || '''string''' || Валюта контракта || RUB<br />
|-<br />
|sborSum || '''string''' || Сумма таможенных сборов || 30000.00<br />
|-<br />
|poshSum || '''string''' || Сумма таможенных пошлин || 1989792.00<br />
|-<br />
|ndsSum || '''string''' || Сумма НДС || 1989792.00<br />
|-<br />
|akcizSum || '''string''' || Сумма акциза || 1989792.00<br />
|-<br />
|platSum || '''string''' || Сумма платежей || 1989792.00<br />
|-<br />
|REGNUM || '''string''' || Номер ДТ || 10000000/010121/0123456 <br />
|-<br />
|PackageNumber || '''string''' || Кол-во мест || <br />
|-<br />
|GoodsCount || '''string''' || Кол-во товаров || 1<br />
|-<br />
|BorderCustoms || '''string''' || Код поста гр.29 || 10000000<br />
|-<br />
|UD || '''string''' || Код поста гр.30 || 10000000<br />
|-<br />
|UDName || '''string''' || Наименование поста гр.30 || ФТС России<br />
|-<br />
|CustomsProcedure || '''string''' || Режим || ИМ<br />
|-<br />
|CustomsModeCode || '''string''' || Процедура || 40<br />
|-<br />
|DeclarationKind || '''string''' || Особенности процедуры || ПТД<br />
|-<br />
|DocUsageCode|| '''string''' || Признак использования товаросопроводительного документа в качестве ДТ || СД<br />
|}<br />
<br />
=== Наименования статусов ===<br />
{| class="wikitable"<br />
|1 || Открытие процедуры<br />
|-<br />
|2 || Присвоен номер<br />
|-<br />
|3 || Идет проверка<br />
|-<br />
|4 || Идет досмотр<br />
|-<br />
|5 || Проверка закончена<br />
|-<br />
|6 || Условно выпущена<br />
|-<br />
|7 || Выпуск разрешен<br />
|-<br />
|10 || Отказано в выпуске<br />
|-<br />
|11 || Товар прибыл (ПТД)<br />
|-<br />
|12 || Выпуск с обеспечением<br />
|-<br />
|13 || Отзыв<br />
|-<br />
|14 || Считается не поданной<br />
|-<br />
|15 || Выпуск приостановлен<br />
|-<br />
|17 || Частично выпущена<br />
|-<br />
|26 || Выпуск под обеспечение<br />
|-<br />
|27 || Идет осмотр<br />
|-<br />
|28 || Идет экспертиза<br />
|-<br />
|8192 || Отказано в приеме<br />
|-<br />
|16384 || Переход на "бумагу"<br />
|-<br />
|32768 || Запрошен отзыв<br />
|}<br />
<br />
=== Получение, Печать документа, Просмотр документа ===<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
=== Получение полей (заголовки столбцов) ===<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов вынесли в отдельный запрос<br />
<br />
=== Получение вложенных документов из графы 44 ===<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
=== Получение тела документа 44. Печать в html ===<br />
<br />
Запрос похож на предыдущий, добавляем только спереди ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Ответные параметры ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|MessageType || '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|Priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|Incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин, с которого пришло сообщение || 123456-01<br />
|-<br />
|EnvelopeID || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|SoftVersion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ParticipantID || '''string''' || ID декларанта <br />
|-<br />
|CustomsCode || '''string''' || Код таможни сообщения || <br />
|-<br />
|InitialEnvelopeID || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|PreparationDateTime || '''string''' || Дата и время сообщения || <br />
|-<br />
|ExchType || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|ProccessID || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|MainProccessID || '''string''' || ID основной процедуры (если есть) || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|SenderInformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|ReceiverInformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|Sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|ArchID || '''string''' || ID архива таможни || <br />
|-<br />
|ArchDocID || '''string''' || ID документа в архиве таможни || <br />
|}<br />
<br />
запрос также проверяет доступ к ИНН, если не прописан доступ к ИНН, то вернет ошибку<br />
<br />
=== Получение сообщения. ===<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен <br />
|-<br />
|'''210''' || Необходимо принять оферту на сайте<br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1374
API для сервиса report.alta.ru
2025-03-03T08:11:08Z
<p>Vetoshkin: /* Объект doc */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ<br />
# Получение документов гр.44 (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10T10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10T10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
из выдачи убрали заголовки столбцов, для их получения есть запрос апи <code>/docs/fields/</code><br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
<br />
==== Объект doc ====<br />
<br />
{| class="wikitable"<br />
|messagetype || '''string''' || Тип текущего сообщения с ДТ || CMN.11023<br />
|-<br />
|login || '''string''' || Catchall Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин СВД || 123456-01<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID текущего сообщения с ДТ || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|messagetype || '''string''' || Тип текущего ЭД сообщения с ДТ || CMN.11010<br />
|-<br />
|status || '''string''' || Статус процедуры в числовом виде || 3<br />
|-<br />
|softver || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ver || '''string''' || Системная версия списка колонок || 1.06<br />
|-<br />
|ProccessID || '''string''' || ID процедуры || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|ExProccessID || '''string''' || Список дополнительных ID процедур по основной || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|LastMessageDate || '''string''' || Дата последнего сообщения по процедуре || <br />
|-<br />
|DeclarantOrganizationName || '''string''' || Наименование организациии || ООО \"Альта-Софт\"<br />
|-<br />
|DeclarantINN || '''string''' || ИНН декларанта || 1234567890<br />
|-<br />
|DeclarantOGRN || '''string''' || ОГРН декларанта || <br />
|-<br />
|DeclarantFIO || '''string''' || ФИО декларанта из гр.54 || <br />
|-<br />
|consignorName || '''string''' || Отправитель || <br />
|-<br />
|consignorAddres || '''string''' || Адрес отправителя || <br />
|-<br />
|consigneeName || '''string''' || Получатель || <br />
|-<br />
|consigneeAddres || '''string''' || Адрес получателя || <br />
|-<br />
|sellerName || '''string''' || Продавец (ДТС) || <br />
|-<br />
|Transp || '''string''' || Номера транспортных средств || <br />
|-<br />
|TrCount || '''string''' || Количество транспортных средств || <br />
|-<br />
|Contract || '''string''' || Номер контракта || <br />
|-<br />
|TrDoc || '''string''' || Номер транспортных документов || <br />
|-<br />
|Cont || '''string''' || Номера контейнеров <br />
|-<br />
|NetWeightQuantity || '''string''' || Нетто || 20160.00<br />
|-<br />
|GrossWeightQuantity || '''string''' || Брутто || 20640.00<br />
|-<br />
|CustomsCost || '''string''' || Таможенная стоимость || 1989792.00<br />
|-<br />
|InvoicedCost || '''string''' || Фактурная стоимость || 1989792.00<br />
|-<br />
|ContractCurrencyCode || '''string''' || Валюта контракта || RUB<br />
|-<br />
|sborSum || '''string''' || Сумма таможенных сборов || 30000.00<br />
|-<br />
|poshSum || '''string''' || Сумма таможенных пошлин || 1989792.00<br />
|-<br />
|ndsSum || '''string''' || Сумма НДС || 1989792.00<br />
|-<br />
|akcizSum || '''string''' || Сумма акциза || 1989792.00<br />
|-<br />
|platSum || '''string''' || Сумма платежей || 1989792.00<br />
|-<br />
|REGNUM || '''string''' || Номер ДТ || 10000000/010121/0123456 <br />
|-<br />
|PackageNumber || '''string''' || Кол-во мест || <br />
|-<br />
|GoodsCount || '''string''' || Кол-во товаров || 1<br />
|-<br />
|BorderCustoms || '''string''' || Код поста гр.29 || 10000000<br />
|-<br />
|UD || '''string''' || Код поста гр.30 || 10000000<br />
|-<br />
|UDName || '''string''' || Наименование поста гр.30 || ФТС России<br />
|-<br />
|CustomsProcedure || '''string''' || Режим || ИМ<br />
|-<br />
|CustomsModeCode || '''string''' || Процедура || 40<br />
|-<br />
|DeclarationKind || '''string''' || Особенности процедуры || ПТД<br />
|-<br />
|DocUsageCode|| '''string''' || Признак использования товаросопроводительного документа в качестве ДТ || СД<br />
|}<br />
<br />
=== Наименования статусов ===<br />
{| class="wikitable"<br />
|1 || Открытие процедуры<br />
|-<br />
|2 || Присвоен номер<br />
|-<br />
|3 || Идет проверка<br />
|-<br />
|4 || Идет досмотр<br />
|-<br />
|5 || Проверка закончена<br />
|-<br />
|6 || Условно выпущена<br />
|-<br />
|7 || Выпуск разрешен<br />
|-<br />
|10 || Отказано в выпуске<br />
|-<br />
|11 || Товар прибыл (ПТД)<br />
|-<br />
|12 || Выпуск с обеспечением<br />
|-<br />
|13 || Отзыв<br />
|-<br />
|14 || Считается не поданной<br />
|-<br />
|15 || Выпуск приостановлен<br />
|-<br />
|17 || Частично выпущена<br />
|-<br />
|26 || Выпуск под обеспечение<br />
|-<br />
|27 || Идет осмотр<br />
|-<br />
|28 || Идет экспертиза<br />
|-<br />
|8192 || Отказано в приеме<br />
|-<br />
|16384 || Переход на "бумагу"<br />
|-<br />
|32768 || Запрошен отзыв<br />
|}<br />
<br />
=== Получение, Печать документа, Просмотр документа ===<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
=== Получение полей (заголовки столбцов) ===<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов вынесли в отдельный запрос<br />
<br />
=== Получение вложенных документов из графы 44 ===<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
=== Получение тела документа 44. Печать в html ===<br />
<br />
Запрос похож на предыдущий, добавляем только спереди ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Ответные параметры ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|MessageType || '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|Priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|Incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин, с которого пришло сообщение || 123456-01<br />
|-<br />
|EnvelopeID || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|SoftVersion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ParticipantID || '''string''' || ID декларанта <br />
|-<br />
|CustomsCode || '''string''' || Код таможни сообщения || <br />
|-<br />
|InitialEnvelopeID || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|PreparationDateTime || '''string''' || Дата и время сообщения || <br />
|-<br />
|ExchType || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|ProccessID || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|MainProccessID || '''string''' || ID основной процедуры (если есть) || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|SenderInformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|ReceiverInformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|Sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|ArchID || '''string''' || ID архива таможни || <br />
|-<br />
|ArchDocID || '''string''' || ID документа в архиве таможни || <br />
|}<br />
<br />
запрос также проверяет доступ к ИНН, если не прописан доступ к ИНН, то вернет ошибку<br />
<br />
=== Получение сообщения. ===<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен <br />
|-<br />
|'''210''' || Необходимо принять оферту на сайте<br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1366
API для сервиса report.alta.ru
2024-11-12T06:33:39Z
<p>Vetoshkin: /* Объект doc */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ<br />
# Получение документов гр.44 (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10T10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10T10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
из выдачи убрали заголовки столбцов, для их получения есть запрос апи <code>/docs/fields/</code><br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
<br />
==== Объект doc ====<br />
<br />
{| class="wikitable"<br />
!messagetype || '''string''' || Тип текущего сообщения с ДТ || CMN.11023<br />
|-<br />
|login || '''string''' || Catchall Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин СВД || 123456-01<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID текущего сообщения с ДТ || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|messagetype || '''string''' || Тип текущего ЭД сообщения с ДТ || CMN.11010<br />
|-<br />
|status || '''string''' || Статус процедуры в числовом виде || 3<br />
|-<br />
|softver || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ver || '''string''' || Системная версия списка колонок || 1.06<br />
|-<br />
|ProccessID || '''string''' || ID процедуры || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|ExProccessID || '''string''' || Список дополнительных ID процедур по основной || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|LastMessageDate || '''string''' || Дата последнего сообщения по процедуре || <br />
|-<br />
|DeclarantOrganizationName || '''string''' || Наименование организациии || ООО \"Альта-Софт\"<br />
|-<br />
|DeclarantINN || '''string''' || ИНН декларанта || 1234567890<br />
|-<br />
|DeclarantOGRN || '''string''' || ОГРН декларанта || <br />
|-<br />
|DeclarantFIO || '''string''' || ФИО декларанта из гр.54 || <br />
|-<br />
|consignorName || '''string''' || Отправитель || <br />
|-<br />
|consignorAddres || '''string''' || Адрес отправителя || <br />
|-<br />
|consigneeName || '''string''' || Получатель || <br />
|-<br />
|consigneeAddres || '''string''' || Адрес получателя || <br />
|-<br />
|sellerName || '''string''' || Продавец (ДТС) || <br />
|-<br />
|Transp || '''string''' || Номера транспортных средств || <br />
|-<br />
|TrCount || '''string''' || Количество транспортных средств || <br />
|-<br />
|Contract || '''string''' || Номер контракта || <br />
|-<br />
|TrDoc || '''string''' || Номер транспортных документов || <br />
|-<br />
|Cont || '''string''' || Номера контейнеров <br />
|-<br />
|NetWeightQuantity || '''string''' || Нетто || 20160.00<br />
|-<br />
|GrossWeightQuantity || '''string''' || Брутто || 20640.00<br />
|-<br />
|CustomsCost || '''string''' || Таможенная стоимость || 1989792.00<br />
|-<br />
|InvoicedCost || '''string''' || Фактурная стоимость || 1989792.00<br />
|-<br />
|ContractCurrencyCode || '''string''' || Валюта контракта || RUB<br />
|-<br />
|sborSum || '''string''' || Сумма таможенных сборов || 30000.00<br />
|-<br />
|poshSum || '''string''' || Сумма таможенных пошлин || 1989792.00<br />
|-<br />
|ndsSum || '''string''' || Сумма НДС || 1989792.00<br />
|-<br />
|akcizSum || '''string''' || Сумма акциза || 1989792.00<br />
|-<br />
|platSum || '''string''' || Сумма платежей || 1989792.00<br />
|-<br />
|REGNUM || '''string''' || Номер ДТ || 10000000/010121/0123456 <br />
|-<br />
|PackageNumber || '''string''' || Кол-во мест || <br />
|-<br />
|GoodsCount || '''string''' || Кол-во товаров || 1<br />
|-<br />
|BorderCustoms || '''string''' || Код поста гр.29 || 10000000<br />
|-<br />
|UD || '''string''' || Код поста гр.30 || 10000000<br />
|-<br />
|UDName || '''string''' || Наименование поста гр.30 || ФТС России<br />
|-<br />
|CustomsProcedure || '''string''' || Режим || ИМ<br />
|-<br />
|CustomsModeCode || '''string''' || Процедура || 40<br />
|-<br />
|DeclarationKind || '''string''' || Особенности процедуры || ПТД<br />
|-<br />
|DocUsageCode|| '''string''' || Признак использования товаросопроводительного документа в качестве ДТ || СД<br />
|}<br />
<br />
=== Наименования статусов ===<br />
{| class="wikitable"<br />
|1 || Открытие процедуры<br />
|-<br />
|2 || Присвоен номер<br />
|-<br />
|3 || Идет проверка<br />
|-<br />
|4 || Идет досмотр<br />
|-<br />
|5 || Проверка закончена<br />
|-<br />
|6 || Условно выпущена<br />
|-<br />
|7 || Выпуск разрешен<br />
|-<br />
|10 || Отказано в выпуске<br />
|-<br />
|11 || Товар прибыл (ПТД)<br />
|-<br />
|12 || Выпуск с обеспечением<br />
|-<br />
|13 || Отзыв<br />
|-<br />
|14 || Считается не поданной<br />
|-<br />
|15 || Выпуск приостановлен<br />
|-<br />
|17 || Частично выпущена<br />
|-<br />
|26 || Выпуск под обеспечение<br />
|-<br />
|27 || Идет осмотр<br />
|-<br />
|28 || Идет экспертиза<br />
|-<br />
|8192 || Отказано в приеме<br />
|-<br />
|16384 || Переход на "бумагу"<br />
|-<br />
|32768 || Запрошен отзыв<br />
|}<br />
<br />
=== Получение, Печать документа, Просмотр документа ===<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
=== Получение полей (заголовки столбцов) ===<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов вынесли в отдельный запрос<br />
<br />
=== Получение вложенных документов из графы 44 ===<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
=== Получение тела документа 44. Печать в html ===<br />
<br />
Запрос похож на предыдущий, добавляем только спереди ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Ответные параметры ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|MessageType || '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|Priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|Incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин, с которого пришло сообщение || 123456-01<br />
|-<br />
|EnvelopeID || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|SoftVersion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ParticipantID || '''string''' || ID декларанта <br />
|-<br />
|CustomsCode || '''string''' || Код таможни сообщения || <br />
|-<br />
|InitialEnvelopeID || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|PreparationDateTime || '''string''' || Дата и время сообщения || <br />
|-<br />
|ExchType || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|ProccessID || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|MainProccessID || '''string''' || ID основной процедуры (если есть) || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|SenderInformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|ReceiverInformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|Sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|ArchID || '''string''' || ID архива таможни || <br />
|-<br />
|ArchDocID || '''string''' || ID документа в архиве таможни || <br />
|}<br />
<br />
запрос также проверяет доступ к ИНН, если не прописан доступ к ИНН, то вернет ошибку<br />
<br />
=== Получение сообщения. ===<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен <br />
|-<br />
|'''210''' || Необходимо принять оферту на сайте<br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1344
API для сервиса report.alta.ru
2024-07-04T06:25:39Z
<p>Vetoshkin: /* Ответные параметры */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ<br />
# Получение документов гр.44 (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10T10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10T10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
из выдачи убрали заголовки столбцов, для их получения есть запрос апи <code>/docs/fields/</code><br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
<br />
==== Объект doc ====<br />
<br />
{| class="wikitable"<br />
!messagetype || '''string''' || Тип текущего сообщения с ДТ || CMN.11023<br />
|-<br />
|login || '''string''' || Catchall Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин СВД || 123456-01<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID текущего сообщения с ДТ || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|messagetype || '''string''' || Тип текущего ЭД сообщения с ДТ || CMN.11010<br />
|-<br />
|status || '''string''' || Статус процедуры в числовом виде || 3<br />
|-<br />
|softver || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ver || '''string''' || Системная версия списка колонок || 1.06<br />
|-<br />
|ProccessID || '''string''' || ID процедуры || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|ExProccessID || '''string''' || Список дополнительных ID процедур по основной || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|LastMessageDate || '''string''' || Дата последнего сообщения по процедуре || <br />
|-<br />
|DeclarantOrganizationName || '''string''' || Наименование организациии || ООО \"Альта-Софт\"<br />
|-<br />
|DeclarantINN || '''string''' || ИНН декларанта || 1234567890<br />
|-<br />
|DeclarantOGRN || '''string''' || ОГРН декларанта || <br />
|-<br />
|DeclarantFIO || '''string''' || ФИО декларанта из гр.54 || <br />
|-<br />
|consignorName || '''string''' || Отправитель || <br />
|-<br />
|consignorAddres || '''string''' || Адрес отправителя || <br />
|-<br />
|consigneeName || '''string''' || Получатель || <br />
|-<br />
|consigneeAddres || '''string''' || Адрес получателя || <br />
|-<br />
|sellerName || '''string''' || Продавец (ДТС) || <br />
|-<br />
|Transp || '''string''' || Номера транспортных средств || <br />
|-<br />
|TrCount || '''string''' || Количество транспортных средств || <br />
|-<br />
|Contract || '''string''' || Номер контракта || <br />
|-<br />
|TrDoc || '''string''' || Номер транспортных документов || <br />
|-<br />
|Cont || '''string''' || Номера контейнеров <br />
|-<br />
|NetWeightQuantity || '''string''' || Нетто || 20160.00<br />
|-<br />
|GrossWeightQuantity || '''string''' || Брутто || 20640.00<br />
|-<br />
|CustomsCost || '''string''' || Таможенная стоимость || 1989792.00<br />
|-<br />
|InvoicedCost || '''string''' || Фактурная стоимость || 1989792.00<br />
|-<br />
|ContractCurrencyCode || '''string''' || Валюта контракта || RUB<br />
|-<br />
|sborSum || '''string''' || Сумма таможенных сборов || 30000.00<br />
|-<br />
|poshSum || '''string''' || Сумма таможенных пошлин || 1989792.00<br />
|-<br />
|ndsSum || '''string''' || Сумма НДС || 1989792.00<br />
|-<br />
|akcizSum || '''string''' || Сумма акциза || 1989792.00<br />
|-<br />
|platSum || '''string''' || Сумма платежей || 1989792.00<br />
|-<br />
|REGNUM || '''string''' || Номер ДТ || 10000000/010121/0123456 <br />
|-<br />
|PackageNumber || '''string''' || Кол-во мест || <br />
|-<br />
|GoodsCount || '''string''' || Кол-во товаров || 1<br />
|-<br />
|BorderCustoms || '''string''' || Код поста гр.29 || 10000000<br />
|-<br />
|UD || '''string''' || Код поста гр.30 || 10000000<br />
|-<br />
|UDName || '''string''' || Наименование поста гр.30 || ФТС России<br />
|-<br />
|CustomsProcedure || '''string''' || Режим || ИМ<br />
|-<br />
|CustomsModeCode || '''string''' || Процедура || 40<br />
|-<br />
|DeclarationKind || '''string''' || Особенности процедуры || ПТД<br />
|}<br />
<br />
=== Наименования статусов ===<br />
{| class="wikitable"<br />
|1 || Открытие процедуры<br />
|-<br />
|2 || Присвоен номер<br />
|-<br />
|3 || Идет проверка<br />
|-<br />
|4 || Идет досмотр<br />
|-<br />
|5 || Проверка закончена<br />
|-<br />
|6 || Условно выпущена<br />
|-<br />
|7 || Выпуск разрешен<br />
|-<br />
|10 || Отказано в выпуске<br />
|-<br />
|11 || Товар прибыл (ПТД)<br />
|-<br />
|12 || Выпуск с обеспечением<br />
|-<br />
|13 || Отзыв<br />
|-<br />
|14 || Считается не поданной<br />
|-<br />
|15 || Выпуск приостановлен<br />
|-<br />
|17 || Частично выпущена<br />
|-<br />
|26 || Выпуск под обеспечение<br />
|-<br />
|27 || Идет осмотр<br />
|-<br />
|28 || Идет экспертиза<br />
|-<br />
|8192 || Отказано в приеме<br />
|-<br />
|16384 || Переход на "бумагу"<br />
|-<br />
|32768 || Запрошен отзыв<br />
|}<br />
<br />
=== Получение, Печать документа, Просмотр документа ===<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
=== Получение полей (заголовки столбцов) ===<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов вынесли в отдельный запрос<br />
<br />
=== Получение вложенных документов из графы 44 ===<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
=== Получение тела документа 44. Печать в html ===<br />
<br />
Запрос похож на предыдущий, добавляем только спереди ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Ответные параметры ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|MessageType || '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|Priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|Incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин, с которого пришло сообщение || 123456-01<br />
|-<br />
|EnvelopeID || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|SoftVersion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ParticipantID || '''string''' || ID декларанта <br />
|-<br />
|CustomsCode || '''string''' || Код таможни сообщения || <br />
|-<br />
|InitialEnvelopeID || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|PreparationDateTime || '''string''' || Дата и время сообщения || <br />
|-<br />
|ExchType || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|ProccessID || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|MainProccessID || '''string''' || ID основной процедуры (если есть) || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|SenderInformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|ReceiverInformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|Sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|ArchID || '''string''' || ID архива таможни || <br />
|-<br />
|ArchDocID || '''string''' || ID документа в архиве таможни || <br />
|}<br />
<br />
запрос также проверяет доступ к ИНН, если не прописан доступ к ИНН, то вернет ошибку<br />
<br />
=== Получение сообщения. ===<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен <br />
|-<br />
|'''210''' || Необходимо принять оферту на сайте<br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1343
API для сервиса report.alta.ru
2024-07-04T06:22:04Z
<p>Vetoshkin: /* Объект doc */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ<br />
# Получение документов гр.44 (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10T10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10T10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
из выдачи убрали заголовки столбцов, для их получения есть запрос апи <code>/docs/fields/</code><br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
<br />
==== Объект doc ====<br />
<br />
{| class="wikitable"<br />
!messagetype || '''string''' || Тип текущего сообщения с ДТ || CMN.11023<br />
|-<br />
|login || '''string''' || Catchall Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин СВД || 123456-01<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID текущего сообщения с ДТ || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|messagetype || '''string''' || Тип текущего ЭД сообщения с ДТ || CMN.11010<br />
|-<br />
|status || '''string''' || Статус процедуры в числовом виде || 3<br />
|-<br />
|softver || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ver || '''string''' || Системная версия списка колонок || 1.06<br />
|-<br />
|ProccessID || '''string''' || ID процедуры || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|ExProccessID || '''string''' || Список дополнительных ID процедур по основной || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|LastMessageDate || '''string''' || Дата последнего сообщения по процедуре || <br />
|-<br />
|DeclarantOrganizationName || '''string''' || Наименование организациии || ООО \"Альта-Софт\"<br />
|-<br />
|DeclarantINN || '''string''' || ИНН декларанта || 1234567890<br />
|-<br />
|DeclarantOGRN || '''string''' || ОГРН декларанта || <br />
|-<br />
|DeclarantFIO || '''string''' || ФИО декларанта из гр.54 || <br />
|-<br />
|consignorName || '''string''' || Отправитель || <br />
|-<br />
|consignorAddres || '''string''' || Адрес отправителя || <br />
|-<br />
|consigneeName || '''string''' || Получатель || <br />
|-<br />
|consigneeAddres || '''string''' || Адрес получателя || <br />
|-<br />
|sellerName || '''string''' || Продавец (ДТС) || <br />
|-<br />
|Transp || '''string''' || Номера транспортных средств || <br />
|-<br />
|TrCount || '''string''' || Количество транспортных средств || <br />
|-<br />
|Contract || '''string''' || Номер контракта || <br />
|-<br />
|TrDoc || '''string''' || Номер транспортных документов || <br />
|-<br />
|Cont || '''string''' || Номера контейнеров <br />
|-<br />
|NetWeightQuantity || '''string''' || Нетто || 20160.00<br />
|-<br />
|GrossWeightQuantity || '''string''' || Брутто || 20640.00<br />
|-<br />
|CustomsCost || '''string''' || Таможенная стоимость || 1989792.00<br />
|-<br />
|InvoicedCost || '''string''' || Фактурная стоимость || 1989792.00<br />
|-<br />
|ContractCurrencyCode || '''string''' || Валюта контракта || RUB<br />
|-<br />
|sborSum || '''string''' || Сумма таможенных сборов || 30000.00<br />
|-<br />
|poshSum || '''string''' || Сумма таможенных пошлин || 1989792.00<br />
|-<br />
|ndsSum || '''string''' || Сумма НДС || 1989792.00<br />
|-<br />
|akcizSum || '''string''' || Сумма акциза || 1989792.00<br />
|-<br />
|platSum || '''string''' || Сумма платежей || 1989792.00<br />
|-<br />
|REGNUM || '''string''' || Номер ДТ || 10000000/010121/0123456 <br />
|-<br />
|PackageNumber || '''string''' || Кол-во мест || <br />
|-<br />
|GoodsCount || '''string''' || Кол-во товаров || 1<br />
|-<br />
|BorderCustoms || '''string''' || Код поста гр.29 || 10000000<br />
|-<br />
|UD || '''string''' || Код поста гр.30 || 10000000<br />
|-<br />
|UDName || '''string''' || Наименование поста гр.30 || ФТС России<br />
|-<br />
|CustomsProcedure || '''string''' || Режим || ИМ<br />
|-<br />
|CustomsModeCode || '''string''' || Процедура || 40<br />
|-<br />
|DeclarationKind || '''string''' || Особенности процедуры || ПТД<br />
|}<br />
<br />
=== Наименования статусов ===<br />
{| class="wikitable"<br />
|1 || Открытие процедуры<br />
|-<br />
|2 || Присвоен номер<br />
|-<br />
|3 || Идет проверка<br />
|-<br />
|4 || Идет досмотр<br />
|-<br />
|5 || Проверка закончена<br />
|-<br />
|6 || Условно выпущена<br />
|-<br />
|7 || Выпуск разрешен<br />
|-<br />
|10 || Отказано в выпуске<br />
|-<br />
|11 || Товар прибыл (ПТД)<br />
|-<br />
|12 || Выпуск с обеспечением<br />
|-<br />
|13 || Отзыв<br />
|-<br />
|14 || Считается не поданной<br />
|-<br />
|15 || Выпуск приостановлен<br />
|-<br />
|17 || Частично выпущена<br />
|-<br />
|26 || Выпуск под обеспечение<br />
|-<br />
|27 || Идет осмотр<br />
|-<br />
|28 || Идет экспертиза<br />
|-<br />
|8192 || Отказано в приеме<br />
|-<br />
|16384 || Переход на "бумагу"<br />
|-<br />
|32768 || Запрошен отзыв<br />
|}<br />
<br />
=== Получение, Печать документа, Просмотр документа ===<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
=== Получение полей (заголовки столбцов) ===<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов вынесли в отдельный запрос<br />
<br />
=== Получение вложенных документов из графы 44 ===<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
=== Получение тела документа 44. Печать в html ===<br />
<br />
Запрос похож на предыдущий, добавляем только спереди ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Ответные параметры ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|MessageType || '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|Priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|Incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456<br />
|-<br />
|EnvelopeID || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|SoftVersion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ParticipantID || '''string''' || ID декларанта <br />
|-<br />
|CustomsCode || '''string''' || Код таможни сообщения || <br />
|-<br />
|InitialEnvelopeID || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|PreparationDateTime || '''string''' || Дата и время сообщения || <br />
|-<br />
|ExchType || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|ProccessID || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|SenderInformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|ReceiverInformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|Sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|ArchID || '''string''' || ID архива таможни || <br />
|-<br />
|ArchDocID || '''string''' || ID документа в архиве таможни || <br />
|}<br />
<br />
запрос также проверяет доступ к ИНН, если не прописан доступ к ИНН, то вернет ошибку<br />
<br />
=== Получение сообщения. ===<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен <br />
|-<br />
|'''210''' || Необходимо принять оферту на сайте<br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1342
API для сервиса report.alta.ru
2024-05-21T10:15:05Z
<p>Vetoshkin: /* Ошибки */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ<br />
# Получение документов гр.44 (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10T10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10T10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
из выдачи убрали заголовки столбцов, для их получения есть запрос апи <code>/docs/fields/</code><br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
<br />
==== Объект doc ====<br />
<br />
{| class="wikitable"<br />
!messagetype || '''string''' || Тип текущего сообщения с ДТ || CMN.11023<br />
|-<br />
|login || '''string''' || Catchall Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин СВД || 123456-01<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID текущего сообщения с ДТ || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|status || '''string''' || Статус процедуры в числовом виде || 3<br />
|-<br />
|softver || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ProccessID || '''string''' || ID процедуры || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|LastMessageDate || '''string''' || Дата последнего сообщения по процедуре || <br />
|-<br />
|DeclarantOrganizationName || '''string''' || Наименование организациии || ООО \"Альта-Софт\"<br />
|-<br />
|DeclarantINN || '''string''' || ИНН декларанта || 1234567890<br />
|-<br />
|DeclarantOGRN || '''string''' || ОГРН декларанта || <br />
|-<br />
|DeclarantFIO || '''string''' || ФИО декларанта из гр.54 || <br />
|-<br />
|consignorName || '''string''' || Отправитель || <br />
|-<br />
|consignorAddres || '''string''' || Адрес отправителя || <br />
|-<br />
|consigneeName || '''string''' || Получатель || <br />
|-<br />
|consigneeAddres || '''string''' || Адрес получателя || <br />
|-<br />
|sellerName || '''string''' || Продавец (ДТС) || <br />
|-<br />
|Transp || '''string''' || Номера транспортных средств || <br />
|-<br />
|TrCount || '''string''' || Количество транспортных средств || <br />
|-<br />
|Contract || '''string''' || Номер контракта || <br />
|-<br />
|TrDoc || '''string''' || Номер транспортных документов || <br />
|-<br />
|Cont || '''string''' || Номера контейнеров <br />
|-<br />
|NetWeightQuantity || '''string''' || Нетто || 20160.00<br />
|-<br />
|GrossWeightQuantity || '''string''' || Брутто || 20640.00<br />
|-<br />
|CustomsCost || '''string''' || Таможенная стоимость || 1989792.00<br />
|-<br />
|InvoicedCost || '''string''' || Фактурная стоимость || 1989792.00<br />
|-<br />
|ContractCurrencyCode || '''string''' || Валюта контракта || RUB<br />
|-<br />
|sborSum || '''string''' || Сумма таможенных сборов || 30000.00<br />
|-<br />
|poshSum || '''string''' || Сумма таможенных пошлин || 1989792.00<br />
|-<br />
|ndsSum || '''string''' || Сумма НДС || 1989792.00<br />
|-<br />
|akcizSum || '''string''' || Сумма акциза || 1989792.00<br />
|-<br />
|platSum || '''string''' || Сумма платежей || 1989792.00<br />
|-<br />
|REGNUM || '''string''' || Номер ДТ || 10000000/010121/0123456 <br />
|-<br />
|PackageNumber || '''string''' || Кол-во мест || <br />
|-<br />
|GoodsCount || '''string''' || Кол-во товаров || 1<br />
|-<br />
|BorderCustoms || '''string''' || Код поста гр.29 || 10000000<br />
|-<br />
|UD || '''string''' || Код поста гр.30 || 10000000<br />
|-<br />
|UDName || '''string''' || Наименование поста гр.30 || ФТС России<br />
|-<br />
|CustomsProcedure || '''string''' || Режим || ИМ<br />
|-<br />
|CustomsModeCode || '''string''' || Процедура || 40<br />
|-<br />
|DeclarationKind || '''string''' || Особенности процедуры || ПТД<br />
|}<br />
<br />
=== Наименования статусов ===<br />
{| class="wikitable"<br />
|1 || Открытие процедуры<br />
|-<br />
|2 || Присвоен номер<br />
|-<br />
|3 || Идет проверка<br />
|-<br />
|4 || Идет досмотр<br />
|-<br />
|5 || Проверка закончена<br />
|-<br />
|6 || Условно выпущена<br />
|-<br />
|7 || Выпуск разрешен<br />
|-<br />
|10 || Отказано в выпуске<br />
|-<br />
|11 || Товар прибыл (ПТД)<br />
|-<br />
|12 || Выпуск с обеспечением<br />
|-<br />
|13 || Отзыв<br />
|-<br />
|14 || Считается не поданной<br />
|-<br />
|15 || Выпуск приостановлен<br />
|-<br />
|17 || Частично выпущена<br />
|-<br />
|26 || Выпуск под обеспечение<br />
|-<br />
|27 || Идет осмотр<br />
|-<br />
|28 || Идет экспертиза<br />
|-<br />
|8192 || Отказано в приеме<br />
|-<br />
|16384 || Переход на "бумагу"<br />
|-<br />
|32768 || Запрошен отзыв<br />
|}<br />
<br />
=== Получение, Печать документа, Просмотр документа ===<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
=== Получение полей (заголовки столбцов) ===<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов вынесли в отдельный запрос<br />
<br />
=== Получение вложенных документов из графы 44 ===<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
=== Получение тела документа 44. Печать в html ===<br />
<br />
Запрос похож на предыдущий, добавляем только спереди ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Ответные параметры ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|MessageType || '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|Priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|Incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456<br />
|-<br />
|EnvelopeID || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|SoftVersion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ParticipantID || '''string''' || ID декларанта <br />
|-<br />
|CustomsCode || '''string''' || Код таможни сообщения || <br />
|-<br />
|InitialEnvelopeID || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|PreparationDateTime || '''string''' || Дата и время сообщения || <br />
|-<br />
|ExchType || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|ProccessID || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|SenderInformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|ReceiverInformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|Sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|ArchID || '''string''' || ID архива таможни || <br />
|-<br />
|ArchDocID || '''string''' || ID документа в архиве таможни || <br />
|}<br />
<br />
запрос также проверяет доступ к ИНН, если не прописан доступ к ИНН, то вернет ошибку<br />
<br />
=== Получение сообщения. ===<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен <br />
|-<br />
|'''210''' || Необходимо принять оферту на сайте<br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1341
API для сервиса report.alta.ru
2024-05-21T10:14:25Z
<p>Vetoshkin: /* Ошибки */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ<br />
# Получение документов гр.44 (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10T10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10T10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
из выдачи убрали заголовки столбцов, для их получения есть запрос апи <code>/docs/fields/</code><br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
<br />
==== Объект doc ====<br />
<br />
{| class="wikitable"<br />
!messagetype || '''string''' || Тип текущего сообщения с ДТ || CMN.11023<br />
|-<br />
|login || '''string''' || Catchall Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин СВД || 123456-01<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID текущего сообщения с ДТ || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|status || '''string''' || Статус процедуры в числовом виде || 3<br />
|-<br />
|softver || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ProccessID || '''string''' || ID процедуры || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|LastMessageDate || '''string''' || Дата последнего сообщения по процедуре || <br />
|-<br />
|DeclarantOrganizationName || '''string''' || Наименование организациии || ООО \"Альта-Софт\"<br />
|-<br />
|DeclarantINN || '''string''' || ИНН декларанта || 1234567890<br />
|-<br />
|DeclarantOGRN || '''string''' || ОГРН декларанта || <br />
|-<br />
|DeclarantFIO || '''string''' || ФИО декларанта из гр.54 || <br />
|-<br />
|consignorName || '''string''' || Отправитель || <br />
|-<br />
|consignorAddres || '''string''' || Адрес отправителя || <br />
|-<br />
|consigneeName || '''string''' || Получатель || <br />
|-<br />
|consigneeAddres || '''string''' || Адрес получателя || <br />
|-<br />
|sellerName || '''string''' || Продавец (ДТС) || <br />
|-<br />
|Transp || '''string''' || Номера транспортных средств || <br />
|-<br />
|TrCount || '''string''' || Количество транспортных средств || <br />
|-<br />
|Contract || '''string''' || Номер контракта || <br />
|-<br />
|TrDoc || '''string''' || Номер транспортных документов || <br />
|-<br />
|Cont || '''string''' || Номера контейнеров <br />
|-<br />
|NetWeightQuantity || '''string''' || Нетто || 20160.00<br />
|-<br />
|GrossWeightQuantity || '''string''' || Брутто || 20640.00<br />
|-<br />
|CustomsCost || '''string''' || Таможенная стоимость || 1989792.00<br />
|-<br />
|InvoicedCost || '''string''' || Фактурная стоимость || 1989792.00<br />
|-<br />
|ContractCurrencyCode || '''string''' || Валюта контракта || RUB<br />
|-<br />
|sborSum || '''string''' || Сумма таможенных сборов || 30000.00<br />
|-<br />
|poshSum || '''string''' || Сумма таможенных пошлин || 1989792.00<br />
|-<br />
|ndsSum || '''string''' || Сумма НДС || 1989792.00<br />
|-<br />
|akcizSum || '''string''' || Сумма акциза || 1989792.00<br />
|-<br />
|platSum || '''string''' || Сумма платежей || 1989792.00<br />
|-<br />
|REGNUM || '''string''' || Номер ДТ || 10000000/010121/0123456 <br />
|-<br />
|PackageNumber || '''string''' || Кол-во мест || <br />
|-<br />
|GoodsCount || '''string''' || Кол-во товаров || 1<br />
|-<br />
|BorderCustoms || '''string''' || Код поста гр.29 || 10000000<br />
|-<br />
|UD || '''string''' || Код поста гр.30 || 10000000<br />
|-<br />
|UDName || '''string''' || Наименование поста гр.30 || ФТС России<br />
|-<br />
|CustomsProcedure || '''string''' || Режим || ИМ<br />
|-<br />
|CustomsModeCode || '''string''' || Процедура || 40<br />
|-<br />
|DeclarationKind || '''string''' || Особенности процедуры || ПТД<br />
|}<br />
<br />
=== Наименования статусов ===<br />
{| class="wikitable"<br />
|1 || Открытие процедуры<br />
|-<br />
|2 || Присвоен номер<br />
|-<br />
|3 || Идет проверка<br />
|-<br />
|4 || Идет досмотр<br />
|-<br />
|5 || Проверка закончена<br />
|-<br />
|6 || Условно выпущена<br />
|-<br />
|7 || Выпуск разрешен<br />
|-<br />
|10 || Отказано в выпуске<br />
|-<br />
|11 || Товар прибыл (ПТД)<br />
|-<br />
|12 || Выпуск с обеспечением<br />
|-<br />
|13 || Отзыв<br />
|-<br />
|14 || Считается не поданной<br />
|-<br />
|15 || Выпуск приостановлен<br />
|-<br />
|17 || Частично выпущена<br />
|-<br />
|26 || Выпуск под обеспечение<br />
|-<br />
|27 || Идет осмотр<br />
|-<br />
|28 || Идет экспертиза<br />
|-<br />
|8192 || Отказано в приеме<br />
|-<br />
|16384 || Переход на "бумагу"<br />
|-<br />
|32768 || Запрошен отзыв<br />
|}<br />
<br />
=== Получение, Печать документа, Просмотр документа ===<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
=== Получение полей (заголовки столбцов) ===<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов вынесли в отдельный запрос<br />
<br />
=== Получение вложенных документов из графы 44 ===<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
=== Получение тела документа 44. Печать в html ===<br />
<br />
Запрос похож на предыдущий, добавляем только спереди ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Ответные параметры ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|MessageType || '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|Priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|Incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456<br />
|-<br />
|EnvelopeID || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|SoftVersion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ParticipantID || '''string''' || ID декларанта <br />
|-<br />
|CustomsCode || '''string''' || Код таможни сообщения || <br />
|-<br />
|InitialEnvelopeID || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|PreparationDateTime || '''string''' || Дата и время сообщения || <br />
|-<br />
|ExchType || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|ProccessID || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|SenderInformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|ReceiverInformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|Sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|ArchID || '''string''' || ID архива таможни || <br />
|-<br />
|ArchDocID || '''string''' || ID документа в архиве таможни || <br />
|}<br />
<br />
запрос также проверяет доступ к ИНН, если не прописан доступ к ИНН, то вернет ошибку<br />
<br />
=== Получение сообщения. ===<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен. <br />
|-<br />
|'''210''' || Необходимо принять оферту на сайте. <br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения.<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1330
API для сервиса report.alta.ru
2023-11-18T11:51:48Z
<p>Vetoshkin: /* Объект doc */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ<br />
# Получение документов гр.44 (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10T10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10T10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
из выдачи убрали заголовки столбцов, для их получения есть запрос апи <code>/docs/fields/</code><br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
<br />
==== Объект doc ====<br />
<br />
{| class="wikitable"<br />
!messagetype || '''string''' || Тип текущего сообщения с ДТ || CMN.11023<br />
|-<br />
|login || '''string''' || Catchall Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин СВД || 123456-01<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID текущего сообщения с ДТ || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|status || '''string''' || Статус процедуры в числовом виде || 3<br />
|-<br />
|softver || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ProccessID || '''string''' || ID процедуры || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|LastMessageDate || '''string''' || Дата последнего сообщения по процедуре || <br />
|-<br />
|DeclarantOrganizationName || '''string''' || Наименование организациии || ООО \"Альта-Софт\"<br />
|-<br />
|DeclarantINN || '''string''' || ИНН декларанта || 1234567890<br />
|-<br />
|DeclarantOGRN || '''string''' || ОГРН декларанта || <br />
|-<br />
|DeclarantFIO || '''string''' || ФИО декларанта из гр.54 || <br />
|-<br />
|consignorName || '''string''' || Отправитель || <br />
|-<br />
|consignorAddres || '''string''' || Адрес отправителя || <br />
|-<br />
|consigneeName || '''string''' || Получатель || <br />
|-<br />
|consigneeAddres || '''string''' || Адрес получателя || <br />
|-<br />
|sellerName || '''string''' || Продавец (ДТС) || <br />
|-<br />
|Transp || '''string''' || Номера транспортных средств || <br />
|-<br />
|TrCount || '''string''' || Количество транспортных средств || <br />
|-<br />
|Contract || '''string''' || Номер контракта || <br />
|-<br />
|TrDoc || '''string''' || Номер транспортных документов || <br />
|-<br />
|Cont || '''string''' || Номера контейнеров <br />
|-<br />
|NetWeightQuantity || '''string''' || Нетто || 20160.00<br />
|-<br />
|GrossWeightQuantity || '''string''' || Брутто || 20640.00<br />
|-<br />
|CustomsCost || '''string''' || Таможенная стоимость || 1989792.00<br />
|-<br />
|InvoicedCost || '''string''' || Фактурная стоимость || 1989792.00<br />
|-<br />
|ContractCurrencyCode || '''string''' || Валюта контракта || RUB<br />
|-<br />
|sborSum || '''string''' || Сумма таможенных сборов || 30000.00<br />
|-<br />
|poshSum || '''string''' || Сумма таможенных пошлин || 1989792.00<br />
|-<br />
|ndsSum || '''string''' || Сумма НДС || 1989792.00<br />
|-<br />
|akcizSum || '''string''' || Сумма акциза || 1989792.00<br />
|-<br />
|platSum || '''string''' || Сумма платежей || 1989792.00<br />
|-<br />
|REGNUM || '''string''' || Номер ДТ || 10000000/010121/0123456 <br />
|-<br />
|PackageNumber || '''string''' || Кол-во мест || <br />
|-<br />
|GoodsCount || '''string''' || Кол-во товаров || 1<br />
|-<br />
|BorderCustoms || '''string''' || Код поста гр.29 || 10000000<br />
|-<br />
|UD || '''string''' || Код поста гр.30 || 10000000<br />
|-<br />
|UDName || '''string''' || Наименование поста гр.30 || ФТС России<br />
|-<br />
|CustomsProcedure || '''string''' || Режим || ИМ<br />
|-<br />
|CustomsModeCode || '''string''' || Процедура || 40<br />
|-<br />
|DeclarationKind || '''string''' || Особенности процедуры || ПТД<br />
|}<br />
<br />
=== Наименования статусов ===<br />
{| class="wikitable"<br />
|1 || Открытие процедуры<br />
|-<br />
|2 || Присвоен номер<br />
|-<br />
|3 || Идет проверка<br />
|-<br />
|4 || Идет досмотр<br />
|-<br />
|5 || Проверка закончена<br />
|-<br />
|6 || Условно выпущена<br />
|-<br />
|7 || Выпуск разрешен<br />
|-<br />
|10 || Отказано в выпуске<br />
|-<br />
|11 || Товар прибыл (ПТД)<br />
|-<br />
|12 || Выпуск с обеспечением<br />
|-<br />
|13 || Отзыв<br />
|-<br />
|14 || Считается не поданной<br />
|-<br />
|15 || Выпуск приостановлен<br />
|-<br />
|17 || Частично выпущена<br />
|-<br />
|26 || Выпуск под обеспечение<br />
|-<br />
|27 || Идет осмотр<br />
|-<br />
|28 || Идет экспертиза<br />
|-<br />
|8192 || Отказано в приеме<br />
|-<br />
|16384 || Переход на "бумагу"<br />
|-<br />
|32768 || Запрошен отзыв<br />
|}<br />
<br />
=== Получение, Печать документа, Просмотр документа ===<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
=== Получение полей (заголовки столбцов) ===<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов вынесли в отдельный запрос<br />
<br />
=== Получение вложенных документов из графы 44 ===<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
=== Получение тела документа 44. Печать в html ===<br />
<br />
Запрос похож на предыдущий, добавляем только спереди ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Ответные параметры ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|MessageType || '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|Priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|Incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456<br />
|-<br />
|EnvelopeID || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|SoftVersion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ParticipantID || '''string''' || ID декларанта <br />
|-<br />
|CustomsCode || '''string''' || Код таможни сообщения || <br />
|-<br />
|InitialEnvelopeID || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|PreparationDateTime || '''string''' || Дата и время сообщения || <br />
|-<br />
|ExchType || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|ProccessID || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|SenderInformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|ReceiverInformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|Sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|ArchID || '''string''' || ID архива таможни || <br />
|-<br />
|ArchDocID || '''string''' || ID документа в архиве таможни || <br />
|}<br />
<br />
запрос также проверяет доступ к ИНН, если не прописан доступ к ИНН, то вернет ошибку<br />
<br />
=== Получение сообщения. ===<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен. <br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения.<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%AD%D0%94_%D0%9C%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80_2&diff=1328
ЭД Монитор 2
2023-10-27T10:48:20Z
<p>Vetoshkin: </p>
<hr />
<div>Монитор Электронного Декларирования 2 (далее Монитор ЭД) - средство, входящее в состав ГТД сервера, которое позволяет получать информацию о статусе документов ГТД участвующих в процессе электронного декларирования. Это новая версия ЭД Монитора основанная на Web.<br />
<br />
К ЭД монитору принадлежат следующие файлы<br />
<br />
EdMon2GUI.exe - программа настройки ЭД монитор 2.<br />
<br />
EdMon2GUI.log - log файл событий программы настройки ЭД монитор 2.<br />
<br />
EdMon2GUI.elf - журнал критических ошибок программы настройки ЭД монитор 2.<br />
<br />
edmonsrvc2.exe - служба-сервер ЭД монитор 2. В своем составе содержит HTTP сервер.<br />
<br />
edmonsrvc2.log - log файл событий службы-сервер ЭД монитор 2.<br />
<br />
edmonsrvc2.elf - журнал критических ошибок службы-сервер ЭД монитор 2.<br />
<br />
EdMon2.ini - фиксированные настройки ЭД монитор 2.<br />
<br />
webserv.vmonitor.dat - файл данных для службы-сервер<br />
<br />
iniedmon2.json - файл пользовательских настроек<br />
<br />
ВАЖНО! При возникновении проблем с работой программы требуется написать письмо в тех.поддержку Альта-Софт с кратким описанием проблемы (ошибки), указать версию программы ЭД монитор 2 и приложить к письму файлы edmonsrvc2.log, iniedmon2.json, edmonsrvc2.elf (если такой имеется).<br />
<br />
==Основные сведения==<br />
ЭД Монитор 2 фактически состоит из двух модуле: программа первичной настройки (GUI) и службы-сервер, которая выступает посредником между браузером и данными MS SQL.<br />
<br />
Типичное окно первичной настройки ЭД Монитор 2 изображено на следующем рисунке<br />
<br />
<br />
[[Файл:EdMon2GUIView.png]]<br />
<br />
<br />
Здесь можно:<br />
<br />
- выбрать MS SQL сервера<br />
<br />
- выбрать базы данных<br />
<br />
- задать логин/пароль для доступа<br />
<br />
- проверить связь с сервером<br />
<br />
- задать порт для доступа из браузера к службе<br />
<br />
- установить, удалить, запустить службу ЭД Монитора 2<br />
<br />
- сохранить настройки<br />
<br />
==Общие принципы работы==<br />
После запуска службы доступ к монитору можно получить из любого Web браузера. Для перехода на страницу авторизации монитора, можно в программе первичной настройки нажать кнопку '''Открыть в браузере''' или открыть браузер и в строке адреса и ввести '''сервер:порт/vmonitor/'''.<br />
<br />
Появится страница авторизации, на которой надо ввести логин пароль (по умолчанию admin|admin) и нажать '''Войти в кабинет'''.<br />
<br />
Появится главное окно ЭД Монитора 2.<br />
<br />
[[Файл:EdMon2WebGeneral.png]] <br />
<br />
<br />
Мониторы, которые находятся в разработке или являются недоступными для вашей лицензии, отображаются неактивными.<br />
<br />
Кликнув по нужному монитору, можно в него зайти.<br />
<br />
Например вот так выглядит '''Монитор руководителя'''.<br />
<br />
[[Файл:EdMon2WebMonRuck.png]]<br />
<br />
==Описание API==<br />
=== Авторизация ===<br />
Для доступа к функциям ядра необходимо предварительно авторизоваться. Для стандартного монитора это происходит через окно авторизации. Но можно произвести авторизацию и вручную своим скриптом. Вот пример авторизации на javascript.<br />
<br />
var tmp = {};<br />
tmp['login'] = 'admin';<br />
tmp['pass'] = 'admin';<br />
<br />
$.ajax({<br />
url: "http://localhost:80/auth.json",<br />
dataType: "text",<br />
data: $.toJSON(tmp),<br />
type: "POST",<br />
cache:false,<br />
crossDomain: true,<br />
xhrFields: {withCredentials: true},<br />
timeout:5000,<br />
success: function(dtn, textStatus, jqXHR) {<br />
data = JSON.parse(dtn);<br />
if (data['message'] !== undefined)<br />
alert(data['message']['title'] + '\n' + data['message']['text']);<br />
},<br />
error: function(XMLHttpRequest, textStatus, errorThrown) {<br />
alert('Ошибка.\n' + errorThrown);<br />
},<br />
complete: function() {<br />
}<br />
});<br />
<br />
Здесь в виде ajax запроса передается json структура с логином и паролем. После прихода ответа его надот проанализировать. Если в ответе есть поле 'message', то значит при авторизации происходит какая то ошибка.<br />
<br />
=== Получение APIKEY и секретного слова ===<br />
Для получения ключа и секретного слова, которые могут использоваться для доступа к API функциям монитора, необходимо зайти в настройки пользователей ЭД монитора. Там необходимо нажать кнопку '''Добавить''' (рядом с надписью "API ключ"). Появится API ключ и секретное слово. Необходимо их запомнить (записать), для дальнейшего использования.<br />
API ключ и секретное слово отображаются только один раз до сохранения настроек. Если ключ и слово утеряны, то придется генерировать их заново.<br />
<br />
[[Файл:Edmonapikey1.png]] [[Файл:Edmonapikey2.png]]<br />
<br />
=== Использование APIKEY и секретного слова для доступа к API функциям ===<br />
Используется двойное хэширование ключа и передаваемых параметров в URL строке. Ниже приведен пример формирования hash суммы параметров при отправке запроса request_gtd_status.<br />
<br />
$("#btget").on("click", function() {<br />
var params = {};<br />
params['from'] = "15.11.2020";<br />
params['to'] = "20.11.2020";<br />
$.toJSON(params);<br />
var apikey, salt;<br />
apikey = 'C188E85AA4C770EC32FD1426';<br />
salt = 'FCCE90';<br />
var p;<br />
p = 'apikey=' + apikey + '&a=3&b=5';<br />
var md5;<br />
md5 = $.md5(p);<br />
md5 = md5 + salt;<br />
md5 = $.md5(md5);<br />
p = p + '&hash=' + md5;<br />
$.ajax({<br />
url: "request_gtd_status.json?" + p,<br />
dataType: "json",<br />
type: "POST",<br />
data: $.toJSON(params),<br />
cache:false,<br />
success: function(data) {<br />
alert(JSON.stringify(data));<br />
},<br />
error: function(XMLHttpRequest, textStatus, errorThrown) {<br />
alert("Ошибка.\n" + errorThrown);<br />
},<br />
complete: function() {<br />
}<br />
});<br />
});<br />
<br />
=== Получение данных ===<br />
После авторизации появляется возможность взаимодействовать с ядром монитора для получения данных из базы данных. Для этого используется скриптовый метод. Для начала необходимо создать некоторый js файл в котором описана функция для формирования строки SQL запроса. Например его содержимое может быть следующим...<br />
function gtdstat(from, to) {<br />
var tmp = {};<br />
tmp['sqlstr'] = "select * from [dbo].[Docs] where [moddate] between '" + from + "' and '" + to + "'";<br />
return JSON.stringify(tmp);<br />
}<br />
Функция принимает два параметра (диапазон дат). В результате формируется строка запроса с получением всех данных из таблицы Docs в заданном диапазоне дат для поля MODDATE. Этот файл нужно положить в папку WebServ\scriptsql\ ГТД Сервера. Т.е. должно получиться так WebServ\scriptsql\getstat.js.<br />
Запрос данных тогда будет выглядеть следующим образом.<br />
<br />
$("#bttest").on("click", function() {<br />
var apikey, salt;<br />
apikey = 'C188E85AA4C770EC32FD1426';<br />
salt = 'FCCE90';<br />
var p;<br />
p = 'apikey=' + apikey;<br />
var md5;<br />
md5 = $.md5(p);<br />
md5 = md5 + salt;<br />
md5 = $.md5(md5);<br />
p = p + '&hash=' + md5;<br />
var params = {};<br />
params['scriptfunc'] = "gtdstat";<br />
params['scriptval'] = {};<br />
params['scriptval']['0'] = '20210101'; // from<br />
params['scriptval']['1'] = '20210501'; // to<br />
<br />
$.ajax({<br />
url: "getdata.json?" + p,<br />
dataType: "json",<br />
type: "POST",<br />
data: $.toJSON(params),<br />
cache:false,<br />
success: function(data) {<br />
alert(JSON.stringify(data));<br />
},<br />
error: function(XMLHttpRequest, textStatus, errorThrown) {<br />
alert("Ошибка.\n" + errorThrown);<br />
},<br />
complete: function() {<br />
}<br />
});<br />
});<br />
В даном примере используется API ключ для доступа. Запрашивается скриптовая функция, которую ранее мы описали в файле getstat.js и передаваемые в неё параметры.<br />
В ответе будет получен json файл с данными.<br />
<br />
<br />
[[Категория:ГТД-Сервер]]<br />
[[Категория:ЭД-2]]<br />
[[Категория:Web-Сервисы]]<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1324
API для сервиса report.alta.ru
2023-08-17T07:00:38Z
<p>Vetoshkin: /* Объект doc */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ<br />
# Получение документов гр.44 (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10T10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10T10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
из выдачи убрали заголовки столбцов, для их получения есть запрос апи <code>/docs/fields/</code><br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
<br />
==== Объект doc ====<br />
<br />
{| class="wikitable"<br />
!messagetype || '''string''' || Тип текущего сообщения с ДТ || CMN.11023<br />
|-<br />
|login || '''string''' || Catchall Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин СВД || 123456-01<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID текущего сообщения с ДТ || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|status || '''string''' || Статус процедуры в числовом виде || 3<br />
|-<br />
|softver || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ProccessID || '''string''' || ID процедуры || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|LastMessageDate || '''string''' || Дата последнего сообщения по процедуре || <br />
|-<br />
|DeclarantOrganizationName || '''string''' || Наименование организациии || ООО \"Альта-Софт\"<br />
|-<br />
|DeclarantINN || '''string''' || ИНН декларанта || 1234567890<br />
|-<br />
|DeclarantOGRN || '''string''' || ОГРН декларанта || <br />
|-<br />
|DeclarantFIO || '''string''' || ФИО декларанта из гр.54 || <br />
|-<br />
|consignorName || '''string''' || Отправитель || <br />
|-<br />
|consignorAddres || '''string''' || Адрес отправителя || <br />
|-<br />
|consigneeName || '''string''' || Получатель || <br />
|-<br />
|consigneeAddres || '''string''' || Адрес получателя || <br />
|-<br />
|sellerName || '''string''' || Продавец (ДТС) || <br />
|-<br />
|Transp || '''string''' || Номера транспортных средств || <br />
|-<br />
|Contract || '''string''' || Номер контракта || <br />
|-<br />
|TrDoc || '''string''' || Номер транспортных документов || <br />
|-<br />
|Cont || '''string''' || Номера контейнеров <br />
|-<br />
|NetWeightQuantity || '''string''' || Нетто || 20160.00<br />
|-<br />
|GrossWeightQuantity || '''string''' || Брутто || 20640.00<br />
|-<br />
|CustomsCost || '''string''' || Таможенная стоимость || 1989792.00<br />
|-<br />
|InvoicedCost || '''string''' || Фактурная стоимость || 1989792.00<br />
|-<br />
|ContractCurrencyCode || '''string''' || Валюта контракта || RUB<br />
|-<br />
|sborSum || '''string''' || Сумма таможенных сборов || 30000.00<br />
|-<br />
|poshSum || '''string''' || Сумма таможенных пошлин || 1989792.00<br />
|-<br />
|ndsSum || '''string''' || Сумма НДС || 1989792.00<br />
|-<br />
|akcizSum || '''string''' || Сумма акциза || 1989792.00<br />
|-<br />
|REGNUM || '''string''' || Номер ДТ || 10000000/010121/0123456 <br />
|-<br />
|PackageNumber || '''string''' || Кол-во мест || <br />
|-<br />
|GoodsCount || '''string''' || Кол-во товаров || 1<br />
|-<br />
|UD || '''string''' || Код поста гр.30 || 10000000<br />
|-<br />
|UDName || '''string''' || Наименование поста гр.30 || ФТС России<br />
|-<br />
|CustomsProcedure || '''string''' || Режим || ИМ<br />
|-<br />
|CustomsModeCode || '''string''' || Процедура || 40<br />
|-<br />
|DeclarationKind || '''string''' || Особенности процедуры || ПТД<br />
|}<br />
<br />
=== Наименования статусов ===<br />
{| class="wikitable"<br />
|1 || Открытие процедуры<br />
|-<br />
|2 || Присвоен номер<br />
|-<br />
|3 || Идет проверка<br />
|-<br />
|4 || Идет досмотр<br />
|-<br />
|5 || Проверка закончена<br />
|-<br />
|6 || Условно выпущена<br />
|-<br />
|7 || Выпуск разрешен<br />
|-<br />
|10 || Отказано в выпуске<br />
|-<br />
|11 || Товар прибыл (ПТД)<br />
|-<br />
|12 || Выпуск с обеспечением<br />
|-<br />
|13 || Отзыв<br />
|-<br />
|14 || Считается не поданной<br />
|-<br />
|15 || Выпуск приостановлен<br />
|-<br />
|17 || Частично выпущена<br />
|-<br />
|26 || Выпуск под обеспечение<br />
|-<br />
|27 || Идет осмотр<br />
|-<br />
|28 || Идет экспертиза<br />
|-<br />
|8192 || Отказано в приеме<br />
|-<br />
|16384 || Переход на "бумагу"<br />
|-<br />
|32768 || Запрошен отзыв<br />
|}<br />
<br />
=== Получение, Печать документа, Просмотр документа ===<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
=== Получение полей (заголовки столбцов) ===<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов вынесли в отдельный запрос<br />
<br />
=== Получение вложенных документов из графы 44 ===<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
=== Получение тела документа 44. Печать в html ===<br />
<br />
Запрос похож на предыдущий, добавляем только спереди ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Ответные параметры ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|MessageType || '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|Priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|Incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456<br />
|-<br />
|EnvelopeID || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|SoftVersion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ParticipantID || '''string''' || ID декларанта <br />
|-<br />
|CustomsCode || '''string''' || Код таможни сообщения || <br />
|-<br />
|InitialEnvelopeID || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|PreparationDateTime || '''string''' || Дата и время сообщения || <br />
|-<br />
|ExchType || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|ProccessID || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|SenderInformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|ReceiverInformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|Sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|ArchID || '''string''' || ID архива таможни || <br />
|-<br />
|ArchDocID || '''string''' || ID документа в архиве таможни || <br />
|}<br />
<br />
запрос также проверяет доступ к ИНН, если не прописан доступ к ИНН, то вернет ошибку<br />
<br />
=== Получение сообщения. ===<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен. <br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения.<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1323
API для сервиса report.alta.ru
2023-08-17T06:59:40Z
<p>Vetoshkin: /* Объект doc */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ<br />
# Получение документов гр.44 (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10T10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10T10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
из выдачи убрали заголовки столбцов, для их получения есть запрос апи <code>/docs/fields/</code><br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
<br />
==== Объект doc ====<br />
<br />
{| class="wikitable"<br />
!messagetype || '''string''' || Тип текущего сообщения с ДТ || CMN.11023<br />
|-<br />
|login || '''string''' || Catchall Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин СВД || 123456-01<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID текущего сообщения с ДТ || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|status || '''string''' || Статус процедуры в числовом виде || 3<br />
|-<br />
|softver || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ProccessID || '''string''' || ID процедуры || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|LastMessageDate || '''string''' || Дата последнего сообщения по процедуре || <br />
|-<br />
|DeclarantOrganizationName || '''string''' || Наименование организациии || ООО \"Альта-Софт\"<br />
|-<br />
|DeclarantINN || '''string''' || ИНН декларанта || 1234567890<br />
|-<br />
|DeclarantOGRN || '''string''' || ОГРН декларанта || <br />
|-<br />
|DeclarantFIO || '''string''' || ФИО декларанта из гр.54 || <br />
|-<br />
|consignorName || '''string''' || Отправитель || <br />
|-<br />
|consignorAddres || '''string''' || Адрес отправителя || <br />
|-<br />
|consigneeName || '''string''' || Получатель || <br />
|-<br />
|consigneeAddres || '''string''' || Адрес получателя || <br />
|-<br />
|Transp || '''string''' || Номера транспортных средств || <br />
|-<br />
|Contract || '''string''' || Номер контракта || <br />
|-<br />
|TrDoc || '''string''' || Номер транспортных документов || <br />
|-<br />
|Cont || '''string''' || Номера контейнеров <br />
|-<br />
|NetWeightQuantity || '''string''' || Нетто || 20160.00<br />
|-<br />
|GrossWeightQuantity || '''string''' || Брутто || 20640.00<br />
|-<br />
|CustomsCost || '''string''' || Таможенная стоимость || 1989792.00<br />
|-<br />
|InvoicedCost || '''string''' || Фактурная стоимость || 1989792.00<br />
|-<br />
|ContractCurrencyCode || '''string''' || Валюта контракта || RUB<br />
|-<br />
|sborSum || '''string''' || Сумма таможенных сборов || 30000.00<br />
|-<br />
|poshSum || '''string''' || Сумма таможенных пошлин || 1989792.00<br />
|-<br />
|ndsSum || '''string''' || Сумма НДС || 1989792.00<br />
|-<br />
|akcizSum || '''string''' || Сумма акциза || 1989792.00<br />
|-<br />
|REGNUM || '''string''' || Номер ДТ || 10000000/010121/0123456 <br />
|-<br />
|PackageNumber || '''string''' || Кол-во мест || <br />
|-<br />
|GoodsCount || '''string''' || Кол-во товаров || 1<br />
|-<br />
|UD || '''string''' || Код поста гр.30 || 10000000<br />
|-<br />
|UDName || '''string''' || Наименование поста гр.30 || ФТС России<br />
|-<br />
|CustomsProcedure || '''string''' || Режим || ИМ<br />
|-<br />
|CustomsModeCode || '''string''' || Процедура || 40<br />
|-<br />
|DeclarationKind || '''string''' || Особенности процедуры || ПТД<br />
|}<br />
<br />
=== Наименования статусов ===<br />
{| class="wikitable"<br />
|1 || Открытие процедуры<br />
|-<br />
|2 || Присвоен номер<br />
|-<br />
|3 || Идет проверка<br />
|-<br />
|4 || Идет досмотр<br />
|-<br />
|5 || Проверка закончена<br />
|-<br />
|6 || Условно выпущена<br />
|-<br />
|7 || Выпуск разрешен<br />
|-<br />
|10 || Отказано в выпуске<br />
|-<br />
|11 || Товар прибыл (ПТД)<br />
|-<br />
|12 || Выпуск с обеспечением<br />
|-<br />
|13 || Отзыв<br />
|-<br />
|14 || Считается не поданной<br />
|-<br />
|15 || Выпуск приостановлен<br />
|-<br />
|17 || Частично выпущена<br />
|-<br />
|26 || Выпуск под обеспечение<br />
|-<br />
|27 || Идет осмотр<br />
|-<br />
|28 || Идет экспертиза<br />
|-<br />
|8192 || Отказано в приеме<br />
|-<br />
|16384 || Переход на "бумагу"<br />
|-<br />
|32768 || Запрошен отзыв<br />
|}<br />
<br />
=== Получение, Печать документа, Просмотр документа ===<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
=== Получение полей (заголовки столбцов) ===<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов вынесли в отдельный запрос<br />
<br />
=== Получение вложенных документов из графы 44 ===<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
=== Получение тела документа 44. Печать в html ===<br />
<br />
Запрос похож на предыдущий, добавляем только спереди ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Ответные параметры ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|MessageType || '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|Priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|Incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456<br />
|-<br />
|EnvelopeID || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|SoftVersion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ParticipantID || '''string''' || ID декларанта <br />
|-<br />
|CustomsCode || '''string''' || Код таможни сообщения || <br />
|-<br />
|InitialEnvelopeID || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|PreparationDateTime || '''string''' || Дата и время сообщения || <br />
|-<br />
|ExchType || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|ProccessID || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|SenderInformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|ReceiverInformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|Sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|ArchID || '''string''' || ID архива таможни || <br />
|-<br />
|ArchDocID || '''string''' || ID документа в архиве таможни || <br />
|}<br />
<br />
запрос также проверяет доступ к ИНН, если не прописан доступ к ИНН, то вернет ошибку<br />
<br />
=== Получение сообщения. ===<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен. <br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения.<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1322
API для сервиса report.alta.ru
2023-08-10T15:08:37Z
<p>Vetoshkin: /* Получение документов */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ<br />
# Получение документов гр.44 (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10T10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10T10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20T10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
из выдачи убрали заголовки столбцов, для их получения есть запрос апи <code>/docs/fields/</code><br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
<br />
==== Объект doc ====<br />
<br />
{| class="wikitable"<br />
!messagetype || '''string''' || Тип текущего сообщения с ДТ || CMN.11023<br />
|-<br />
|login || '''string''' || Catchall Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин СВД || 123456-01<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID текущего сообщения с ДТ || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|status || '''string''' || Статус процедуры в числовом виде || 3<br />
|-<br />
|softver || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ProccessID || '''string''' || ID процедуры || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|LastMessageDate || '''string''' || Дата последнего сообщения по процедуре || <br />
|-<br />
|DeclarantOrganizationName || '''string''' || Наименование организациии || ООО \"Альта-Софт\"<br />
|-<br />
|DeclarantINN || '''string''' || ИНН декларанта || 1234567890<br />
|-<br />
|DeclarantOGRN || '''string''' || ОГРН декларанта || <br />
|-<br />
|DeclarantFIO || '''string''' || ФИО декларанта из гр.54 || <br />
|-<br />
|consignorName || '''string''' || Отправитель || <br />
|-<br />
|consignorAddres || '''string''' || Адрес отправителя || <br />
|-<br />
|consigneeName || '''string''' || Получатель || <br />
|-<br />
|consigneeAddres || '''string''' || Адрес получателя || <br />
|-<br />
|Transp || '''string''' || Номера транспортных средств || <br />
|-<br />
|TrDoc || '''string''' || Номер транспортных документов || <br />
|-<br />
|Cont || '''string''' || Номера контейнеров <br />
|-<br />
|NetWeightQuantity || '''string''' || Нетто || 20160.00<br />
|-<br />
|GrossWeightQuantity || '''string''' || Брутто || 20640.00<br />
|-<br />
|CustomsCost || '''string''' || Таможенная стоимость || 1989792.00<br />
|-<br />
|InvoicedCost || '''string''' || Фактурная стоимость || 1989792.00<br />
|-<br />
|ContractCurrencyCode || '''string''' || Валюта контракта || RUB<br />
|-<br />
|REGNUM || '''string''' || Номер ДТ || 10000000/010121/0123456 <br />
|-<br />
|PackageNumber || '''string''' || Кол-во мест || <br />
|-<br />
|GoodsCount || '''string''' || Кол-во товаров || 1<br />
|-<br />
|UD || '''string''' || Код поста гр.30 || 10000000<br />
|-<br />
|UDName || '''string''' || Наименование поста гр.30 || ФТС России<br />
|-<br />
|CustomsProcedure || '''string''' || Режим || ИМ<br />
|-<br />
|CustomsModeCode || '''string''' || Процедура || 40<br />
|-<br />
|DeclarationKind || '''string''' || Особенности процедуры || ПТД<br />
|}<br />
<br />
=== Наименования статусов ===<br />
{| class="wikitable"<br />
|1 || Открытие процедуры<br />
|-<br />
|2 || Присвоен номер<br />
|-<br />
|3 || Идет проверка<br />
|-<br />
|4 || Идет досмотр<br />
|-<br />
|5 || Проверка закончена<br />
|-<br />
|6 || Условно выпущена<br />
|-<br />
|7 || Выпуск разрешен<br />
|-<br />
|10 || Отказано в выпуске<br />
|-<br />
|11 || Товар прибыл (ПТД)<br />
|-<br />
|12 || Выпуск с обеспечением<br />
|-<br />
|13 || Отзыв<br />
|-<br />
|14 || Считается не поданной<br />
|-<br />
|15 || Выпуск приостановлен<br />
|-<br />
|17 || Частично выпущена<br />
|-<br />
|26 || Выпуск под обеспечение<br />
|-<br />
|27 || Идет осмотр<br />
|-<br />
|28 || Идет экспертиза<br />
|-<br />
|8192 || Отказано в приеме<br />
|-<br />
|16384 || Переход на "бумагу"<br />
|-<br />
|32768 || Запрошен отзыв<br />
|}<br />
<br />
=== Получение, Печать документа, Просмотр документа ===<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
=== Получение полей (заголовки столбцов) ===<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов вынесли в отдельный запрос<br />
<br />
=== Получение вложенных документов из графы 44 ===<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
=== Получение тела документа 44. Печать в html ===<br />
<br />
Запрос похож на предыдущий, добавляем только спереди ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Ответные параметры ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|MessageType || '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|Priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|Incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456<br />
|-<br />
|EnvelopeID || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|SoftVersion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ParticipantID || '''string''' || ID декларанта <br />
|-<br />
|CustomsCode || '''string''' || Код таможни сообщения || <br />
|-<br />
|InitialEnvelopeID || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|PreparationDateTime || '''string''' || Дата и время сообщения || <br />
|-<br />
|ExchType || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|ProccessID || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|SenderInformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|ReceiverInformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|Sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|ArchID || '''string''' || ID архива таможни || <br />
|-<br />
|ArchDocID || '''string''' || ID документа в архиве таможни || <br />
|}<br />
<br />
запрос также проверяет доступ к ИНН, если не прописан доступ к ИНН, то вернет ошибку<br />
<br />
=== Получение сообщения. ===<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен. <br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения.<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1321
API для сервиса report.alta.ru
2023-07-24T12:28:20Z
<p>Vetoshkin: /* Объект doc */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ<br />
# Получение документов гр.44 (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10Т10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20Т10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10Т10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20Т10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
из выдачи убрали заголовки столбцов, для их получения есть запрос апи <code>/docs/fields/</code><br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
<br />
==== Объект doc ====<br />
<br />
{| class="wikitable"<br />
!messagetype || '''string''' || Тип текущего сообщения с ДТ || CMN.11023<br />
|-<br />
|login || '''string''' || Catchall Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин СВД || 123456-01<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID текущего сообщения с ДТ || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|status || '''string''' || Статус процедуры в числовом виде || 3<br />
|-<br />
|softver || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ProccessID || '''string''' || ID процедуры || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|LastMessageDate || '''string''' || Дата последнего сообщения по процедуре || <br />
|-<br />
|DeclarantOrganizationName || '''string''' || Наименование организациии || ООО \"Альта-Софт\"<br />
|-<br />
|DeclarantINN || '''string''' || ИНН декларанта || 1234567890<br />
|-<br />
|DeclarantOGRN || '''string''' || ОГРН декларанта || <br />
|-<br />
|DeclarantFIO || '''string''' || ФИО декларанта из гр.54 || <br />
|-<br />
|consignorName || '''string''' || Отправитель || <br />
|-<br />
|consignorAddres || '''string''' || Адрес отправителя || <br />
|-<br />
|consigneeName || '''string''' || Получатель || <br />
|-<br />
|consigneeAddres || '''string''' || Адрес получателя || <br />
|-<br />
|Transp || '''string''' || Номера транспортных средств || <br />
|-<br />
|TrDoc || '''string''' || Номер транспортных документов || <br />
|-<br />
|Cont || '''string''' || Номера контейнеров <br />
|-<br />
|NetWeightQuantity || '''string''' || Нетто || 20160.00<br />
|-<br />
|GrossWeightQuantity || '''string''' || Брутто || 20640.00<br />
|-<br />
|CustomsCost || '''string''' || Таможенная стоимость || 1989792.00<br />
|-<br />
|InvoicedCost || '''string''' || Фактурная стоимость || 1989792.00<br />
|-<br />
|ContractCurrencyCode || '''string''' || Валюта контракта || RUB<br />
|-<br />
|REGNUM || '''string''' || Номер ДТ || 10000000/010121/0123456 <br />
|-<br />
|PackageNumber || '''string''' || Кол-во мест || <br />
|-<br />
|GoodsCount || '''string''' || Кол-во товаров || 1<br />
|-<br />
|UD || '''string''' || Код поста гр.30 || 10000000<br />
|-<br />
|UDName || '''string''' || Наименование поста гр.30 || ФТС России<br />
|-<br />
|CustomsProcedure || '''string''' || Режим || ИМ<br />
|-<br />
|CustomsModeCode || '''string''' || Процедура || 40<br />
|-<br />
|DeclarationKind || '''string''' || Особенности процедуры || ПТД<br />
|}<br />
<br />
=== Наименования статусов ===<br />
{| class="wikitable"<br />
|1 || Открытие процедуры<br />
|-<br />
|2 || Присвоен номер<br />
|-<br />
|3 || Идет проверка<br />
|-<br />
|4 || Идет досмотр<br />
|-<br />
|5 || Проверка закончена<br />
|-<br />
|6 || Условно выпущена<br />
|-<br />
|7 || Выпуск разрешен<br />
|-<br />
|10 || Отказано в выпуске<br />
|-<br />
|11 || Товар прибыл (ПТД)<br />
|-<br />
|12 || Выпуск с обеспечением<br />
|-<br />
|13 || Отзыв<br />
|-<br />
|14 || Считается не поданной<br />
|-<br />
|15 || Выпуск приостановлен<br />
|-<br />
|17 || Частично выпущена<br />
|-<br />
|26 || Выпуск под обеспечение<br />
|-<br />
|27 || Идет осмотр<br />
|-<br />
|28 || Идет экспертиза<br />
|-<br />
|8192 || Отказано в приеме<br />
|-<br />
|16384 || Переход на "бумагу"<br />
|-<br />
|32768 || Запрошен отзыв<br />
|}<br />
<br />
=== Получение, Печать документа, Просмотр документа ===<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
=== Получение полей (заголовки столбцов) ===<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов вынесли в отдельный запрос<br />
<br />
=== Получение вложенных документов из графы 44 ===<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
=== Получение тела документа 44. Печать в html ===<br />
<br />
Запрос похож на предыдущий, добавляем только спереди ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Ответные параметры ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|MessageType || '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|Priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|Incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456<br />
|-<br />
|EnvelopeID || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|SoftVersion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ParticipantID || '''string''' || ID декларанта <br />
|-<br />
|CustomsCode || '''string''' || Код таможни сообщения || <br />
|-<br />
|InitialEnvelopeID || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|PreparationDateTime || '''string''' || Дата и время сообщения || <br />
|-<br />
|ExchType || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|ProccessID || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|SenderInformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|ReceiverInformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|Sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|ArchID || '''string''' || ID архива таможни || <br />
|-<br />
|ArchDocID || '''string''' || ID документа в архиве таможни || <br />
|}<br />
<br />
запрос также проверяет доступ к ИНН, если не прописан доступ к ИНН, то вернет ошибку<br />
<br />
=== Получение сообщения. ===<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен. <br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения.<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1320
API для сервиса report.alta.ru
2023-07-24T12:27:54Z
<p>Vetoshkin: /* Объект doc */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ<br />
# Получение документов гр.44 (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10Т10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20Т10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10Т10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20Т10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
из выдачи убрали заголовки столбцов, для их получения есть запрос апи <code>/docs/fields/</code><br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
<br />
==== Объект doc ====<br />
<br />
{| class="wikitable"<br />
!messagetype || '''string''' || Тип текущего сообщения с ДТ || CMN.11023<br />
|-<br />
|login || '''string''' || Логин || 123456-ca<br />
|-<br />
|svdlogin || '''string''' || Логин СВД || 123456-01<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID текущего сообщения с ДТ || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|status || '''string''' || Статус процедуры в числовом виде || 3<br />
|-<br />
|softver || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ProccessID || '''string''' || ID процедуры || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|LastMessageDate || '''string''' || Дата последнего сообщения по процедуре || <br />
|-<br />
|DeclarantOrganizationName || '''string''' || Наименование организациии || ООО \"Альта-Софт\"<br />
|-<br />
|DeclarantINN || '''string''' || ИНН декларанта || 1234567890<br />
|-<br />
|DeclarantOGRN || '''string''' || ОГРН декларанта || <br />
|-<br />
|DeclarantFIO || '''string''' || ФИО декларанта из гр.54 || <br />
|-<br />
|consignorName || '''string''' || Отправитель || <br />
|-<br />
|consignorAddres || '''string''' || Адрес отправителя || <br />
|-<br />
|consigneeName || '''string''' || Получатель || <br />
|-<br />
|consigneeAddres || '''string''' || Адрес получателя || <br />
|-<br />
|Transp || '''string''' || Номера транспортных средств || <br />
|-<br />
|TrDoc || '''string''' || Номер транспортных документов || <br />
|-<br />
|Cont || '''string''' || Номера контейнеров <br />
|-<br />
|NetWeightQuantity || '''string''' || Нетто || 20160.00<br />
|-<br />
|GrossWeightQuantity || '''string''' || Брутто || 20640.00<br />
|-<br />
|CustomsCost || '''string''' || Таможенная стоимость || 1989792.00<br />
|-<br />
|InvoicedCost || '''string''' || Фактурная стоимость || 1989792.00<br />
|-<br />
|ContractCurrencyCode || '''string''' || Валюта контракта || RUB<br />
|-<br />
|REGNUM || '''string''' || Номер ДТ || 10000000/010121/0123456 <br />
|-<br />
|PackageNumber || '''string''' || Кол-во мест || <br />
|-<br />
|GoodsCount || '''string''' || Кол-во товаров || 1<br />
|-<br />
|UD || '''string''' || Код поста гр.30 || 10000000<br />
|-<br />
|UDName || '''string''' || Наименование поста гр.30 || ФТС России<br />
|-<br />
|CustomsProcedure || '''string''' || Режим || ИМ<br />
|-<br />
|CustomsModeCode || '''string''' || Процедура || 40<br />
|-<br />
|DeclarationKind || '''string''' || Особенности процедуры || ПТД<br />
|}<br />
<br />
=== Наименования статусов ===<br />
{| class="wikitable"<br />
|1 || Открытие процедуры<br />
|-<br />
|2 || Присвоен номер<br />
|-<br />
|3 || Идет проверка<br />
|-<br />
|4 || Идет досмотр<br />
|-<br />
|5 || Проверка закончена<br />
|-<br />
|6 || Условно выпущена<br />
|-<br />
|7 || Выпуск разрешен<br />
|-<br />
|10 || Отказано в выпуске<br />
|-<br />
|11 || Товар прибыл (ПТД)<br />
|-<br />
|12 || Выпуск с обеспечением<br />
|-<br />
|13 || Отзыв<br />
|-<br />
|14 || Считается не поданной<br />
|-<br />
|15 || Выпуск приостановлен<br />
|-<br />
|17 || Частично выпущена<br />
|-<br />
|26 || Выпуск под обеспечение<br />
|-<br />
|27 || Идет осмотр<br />
|-<br />
|28 || Идет экспертиза<br />
|-<br />
|8192 || Отказано в приеме<br />
|-<br />
|16384 || Переход на "бумагу"<br />
|-<br />
|32768 || Запрошен отзыв<br />
|}<br />
<br />
=== Получение, Печать документа, Просмотр документа ===<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
=== Получение полей (заголовки столбцов) ===<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов вынесли в отдельный запрос<br />
<br />
=== Получение вложенных документов из графы 44 ===<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
=== Получение тела документа 44. Печать в html ===<br />
<br />
Запрос похож на предыдущий, добавляем только спереди ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Ответные параметры ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|MessageType || '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|Priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|Incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456<br />
|-<br />
|EnvelopeID || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|SoftVersion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ParticipantID || '''string''' || ID декларанта <br />
|-<br />
|CustomsCode || '''string''' || Код таможни сообщения || <br />
|-<br />
|InitialEnvelopeID || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|PreparationDateTime || '''string''' || Дата и время сообщения || <br />
|-<br />
|ExchType || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|ProccessID || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|SenderInformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|ReceiverInformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|Sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|ArchID || '''string''' || ID архива таможни || <br />
|-<br />
|ArchDocID || '''string''' || ID документа в архиве таможни || <br />
|}<br />
<br />
запрос также проверяет доступ к ИНН, если не прописан доступ к ИНН, то вернет ошибку<br />
<br />
=== Получение сообщения. ===<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен. <br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения.<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1312
API для сервиса report.alta.ru
2023-05-22T14:01:34Z
<p>Vetoshkin: /* Наименования статусов */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ<br />
# Получение документов гр.44 (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10Т10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20Т10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10Т10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20Т10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
из выдачи убрали заголовки столбцов, для их получения есть запрос апи <code>/docs/fields/</code><br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
<br />
==== Объект doc ====<br />
<br />
{| class="wikitable"<br />
!messagetype || '''string''' || Тип текущего сообщения с ДТ || CMN.11023<br />
|-<br />
|login || '''string''' || Логин || 123456<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID текущего сообщения с ДТ || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|status || '''string''' || Статус процедуры в числовом виде || 3<br />
|-<br />
|softver || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ProccessID || '''string''' || ID процедуры || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|LastMessageDate || '''string''' || Дата последнего сообщения по процедуре || <br />
|-<br />
|DeclarantOrganizationName || '''string''' || Наименование организациии || ООО \"Альта-Софт\"<br />
|-<br />
|DeclarantINN || '''string''' || ИНН декларанта || 1234567890<br />
|-<br />
|DeclarantOGRN || '''string''' || ОГРН декларанта || <br />
|-<br />
|DeclarantFIO || '''string''' || ФИО декларанта из гр.54 || <br />
|-<br />
|consignorName || '''string''' || Отправитель || <br />
|-<br />
|consignorAddres || '''string''' || Адрес отправителя || <br />
|-<br />
|consigneeName || '''string''' || Получатель || <br />
|-<br />
|consigneeAddres || '''string''' || Адрес получателя || <br />
|-<br />
|Transp || '''string''' || Номера транспортных средств || <br />
|-<br />
|TrDoc || '''string''' || Номер транспортных документов || <br />
|-<br />
|Cont || '''string''' || Номера контейнеров <br />
|-<br />
|NetWeightQuantity || '''string''' || Нетто || 20160.00<br />
|-<br />
|GrossWeightQuantity || '''string''' || Брутто || 20640.00<br />
|-<br />
|CustomsCost || '''string''' || Таможенная стоимость || 1989792.00<br />
|-<br />
|InvoicedCost || '''string''' || Фактурная стоимость || 1989792.00<br />
|-<br />
|ContractCurrencyCode || '''string''' || Валюта контракта || RUB<br />
|-<br />
|REGNUM || '''string''' || Номер ДТ || 10000000/010121/0123456 <br />
|-<br />
|PackageNumber || '''string''' || Кол-во мест || <br />
|-<br />
|GoodsCount || '''string''' || Кол-во товаров || 1<br />
|-<br />
|UD || '''string''' || Код поста гр.30 || 10000000<br />
|-<br />
|UDName || '''string''' || Наименование поста гр.30 || ФТС России<br />
|-<br />
|CustomsProcedure || '''string''' || Режим || ИМ<br />
|-<br />
|CustomsModeCode || '''string''' || Процедура || 40<br />
|-<br />
|DeclarationKind || '''string''' || Особенности процедуры || ПТД<br />
|}<br />
<br />
=== Наименования статусов ===<br />
{| class="wikitable"<br />
|1 || Открытие процедуры<br />
|-<br />
|2 || Присвоен номер<br />
|-<br />
|3 || Идет проверка<br />
|-<br />
|4 || Идет досмотр<br />
|-<br />
|5 || Проверка закончена<br />
|-<br />
|6 || Условно выпущена<br />
|-<br />
|7 || Выпуск разрешен<br />
|-<br />
|10 || Отказано в выпуске<br />
|-<br />
|11 || Товар прибыл (ПТД)<br />
|-<br />
|12 || Выпуск с обеспечением<br />
|-<br />
|13 || Отзыв<br />
|-<br />
|14 || Считается не поданной<br />
|-<br />
|15 || Выпуск приостановлен<br />
|-<br />
|17 || Частично выпущена<br />
|-<br />
|26 || Выпуск под обеспечение<br />
|-<br />
|27 || Идет осмотр<br />
|-<br />
|28 || Идет экспертиза<br />
|-<br />
|8192 || Отказано в приеме<br />
|-<br />
|16384 || Переход на "бумагу"<br />
|-<br />
|32768 || Запрошен отзыв<br />
|}<br />
<br />
=== Получение, Печать документа, Просмотр документа ===<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
=== Получение полей (заголовки столбцов) ===<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов вынесли в отдельный запрос<br />
<br />
=== Получение вложенных документов из графы 44 ===<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
=== Получение тела документа 44. Печать в html ===<br />
<br />
Запрос похож на предыдущий, добавляем только спереди ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Ответные параметры ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|MessageType || '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|Priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|Incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456<br />
|-<br />
|EnvelopeID || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|SoftVersion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ParticipantID || '''string''' || ID декларанта <br />
|-<br />
|CustomsCode || '''string''' || Код таможни сообщения || <br />
|-<br />
|InitialEnvelopeID || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|PreparationDateTime || '''string''' || Дата и время сообщения || <br />
|-<br />
|ExchType || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|ProccessID || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|SenderInformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|ReceiverInformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|Sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|ArchID || '''string''' || ID архива таможни || <br />
|-<br />
|ArchDocID || '''string''' || ID документа в архиве таможни || <br />
|}<br />
<br />
запрос также проверяет доступ к ИНН, если не прописан доступ к ИНН, то вернет ошибку<br />
<br />
=== Получение сообщения. ===<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен. <br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения.<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1311
API для сервиса report.alta.ru
2023-05-22T14:00:26Z
<p>Vetoshkin: /* Объект doc */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ<br />
# Получение документов гр.44 (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10Т10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20Т10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10Т10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20Т10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
из выдачи убрали заголовки столбцов, для их получения есть запрос апи <code>/docs/fields/</code><br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
<br />
==== Объект doc ====<br />
<br />
{| class="wikitable"<br />
!messagetype || '''string''' || Тип текущего сообщения с ДТ || CMN.11023<br />
|-<br />
|login || '''string''' || Логин || 123456<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID текущего сообщения с ДТ || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|status || '''string''' || Статус процедуры в числовом виде || 3<br />
|-<br />
|softver || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ProccessID || '''string''' || ID процедуры || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|LastMessageDate || '''string''' || Дата последнего сообщения по процедуре || <br />
|-<br />
|DeclarantOrganizationName || '''string''' || Наименование организациии || ООО \"Альта-Софт\"<br />
|-<br />
|DeclarantINN || '''string''' || ИНН декларанта || 1234567890<br />
|-<br />
|DeclarantOGRN || '''string''' || ОГРН декларанта || <br />
|-<br />
|DeclarantFIO || '''string''' || ФИО декларанта из гр.54 || <br />
|-<br />
|consignorName || '''string''' || Отправитель || <br />
|-<br />
|consignorAddres || '''string''' || Адрес отправителя || <br />
|-<br />
|consigneeName || '''string''' || Получатель || <br />
|-<br />
|consigneeAddres || '''string''' || Адрес получателя || <br />
|-<br />
|Transp || '''string''' || Номера транспортных средств || <br />
|-<br />
|TrDoc || '''string''' || Номер транспортных документов || <br />
|-<br />
|Cont || '''string''' || Номера контейнеров <br />
|-<br />
|NetWeightQuantity || '''string''' || Нетто || 20160.00<br />
|-<br />
|GrossWeightQuantity || '''string''' || Брутто || 20640.00<br />
|-<br />
|CustomsCost || '''string''' || Таможенная стоимость || 1989792.00<br />
|-<br />
|InvoicedCost || '''string''' || Фактурная стоимость || 1989792.00<br />
|-<br />
|ContractCurrencyCode || '''string''' || Валюта контракта || RUB<br />
|-<br />
|REGNUM || '''string''' || Номер ДТ || 10000000/010121/0123456 <br />
|-<br />
|PackageNumber || '''string''' || Кол-во мест || <br />
|-<br />
|GoodsCount || '''string''' || Кол-во товаров || 1<br />
|-<br />
|UD || '''string''' || Код поста гр.30 || 10000000<br />
|-<br />
|UDName || '''string''' || Наименование поста гр.30 || ФТС России<br />
|-<br />
|CustomsProcedure || '''string''' || Режим || ИМ<br />
|-<br />
|CustomsModeCode || '''string''' || Процедура || 40<br />
|-<br />
|DeclarationKind || '''string''' || Особенности процедуры || ПТД<br />
|}<br />
<br />
=== Наименования статусов ===<br />
{| class="wikitable"<br />
|1 || Открытие процедуры<br />
|-<br />
|2 || Присвоен номер<br />
|-<br />
|3 || Идет проверка<br />
|-<br />
|4 || Идет досмотр<br />
|-<br />
|5 || Проверка закончена<br />
|-<br />
|6 || Условно выпущена<br />
|-<br />
|7 || Выпуск разрешен<br />
|-<br />
|10 || Отказано в выпуске<br />
|-<br />
|11 || Товар прибыл (ПТД)<br />
|-<br />
|12 || Выпуск с обеспечением<br />
|-<br />
|13 || Отзыв<br />
|-<br />
|14 || Считается не поданной<br />
|-<br />
|15 || Выпуск приостановлен<br />
|-<br />
|17 || Частично выпущена<br />
|-<br />
|26 || Выпуск под обеспечение<br />
|-<br />
|27 || Идет осмотр<br />
|-<br />
|8192 || Отказано в приеме<br />
|-<br />
|16384 || Переход на "бумагу"<br />
|-<br />
|32768 || Запрошен отзыв<br />
|}<br />
<br />
=== Получение, Печать документа, Просмотр документа ===<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
=== Получение полей (заголовки столбцов) ===<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов вынесли в отдельный запрос<br />
<br />
=== Получение вложенных документов из графы 44 ===<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
=== Получение тела документа 44. Печать в html ===<br />
<br />
Запрос похож на предыдущий, добавляем только спереди ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Ответные параметры ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|MessageType || '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|Priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|Incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456<br />
|-<br />
|EnvelopeID || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|SoftVersion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ParticipantID || '''string''' || ID декларанта <br />
|-<br />
|CustomsCode || '''string''' || Код таможни сообщения || <br />
|-<br />
|InitialEnvelopeID || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|PreparationDateTime || '''string''' || Дата и время сообщения || <br />
|-<br />
|ExchType || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|ProccessID || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|SenderInformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|ReceiverInformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|Sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|ArchID || '''string''' || ID архива таможни || <br />
|-<br />
|ArchDocID || '''string''' || ID документа в архиве таможни || <br />
|}<br />
<br />
запрос также проверяет доступ к ИНН, если не прописан доступ к ИНН, то вернет ошибку<br />
<br />
=== Получение сообщения. ===<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен. <br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения.<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1310
API для сервиса report.alta.ru
2023-04-14T09:01:31Z
<p>Vetoshkin: /* Получение сообщения. Печать в html */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ<br />
# Получение документов гр.44 (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10Т10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20Т10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10Т10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20Т10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
из выдачи убрали заголовки столбцов, для их получения есть запрос апи <code>/docs/fields/</code><br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
<br />
==== Объект doc ====<br />
<br />
{| class="wikitable"<br />
!messagetype || '''string''' || Тип текущего сообщения с ДТ || CMN.11023<br />
|-<br />
|login || '''string''' || Логин || 123456<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID текущего сообщения с ДТ || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|status || '''string''' || Статус процедуры в числовом виде || 3<br />
|-<br />
|softver || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ProccessID || '''string''' || ID процедуры || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|LastMessageDate || '''string''' || Дата последнего сообщения по процедуре || <br />
|-<br />
|DeclarantOrganizationName || '''string''' || Наименование организациии || ООО \"Альта-Софт\"<br />
|-<br />
|DeclarantINN || '''string''' || ИНН декларанта || 1234567890<br />
|-<br />
|DeclarantOGRN || '''string''' || ОГРН декларанта || <br />
|-<br />
|DeclarantFIO || '''string''' || ФИО декларанта из гр.54 || <br />
|-<br />
|consignorName || '''string''' || Отправитель || <br />
|-<br />
|consignorAddres || '''string''' || Адрес отправителя || <br />
|-<br />
|consigneeName || '''string''' || Получатель || <br />
|-<br />
|consigneeAddres || '''string''' || Адрес получателя || <br />
|-<br />
|Transp || '''string''' || Номера транспортных средств || <br />
|-<br />
|TrDoc || '''string''' || Номер транспортных документов || <br />
|-<br />
|Cont || '''string''' || Номера контейнеров <br />
|-<br />
|NetWeightQuantity || '''string''' || Нетто || 20160.00<br />
|-<br />
|GrossWeightQuantity || '''string''' || Брутто || 20640.00<br />
|-<br />
|CustomsCost || '''string''' || Таможенная стоимость || 1989792.00<br />
|-<br />
|InvoicedCost || '''string''' || Фактурная стоимость || 1989792.00<br />
|-<br />
|ContractCurrencyCode || '''string''' || Валюта контракта || RUB<br />
|-<br />
|REGNUM || '''string''' || Номер ДТ || 10000000/010121/0123456 <br />
|-<br />
|PackageNumber || '''string''' || Кол-во мест || <br />
|-<br />
|GoodsCount || '''string''' || Кол-во товаров || 1<br />
|-<br />
|UD || '''string''' || Код поста гр.30 || <br />
|-<br />
|CustomsProcedure || '''string''' || Режим || ИМ<br />
|-<br />
|CustomsModeCode || '''string''' || Процедура || 40<br />
|-<br />
|DeclarationKind || '''string''' || Особенности процедуры || ПТД<br />
|}<br />
<br />
=== Наименования статусов ===<br />
{| class="wikitable"<br />
|1 || Открытие процедуры<br />
|-<br />
|2 || Присвоен номер<br />
|-<br />
|3 || Идет проверка<br />
|-<br />
|4 || Идет досмотр<br />
|-<br />
|5 || Проверка закончена<br />
|-<br />
|6 || Условно выпущена<br />
|-<br />
|7 || Выпуск разрешен<br />
|-<br />
|10 || Отказано в выпуске<br />
|-<br />
|11 || Товар прибыл (ПТД)<br />
|-<br />
|12 || Выпуск с обеспечением<br />
|-<br />
|13 || Отзыв<br />
|-<br />
|14 || Считается не поданной<br />
|-<br />
|15 || Выпуск приостановлен<br />
|-<br />
|17 || Частично выпущена<br />
|-<br />
|26 || Выпуск под обеспечение<br />
|-<br />
|27 || Идет осмотр<br />
|-<br />
|8192 || Отказано в приеме<br />
|-<br />
|16384 || Переход на "бумагу"<br />
|-<br />
|32768 || Запрошен отзыв<br />
|}<br />
<br />
=== Получение, Печать документа, Просмотр документа ===<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
=== Получение полей (заголовки столбцов) ===<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов вынесли в отдельный запрос<br />
<br />
=== Получение вложенных документов из графы 44 ===<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
=== Получение тела документа 44. Печать в html ===<br />
<br />
Запрос похож на предыдущий, добавляем только спереди ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Ответные параметры ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|MessageType || '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|Priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|Incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456<br />
|-<br />
|EnvelopeID || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|SoftVersion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ParticipantID || '''string''' || ID декларанта <br />
|-<br />
|CustomsCode || '''string''' || Код таможни сообщения || <br />
|-<br />
|InitialEnvelopeID || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|PreparationDateTime || '''string''' || Дата и время сообщения || <br />
|-<br />
|ExchType || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|ProccessID || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|SenderInformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|ReceiverInformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|Sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|ArchID || '''string''' || ID архива таможни || <br />
|-<br />
|ArchDocID || '''string''' || ID документа в архиве таможни || <br />
|}<br />
<br />
запрос также проверяет доступ к ИНН, если не прописан доступ к ИНН, то вернет ошибку<br />
<br />
=== Получение сообщения. ===<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение по умолчанию в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен. <br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения.<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=API_%D0%B4%D0%BB%D1%8F_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0_report.alta.ru&diff=1309
API для сервиса report.alta.ru
2023-04-14T08:59:39Z
<p>Vetoshkin: /* Получение, Печать документа, Просмотр документа */</p>
<hr />
<div>== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==<br />
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:<br />
<br />
# Список логинов, к пользователю может быть прикреплено много логинов<br />
# Декларанты, таможенные посты<br />
# Получение ДТ<br />
# Получение документов гр.44 (если включено дублирование всех сообщений)<br />
# Получение ЭД сообщений<br />
<br />
== Описание параметров ==<br />
Доступ к API предоставляется по URL https://report.alta.ru/api/<br />
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете<br />
<br />
Пример адреса запроса с параметрами:<br />
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY<br />
<br />
любой запрос должен содержать '''обязательные''' параметры, они выделены жирным<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|colspan="4" | Обязательные, должны быть в любом запросе<br />
|-<br />
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1<br />
|-<br />
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam<br />
|-<br />
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45<br />
|-<br />
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456<br />
|}<br />
<br />
К необязательным параметрам относится, например, параметр0<br />
Параметр0 идет сразу после функции, его можно опустить, и не писать, тогда ставим слеш после функции и дописываем обязательные параметры ключ и хэш, пример:<br />
<br />
<code>/api/v1/docs/?apikey=XXX&hash=YYY</code><br />
<br />
Параметр0 указываем для получения конкретного документа, пример:<br />
<br />
<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code><br />
<br />
'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,<br />
ХЭШ генерируется так:<br />
<br />
<br />
hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))<br />
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют <br />
пример, запрос:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code><br />
<br />
в данном случае ВСЕ_ПАРАМЕТРЫ это x y z <br />
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777<br />
тогда вычислим хэш:<br />
<br />
<br />
hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =<br />
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =<br />
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''<br />
<br />
== Список всех функций API ==<br />
Для наглядности опустим тут обязательную часть запроса, оставим только конкретику<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code><br />
<br />
=== Получение логинов ===<br />
<code>/logins/</code><br />
<br />
Ответом получаем массив с логинами<br />
<br />
=== Получение декларантов === <br />
<code>/decl/</code><br />
<br />
получаем массив с ИНН и названиями организаций<br />
<br />
=== Получение таможенных постов === <br />
<code>/tam/</code><br />
<br />
Получаем массив таможенных постов<br />
<br />
=== Получение документов ===<br />
<br />
<code>/docs/</code> <br />
<br />
фильтры, передаются как ПАРАМЕТРЫ запроса, пример:<br />
<br />
<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code><br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|regdate[from] || '''string''' || дата регистрации от<br/>только дата || regdate[from]=2019-03-01<br />
|-<br />
|regdate[to] || '''string''' || дата регистрации до<br/>только дата || regdate[to]=2019-03-01<br />
|-<br />
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08<br/>vypdate[from]=2021-10-10Т10:30:00<br />
|-<br />
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08<br/>vypdate[to]=2021-10-20Т10:30:00+03:00<br />
|-<br />
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08<br/>lastmsgdate[from]=2021-10-10Т10:30:00<br />
|-<br />
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01<br/>lastmsgdate[to]=2021-10-20Т10:30:00+03:00<br />
|-<br />
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555<br/>decl[]=666666<br />
|-<br />
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555<br />
|-<br />
|login || '''array''' || Логин, можно несколько || login[]=xxx<br />
|-<br />
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..<br />
|}<br />
<br />
В ответ получаем документы<br />
<br />
{| class="wikitable"<br />
|docs || '''array''' || массив документов || <br />
|}<br />
<br />
из выдачи убрали заголовки столбцов, для их получения есть запрос апи <code>/docs/fields/</code><br />
<br />
==== Массив docs ====<br />
<br />
Это массив документов, содержит в себе объект doc<br />
<br />
==== Объект doc ====<br />
<br />
{| class="wikitable"<br />
!messagetype || '''string''' || Тип текущего сообщения с ДТ || CMN.11023<br />
|-<br />
|login || '''string''' || Логин || 123456<br />
|-<br />
|envelopeid || '''string''' || EnvelopeID текущего сообщения с ДТ || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|status || '''string''' || Статус процедуры в числовом виде || 3<br />
|-<br />
|softver || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ProccessID || '''string''' || ID процедуры || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|LastMessageDate || '''string''' || Дата последнего сообщения по процедуре || <br />
|-<br />
|DeclarantOrganizationName || '''string''' || Наименование организациии || ООО \"Альта-Софт\"<br />
|-<br />
|DeclarantINN || '''string''' || ИНН декларанта || 1234567890<br />
|-<br />
|DeclarantOGRN || '''string''' || ОГРН декларанта || <br />
|-<br />
|DeclarantFIO || '''string''' || ФИО декларанта из гр.54 || <br />
|-<br />
|consignorName || '''string''' || Отправитель || <br />
|-<br />
|consignorAddres || '''string''' || Адрес отправителя || <br />
|-<br />
|consigneeName || '''string''' || Получатель || <br />
|-<br />
|consigneeAddres || '''string''' || Адрес получателя || <br />
|-<br />
|Transp || '''string''' || Номера транспортных средств || <br />
|-<br />
|TrDoc || '''string''' || Номер транспортных документов || <br />
|-<br />
|Cont || '''string''' || Номера контейнеров <br />
|-<br />
|NetWeightQuantity || '''string''' || Нетто || 20160.00<br />
|-<br />
|GrossWeightQuantity || '''string''' || Брутто || 20640.00<br />
|-<br />
|CustomsCost || '''string''' || Таможенная стоимость || 1989792.00<br />
|-<br />
|InvoicedCost || '''string''' || Фактурная стоимость || 1989792.00<br />
|-<br />
|ContractCurrencyCode || '''string''' || Валюта контракта || RUB<br />
|-<br />
|REGNUM || '''string''' || Номер ДТ || 10000000/010121/0123456 <br />
|-<br />
|PackageNumber || '''string''' || Кол-во мест || <br />
|-<br />
|GoodsCount || '''string''' || Кол-во товаров || 1<br />
|-<br />
|UD || '''string''' || Код поста гр.30 || <br />
|-<br />
|CustomsProcedure || '''string''' || Режим || ИМ<br />
|-<br />
|CustomsModeCode || '''string''' || Процедура || 40<br />
|-<br />
|DeclarationKind || '''string''' || Особенности процедуры || ПТД<br />
|}<br />
<br />
=== Наименования статусов ===<br />
{| class="wikitable"<br />
|1 || Открытие процедуры<br />
|-<br />
|2 || Присвоен номер<br />
|-<br />
|3 || Идет проверка<br />
|-<br />
|4 || Идет досмотр<br />
|-<br />
|5 || Проверка закончена<br />
|-<br />
|6 || Условно выпущена<br />
|-<br />
|7 || Выпуск разрешен<br />
|-<br />
|10 || Отказано в выпуске<br />
|-<br />
|11 || Товар прибыл (ПТД)<br />
|-<br />
|12 || Выпуск с обеспечением<br />
|-<br />
|13 || Отзыв<br />
|-<br />
|14 || Считается не поданной<br />
|-<br />
|15 || Выпуск приостановлен<br />
|-<br />
|17 || Частично выпущена<br />
|-<br />
|26 || Выпуск под обеспечение<br />
|-<br />
|27 || Идет осмотр<br />
|-<br />
|8192 || Отказано в приеме<br />
|-<br />
|16384 || Переход на "бумагу"<br />
|-<br />
|32768 || Запрошен отзыв<br />
|}<br />
<br />
=== Получение, Печать документа, Просмотр документа ===<br />
<br />
Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса по умолчанию идет в html виде<br />
<br />
<code>/docs/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code><br />
<br />
'''также можно передать дополнительные параметры'''<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|format || '''string''' || Формат ответа (html, xml, pdf) || format=xml<br />
|}<br />
<br />
=== Получение полей (заголовки столбцов) ===<br />
<br />
<code>/docs/fields/</code><br />
<br />
получение полей, заголовков столбцов вынесли в отдельный запрос<br />
<br />
=== Получение вложенных документов из графы 44 ===<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
'''также можно передать дополнительные параметры - фильтры'''<br />
<br />
у каждого документа, есть вложенные документы, у документа может быть очень много записей в этом параметре, <br />
поэтому также есть фильтр по вложенным документам <br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031<br />
|-<br />
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/<br />
|-<br />
|docDate[from] || '''string''' || Дата от || 2018-01-01<br />
|-<br />
|docDate[to] || '''string''' || Дата до || 2019-05-08<br />
|-<br />
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1</br>tovNum[]=40<br />
|}<br />
<br />
в ответ получаем массив с документами<br />
<br />
{| class="wikitable"<br />
|docName || '''string''' || имя документа <br />
|-<br />
|docCode || '''string''' || Код документа <br />
|-<br />
|docDate || '''string''' || Дата документа <br />
|-<br />
|tovNum || '''string''' || Товары, их номера <br />
|-<br />
|elDocId || '''string''' || ID документа в архиве таможни <br />
|-<br />
|docNum || '''string''' || Номер документа <br />
|-<br />
|elArchId || '''string''' || ID архива таможни <br />
|}<br />
<br />
=== Получение тела документа 44. Печать в html ===<br />
<br />
Запрос похож на предыдущий, добавляем только спереди ID документа в архиве таможни<br />
<br />
<code>/docs44/ID/</code><br />
<br />
, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
=== Получение сообщений ===<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
ProccessID и Login обязательны<br />
<br />
дополнительные параметры для запроса:<br />
<br />
{| class="wikitable"<br />
!Параметр || '''Тип''' || Описание || Пример<br />
|-<br />
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01<br />
|-<br />
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01<br />
|}<br />
<br />
==== Ответные параметры ====<br />
<br />
в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения<br />
<br />
{| class="wikitable"<br />
|messages || array || массив с сообщениями <br />
|}<br />
<br />
сообщение message, элемент этого массива, структура:<br />
<br />
{| class="wikitable"<br />
|MessageType || '''string''' || Тип сообщения || CMN.11001<br />
|-<br />
|Priority || '''string''' || Служебное поле в заголовке сообщения || 4<br />
|-<br />
|Incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1<br />
|-<br />
|login || '''string''' || Логин || 123456<br />
|-<br />
|EnvelopeID || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD<br />
|-<br />
|SoftVersion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21<br />
|-<br />
|ParticipantID || '''string''' || ID декларанта <br />
|-<br />
|CustomsCode || '''string''' || Код таможни сообщения || <br />
|-<br />
|InitialEnvelopeID || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) || <br />
|-<br />
|PreparationDateTime || '''string''' || Дата и время сообщения || <br />
|-<br />
|ExchType || '''string''' || Служебное поле в заголовке сообщения || 19200<br />
|-<br />
|ProccessID || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1<br />
|-<br />
|SenderInformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway<br />
|-<br />
|ReceiverInformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as<br />
|-<br />
|Sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА<br />
|-<br />
|canView || '''string''' || 1 – возможен ли просмотр сообщения || <br />
|-<br />
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) || <br />
|-<br />
|ArchID || '''string''' || ID архива таможни || <br />
|-<br />
|ArchDocID || '''string''' || ID документа в архиве таможни || <br />
|}<br />
<br />
запрос также проверяет доступ к ИНН, если не прописан доступ к ИНН, то вернет ошибку<br />
<br />
=== Получение сообщения. Печать в html ===<br />
<br />
Запрос похож на предыдущий, добавляется только EnvelopeID<br />
<br />
<code>/messages/ID/</code><br />
<br />
, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456<br />
<br />
EnvelopeID, ProccessID и Login обязательны<br />
<br />
возвращается сообщение в html виде<br />
<br />
если сообщение содержит несколько документов, то все они будут склеены в один html <br />
<br />
НО разделены комментариями <nowiki><!-- next doc --> </nowiki><br />
<br />
лучше показывать каждый документ отдельно, т.к. иногда бывает, что у документов пересекаются стили и они могут выглядеть некорректно, т.к. при склеивании html склеивается тело и стили. Пример как это выглядит:<br />
<br />
<source lang="xml"><br />
<br />
<!-- count 2 --><br />
<!-- id=172987F4-A741-4A71-9780-AE28A38031E4 --><br />
<!DOCTYPE html ....<br />
html.... тело документа со всеми стилями<br />
<!-- NEXT DOC --><br />
<!-- id=2ACB2210-F7E7-4AB0-A2BD-10533FE4FBE4 --><br />
<!DOCTYPE html ....<br />
html.... тут следующее тело со стилями<br />
</source><br />
<br />
надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа<br />
<br />
<br />
== Типы данных ==<br />
<br />
{| class="wikitable"<br />
|'''string''' || строковый параметр <br />
|-<br />
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов <br />
|-<br />
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов <br />
|}<br />
<br />
== Ошибки ==<br />
<br />
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.<br />
При работе с сервисом возможны следующие ошибки:<br />
<br />
{| class="wikitable"<br />
!Код || Описание<br />
|-<br />
|'''100''' || Нет обязательных параметров <br />
|-<br />
|'''200''' || АПИ ключ не найден или не действительный<br />
|-<br />
|'''201''' || Неверный хэш<br />
|-<br />
|'''202''' || Ошибка авторизации, обратитесь к администратору <br />
|-<br />
|'''204''' || Нет права выполнять эту операцию(запрос)<br />
|-<br />
|'''203''' || Слишком много запросов. Запрос отклонен. <br />
|-<br />
|'''300''' || Метод API не найден, возможно неверная версия АПИ<br />
|-<br />
|'''301''' || В запросе(методе) отсутствует необходимый параметр<br />
|-<br />
| || Строка запроса содержит синтаксическую ошибку<br />
|-<br />
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения.<br />
|}<br />
<br />
пример ошибок<br />
<br />
<source lang='json'><br />
{<br />
"error": 200,<br />
"text": "BAD api key, USER not found"<br />
}<br />
{<br />
"error": 201,<br />
"text": "ERROR HASH"<br />
}<br />
{<br />
"error": 203,<br />
"q": "v1/decl/",<br />
"request_wait": 3.05,<br />
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"<br />
} <br />
</source><br />
<br />
== Примеры реализации простого клиента ==<br />
<br />
=== простой клиент на питоне ===<br />
<br />
на питоне 2.7, надо установить библиотеку pip install requests<br />
<br />
<source lang="Python"><br />
apikey = "api_key" # ваш ключ апи<br />
secret = "secret" # ваш секрет апи<br />
v = 1 # версия<br />
func = "docs" # вызываемая функция<br />
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/<br />
# доп параметры запроса<br />
params = {<br />
'd': '123',<br />
'param1': 'xxxxx',<br />
'param2': 'yyyyyy'<br />
}<br />
# урл для запроса<br />
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")<br />
<br />
if __name__ == "__main__":<br />
# рассчитываем хэш секрет для запроса<br />
# идем по всем параметрам по порядку<br />
str = ""<br />
for p in params:<br />
str += params[p]<br />
print p, params[p]<br />
# и в конце прибавляем ключ<br />
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())<br />
# считаем хэш<br />
hash = hashlib.md5(str).hexdigest()<br />
# добавляем эти параметры в запрос<br />
params['hash'] = hash # + "1111"<br />
params['apikey'] = apikey<br />
print str, hash, api_url<br />
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос<br />
r = requests.get(api_url, params, verify=False)<br />
# выдаем ответ<br />
if r.status_code != 200:<br />
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content<br />
else:<br />
print "ОТВЕТ", r.content<br />
</source><br />
<br />
<br />
<br />
[[Категория:Автоматизация]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9F%D0%B5%D1%81%D0%BE%D1%87%D0%BD%D0%B8%D1%86%D0%B0&diff=495
Песочница
2013-02-22T13:58:20Z
<p>Vetoshkin: /* Второй тест */</p>
<hr />
<div>== Тест раздел1 ==<br />
<br />
авплдваолп ваодплваодопл <br />
<br />
323263<br />
м247983247<br />
<br />
== Второй тест ==<br />
<br />
Основная статья об [[Второй раздел, песочницы|песочнице]]<br />
<br />
== Второй тест ==<br />
<br />
В песочнице живут маленькие песочные черви (с)Ф.Хереберт "Дюна"<br />
<br />
== Второй тест ==<br />
<br />
В песочнице можно прятать лимоны (с)Группа "Дюна"<br />
<br />
<div style='margin:0px 50px;'><br />
<br />
<div style='background:#fff;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(7deg);-ms-transform:rotate(7deg); /* IE 9 */-moz-transform:rotate(7deg); /* Firefox */-webkit-transform:rotate(7deg); /* Safari and Chrome */-o-transform:rotate(7deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
<div style='background:#fff;position:relative;top:-500px;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(15deg);-ms-transform:rotate(15deg); /* IE 9 */-moz-transform:rotate(15deg); /* Firefox */-webkit-transform:rotate(15deg); /* Safari and Chrome */-o-transform:rotate(15deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
</div><br />
<br />
[[#Тест раздел1]]<br />
<br />
[[Категория:Альта-ГТД]]<br />
[[Категория:Тест]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9F%D0%B5%D1%81%D0%BE%D1%87%D0%BD%D0%B8%D1%86%D0%B0&diff=494
Песочница
2013-02-22T13:58:09Z
<p>Vetoshkin: /* Второй тест */</p>
<hr />
<div>== Тест раздел1 ==<br />
<br />
авплдваолп ваодплваодопл <br />
<br />
323263<br />
м247983247<br />
<br />
== Второй тест ==<br />
<br />
Основная статья об [[Второй раздел, песочницы|песочнице]]<br />
<br />
== Второй тест ==<br />
<br />
В песочнице живут маленькие песочные черви (с)Ф.Хереберт "Дюна"<br />
<br />
== Второй тест ==<br />
<br />
В песочнице можно прятать лимоны (с)Группа "Дюна"<br />
<br />
<div style='margin:0px 50px;'><br />
<br />
<div style='background:#fff;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(7deg);-ms-transform:rotate(7deg); /* IE 9 */-moz-transform:rotate(7deg); /* Firefox */-webkit-transform:rotate(7deg); /* Safari and Chrome */-o-transform:rotate(7deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
<div style='background:#fff;position:relative;top:-500px;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(15deg);-ms-transform:rotate(15deg); /* IE 9 */-moz-transform:rotate(15deg); /* Firefox */-webkit-transform:rotate(15deg); /* Safari and Chrome */-o-transform:rotate(15deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
</div><br />
<br />
[[#.D0.92.D1.82.D0.BE.D1.80.D0.BE.D0.B9_.D1.82.D0.B5.D1.81.D1.82]]<br />
<br />
[[#Тест раздел1]]<br />
<br />
[[Категория:Альта-ГТД]]<br />
[[Категория:Тест]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9F%D0%B5%D1%81%D0%BE%D1%87%D0%BD%D0%B8%D1%86%D0%B0&diff=493
Песочница
2013-02-22T13:57:45Z
<p>Vetoshkin: /* Второй тест */</p>
<hr />
<div>== Тест раздел1 ==<br />
<br />
авплдваолп ваодплваодопл <br />
<br />
323263<br />
м247983247<br />
<br />
== Второй тест ==<br />
<br />
Основная статья об [[Второй раздел, песочницы|песочнице]]<br />
<br />
== Второй тест ==<br />
<br />
В песочнице живут маленькие песочные черви (с)Ф.Хереберт "Дюна"<br />
<br />
== Второй тест ==<br />
<br />
В песочнице можно прятать лимоны (с)Группа "Дюна"<br />
<br />
<div style='margin:0px 50px;'><br />
<br />
<div style='background:#fff;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(7deg);-ms-transform:rotate(7deg); /* IE 9 */-moz-transform:rotate(7deg); /* Firefox */-webkit-transform:rotate(7deg); /* Safari and Chrome */-o-transform:rotate(7deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
<div style='background:#fff;position:relative;top:-500px;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(15deg);-ms-transform:rotate(15deg); /* IE 9 */-moz-transform:rotate(15deg); /* Firefox */-webkit-transform:rotate(15deg); /* Safari and Chrome */-o-transform:rotate(15deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
</div><br />
<br />
[[#.D0.92.D1.82.D0.BE.D1.80.D0.BE.D0.B9_.D1.82.D0.B5.D1.81.D1.82]]<br />
<br />
[[Категория:Альта-ГТД]]<br />
[[Категория:Тест]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9F%D0%B5%D1%81%D0%BE%D1%87%D0%BD%D0%B8%D1%86%D0%B0&diff=492
Песочница
2013-02-22T13:57:20Z
<p>Vetoshkin: /* Второй тест */</p>
<hr />
<div>== Тест раздел1 ==<br />
<br />
авплдваолп ваодплваодопл <br />
<br />
323263<br />
м247983247<br />
<br />
== Второй тест ==<br />
<br />
Основная статья об [[Второй раздел, песочницы|песочнице]]<br />
<br />
== Второй тест ==<br />
<br />
В песочнице живут маленькие песочные черви (с)Ф.Хереберт "Дюна"<br />
<br />
== Второй тест ==<br />
<br />
В песочнице можно прятать лимоны (с)Группа "Дюна"<br />
<br />
<div style='margin:0px 50px;'><br />
<br />
<div style='background:#fff;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(7deg);-ms-transform:rotate(7deg); /* IE 9 */-moz-transform:rotate(7deg); /* Firefox */-webkit-transform:rotate(7deg); /* Safari and Chrome */-o-transform:rotate(7deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
<div style='background:#fff;position:relative;top:-500px;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(15deg);-ms-transform:rotate(15deg); /* IE 9 */-moz-transform:rotate(15deg); /* Firefox */-webkit-transform:rotate(15deg); /* Safari and Chrome */-o-transform:rotate(15deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
</div><br />
<br />
[[#.D0.92.D1.82.D0.BE.D1.80.D0.BE.D0.B9_.D1.82.D0.B5.D1.81.D1.82]]<br />
<br />
[[#test]]<br />
<br />
[[#якорь2]]<br />
<br />
[[#asdf]]<br />
<br />
[[#1]]<br />
<br />
<br />
[[Категория:Альта-ГТД]]<br />
[[Категория:Тест]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9F%D0%B5%D1%81%D0%BE%D1%87%D0%BD%D0%B8%D1%86%D0%B0&diff=491
Песочница
2013-02-22T13:54:49Z
<p>Vetoshkin: /* Второй тест */</p>
<hr />
<div>== Тест раздел1 ==<br />
<br />
авплдваолп ваодплваодопл <br />
<br />
323263<br />
м247983247<br />
<br />
== Второй тест ==<br />
<br />
Основная статья об [[Второй раздел, песочницы|песочнице]]<br />
<br />
== Второй тест ==<br />
<br />
В песочнице живут маленькие песочные черви (с)Ф.Хереберт "Дюна"<br />
<br />
{{Песочница|asdf}}<br />
<br />
== Второй тест ==<br />
<br />
В песочнице можно прятать лимоны (с)Группа "Дюна"<br />
<br />
<div style='margin:0px 50px;'><br />
<br />
<div style='background:#fff;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(7deg);-ms-transform:rotate(7deg); /* IE 9 */-moz-transform:rotate(7deg); /* Firefox */-webkit-transform:rotate(7deg); /* Safari and Chrome */-o-transform:rotate(7deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
<div style='background:#fff;position:relative;top:-500px;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(15deg);-ms-transform:rotate(15deg); /* IE 9 */-moz-transform:rotate(15deg); /* Firefox */-webkit-transform:rotate(15deg); /* Safari and Chrome */-o-transform:rotate(15deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
</div><br />
<br />
[[#.D0.92.D1.82.D0.BE.D1.80.D0.BE.D0.B9_.D1.82.D0.B5.D1.81.D1.82]]<br />
<br />
[[#test]]<br />
<br />
[[#якорь2]]<br />
<br />
[[#asdf]]<br />
<br />
[[#1]]<br />
<br />
<br />
[[Категория:Альта-ГТД]]<br />
[[Категория:Тест]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9F%D0%B5%D1%81%D0%BE%D1%87%D0%BD%D0%B8%D1%86%D0%B0&diff=490
Песочница
2013-02-22T13:54:08Z
<p>Vetoshkin: /* Второй тест */</p>
<hr />
<div>== Тест раздел1 ==<br />
<br />
авплдваолп ваодплваодопл <br />
<br />
323263<br />
м247983247<br />
<br />
== Второй тест ==<br />
<br />
Основная статья об [[Второй раздел, песочницы|песочнице]]<br />
<br />
== Второй тест ==<br />
<br />
В песочнице живут маленькие песочные черви (с)Ф.Хереберт "Дюна"<br />
<br />
{{якорь2|asdf}}{{{1}}}<br />
<br />
== Второй тест ==<br />
<br />
В песочнице можно прятать лимоны (с)Группа "Дюна"<br />
<br />
<div style='margin:0px 50px;'><br />
<br />
<div style='background:#fff;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(7deg);-ms-transform:rotate(7deg); /* IE 9 */-moz-transform:rotate(7deg); /* Firefox */-webkit-transform:rotate(7deg); /* Safari and Chrome */-o-transform:rotate(7deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
<div style='background:#fff;position:relative;top:-500px;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(15deg);-ms-transform:rotate(15deg); /* IE 9 */-moz-transform:rotate(15deg); /* Firefox */-webkit-transform:rotate(15deg); /* Safari and Chrome */-o-transform:rotate(15deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
</div><br />
<br />
[[#.D0.92.D1.82.D0.BE.D1.80.D0.BE.D0.B9_.D1.82.D0.B5.D1.81.D1.82]]<br />
<br />
[[#test]]<br />
<br />
[[#якорь2]]<br />
<br />
[[#asdf]]<br />
<br />
[[#1]]<br />
<br />
<br />
[[Категория:Альта-ГТД]]<br />
[[Категория:Тест]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9F%D0%B5%D1%81%D0%BE%D1%87%D0%BD%D0%B8%D1%86%D0%B0&diff=489
Песочница
2013-02-22T13:52:53Z
<p>Vetoshkin: /* Второй тест */</p>
<hr />
<div>== Тест раздел1 ==<br />
<br />
авплдваолп ваодплваодопл <br />
<br />
323263<br />
м247983247<br />
<br />
== Второй тест ==<br />
<br />
Основная статья об [[Второй раздел, песочницы|песочнице]]<br />
<br />
== Второй тест ==<br />
<br />
В песочнице живут маленькие песочные черви (с)Ф.Хереберт "Дюна"<br />
<br />
== Второй тест ==<br />
<br />
В песочнице можно прятать лимоны (с)Группа "Дюна"<br />
<br />
<div style='margin:0px 50px;'><br />
<br />
<div style='background:#fff;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(7deg);-ms-transform:rotate(7deg); /* IE 9 */-moz-transform:rotate(7deg); /* Firefox */-webkit-transform:rotate(7deg); /* Safari and Chrome */-o-transform:rotate(7deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
{{якорь2|asdf}}{{{1}}}<div style='background:#fff;position:relative;top:-500px;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(15deg);-ms-transform:rotate(15deg); /* IE 9 */-moz-transform:rotate(15deg); /* Firefox */-webkit-transform:rotate(15deg); /* Safari and Chrome */-o-transform:rotate(15deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
</div><br />
<br />
[[#.D0.92.D1.82.D0.BE.D1.80.D0.BE.D0.B9_.D1.82.D0.B5.D1.81.D1.82]]<br />
<br />
[[#test]]<br />
<br />
[[#якорь2]]<br />
<br />
[[#asdf]]<br />
<br />
[[#1]]<br />
<br />
<br />
[[Категория:Альта-ГТД]]<br />
[[Категория:Тест]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9F%D0%B5%D1%81%D0%BE%D1%87%D0%BD%D0%B8%D1%86%D0%B0&diff=488
Песочница
2013-02-22T13:52:20Z
<p>Vetoshkin: /* Второй тест */</p>
<hr />
<div>== Тест раздел1 ==<br />
<br />
авплдваолп ваодплваодопл <br />
<br />
323263<br />
м247983247<br />
<br />
== Второй тест ==<br />
<br />
Основная статья об [[Второй раздел, песочницы|песочнице]]<br />
<br />
== Второй тест ==<br />
<br />
В песочнице живут маленькие песочные черви (с)Ф.Хереберт "Дюна"<br />
<br />
== Второй тест ==<br />
<br />
В песочнице можно прятать лимоны (с)Группа "Дюна"<br />
<br />
<div style='margin:0px 50px;'><br />
<br />
<div style='background:#fff;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(7deg);-ms-transform:rotate(7deg); /* IE 9 */-moz-transform:rotate(7deg); /* Firefox */-webkit-transform:rotate(7deg); /* Safari and Chrome */-o-transform:rotate(7deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
{{якорь2|asdf}}<div style='background:#fff;position:relative;top:-500px;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(15deg);-ms-transform:rotate(15deg); /* IE 9 */-moz-transform:rotate(15deg); /* Firefox */-webkit-transform:rotate(15deg); /* Safari and Chrome */-o-transform:rotate(15deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
</div><br />
<br />
[[#.D0.92.D1.82.D0.BE.D1.80.D0.BE.D0.B9_.D1.82.D0.B5.D1.81.D1.82]]<br />
<br />
[[#test]]<br />
<br />
[[#якорь2]]<br />
<br />
[[#asdf]]<br />
<br />
<br />
[[Категория:Альта-ГТД]]<br />
[[Категория:Тест]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9F%D0%B5%D1%81%D0%BE%D1%87%D0%BD%D0%B8%D1%86%D0%B0&diff=487
Песочница
2013-02-22T13:51:05Z
<p>Vetoshkin: /* Второй тест */</p>
<hr />
<div>== Тест раздел1 ==<br />
<br />
авплдваолп ваодплваодопл <br />
<br />
323263<br />
м247983247<br />
<br />
== Второй тест ==<br />
<br />
Основная статья об [[Второй раздел, песочницы|песочнице]]<br />
<br />
== Второй тест ==<br />
<br />
В песочнице живут маленькие песочные черви (с)Ф.Хереберт "Дюна"<br />
<br />
== Второй тест ==<br />
<br />
В песочнице можно прятать лимоны (с)Группа "Дюна"<br />
<br />
<div style='margin:0px 50px;'><br />
<br />
<div style='background:#fff;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(7deg);-ms-transform:rotate(7deg); /* IE 9 */-moz-transform:rotate(7deg); /* Firefox */-webkit-transform:rotate(7deg); /* Safari and Chrome */-o-transform:rotate(7deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
{{anchor name="test"}}<div style='background:#fff;position:relative;top:-500px;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(15deg);-ms-transform:rotate(15deg); /* IE 9 */-moz-transform:rotate(15deg); /* Firefox */-webkit-transform:rotate(15deg); /* Safari and Chrome */-o-transform:rotate(15deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
</div><br />
<br />
[[Песочница#.D0.92.D1.82.D0.BE.D1.80.D0.BE.D0.B9_.D1.82.D0.B5.D1.81.D1.82]]<br />
<br />
[[#test]]<br />
<br />
[[Категория:Альта-ГТД]]<br />
[[Категория:Тест]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9F%D0%B5%D1%81%D0%BE%D1%87%D0%BD%D0%B8%D1%86%D0%B0&diff=486
Песочница
2013-02-22T13:50:39Z
<p>Vetoshkin: /* Второй тест */</p>
<hr />
<div>== Тест раздел1 ==<br />
<br />
авплдваолп ваодплваодопл <br />
<br />
323263<br />
м247983247<br />
<br />
== Второй тест ==<br />
<br />
Основная статья об [[Второй раздел, песочницы|песочнице]]<br />
<br />
== Второй тест ==<br />
<br />
В песочнице живут маленькие песочные черви (с)Ф.Хереберт "Дюна"<br />
<br />
== Второй тест ==<br />
<br />
В песочнице можно прятать лимоны (с)Группа "Дюна"<br />
<br />
<div style='margin:0px 50px;'><br />
<br />
<div style='background:#fff;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(7deg);-ms-transform:rotate(7deg); /* IE 9 */-moz-transform:rotate(7deg); /* Firefox */-webkit-transform:rotate(7deg); /* Safari and Chrome */-o-transform:rotate(7deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
{{a name="test"}}<div style='background:#fff;position:relative;top:-500px;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(15deg);-ms-transform:rotate(15deg); /* IE 9 */-moz-transform:rotate(15deg); /* Firefox */-webkit-transform:rotate(15deg); /* Safari and Chrome */-o-transform:rotate(15deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
</div><br />
<br />
[[Песочница#.D0.92.D1.82.D0.BE.D1.80.D0.BE.D0.B9_.D1.82.D0.B5.D1.81.D1.82]]<br />
<br />
[[#test]]<br />
<br />
[[Категория:Альта-ГТД]]<br />
[[Категория:Тест]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9F%D0%B5%D1%81%D0%BE%D1%87%D0%BD%D0%B8%D1%86%D0%B0&diff=485
Песочница
2013-02-22T13:49:33Z
<p>Vetoshkin: /* Второй тест */</p>
<hr />
<div>== Тест раздел1 ==<br />
<br />
авплдваолп ваодплваодопл <br />
<br />
323263<br />
м247983247<br />
<br />
== Второй тест ==<br />
<br />
Основная статья об [[Второй раздел, песочницы|песочнице]]<br />
<br />
== Второй тест ==<br />
<br />
В песочнице живут маленькие песочные черви (с)Ф.Хереберт "Дюна"<br />
<br />
== Второй тест ==<br />
<br />
В песочнице можно прятать лимоны (с)Группа "Дюна"<br />
<br />
<div style='margin:0px 50px;'><br />
<br />
<div style='background:#fff;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(7deg);-ms-transform:rotate(7deg); /* IE 9 */-moz-transform:rotate(7deg); /* Firefox */-webkit-transform:rotate(7deg); /* Safari and Chrome */-o-transform:rotate(7deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
{{якорь|place1}}<div style='background:#fff;position:relative;top:-500px;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(15deg);-ms-transform:rotate(15deg); /* IE 9 */-moz-transform:rotate(15deg); /* Firefox */-webkit-transform:rotate(15deg); /* Safari and Chrome */-o-transform:rotate(15deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
</div><br />
<br />
[[Песочница#.D0.92.D1.82.D0.BE.D1.80.D0.BE.D0.B9_.D1.82.D0.B5.D1.81.D1.82]]<br />
<br />
[[#.D0.92.D1.82.D0.BE.D1.80.D0.BE.D0.B9_.D1.82.D0.B5.D1.81.D1.82]]<br />
<br />
[[Категория:Альта-ГТД]]<br />
[[Категория:Тест]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9F%D0%B5%D1%81%D0%BE%D1%87%D0%BD%D0%B8%D1%86%D0%B0&diff=484
Песочница
2013-02-22T13:49:20Z
<p>Vetoshkin: /* Второй тест */</p>
<hr />
<div>== Тест раздел1 ==<br />
<br />
авплдваолп ваодплваодопл <br />
<br />
323263<br />
м247983247<br />
<br />
== Второй тест ==<br />
<br />
Основная статья об [[Второй раздел, песочницы|песочнице]]<br />
<br />
== Второй тест ==<br />
<br />
В песочнице живут маленькие песочные черви (с)Ф.Хереберт "Дюна"<br />
<br />
== Второй тест ==<br />
<br />
В песочнице можно прятать лимоны (с)Группа "Дюна"<br />
<br />
<div style='margin:0px 50px;'><br />
<br />
<div style='background:#fff;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(7deg);-ms-transform:rotate(7deg); /* IE 9 */-moz-transform:rotate(7deg); /* Firefox */-webkit-transform:rotate(7deg); /* Safari and Chrome */-o-transform:rotate(7deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
{{якорь|place1}}<div style='background:#fff;position:relative;top:-500px;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(15deg);-ms-transform:rotate(15deg); /* IE 9 */-moz-transform:rotate(15deg); /* Firefox */-webkit-transform:rotate(15deg); /* Safari and Chrome */-o-transform:rotate(15deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
</div><br />
<br />
[[Песочница#.D0.92.D1.82.D0.BE.D1.80.D0.BE.D0.B9_.D1.82.D0.B5.D1.81.D1.82]]<br />
<br />
((#.D0.92.D1.82.D0.BE.D1.80.D0.BE.D0.B9_.D1.82.D0.B5.D1.81.D1.82))<br />
<br />
[[Категория:Альта-ГТД]]<br />
[[Категория:Тест]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9F%D0%B5%D1%81%D0%BE%D1%87%D0%BD%D0%B8%D1%86%D0%B0&diff=483
Песочница
2013-02-22T13:47:46Z
<p>Vetoshkin: /* Второй тест */</p>
<hr />
<div>== Тест раздел1 ==<br />
<br />
авплдваолп ваодплваодопл <br />
<br />
323263<br />
м247983247<br />
<br />
== Второй тест ==<br />
<br />
Основная статья об [[Второй раздел, песочницы|песочнице]]<br />
<br />
== Второй тест ==<br />
<br />
В песочнице живут маленькие песочные черви (с)Ф.Хереберт "Дюна"<br />
<br />
== Второй тест ==<br />
<br />
В песочнице можно прятать лимоны (с)Группа "Дюна"<br />
<br />
<div style='margin:0px 50px;'><br />
<br />
<div style='background:#fff;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(7deg);-ms-transform:rotate(7deg); /* IE 9 */-moz-transform:rotate(7deg); /* Firefox */-webkit-transform:rotate(7deg); /* Safari and Chrome */-o-transform:rotate(7deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
{{якорь|place1}}<div style='background:#fff;position:relative;top:-500px;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(15deg);-ms-transform:rotate(15deg); /* IE 9 */-moz-transform:rotate(15deg); /* Firefox */-webkit-transform:rotate(15deg); /* Safari and Chrome */-o-transform:rotate(15deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
</div><br />
<br />
[[Песочница#.D0.92.D1.82.D0.BE.D1.80.D0.BE.D0.B9_.D1.82.D0.B5.D1.81.D1.82]]<br />
((#.D0.92.D1.82.D0.BE.D1.80.D0.BE.D0.B9_.D1.82.D0.B5.D1.81.D1.82))<br />
<br />
[[Категория:Альта-ГТД]]<br />
[[Категория:Тест]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9F%D0%B5%D1%81%D0%BE%D1%87%D0%BD%D0%B8%D1%86%D0%B0&diff=482
Песочница
2013-02-22T13:44:10Z
<p>Vetoshkin: /* Второй тест */</p>
<hr />
<div>== Тест раздел1 ==<br />
<br />
авплдваолп ваодплваодопл <br />
<br />
323263<br />
м247983247<br />
<br />
== Второй тест ==<br />
<br />
Основная статья об [[Второй раздел, песочницы|песочнице]]<br />
<br />
== Второй тест ==<br />
<br />
В песочнице живут маленькие песочные черви (с)Ф.Хереберт "Дюна"<br />
<br />
== Второй тест ==<br />
<br />
В песочнице можно прятать лимоны (с)Группа "Дюна"<br />
<br />
<div style='margin:0px 50px;'><br />
<br />
<div style='background:#fff;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(7deg);-ms-transform:rotate(7deg); /* IE 9 */-moz-transform:rotate(7deg); /* Firefox */-webkit-transform:rotate(7deg); /* Safari and Chrome */-o-transform:rotate(7deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
{{якорь|place1}}<div style='background:#fff;position:relative;top:-500px;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(15deg);-ms-transform:rotate(15deg); /* IE 9 */-moz-transform:rotate(15deg); /* Firefox */-webkit-transform:rotate(15deg); /* Safari and Chrome */-o-transform:rotate(15deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
</div><br />
<br />
[[Песочница#.D0.92.D1.82.D0.BE.D1.80.D0.BE.D0.B9_.D1.82.D0.B5.D1.81.D1.82]]<br />
<br />
[[Категория:Альта-ГТД]]<br />
[[Категория:Тест]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9F%D0%B5%D1%81%D0%BE%D1%87%D0%BD%D0%B8%D1%86%D0%B0&diff=481
Песочница
2013-02-22T13:43:24Z
<p>Vetoshkin: /* Второй тест */</p>
<hr />
<div>== Тест раздел1 ==<br />
<br />
авплдваолп ваодплваодопл <br />
<br />
323263<br />
м247983247<br />
<br />
== Второй тест ==<br />
<br />
Основная статья об [[Второй раздел, песочницы|песочнице]]<br />
<br />
== Второй тест ==<br />
<br />
В песочнице живут маленькие песочные черви (с)Ф.Хереберт "Дюна"<br />
<br />
== Второй тест ==<br />
<br />
В песочнице можно прятать лимоны (с)Группа "Дюна"<br />
<br />
<div style='margin:0px 50px;'><br />
<br />
<div style='background:#fff;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(7deg);-ms-transform:rotate(7deg); /* IE 9 */-moz-transform:rotate(7deg); /* Firefox */-webkit-transform:rotate(7deg); /* Safari and Chrome */-o-transform:rotate(7deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
{{якорь|place1}}<div style='background:#fff;position:relative;top:-500px;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(15deg);-ms-transform:rotate(15deg); /* IE 9 */-moz-transform:rotate(15deg); /* Firefox */-webkit-transform:rotate(15deg); /* Safari and Chrome */-o-transform:rotate(15deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
</div><br />
<br />
[[Песочница#place1]]<br />
<br />
[[Категория:Альта-ГТД]]<br />
[[Категория:Тест]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9F%D0%B5%D1%81%D0%BE%D1%87%D0%BD%D0%B8%D1%86%D0%B0&diff=480
Песочница
2013-02-22T13:41:38Z
<p>Vetoshkin: /* Второй тест */</p>
<hr />
<div>== Тест раздел1 ==<br />
<br />
авплдваолп ваодплваодопл <br />
<br />
323263<br />
м247983247<br />
<br />
== Второй тест ==<br />
<br />
Основная статья об [[Второй раздел, песочницы|песочнице]]<br />
<br />
== Второй тест ==<br />
<br />
В песочнице живут маленькие песочные черви (с)Ф.Хереберт "Дюна"<br />
<br />
== Второй тест ==<br />
<br />
В песочнице можно прятать лимоны (с)Группа "Дюна"<br />
<br />
<div style='margin:0px 50px;'><br />
<br />
<div style='background:#fff;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(7deg);-ms-transform:rotate(7deg); /* IE 9 */-moz-transform:rotate(7deg); /* Firefox */-webkit-transform:rotate(7deg); /* Safari and Chrome */-o-transform:rotate(7deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
{{якорь|ппп}}<div style='background:#fff;position:relative;top:-500px;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(15deg);-ms-transform:rotate(15deg); /* IE 9 */-moz-transform:rotate(15deg); /* Firefox */-webkit-transform:rotate(15deg); /* Safari and Chrome */-o-transform:rotate(15deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
</div><br />
<br />
[[Песочница#ппп]]<br />
<br />
[[Категория:Альта-ГТД]]<br />
[[Категория:Тест]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9E%D1%88%D0%B8%D0%B1%D0%BA%D0%B8_%D0%BF%D1%80%D0%B8_%D0%AD%D0%94-2&diff=433
Ошибки при ЭД-2
2013-02-05T08:56:43Z
<p>Vetoshkin: /* .&nbsp;&nbsp;Обработка документов данного формата запрещена. Истек срок действия формата. Истек срок действия версии альбома форматов, ук…</p>
<hr />
<div>[[Категория:ЭД-2]][[Категория:Альта-ГТД]]<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Документ отсутствует в альбоме форматов ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00071.04)<br />
<br />
'''Описание:''' По ЭД отправляют документ, отсутствующий в секции ЭД и не описанный в действующем альбоме форматов.<br />
<br />
'''Решение:''' Необходимо формализовать документ описанным в альбоме форматов ЭД документом и отправить в таможню.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>В текущем статусном состоянии обработка данного сообщения невозможна. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 02.00081.01)<br />
<br />
'''Описание:''' На сервере таможни по процедуре стоит статус, при котором обработка сервером отправленного сообщения невозможна.<br />
<br />
<br />
<span style='color:#00f;'>Пример 1:</span> Нельзя ничего отправлять после закрытия процедуры: ДТ отозвана, Отказ в регистрации ДТ, Переход на декларирование в общеустановленном порядке (На бумаге).<br />
<br />
[[Файл:02.00081.01_1.png]]<br />
<br />
''На примере выше, повторная отправка ДТ после отказа в регистрации возвращается с ошибкой.''<br />
<br />
'''Решение:''' Дублировать ДТ с взаимосвязанными и отправить заново.<br />
<br />
<br />
<span style='color:#00f;'>Пример 2:</span> Нельзя отвечать измененной ПРД на «Уведомление о прибытии товаров на СВХ…».<br/><br />
<br />
[[Файл:02.00081.01_2.png]]<br />
<br />
'''Решение:''' В ответ на «Уведомление о прибытии товаров на СВХ…» сначала нужно отправить «Уведомление о прибытии товаров (ПРД)».<br />
<br />
<br />
<span style='color:#00f;'>Пример 3:</span> Нельзя отправлять документы или ДТ во время проведения досмотра<br/><br />
<br />
[[Файл:02.00081.01_3.png]]<br />
<br />
'''Решение:''' Во время проведения досмотра отправка эд документов невозможна. Необходимо дождаться от инспектора Акта таможенного досмотра.<br />
<br><br />
<br><br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Код КАСТО назначения не зарегистрирован в системе. ==<br />
<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.01)<br />
<br />
<br />
[[Файл:01.00038.01_1.png]]<br />
<br />
<br />
'''Описание:''' Пост, на который происходит отправка ДТ, не поддерживает электронное декларирование. Либо ДТ отправлена на несуществующий или устаревший пост.<br />
<br />
'''Решение:''' Электронное декларирование возможно только с постом, поддерживающим ЭД. Иначе декларирование на бумаге.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Код внутреннего таможенного органа отсутствует в списке ТО, участвующих в применении технологии удаленного выпуска. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.02)<br />
<br />
'''Описание:''' Пост, на который отправлена декларация, не поддерживает удаленное декларирование.<br />
<br />
'''Решение:''' При такой ошибке отправка по ЭД на пост невозможна. Подать ДТ на бумаге.<br />
<br />
<br><br />
<br><br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Указанная комбинация внутренний ТО - приграничный ТО отсутствует списке ТО, участвующих в применении технологии удаленного выпуска. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.04)<br />
<br />
<br />
[[Файл:01.00038.04_1.png]]<br />
<br />
<br />
'''Описание:''' Пост, на который отправлена ДТ и пост, указанный в гр.7 ДТ «Код поста (удал. декл.)» не могут взаимодействовать друг с другом по технологии удаленного выпуска.<br />
<br />
'''Решение:''' Если в гр.7 ДТ «Код поста (удал. декл.)» стоит нужный пост и отсылка происходит на верный пост, то эти два поста не могут друг с другом взаимодействовать по технологии удаленного выпуска.<br/>Иначе, <br />
проверить на какой пост была выслана декларация. Возможно из-за некорректных настроек выбора поста при отправке по ЭД, ДТ была отправлена на неверный пост.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Процедура декларирования отсутствует в системе. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00041.01)<br />
<br />
<br />
[[Файл:01.00041.01_1.png]]<br />
<br />
''Версия альбома форматов отличная от первоначальной. Документ был отослан в формате 5.0.7, а процедура была начата в формате 5.0.8''<br />
<br />
<br />
'''Описание:''' <br/><br />
После открытия процедуры декларирования изменились параметры отправки:<br/><br />
1. Изменилась версия альбома форматов. Например, процедура открыта в 5.0.8, а сообщения отправляют в 5.0.9<br/><br />
2. Изменилось поле "Отправитель" в настройках фирмы. Например, была изменена привязанная к ЭЦП фирма в меню «Настройка сертификатов»<br/><br />
3. Изменили код поста. Встречается при восстановлении процедуры декларирования.<br/><br />
4. Изменен тип декларации. Например, отправили обычную ГТД, а потом изменили ее на ПРД и продолжили.<br/><br />
5. Изменен идентификатор процедуры. При восстановлении процедуры, был указан несуществующий (или неверный) ID процедуры.<br />
<br />
'''Решение:''' Проверить причину ошибки можно в окне <span style='border-bottom:1px dotted #000;'>Каталог | Электронное декларирование | Открыть окно сообщений ЭД</span> и отфильтровав по идентификатору процедуры.<br/>Сравнить описанные выше данные у успешно отправленных сообщений и у сообщений, на которые вернулась ошибка.<br />
<br><br />
<br><br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Подан неполный набор первоначальных документов. Документ-контейнер не содержит обязательного набора документов. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00011.01)<br />
<br />
<br />
[[Файл:03.00011.01_1.png]]<br />
<br />
<br />
'''Описание:''' При отправке в контейнере отсутствует ДТС и/или Опись.<br/><br />
Опись при отправке ДТ должна присутствовать всегда. Наличие ДТС в ЭД контейнере обязательно, кроме тех случаев, когда платежи не зависят от стоимости товаров (например, режим чистого экспорта или режим импорта при перемещении припасов). <br/><br />
<br />
'''Решение:''' Создать ДТС и/или опись и отправить полный контейнер в таможню.<br />
<br><br />
<br><br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Подан неполный набор первоначальных документов. Признак подачи неполного контейнера не установлен. Документ-контейнер не содержит обязательного набора документов, либо не установлен флаг ''FullSetIndicator''. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00012.01)<br />
<br />
<br />
[[Файл:03.00012.01_1.png]]<br />
<br />
<br />
'''Описание:''' При отправке в контейнере отсутствует ДТС и/или Опись. Если ДТС не должна быть, то в контейнере отсутствует флаг ''FullSetIndicator''.<br />
<br />
'''Решение:''' Ошибка может встретиться, например, если декларант выгрузил ДТ в XML и из нее пытается открыть процедуру.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Внесение изменений в ДТ при необработанном предыдущем сообщении на изменение ДТ невозможно. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00021.01)<br />
<br />
'''Описание:''' На каждую отправленную ДТ должно быть сообщение с решением по данной ДТ. На передано ГТД ответом является протокол ошибок или присвоение номера, на повторно отправленную ДТ, «разрешено внести изменения» или «отказ во внесении изменений». Если у повторно отправленной ДТ стоит статус обрабатывается, это значит что на данное сообщение не было ответа от инспектора. При этом на повторную отправку декларантом контейнера, будет приходить подобная ошибка.<br />
<br />
<br />
[[Файл:03.00021.01_1.png]]<br />
<br />
<br />
'''Решение:''' Дождаться решения по декларации со статусом «Обрабатывается» и после этого выслать повторно с изменениями.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Превышен интервал ожидания ответа от архива декларанта. При работе сервиса электронного архива декларанта возникла ошибка. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00024.01)<br />
<br />
'''Описание:''' Не работает архив в таможне.<br />
<br />
'''Решение:''' Попробовать отправить запрос на создание архива или документ в архив позже.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Документы не прошли проверку ФЛК. Ошибка при работе сервиса проверки документов. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00100.00 03.00100.01)<br />
<br />
'''Описание:''' Кратковременный сбой в работе сервиса проверки таможенного сервера.<br />
<br />
'''Решение:''' Отправить документ повторно через некоторое время.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Обработка документов данного формата запрещена. Формат не вступил в действие.Обработка документов данного формата запрещена. Формат не вступил в действие. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00101.01)<br />
<br />
'''Описание:''' Используемый альбом форматов не вступил в действие. В настройках был выбран не вступивший в действие альбом форматов. Либо системная дата на компьютере установлена неверно, а в настройках выбора альбома форматов установлено «Авто (зависит от даты)».<br />
<br />
'''Решение:''' Войти в меню <span style='border-bottom:1px dotted #000;'>Настройка | Документы | ГТД</span>, вкладка «Выгрузка 1», В блоке «Выгрузка ГТД в формате XML» выбрать действующий на текущую дату альбом форматов. Либо установить верную системную дату.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Обработка документов данного формата запрещена. Истек срок действия формата. Истек срок действия версии альбома форматов, указанной в заголовке сообщения ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00102.01)<br />
<br />
'''Описание:''' Используемый альбом форматов не используется для ЭД в связи со вступлением в действие нового альбома форматов. В настройках указан альбом форматов с истекшим сроком действия. <br />
<br />
[[Файл:03.00102.01_1.png]]<br />
<br />
'''Решение:''' Войти в меню <span style='border-bottom:1px dotted #000;'>Настройка | Документы | ГТД</span>, вкладка «Выгрузка 1», В блоке «Выгрузка ГТД в формате XML» выбрать действующий на текущую дату альбом форматов.<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Ошибка обработки сообщения. Системная ошибка. Процесс обработки или формирования сообщения завершился аварийно. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Коды возврата 09.00001.01 и 09.00005.05)<br />
<br />
'''Описание:''' Сбой в работе таможенного сервера.<br />
<br />
<br />
[[Файл:09.00001.01_09.00005.05_1.png]]<br />
<br />
<br />
'''Решение:''' Если ошибка пришла в ответ на «Запрос на открытие процедуры декларирования», то декларацию необходимо отозвать (на всякий случай), сдублировать и заново отправить. В случае, если ошибка вернулась в ответ на повторно отправленную ГТД либо на отправленный документ или контейнер после присвоения номера, то необходимо повторно выслать сообщение в рамках данной процедуры.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Несоответствие кода запрашиваемого документа(DocCode) и его DocumentModeID. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Коды возврата 09.00000.32)<br />
<br />
<br />
[[Файл:09.00000.32_1.png]]<br />
<br />
'''Описание:''' Документ, отправляемый в ответ на запрос инспектора в таможню, не соответствует коду документа в запросе от инспектора.<br />
<br />
'''Решение:''' Необходимо отправить документ, который допустимо отправлять на запрос с таким кодом. <br><br />
Вариант решения: В окне "Привязка и отправка документов ЭД" выделить строку с неверно привязанным документом и нажать на кнопку «Привязать документ». После этого выбрать необходимый тип документа и привязать готовый ЭД документ подходящего типа, после чего отправить его в таможню.<br/><br />
<br />
Таблица соответствия документов классификатору видов документов находится в приложении А2 Спецификации ЭД. В программе посмотреть таблицу можно из Описи, нажав на синий кружок в заголовке столбца «Код». В левом столбце таблицы указан код, а в правом ЭД документ, который соответствует по альбому форматов данному коду.<br />
<br />
[[Файл:09.00000.32_2.png]]<br />
<br />
<br><br />
<br><br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Общая ошибка при работе системы. ==<br />
<br />
'''Код ошибки:''' CMN.09999 (Код возврата 99.99999.99)<br />
<br />
'''Описание:''' Временный сбой в таможне<br />
<br />
'''Решение:''' Попробовать повторить действия, на которые вернулась данная ошибка (отправка документа, открытие процедуры и т.д.) позже.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Невозможно заменить незаменяемый документ. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00017.01)<br />
<br />
<br />
[[Файл:03.00017.01_1.png]]<br />
<br />
<br />
'''Описание:''' При повторной отправке декларации по ЭД, контейнер должен ссылаться на предыдущую успешно(!) отправленную ДТ. При нарушении такой ссылочности и возникает такая ошибка.<br />
<br />
<font color=blue>'''Возможные причины:'''</font><br><br />
Сбой в таможне при попытке повторно обработать одно и то же сообщение. При этом декларанту приходит «ошибка обработки сообщения» (возможно, несколько раз подряд). У отправленной ДТ стоит статус "Не принято". При этом повторно отправленная ДТ ссылается не на описанное выше сообщение, а на предыдущее, вследствие чего приходит ошибка.<br><br />
С таможни не пришла часть сообщений, в результате обработанные отправленные ДТ не перешли в корректный статус. <br><br />
Также причиной может стать неверное выставление статусов вручную декларантом.<br><br><br />
<br />
'''Решение:''' Запросить историю процедуры. Если есть пропущенные – запросить их и после получения повторить отправку. Если ошибка повторилась – необходимо обратиться к специалистам техподдержки для разрешения проблемы с отправкой.<br />
<br><br />
<br><br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Запрошенный документ отсутствует в БД. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 02.00001.01)<br />
<br />
<br />
[[Файл:02.00001.01_1.png]]<br />
<br />
<br />
'''Описание:''' При повторной отправке декларации по ЭД, контейнер ссылается на предыдущую отправленную ДТ. Но так как на сервере таможни предыдущего сообщения нет, таможенный сервер возвращает такую ошибку.<br/>Данная проблема схожа с ошибкой «Невозможно заменить незаменяемый документ». Основная причина может быть связана с нарушением ссылочности эд-сообщений. Реже – сбои в таможенной системе.<br />
<br />
'''Решение:''' Запросить историю процедуры. Если есть пропущенные – запросить их и после получения повторить отправку. Если ошибка повторилась – необходимо обратиться к специалистам техподдержки для разрешения проблемы с отправкой.<br />
<br />
<br />
----</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:03.00102.01_1.png&diff=432
Файл:03.00102.01 1.png
2013-02-05T08:56:23Z
<p>Vetoshkin: </p>
<hr />
<div></div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9E%D1%88%D0%B8%D0%B1%D0%BA%D0%B8_%D0%BF%D1%80%D0%B8_%D0%AD%D0%94-2&diff=414
Ошибки при ЭД-2
2013-02-01T11:39:46Z
<p>Vetoshkin: </p>
<hr />
<div>[[Категория:ЭД-2]][[Категория:Альта-ГТД]]<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Документ отсутствует в альбоме форматов ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00071.04)<br />
<br />
'''Описание:''' По ЭД отправляют документ, отсутствующий в секции ЭД и не описанный в действующем альбоме форматов.<br />
<br />
'''Решение:''' Необходимо формализовать документ описанным в альбоме форматов ЭД документом и отправить в таможню.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>В текущем статусном состоянии обработка данного сообщения невозможна. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 02.00081.01)<br />
<br />
'''Описание:''' На сервере таможни по процедуре стоит статус, при котором обработка сервером отправленного сообщения невозможна.<br />
<br />
<br />
<span style='color:#00f;'>Пример 1:</span> Нельзя ничего отправлять после закрытия процедуры: ДТ отозвана, Переход на декларирование в общеустановленном порядке (На бумаге), отказ в регистрации ДТ.<br />
<br />
[[Файл:02.00081.01_1.png]]<br />
<br />
На примере выше, повторная отправка ДТ после отказа в регистрации возвращается с ошибкой.<br />
<br />
'''Решение:''' Дублировать ДТ с взаимосвязанными и отправить заново.<br />
<br />
<br />
<span style='color:#00f;'>Пример 2:</span> Нельзя отвечать измененной ПРД на «Уведомление о прибытии товаров на СВХ…».<br/><br />
<br />
[[Файл:02.00081.01_2.png]]<br />
<br />
'''Решение:''' В указанном на картинке примере решением является в ответ на «Уведомление о прибытии товаров на СВХ…» отправка «Уведомления о прибытии товаров (ПРД)».<br />
<br />
<br />
<span style='color:#00f;'>Пример 3:</span> Нельзя отправлять документы или ДТ во время проведения досмотра<br/><br />
<br />
[[Файл:02.00081.01_3.png]]<br />
<br />
'''Решение:''' Во время проведения досмотра отправка эд документов невозможна. Необходимо дождаться от инспектора акт таможенного досмотра.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Код КАСТО назначения не зарегистрирован в системе. ==<br />
<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.01)<br />
<br />
<br />
[[Файл:01.00038.01_1.png]]<br />
<br />
<br />
'''Описание:''' Пост, на который происходит отправка ДТ, не поддерживает электронное декларирование. Либо ДТ отправлена на несуществующий или устаревший пост.<br />
<br />
'''Решение:''' Электронное декларирование возможно только с постом, поддерживающим ЭД. Иначе декларирование на бумаге.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Код внутреннего таможенного органа отсутствует в списке ТО, участвующих в применении технологии удаленного выпуска. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.02)<br />
<br />
'''Описание:''' Пост, на который отправлена декларация не поддерживает удаленное декларирование.<br />
<br />
'''Решение:''' При такой ошибке отправка по ЭД на пост невозможна. Подать ДТ на бумаге. <br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Указанная комбинация внутренний ТО - приграничный ТО отсутствует списке ТО, участвующих в применении технологии удаленного выпуска. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.04)<br />
<br />
<br />
[[Файл:01.00038.04_1.png]]<br />
<br />
<br />
'''Описание:''' Пост, на который отправлена ДТ и пост, указанный в гр.7 ДТ «Код поста (удал. декл.)» не могут взаимодействовать друг с другом по технологии удаленного выпуска.<br />
<br />
'''Решение:''' Если в гр.7 ДТ «Код поста (удал. декл.)» стоит нужный пост и отсылка происходит на верный пост, то эти два поста не могут друг с другом взаимодействовать по технологии удаленного выпуска.<br/>Иначе, <br />
проверить на какой пост была выслана декларация. Возможно из-за некорректных настроек выбора поста при отправке по ЭД, ДТ была отправлена на неверный пост.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Процедура декларирования отсутствует в системе. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00041.01)<br />
<br />
<br />
[[Файл:01.00041.01_1.png]]<br />
<br />
''Версия альбома форматов отличная от первоначальной. Документ был отослан в формате 5.0.7, а процедура была начата в формате 5.0.8''<br />
<br />
<br />
'''Описание:''' <br/><br />
После открытия процедуры декларирования изменились:<br/><br />
1. Версия альбома форматов. Например: процедура открыта в 5.0.8, сообщения отправляют в 5.0.9<br/><br />
2. Поле отправитель. Например, была изменена привязанная к ЭЦП фирма в меню «настройка сертификатов»<br/><br />
3. Код поста. Встречается при восстановлении процедуры декларирования.<br/><br />
4. Изменен тип декларации. Например, отправили ГТД, изменили на ПРД и продолжили.<br/><br />
5. Идентификатор процедуры. При восстановлении процедуры, был указан несуществующий ID процедуры.<br />
<br />
'''Решение:''' Проверить причину ошибки можно в окне <span style='border-bottom:1px dotted #000;'>Каталог | Электронное декларирование | Открыть окно сообщений ЭД</span> и отфильтровав по идентификатору процедуры.<br/>Сравнить описанные выше данные у успешно отправленных сообщений и у сообщений, на которые вернулась ошибка.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Подан неполный набор первоначальных документов. Документ-контейнер не содержит обязательного набора документов. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00011.01)<br />
<br />
<br />
[[Файл:03.00011.01_1.png]]<br />
<br />
<br />
'''Описание:''' При отправке в контейнере отсутствует ДТС и/или Опись.<br/><br />
Опись при отправке ДТ должна присутствовать всегда. Наличие ДТС в ЭД контейнере обязательно, кроме тех случаев, когда платежи не зависят от стоимости товаров.<br/>Например, режим чистого экспорта, режим импорта при перемещении припасов.<br />
<br />
'''Решение:''' Создать ДТС и/или опись и отправить полный контейнер в таможню.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Подан неполный набор первоначальных документов. Признак подачи неполного контейнера не установлен. Документ-контейнер не содержит обязательного набора документов, либо не установлен флаг ''FullSetIndicator''. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00012.01)<br />
<br />
<br />
[[Файл:03.00012.01_1.png]]<br />
<br />
<br />
'''Описание:''' При отправке в контейнере отсутствует ДТС и/или Опись. Если ДТС не должна быть, то в контейнере отсутствует флаг ''FullSetIndicator''.<br />
<br />
'''Решение:''' Ошибка может встретиться, например, если декларант выгрузил ДТ в XML и из нее пытается открыть процедуру.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Внесение изменений в ДТ при необработанном предыдущем сообщении на изменение ДТ невозможно. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00021.01)<br />
<br />
'''Описание:''' На каждую отправленную ДТ должно быть сообщение с решением по данной ДТ. На передано ГТД ответом является протокол ошибок или присвоение номера, на повторно отправленную ДТ, «разрешено внести изменения» или «отказ во внесении изменений». Если у повторно отправленной ДТ стоит статус обрабатывается, это значит что на данное сообщение не было ответа от инспектора. При этом на повторную отправку декларантом контейнера, будет приходить подобная ошибка.<br />
<br />
<br />
[[Файл:03.00021.01_1.png]]<br />
<br />
<br />
'''Решение:''' Дождаться решения по декларации со статусом «Обрабатывается» и после этого выслать повторно с изменениями.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Превышен интервал ожидания ответа от архива декларанта. При работе сервиса электронного архива декларанта возникла ошибка. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00024.01)<br />
<br />
'''Описание:''' Не работает архив в таможне.<br />
<br />
'''Решение:''' Попробовать отправить запрос на создание архива или документ в архив позже.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Документы не прошли проверку ФЛК. Ошибка при работе сервиса проверки документов. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00100.00 03.00100.01)<br />
<br />
'''Описание:''' Кратковременный сбой в работе сервиса проверки таможенного сервера.<br />
<br />
'''Решение:''' Отправить документ повторно через некоторое время.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Обработка документов данного формата запрещена. Формат не вступил в действие.Обработка документов данного формата запрещена. Формат не вступил в действие. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00101.01)<br />
<br />
'''Описание:''' Используемый альбом форматов не вступил в действие. В настройках был выбран не вступивший в действие альбом форматов. Либо системная дата на компьютере установлена неверно, а в настройках выбора альбома форматов установлено «Авто (зависит от даты)».<br />
<br />
'''Решение:''' Войти в меню <span style='border-bottom:1px dotted #000;'>Настройка | Документы | ГТД</span>, вкладка «Выгрузка 1», В блоке «Выгрузка ГТД в формате XML» выбрать действующий на текущую дату альбом форматов. Либо установить верную системную дату.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Обработка документов данного формата запрещена. Истек срок действия формата. Истек срок действия версии альбома форматов, указанной в заголовке сообщения ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00102.01)<br />
<br />
'''Описание:''' Используемый альбом форматов не используется для ЭД в связи со вступлением в действие нового альбома форматов. В настройках указан альбом форматов с истекшим сроком действия. <br />
<br />
'''Решение:''' Войти в меню <span style='border-bottom:1px dotted #000;'>Настройка | Документы | ГТД</span>, вкладка «Выгрузка 1», В блоке «Выгрузка ГТД в формате XML» выбрать действующий на текущую дату альбом форматов.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Ошибка обработки сообщения. Системная ошибка. Процесс обработки или формирования сообщения завершился аварийно. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Коды возврата 09.00001.01 и 09.00005.05)<br />
<br />
'''Описание:''' Сбой в работе таможенного сервера.<br />
<br />
<br />
[[Файл:09.00001.01_09.00005.05_1.png]]<br />
<br />
<br />
'''Решение:''' Если ошибка пришла в ответ на «Запрос на открытие процедуры декларирования», то декларацию необходимо отозвать (на всякий случай), сдублировать и заново отправить. В случае, если ошибка вернулась в ответ на повторно отправленную ГТД либо на отправленный документ или контейнер после присвоения номера, то необходимо повторно выслать сообщение в рамках данной процедуры.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Несоответствие кода запрашиваемого документа(DocCode) и его DocumentModeID. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Коды возврата 09.00000.32)<br />
<br />
<br />
[[Файл:09.00000.32_1.png]]<br />
<br />
'''Описание:''' Документ, отправляемый в ответ на запрос инспектора в таможню, не соответствует коду запроса от инспектора.<br />
<br />
'''Решение:''' Необходимо в окне Привязка и отправка документов ЭД выделить строку с неверно привязанным документом и нажать на кнопку «Привязать документ». После этого выбрать необходимый тип документа и привязать готовый ЭД документ, после отправить в таможню.<br/><br />
В описи есть таблица соответствия документов альбома форматов классификатору видов документов, используемых при заявлении сведений в графе 44 ГТД. Открыть таблицу можно из Описи, нажав на синий кружок в заголовке столбца «Код». В левом столбце таблицы указан код, а в правом ЭД документ, который соответствует по альбому форматов данному коду.<br />
<br />
<br />
[[Файл:09.00000.32_2.png]]<br />
<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Общая ошибка при работе системы. ==<br />
<br />
'''Код ошибки:''' CMN.09999 (Код возврата 99.99999.99)<br />
<br />
'''Описание:''' Временный сбой в таможне<br />
<br />
'''Решение:''' Попробовать повторить действия, на которые вернулась данная ошибка (отправка документа, открытие процедуры и т.д.) позже.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Невозможно заменить незаменяемый документ. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00017.01)<br />
<br />
<br />
[[Файл:03.00017.01_1.png]]<br />
<br />
<br />
'''Описание:''' В списке сообщений по декларации нарушена ссылочность. У последнего по дате успешно отправленного контейнера стоит неверный статус.<br />
<br />
'''Причина:''' Сбой в таможне при попытке повторно обработать одно и то же сообщение. При этом декларанту приходит «ошибка обработки сообщения» (возможно, несколько раз подряд). Также причиной может стать неверное выставление статусов вручную декларантом. <br />
<br />
'''Решение:''' Например, есть повторно отправленная декларация и в ответ с таможни пришли следующие по порядку сообщения: Получено, Обработано, Получено, Ошибка. Так как есть сообщения «получено» и «обработано», статус у повторно отправленной ДТ должен смениться на ОК. Но на самом деле у ДТ статус стоит «Не принято». При этом повторно отправленная ДТ ссылается не на описанное выше сообщение, а на предыдущее, вследствие чего приходит ошибка. Изменить неверный статус у сообщения на ОК и повторить отсылку сообщения.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Запрошенный документ отсутствует в БД. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 02.00001.01)<br />
<br />
<br />
[[Файл:02.00001.01_1.png]]<br />
<br />
<br />
'''Описание:''' При повторной отправке декларации по ЭД, контейнер ссылается на предыдущую отправленную ДТ. Но так как на сервере таможни предыдущего сообщения нет, таможенный сервер возвращает такую ошибку.<br/>Данная проблема схожа с ошибкой «Невозможно заменить незаменяемый документ». Основная причина может быть связана с нарушением ссылочности эд-сообщений. Реже – сбои в таможенной системе.<br />
<br />
'''Решение:''' Запросить историю процедуры. Если есть пропущенные – запросить их и после получения повторить отправку. Если ошибка повторилась – необходимо обратиться к специалистам техподдержки для разрешения проблемы с отправкой.<br />
<br />
<br />
----</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9E%D1%88%D0%B8%D0%B1%D0%BA%D0%B8_%D0%BF%D1%80%D0%B8_%D0%AD%D0%94-2&diff=413
Ошибки при ЭД-2
2013-02-01T11:38:44Z
<p>Vetoshkin: /* .&nbsp;&nbsp;В текущем статусном состоянии обработка данного сообщения невозможна. */</p>
<hr />
<div>[[Категория:ЭД-2]][[Категория:Альта-ГТД]]<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Документ отсутствует в альбоме форматов ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00071.04)<br />
<br />
'''Описание:''' По ЭД отправляют документ, отсутствующий в секции ЭД и не описанный в действующем альбоме форматов.<br />
<br />
'''Решение:''' Необходимо формализовать документ описанным в альбоме форматов ЭД документом и отправить в таможню.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>В текущем статусном состоянии обработка данного сообщения невозможна. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 02.00081.01)<br />
<br />
'''Описание:''' На сервере таможни по процедуре стоит статус, при котором обработка сервером отправленного сообщения невозможна.<br />
<br />
<br />
<span style='color:#00f;'>Пример 1:</span> Нельзя ничего отправлять после закрытия процедуры: ДТ отозвана, Переход на декларирование в общеустановленном порядке (На бумаге), отказ в регистрации ДТ.<br />
<br />
[[Файл:02.00081.01_1.png]]<br />
<br />
На примере выше, повторная отправка ДТ после отказа в регистрации возвращается с ошибкой.<br />
<br />
'''Решение:''' Дублировать ДТ с взаимосвязанными и отправить заново.<br />
<br />
<br />
<span style='color:#00f;'>Пример 2:</span> Нельзя отвечать измененной ПРД на «Уведомление о прибытии товаров на СВХ…».<br/><br />
<br />
[[Файл:02.00081.01_2.png]]<br />
<br />
'''Решение:''' В указанном на картинке примере решением является в ответ на «Уведомление о прибытии товаров на СВХ…» отправка «Уведомления о прибытии товаров (ПРД)».<br />
<br />
<br />
<span style='color:#00f;'>Пример 3:</span> Нельзя отправлять документы или ДТ во время проведения досмотра<br/><br />
<br />
[[Файл:02.00081.01_3.png]]<br />
<br />
'''Решение:''' Во время проведения досмотра отправка эд документов невозможна. Необходимо дождаться от инспектора акт таможенного досмотра.<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Код КАСТО назначения не зарегистрирован в системе. ==<br />
<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.01)<br />
<br />
<br />
[[Файл:01.00038.01_1.png]]<br />
<br />
<br />
'''Описание:''' Пост, на который происходит отправка ДТ, не поддерживает электронное декларирование. Либо ДТ отправлена на несуществующий или устаревший пост.<br />
<br />
'''Решение:''' Электронное декларирование возможно только с постом, поддерживающим ЭД. Иначе декларирование на бумаге.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Код внутреннего таможенного органа отсутствует в списке ТО, участвующих в применении технологии удаленного выпуска. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.02)<br />
<br />
'''Описание:''' Пост, на который отправлена декларация не поддерживает удаленное декларирование.<br />
<br />
'''Решение:''' При такой ошибке отправка по ЭД на пост невозможна. Подать ДТ на бумаге. <br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Указанная комбинация внутренний ТО - приграничный ТО отсутствует списке ТО, участвующих в применении технологии удаленного выпуска. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.04)<br />
<br />
<br />
[[Файл:01.00038.04_1.png]]<br />
<br />
<br />
'''Описание:''' Пост, на который отправлена ДТ и пост, указанный в гр.7 ДТ «Код поста (удал. декл.)» не могут взаимодействовать друг с другом по технологии удаленного выпуска.<br />
<br />
'''Решение:''' Если в гр.7 ДТ «Код поста (удал. декл.)» стоит нужный пост и отсылка происходит на верный пост, то эти два поста не могут друг с другом взаимодействовать по технологии удаленного выпуска.<br/>Иначе, <br />
проверить на какой пост была выслана декларация. Возможно из-за некорректных настроек выбора поста при отправке по ЭД, ДТ была отправлена на неверный пост.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Процедура декларирования отсутствует в системе. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00041.01)<br />
<br />
<br />
[[Файл:01.00041.01_1.png]]<br />
<br />
''Версия альбома форматов отличная от первоначальной. Документ был отослан в формате 5.0.7, а процедура была начата в формате 5.0.8''<br />
<br />
<br />
'''Описание:''' <br/><br />
После открытия процедуры декларирования изменились:<br/><br />
1. Версия альбома форматов. Например: процедура открыта в 5.0.8, сообщения отправляют в 5.0.9<br/><br />
2. Поле отправитель. Например, была изменена привязанная к ЭЦП фирма в меню «настройка сертификатов»<br/><br />
3. Код поста. Встречается при восстановлении процедуры декларирования.<br/><br />
4. Изменен тип декларации. Например, отправили ГТД, изменили на ПРД и продолжили.<br/><br />
5. Идентификатор процедуры. При восстановлении процедуры, был указан несуществующий ID процедуры.<br />
<br />
'''Решение:''' Проверить причину ошибки можно в окне <span style='border-bottom:1px dotted #000;'>Каталог | Электронное декларирование | Открыть окно сообщений ЭД</span> и отфильтровав по идентификатору процедуры.<br/>Сравнить описанные выше данные у успешно отправленных сообщений и у сообщений, на которые вернулась ошибка.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Подан неполный набор первоначальных документов. Документ-контейнер не содержит обязательного набора документов. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00011.01)<br />
<br />
<br />
[[Файл:03.00011.01_1.png]]<br />
<br />
<br />
'''Описание:''' При отправке в контейнере отсутствует ДТС и/или Опись.<br/><br />
Опись при отправке ДТ должна присутствовать всегда. Наличие ДТС в ЭД контейнере обязательно, кроме тех случаев, когда платежи не зависят от стоимости товаров.<br/>Например, режим чистого экспорта, режим импорта при перемещении припасов.<br />
<br />
'''Решение:''' Создать ДТС и/или опись и отправить полный контейнер в таможню.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Подан неполный набор первоначальных документов. Признак подачи неполного контейнера не установлен. Документ-контейнер не содержит обязательного набора документов, либо не установлен флаг ''FullSetIndicator''. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00012.01)<br />
<br />
<br />
[[Файл:03.00012.01_1.png]]<br />
<br />
<br />
'''Описание:''' При отправке в контейнере отсутствует ДТС и/или Опись. Если ДТС не должна быть, то в контейнере отсутствует флаг ''FullSetIndicator''.<br />
<br />
'''Решение:''' Ошибка может встретиться, например, если декларант выгрузил ДТ в XML и из нее пытается открыть процедуру.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Внесение изменений в ДТ при необработанном предыдущем сообщении на изменение ДТ невозможно. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00021.01)<br />
<br />
'''Описание:''' На каждую отправленную ДТ должно быть сообщение с решением по данной ДТ. На передано ГТД ответом является протокол ошибок или присвоение номера, на повторно отправленную ДТ, «разрешено внести изменения» или «отказ во внесении изменений». Если у повторно отправленной ДТ стоит статус обрабатывается, это значит что на данное сообщение не было ответа от инспектора. При этом на повторную отправку декларантом контейнера, будет приходить подобная ошибка.<br />
<br />
<br />
[[Файл:03.00021.01_1.png]]<br />
<br />
<br />
'''Решение:''' Дождаться решения по декларации со статусом «Обрабатывается» и после этого выслать повторно с изменениями.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Превышен интервал ожидания ответа от архива декларанта. При работе сервиса электронного архива декларанта возникла ошибка. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00024.01)<br />
<br />
'''Описание:''' Не работает архив в таможне.<br />
<br />
'''Решение:''' Попробовать отправить запрос на создание архива или документ в архив позже.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Документы не прошли проверку ФЛК. Ошибка при работе сервиса проверки документов. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00100.00 03.00100.01)<br />
<br />
'''Описание:''' Кратковременный сбой в работе сервиса проверки таможенного сервера.<br />
<br />
'''Решение:''' Отправить документ повторно через некоторое время.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Обработка документов данного формата запрещена. Формат не вступил в действие.Обработка документов данного формата запрещена. Формат не вступил в действие. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00101.01)<br />
<br />
'''Описание:''' Используемый альбом форматов не вступил в действие. В настройках был выбран не вступивший в действие альбом форматов. Либо системная дата на компьютере установлена неверно, а в настройках выбора альбома форматов установлено «Авто (зависит от даты)».<br />
<br />
'''Решение:''' Войти в меню <span style='border-bottom:1px dotted #000;'>Настройка | Документы | ГТД</span>, вкладка «Выгрузка 1», В блоке «Выгрузка ГТД в формате XML» выбрать действующий на текущую дату альбом форматов. Либо установить верную системную дату.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Обработка документов данного формата запрещена. Истек срок действия формата. Истек срок действия версии альбома форматов, указанной в заголовке сообщения ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00102.01)<br />
<br />
'''Описание:''' Используемый альбом форматов не используется для ЭД в связи со вступлением в действие нового альбома форматов. В настройках указан альбом форматов с истекшим сроком действия. <br />
<br />
'''Решение:''' Войти в меню <span style='border-bottom:1px dotted #000;'>Настройка | Документы | ГТД</span>, вкладка «Выгрузка 1», В блоке «Выгрузка ГТД в формате XML» выбрать действующий на текущую дату альбом форматов.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Ошибка обработки сообщения. Системная ошибка. Процесс обработки или формирования сообщения завершился аварийно. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Коды возврата 09.00001.01 и 09.00005.05)<br />
<br />
'''Описание:''' Сбой в работе таможенного сервера.<br />
<br />
<br />
[[Файл:09.00001.01_09.00005.05_1.png]]<br />
<br />
<br />
'''Решение:''' Если ошибка пришла в ответ на «Запрос на открытие процедуры декларирования», то декларацию необходимо отозвать (на всякий случай), сдублировать и заново отправить. В случае, если ошибка вернулась в ответ на повторно отправленную ГТД либо на отправленный документ или контейнер после присвоения номера, то необходимо повторно выслать сообщение в рамках данной процедуры.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Несоответствие кода запрашиваемого документа(DocCode) и его DocumentModeID. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Коды возврата 09.00000.32)<br />
<br />
<br />
[[Файл:09.00000.32_1.png]]<br />
<br />
'''Описание:''' Документ, отправляемый в ответ на запрос инспектора в таможню, не соответствует коду запроса от инспектора.<br />
<br />
'''Решение:''' Необходимо в окне Привязка и отправка документов ЭД выделить строку с неверно привязанным документом и нажать на кнопку «Привязать документ». После этого выбрать необходимый тип документа и привязать готовый ЭД документ, после отправить в таможню.<br/><br />
В описи есть таблица соответствия документов альбома форматов классификатору видов документов, используемых при заявлении сведений в графе 44 ГТД. Открыть таблицу можно из Описи, нажав на синий кружок в заголовке столбца «Код». В левом столбце таблицы указан код, а в правом ЭД документ, который соответствует по альбому форматов данному коду.<br />
<br />
<br />
[[Файл:09.00000.32_2.png]]<br />
<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Общая ошибка при работе системы. ==<br />
<br />
'''Код ошибки:''' CMN.09999 (Код возврата 99.99999.99)<br />
<br />
'''Описание:''' Временный сбой в таможне<br />
<br />
'''Решение:''' Попробовать повторить действия, на которые вернулась данная ошибка (отправка документа, открытие процедуры и т.д.) позже.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Невозможно заменить незаменяемый документ. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00017.01)<br />
<br />
<br />
[[Файл:03.00017.01_1.png]]<br />
<br />
<br />
'''Описание:''' В списке сообщений по декларации нарушена ссылочность. У последнего по дате успешно отправленного контейнера стоит неверный статус.<br />
<br />
'''Причина:''' Сбой в таможне при попытке повторно обработать одно и то же сообщение. При этом декларанту приходит «ошибка обработки сообщения» (возможно, несколько раз подряд). Также причиной может стать неверное выставление статусов вручную декларантом. <br />
<br />
'''Решение:''' Например, есть повторно отправленная декларация и в ответ с таможни пришли следующие по порядку сообщения: Получено, Обработано, Получено, Ошибка. Так как есть сообщения «получено» и «обработано», статус у повторно отправленной ДТ должен смениться на ОК. Но на самом деле у ДТ статус стоит «Не принято». При этом повторно отправленная ДТ ссылается не на описанное выше сообщение, а на предыдущее, вследствие чего приходит ошибка. Изменить неверный статус у сообщения на ОК и повторить отсылку сообщения.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Запрошенный документ отсутствует в БД. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 02.00001.01)<br />
<br />
<br />
[[Файл:02.00001.01_1.png]]<br />
<br />
<br />
'''Описание:''' При повторной отправке декларации по ЭД, контейнер ссылается на предыдущую отправленную ДТ. Но так как на сервере таможни предыдущего сообщения нет, таможенный сервер возвращает такую ошибку.<br/>Данная проблема схожа с ошибкой «Невозможно заменить незаменяемый документ». Основная причина может быть связана с нарушением ссылочности эд-сообщений. Реже – сбои в таможенной системе.<br />
<br />
'''Решение:''' Запросить историю процедуры. Если есть пропущенные – запросить их и после получения повторить отправку. Если ошибка повторилась – необходимо обратиться к специалистам техподдержки для разрешения проблемы с отправкой.<br />
<br />
<br />
----</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9E%D1%88%D0%B8%D0%B1%D0%BA%D0%B8_%D0%BF%D1%80%D0%B8_%D0%AD%D0%94-2&diff=412
Ошибки при ЭД-2
2013-02-01T11:32:39Z
<p>Vetoshkin: </p>
<hr />
<div>[[Категория:ЭД-2]][[Категория:Альта-ГТД]]<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Документ отсутствует в альбоме форматов ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00071.04)<br />
<br />
'''Описание:''' По ЭД отправляют документ, отсутствующий в секции ЭД и не описанный в действующем альбоме форматов.<br />
<br />
'''Решение:''' Необходимо формализовать документ описанным в альбоме форматов ЭД документом и отправить в таможню.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>В текущем статусном состоянии обработка данного сообщения невозможна. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 02.00081.01)<br />
<br />
'''Описание:''' На сервере таможни по процедуре стоит статус, при котором обработка сервером отправленного сообщения невозможна.<br />
<br />
<br />
<span style='color:#00f;'>Пример 1:</span> Нельзя отправлять документы или ДТ во время проведения досмотра<br/><br />
<span style='color:#00f;'>Пример 2:</span> Нельзя отвечать измененной ПРД на «Уведомление о прибытии товаров на СВХ…».<br/><br />
<span style='color:#00f;'>Пример 3:</span> Нельзя ничего отправлять после закрытия процедуры: ДТ отозвана, Переход на декларирование в общеустановленном порядке (На бумаге), отказ в регистрации ДТ.<br />
<br />
<br />
[[Файл:02.00081.01_1.png]]<br />
<br />
На примере выше, повторная отправка ДТ после отказа в регистрации возвращается с ошибкой.<br />
<br />
<br />
[[Файл:02.00081.01_2.png]]<br />
<br />
<br />
'''Решение:''' В указанном на картинке примере решением является в ответ на «Уведомление о прибытии товаров на СВХ…» отправка «Уведомления о прибытии товаров (ПРД)».<br />
<br />
<br />
[[Файл:02.00081.01_3.png]]<br />
<br />
<br />
Во время проведения досмотра отправка эд документов невозможна. Необходимо дождаться от инспектора акт таможенного досмотра.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Код КАСТО назначения не зарегистрирован в системе. ==<br />
<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.01)<br />
<br />
<br />
[[Файл:01.00038.01_1.png]]<br />
<br />
<br />
'''Описание:''' Пост, на который происходит отправка ДТ, не поддерживает электронное декларирование. Либо ДТ отправлена на несуществующий или устаревший пост.<br />
<br />
'''Решение:''' Электронное декларирование возможно только с постом, поддерживающим ЭД. Иначе декларирование на бумаге.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Код внутреннего таможенного органа отсутствует в списке ТО, участвующих в применении технологии удаленного выпуска. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.02)<br />
<br />
'''Описание:''' Пост, на который отправлена декларация не поддерживает удаленное декларирование.<br />
<br />
'''Решение:''' При такой ошибке отправка по ЭД на пост невозможна. Подать ДТ на бумаге. <br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Указанная комбинация внутренний ТО - приграничный ТО отсутствует списке ТО, участвующих в применении технологии удаленного выпуска. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.04)<br />
<br />
<br />
[[Файл:01.00038.04_1.png]]<br />
<br />
<br />
'''Описание:''' Пост, на который отправлена ДТ и пост, указанный в гр.7 ДТ «Код поста (удал. декл.)» не могут взаимодействовать друг с другом по технологии удаленного выпуска.<br />
<br />
'''Решение:''' Если в гр.7 ДТ «Код поста (удал. декл.)» стоит нужный пост и отсылка происходит на верный пост, то эти два поста не могут друг с другом взаимодействовать по технологии удаленного выпуска.<br/>Иначе, <br />
проверить на какой пост была выслана декларация. Возможно из-за некорректных настроек выбора поста при отправке по ЭД, ДТ была отправлена на неверный пост.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Процедура декларирования отсутствует в системе. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00041.01)<br />
<br />
<br />
[[Файл:01.00041.01_1.png]]<br />
<br />
''Версия альбома форматов отличная от первоначальной. Документ был отослан в формате 5.0.7, а процедура была начата в формате 5.0.8''<br />
<br />
<br />
'''Описание:''' <br/><br />
После открытия процедуры декларирования изменились:<br/><br />
1. Версия альбома форматов. Например: процедура открыта в 5.0.8, сообщения отправляют в 5.0.9<br/><br />
2. Поле отправитель. Например, была изменена привязанная к ЭЦП фирма в меню «настройка сертификатов»<br/><br />
3. Код поста. Встречается при восстановлении процедуры декларирования.<br/><br />
4. Изменен тип декларации. Например, отправили ГТД, изменили на ПРД и продолжили.<br/><br />
5. Идентификатор процедуры. При восстановлении процедуры, был указан несуществующий ID процедуры.<br />
<br />
'''Решение:''' Проверить причину ошибки можно в окне <span style='border-bottom:1px dotted #000;'>Каталог | Электронное декларирование | Открыть окно сообщений ЭД</span> и отфильтровав по идентификатору процедуры.<br/>Сравнить описанные выше данные у успешно отправленных сообщений и у сообщений, на которые вернулась ошибка.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Подан неполный набор первоначальных документов. Документ-контейнер не содержит обязательного набора документов. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00011.01)<br />
<br />
<br />
[[Файл:03.00011.01_1.png]]<br />
<br />
<br />
'''Описание:''' При отправке в контейнере отсутствует ДТС и/или Опись.<br/><br />
Опись при отправке ДТ должна присутствовать всегда. Наличие ДТС в ЭД контейнере обязательно, кроме тех случаев, когда платежи не зависят от стоимости товаров.<br/>Например, режим чистого экспорта, режим импорта при перемещении припасов.<br />
<br />
'''Решение:''' Создать ДТС и/или опись и отправить полный контейнер в таможню.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Подан неполный набор первоначальных документов. Признак подачи неполного контейнера не установлен. Документ-контейнер не содержит обязательного набора документов, либо не установлен флаг ''FullSetIndicator''. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00012.01)<br />
<br />
<br />
[[Файл:03.00012.01_1.png]]<br />
<br />
<br />
'''Описание:''' При отправке в контейнере отсутствует ДТС и/или Опись. Если ДТС не должна быть, то в контейнере отсутствует флаг ''FullSetIndicator''.<br />
<br />
'''Решение:''' Ошибка может встретиться, например, если декларант выгрузил ДТ в XML и из нее пытается открыть процедуру.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Внесение изменений в ДТ при необработанном предыдущем сообщении на изменение ДТ невозможно. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00021.01)<br />
<br />
'''Описание:''' На каждую отправленную ДТ должно быть сообщение с решением по данной ДТ. На передано ГТД ответом является протокол ошибок или присвоение номера, на повторно отправленную ДТ, «разрешено внести изменения» или «отказ во внесении изменений». Если у повторно отправленной ДТ стоит статус обрабатывается, это значит что на данное сообщение не было ответа от инспектора. При этом на повторную отправку декларантом контейнера, будет приходить подобная ошибка.<br />
<br />
<br />
[[Файл:03.00021.01_1.png]]<br />
<br />
<br />
'''Решение:''' Дождаться решения по декларации со статусом «Обрабатывается» и после этого выслать повторно с изменениями.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Превышен интервал ожидания ответа от архива декларанта. При работе сервиса электронного архива декларанта возникла ошибка. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00024.01)<br />
<br />
'''Описание:''' Не работает архив в таможне.<br />
<br />
'''Решение:''' Попробовать отправить запрос на создание архива или документ в архив позже.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Документы не прошли проверку ФЛК. Ошибка при работе сервиса проверки документов. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00100.00 03.00100.01)<br />
<br />
'''Описание:''' Кратковременный сбой в работе сервиса проверки таможенного сервера.<br />
<br />
'''Решение:''' Отправить документ повторно через некоторое время.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Обработка документов данного формата запрещена. Формат не вступил в действие.Обработка документов данного формата запрещена. Формат не вступил в действие. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00101.01)<br />
<br />
'''Описание:''' Используемый альбом форматов не вступил в действие. В настройках был выбран не вступивший в действие альбом форматов. Либо системная дата на компьютере установлена неверно, а в настройках выбора альбома форматов установлено «Авто (зависит от даты)».<br />
<br />
'''Решение:''' Войти в меню <span style='border-bottom:1px dotted #000;'>Настройка | Документы | ГТД</span>, вкладка «Выгрузка 1», В блоке «Выгрузка ГТД в формате XML» выбрать действующий на текущую дату альбом форматов. Либо установить верную системную дату.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Обработка документов данного формата запрещена. Истек срок действия формата. Истек срок действия версии альбома форматов, указанной в заголовке сообщения ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00102.01)<br />
<br />
'''Описание:''' Используемый альбом форматов не используется для ЭД в связи со вступлением в действие нового альбома форматов. В настройках указан альбом форматов с истекшим сроком действия. <br />
<br />
'''Решение:''' Войти в меню <span style='border-bottom:1px dotted #000;'>Настройка | Документы | ГТД</span>, вкладка «Выгрузка 1», В блоке «Выгрузка ГТД в формате XML» выбрать действующий на текущую дату альбом форматов.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Ошибка обработки сообщения. Системная ошибка. Процесс обработки или формирования сообщения завершился аварийно. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Коды возврата 09.00001.01 и 09.00005.05)<br />
<br />
'''Описание:''' Сбой в работе таможенного сервера.<br />
<br />
<br />
[[Файл:09.00001.01_09.00005.05_1.png]]<br />
<br />
<br />
'''Решение:''' Если ошибка пришла в ответ на «Запрос на открытие процедуры декларирования», то декларацию необходимо отозвать (на всякий случай), сдублировать и заново отправить. В случае, если ошибка вернулась в ответ на повторно отправленную ГТД либо на отправленный документ или контейнер после присвоения номера, то необходимо повторно выслать сообщение в рамках данной процедуры.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Несоответствие кода запрашиваемого документа(DocCode) и его DocumentModeID. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Коды возврата 09.00000.32)<br />
<br />
<br />
[[Файл:09.00000.32_1.png]]<br />
<br />
'''Описание:''' Документ, отправляемый в ответ на запрос инспектора в таможню, не соответствует коду запроса от инспектора.<br />
<br />
'''Решение:''' Необходимо в окне Привязка и отправка документов ЭД выделить строку с неверно привязанным документом и нажать на кнопку «Привязать документ». После этого выбрать необходимый тип документа и привязать готовый ЭД документ, после отправить в таможню.<br/><br />
В описи есть таблица соответствия документов альбома форматов классификатору видов документов, используемых при заявлении сведений в графе 44 ГТД. Открыть таблицу можно из Описи, нажав на синий кружок в заголовке столбца «Код». В левом столбце таблицы указан код, а в правом ЭД документ, который соответствует по альбому форматов данному коду.<br />
<br />
<br />
[[Файл:09.00000.32_2.png]]<br />
<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Общая ошибка при работе системы. ==<br />
<br />
'''Код ошибки:''' CMN.09999 (Код возврата 99.99999.99)<br />
<br />
'''Описание:''' Временный сбой в таможне<br />
<br />
'''Решение:''' Попробовать повторить действия, на которые вернулась данная ошибка (отправка документа, открытие процедуры и т.д.) позже.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Невозможно заменить незаменяемый документ. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00017.01)<br />
<br />
<br />
[[Файл:03.00017.01_1.png]]<br />
<br />
<br />
'''Описание:''' В списке сообщений по декларации нарушена ссылочность. У последнего по дате успешно отправленного контейнера стоит неверный статус.<br />
<br />
'''Причина:''' Сбой в таможне при попытке повторно обработать одно и то же сообщение. При этом декларанту приходит «ошибка обработки сообщения» (возможно, несколько раз подряд). Также причиной может стать неверное выставление статусов вручную декларантом. <br />
<br />
'''Решение:''' Например, есть повторно отправленная декларация и в ответ с таможни пришли следующие по порядку сообщения: Получено, Обработано, Получено, Ошибка. Так как есть сообщения «получено» и «обработано», статус у повторно отправленной ДТ должен смениться на ОК. Но на самом деле у ДТ статус стоит «Не принято». При этом повторно отправленная ДТ ссылается не на описанное выше сообщение, а на предыдущее, вследствие чего приходит ошибка. Изменить неверный статус у сообщения на ОК и повторить отсылку сообщения.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Запрошенный документ отсутствует в БД. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 02.00001.01)<br />
<br />
<br />
[[Файл:02.00001.01_1.png]]<br />
<br />
<br />
'''Описание:''' При повторной отправке декларации по ЭД, контейнер ссылается на предыдущую отправленную ДТ. Но так как на сервере таможни предыдущего сообщения нет, таможенный сервер возвращает такую ошибку.<br/>Данная проблема схожа с ошибкой «Невозможно заменить незаменяемый документ». Основная причина может быть связана с нарушением ссылочности эд-сообщений. Реже – сбои в таможенной системе.<br />
<br />
'''Решение:''' Запросить историю процедуры. Если есть пропущенные – запросить их и после получения повторить отправку. Если ошибка повторилась – необходимо обратиться к специалистам техподдержки для разрешения проблемы с отправкой.<br />
<br />
<br />
----</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9E%D1%88%D0%B8%D0%B1%D0%BA%D0%B8_%D0%BF%D1%80%D0%B8_%D0%AD%D0%94-2&diff=411
Ошибки при ЭД-2
2013-02-01T11:07:05Z
<p>Vetoshkin: </p>
<hr />
<div>[[Категория:ЭД-2]][[Категория:Альта-ГТД]]<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Документ отсутствует в альбоме форматов ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00071.04)<br />
<br />
'''Описание:''' По ЭД отправляют документ, отсутствующий в секции ЭД и не описанный в действующем альбоме форматов.<br />
<br />
'''Решение:''' Необходимо формализовать документ описанным в альбоме форматов ЭД документом и отправить в таможню.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>В текущем статусном состоянии обработка данного сообщения невозможна. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 02.00081.01)<br />
<br />
'''Описание:''' На сервере таможни по процедуре стоит статус, при котором обработка сервером отправленного сообщения невозможна.<br />
<br />
<br />
Например: Нельзя отправлять документы или ДТ во время проведения досмотра или отвечать измененной ПРД на «Уведомление о прибытии товаров на СВХ…».<br/>Также эта ошибка может приходить после закрытия процедуры: ДТ отозвана, Переход на декларирование в общеустановленном порядке (На бумаге), отказ в регистрации ДТ.<br />
<br />
<br />
[[Файл:02.00081.01_1.png]]<br />
<br />
На примере выше, повторная отправка ДТ после отказа в регистрации возвращается с ошибкой.<br />
<br />
<br />
[[Файл:02.00081.01_2.png]]<br />
<br />
<br />
'''Решение:''' В указанном на картинке примере решением является в ответ на «Уведомление о прибытии товаров на СВХ…» отправка «Уведомления о прибытии товаров (ПРД)».<br />
<br />
<br />
[[Файл:02.00081.01_3.png]]<br />
<br />
<br />
Во время проведения досмотра отправка эд документов невозможна. Необходимо дождаться от инспектора акт таможенного досмотра.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Код КАСТО назначения не зарегистрирован в системе. ==<br />
<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.01)<br />
<br />
<br />
[[Файл:01.00038.01_1.png]]<br />
<br />
<br />
'''Описание:''' Пост, на который происходит отправка ДТ, не поддерживает электронное декларирование. Либо ДТ отправлена на несуществующий или устаревший пост.<br />
<br />
'''Решение:''' Электронное декларирование возможно только с постом, поддерживающим ЭД. Иначе декларирование на бумаге.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Код внутреннего таможенного органа отсутствует в списке ТО, участвующих в применении технологии удаленного выпуска. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.02)<br />
<br />
'''Описание:''' Пост, на который отправлена декларация не поддерживает удаленное декларирование.<br />
<br />
'''Решение:''' При такой ошибке отправка по ЭД на пост невозможна. Подать ДТ на бумаге. <br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Указанная комбинация внутренний ТО - приграничный ТО отсутствует списке ТО, участвующих в применении технологии удаленного выпуска. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.04)<br />
<br />
<br />
[[Файл:01.00038.04_1.png]]<br />
<br />
<br />
'''Описание:''' Пост, на который отправлена ДТ и пост, указанный в гр.7 ДТ «Код поста (удал. декл.)» не могут взаимодействовать друг с другом по технологии удаленного выпуска.<br />
<br />
'''Решение:''' Если в гр.7 ДТ «Код поста (удал. декл.)» стоит нужный пост и отсылка происходит на верный пост, то эти два поста не могут друг с другом взаимодействовать по технологии удаленного выпуска.<br/>Иначе, <br />
проверить на какой пост была выслана декларация. Возможно из-за некорректных настроек выбора поста при отправке по ЭД, ДТ была отправлена на неверный пост.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Процедура декларирования отсутствует в системе. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00041.01)<br />
<br />
<br />
[[Файл:01.00041.01_1.png]]<br />
<br />
''Версия альбома форматов отличная от первоначальной. Документ был отослан в формате 5.0.7, а процедура была начата в формате 5.0.8''<br />
<br />
<br />
'''Описание:''' <br/><br />
После открытия процедуры декларирования изменились:<br/><br />
1. Версия альбома форматов. Например: процедура открыта в 5.0.8, сообщения отправляют в 5.0.9<br/><br />
2. Поле отправитель. Например, была изменена привязанная к ЭЦП фирма в меню «настройка сертификатов»<br/><br />
3. Код поста. Встречается при восстановлении процедуры декларирования.<br/><br />
4. Изменен тип декларации. Например, отправили ГТД, изменили на ПРД и продолжили.<br/><br />
5. Идентификатор процедуры. При восстановлении процедуры, был указан несуществующий ID процедуры.<br />
<br />
'''Решение:''' Проверить причину ошибки можно в окне <span style='border-bottom:1px dotted #000;'>Каталог | Электронное декларирование | Открыть окно сообщений ЭД</span> и отфильтровав по идентификатору процедуры.<br/>Сравнить описанные выше данные у успешно отправленных сообщений и у сообщений, на которые вернулась ошибка.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Подан неполный набор первоначальных документов. Документ-контейнер не содержит обязательного набора документов. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00011.01)<br />
<br />
<br />
[[Файл:03.00011.01_1.png]]<br />
<br />
<br />
'''Описание:''' При отправке в контейнере отсутствует ДТС и/или Опись.<br/><br />
Опись при отправке ДТ должна присутствовать всегда. Наличие ДТС в ЭД контейнере обязательно, кроме тех случаев, когда платежи не зависят от стоимости товаров.<br/>Например, режим чистого экспорта, режим импорта при перемещении припасов.<br />
<br />
'''Решение:''' Создать ДТС и/или опись и отправить полный контейнер в таможню.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Подан неполный набор первоначальных документов. Признак подачи неполного контейнера не установлен. Документ-контейнер не содержит обязательного набора документов, либо не установлен флаг ''FullSetIndicator''. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00012.01)<br />
<br />
<br />
[[Файл:03.00012.01_1.png]]<br />
<br />
<br />
'''Описание:''' При отправке в контейнере отсутствует ДТС и/или Опись. Если ДТС не должна быть, то в контейнере отсутствует флаг ''FullSetIndicator''.<br />
<br />
'''Решение:''' Ошибка может встретиться, например, если декларант выгрузил ДТ в XML и из нее пытается открыть процедуру.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Внесение изменений в ДТ при необработанном предыдущем сообщении на изменение ДТ невозможно. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00021.01)<br />
<br />
'''Описание:''' На каждую отправленную ДТ должно быть сообщение с решением по данной ДТ. На передано ГТД ответом является протокол ошибок или присвоение номера, на повторно отправленную ДТ, «разрешено внести изменения» или «отказ во внесении изменений». Если у повторно отправленной ДТ стоит статус обрабатывается, это значит что на данное сообщение не было ответа от инспектора. При этом на повторную отправку декларантом контейнера, будет приходить подобная ошибка.<br />
<br />
<br />
[[Файл:03.00021.01_1.png]]<br />
<br />
<br />
'''Решение:''' Дождаться решения по декларации со статусом «Обрабатывается» и после этого выслать повторно с изменениями.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Превышен интервал ожидания ответа от архива декларанта. При работе сервиса электронного архива декларанта возникла ошибка. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00024.01)<br />
<br />
'''Описание:''' Не работает архив в таможне.<br />
<br />
'''Решение:''' Попробовать отправить запрос на создание архива или документ в архив позже.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Документы не прошли проверку ФЛК. Ошибка при работе сервиса проверки документов. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00100.00 03.00100.01)<br />
<br />
'''Описание:''' Кратковременный сбой в работе сервиса проверки таможенного сервера.<br />
<br />
'''Решение:''' Отправить документ повторно через некоторое время.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Обработка документов данного формата запрещена. Формат не вступил в действие.Обработка документов данного формата запрещена. Формат не вступил в действие. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00101.01)<br />
<br />
'''Описание:''' Используемый альбом форматов не вступил в действие. В настройках был выбран не вступивший в действие альбом форматов. Либо системная дата на компьютере установлена неверно, а в настройках выбора альбома форматов установлено «Авто (зависит от даты)».<br />
<br />
'''Решение:''' Войти в меню <span style='border-bottom:1px dotted #000;'>Настройка | Документы | ГТД</span>, вкладка «Выгрузка 1», В блоке «Выгрузка ГТД в формате XML» выбрать действующий на текущую дату альбом форматов. Либо установить верную системную дату.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Обработка документов данного формата запрещена. Истек срок действия формата. Истек срок действия версии альбома форматов, указанной в заголовке сообщения ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00102.01)<br />
<br />
'''Описание:''' Используемый альбом форматов не используется для ЭД в связи со вступлением в действие нового альбома форматов. В настройках указан альбом форматов с истекшим сроком действия. <br />
<br />
'''Решение:''' Войти в меню <span style='border-bottom:1px dotted #000;'>Настройка | Документы | ГТД</span>, вкладка «Выгрузка 1», В блоке «Выгрузка ГТД в формате XML» выбрать действующий на текущую дату альбом форматов.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Ошибка обработки сообщения. Системная ошибка. Процесс обработки или формирования сообщения завершился аварийно. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Коды возврата 09.00001.01 и 09.00005.05)<br />
<br />
'''Описание:''' Сбой в работе таможенного сервера.<br />
<br />
<br />
[[Файл:09.00001.01_09.00005.05_1.png]]<br />
<br />
<br />
'''Решение:''' Если ошибка пришла в ответ на «Запрос на открытие процедуры декларирования», то декларацию необходимо отозвать (на всякий случай), сдублировать и заново отправить. В случае, если ошибка вернулась в ответ на повторно отправленную ГТД либо на отправленный документ или контейнер после присвоения номера, то необходимо повторно выслать сообщение в рамках данной процедуры.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Несоответствие кода запрашиваемого документа(DocCode) и его DocumentModeID. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Коды возврата 09.00000.32)<br />
<br />
<br />
[[Файл:09.00000.32_1.png]]<br />
<br />
'''Описание:''' Документ, отправляемый в ответ на запрос инспектора в таможню, не соответствует коду запроса от инспектора.<br />
<br />
'''Решение:''' Необходимо в окне Привязка и отправка документов ЭД выделить строку с неверно привязанным документом и нажать на кнопку «Привязать документ». После этого выбрать необходимый тип документа и привязать готовый ЭД документ, после отправить в таможню.<br/><br />
В описи есть таблица соответствия документов альбома форматов классификатору видов документов, используемых при заявлении сведений в графе 44 ГТД. Открыть таблицу можно из Описи, нажав на синий кружок в заголовке столбца «Код». В левом столбце таблицы указан код, а в правом ЭД документ, который соответствует по альбому форматов данному коду.<br />
<br />
<br />
[[Файл:09.00000.32_2.png]]<br />
<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Общая ошибка при работе системы. ==<br />
<br />
'''Код ошибки:''' CMN.09999 (Код возврата 99.99999.99)<br />
<br />
'''Описание:''' Временный сбой в таможне<br />
<br />
'''Решение:''' Попробовать повторить действия, на которые вернулась данная ошибка (отправка документа, открытие процедуры и т.д.) позже.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Невозможно заменить незаменяемый документ. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00017.01)<br />
<br />
<br />
[[Файл:03.00017.01_1.png]]<br />
<br />
<br />
'''Описание:''' В списке сообщений по декларации нарушена ссылочность. У последнего по дате успешно отправленного контейнера стоит неверный статус.<br />
<br />
'''Причина:''' Сбой в таможне при попытке повторно обработать одно и то же сообщение. При этом декларанту приходит «ошибка обработки сообщения» (возможно, несколько раз подряд). Также причиной может стать неверное выставление статусов вручную декларантом. <br />
<br />
'''Решение:''' Например, есть повторно отправленная декларация и в ответ с таможни пришли следующие по порядку сообщения: Получено, Обработано, Получено, Ошибка. Так как есть сообщения «получено» и «обработано», статус у повторно отправленной ДТ должен смениться на ОК. Но на самом деле у ДТ статус стоит «Не принято». При этом повторно отправленная ДТ ссылается не на описанное выше сообщение, а на предыдущее, вследствие чего приходит ошибка. Изменить неверный статус у сообщения на ОК и повторить отсылку сообщения.<br />
<br />
<br />
<br />
== <span style='display:none'>.&nbsp;&nbsp;</span>Запрошенный документ отсутствует в БД. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 02.00001.01)<br />
<br />
<br />
[[Файл:02.00001.01_1.png]]<br />
<br />
<br />
'''Описание:''' При повторной отправке декларации по ЭД, контейнер ссылается на предыдущую отправленную ДТ. Но так как на сервере таможни предыдущего сообщения нет, таможенный сервер возвращает такую ошибку.<br/>Данная проблема схожа с ошибкой «Невозможно заменить незаменяемый документ». Основная причина может быть связана с нарушением ссылочности эд-сообщений. Реже – сбои в таможенной системе.<br />
<br />
'''Решение:''' Запросить историю процедуры. Если есть пропущенные – запросить их и после получения повторить отправку. Если ошибка повторилась – необходимо обратиться к специалистам техподдержки для разрешения проблемы с отправкой.<br />
<br />
<br />
----</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9F%D0%B5%D1%81%D0%BE%D1%87%D0%BD%D0%B8%D1%86%D0%B0&diff=409
Песочница
2013-02-01T10:48:00Z
<p>Vetoshkin: </p>
<hr />
<div>== Тест раздел1 ==<br />
<br />
авплдваолп ваодплваодопл <br />
<br />
323263<br />
м247983247<br />
<br />
== Второй тест ==<br />
<br />
Основная статья об [[Второй раздел, песочницы|песочнице]]<br />
<br />
== Второй тест ==<br />
<br />
В песочнице живут маленькие песочные черви (с)Ф.Хереберт "Дюна"<br />
<br />
== Второй тест ==<br />
<br />
В песочнице можно прятать лимоны (с)Группа "Дюна"<br />
<br />
<div style='margin:0px 50px;'><br />
<br />
<div style='background:#fff;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(7deg);-ms-transform:rotate(7deg); /* IE 9 */-moz-transform:rotate(7deg); /* Firefox */-webkit-transform:rotate(7deg); /* Safari and Chrome */-o-transform:rotate(7deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
<div style='background:#fff;position:relative;top:-500px;box-shadow:5px 5px 20px 0px #333;width:500px;height:500px;padding:25px;margin:20px 0;border-radius:10px;transform:rotate(15deg);-ms-transform:rotate(15deg); /* IE 9 */-moz-transform:rotate(15deg); /* Firefox */-webkit-transform:rotate(15deg); /* Safari and Chrome */-o-transform:rotate(15deg); /* Opera */'>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл<div style='border-bottom:1px dotted #666;margin:10px 0;'></div>флыдвоарлдфыовра фылвар фцгшщурало фрывгшдфл оывпашдгг флцупрашдфылвашд глп фцукашдг фыадвг фуашдгфы влоарывгралфо ывлдга флоагшд фпцуагл фыу алдгывп адлфывдг фцлуалдгфы пркаолфырваолд фыдвлга флыовар лдфоурад лфгывл</div><br />
<br />
</div><br />
<br />
[[Категория:Альта-ГТД]]<br />
[[Категория:Тест]]</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9E%D1%88%D0%B8%D0%B1%D0%BA%D0%B8_%D0%BF%D1%80%D0%B8_%D0%AD%D0%94-2&diff=407
Ошибки при ЭД-2
2013-02-01T10:26:33Z
<p>Vetoshkin: </p>
<hr />
<div>[[Категория:ЭД-2]][[Категория:Альта-ГТД]]<br />
<br />
<br />
== Документ отсутствует в альбоме форматов ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00071.04)<br />
<br />
'''Описание:''' По ЭД отправляют документ, отсутствующий в секции ЭД и не описанный в действующем альбоме форматов.<br />
<br />
'''Решение:''' Необходимо формализовать документ описанным в альбоме форматов ЭД документом и отправить в таможню.<br />
<br />
<br />
<br />
== В текущем статусном состоянии обработка данного сообщения невозможна. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 02.00081.01)<br />
<br />
'''Описание:''' На сервере таможни по процедуре стоит статус, при котором обработка сервером отправленного сообщения невозможна.<br />
<br />
<br />
Например: Нельзя отправлять документы или ДТ во время проведения досмотра или отвечать измененной ПРД на «Уведомление о прибытии товаров на СВХ…».<br/>Также эта ошибка может приходить после закрытия процедуры: ДТ отозвана, Переход на декларирование в общеустановленном порядке (На бумаге), отказ в регистрации ДТ.<br />
<br />
<br />
[[Файл:02.00081.01_1.png]]<br />
<br />
На примере выше, повторная отправка ДТ после отказа в регистрации возвращается с ошибкой.<br />
<br />
<br />
[[Файл:02.00081.01_2.png]]<br />
<br />
<br />
'''Решение:''' В указанном на картинке примере решением является в ответ на «Уведомление о прибытии товаров на СВХ…» отправка «Уведомления о прибытии товаров (ПРД)».<br />
<br />
<br />
[[Файл:02.00081.01_3.png]]<br />
<br />
<br />
Во время проведения досмотра отправка эд документов невозможна. Необходимо дождаться от инспектора акт таможенного досмотра.<br />
<br />
<br />
<br />
== Код КАСТО назначения не зарегистрирован в системе. ==<br />
<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.01)<br />
<br />
<br />
[[Файл:01.00038.01_1.png]]<br />
<br />
<br />
'''Описание:''' Пост, на который происходит отправка ДТ, не поддерживает электронное декларирование. Либо ДТ отправлена на несуществующий или устаревший пост.<br />
<br />
'''Решение:''' Электронное декларирование возможно только с постом, поддерживающим ЭД. Иначе декларирование на бумаге.<br />
<br />
<br />
<br />
== Код внутреннего таможенного органа отсутствует в списке ТО, участвующих в применении технологии удаленного выпуска. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.02)<br />
<br />
'''Описание:''' Пост, на который отправлена декларация не поддерживает удаленное декларирование.<br />
<br />
'''Решение:''' При такой ошибке отправка по ЭД на пост невозможна. Подать ДТ на бумаге. <br />
<br />
<br />
<br />
== Указанная комбинация внутренний ТО - приграничный ТО отсутствует списке ТО, участвующих в применении технологии удаленного выпуска. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.04)<br />
<br />
<br />
[[Файл:01.00038.04_1.png]]<br />
<br />
<br />
'''Описание:''' Пост, на который отправлена ДТ и пост, указанный в гр.7 ДТ «Код поста (удал. декл.)» не могут взаимодействовать друг с другом по технологии удаленного выпуска.<br />
<br />
'''Решение:''' Если в гр.7 ДТ «Код поста (удал. декл.)» стоит нужный пост и отсылка происходит на верный пост, то эти два поста не могут друг с другом взаимодействовать по технологии удаленного выпуска.<br/>Иначе, <br />
проверить на какой пост была выслана декларация. Возможно из-за некорректных настроек выбора поста при отправке по ЭД, ДТ была отправлена на неверный пост.<br />
<br />
<br />
<br />
== Процедура декларирования отсутствует в системе. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00041.01)<br />
<br />
<br />
[[Файл:01.00041.01_1.png]]<br />
<br />
''Версия альбома форматов отличная от первоначальной. Документ был отослан в формате 5.0.7, а процедура была начата в формате 5.0.8''<br />
<br />
<br />
'''Описание:''' <br/><br />
После открытия процедуры декларирования изменились:<br/><br />
1. Версия альбома форматов. Например: процедура открыта в 5.0.8, сообщения отправляют в 5.0.9<br/><br />
2. Поле отправитель. Например, была изменена привязанная к ЭЦП фирма в меню «настройка сертификатов»<br/><br />
3. Код поста. Встречается при восстановлении процедуры декларирования.<br/><br />
4. Изменен тип декларации. Например, отправили ГТД, изменили на ПРД и продолжили.<br/><br />
5. Идентификатор процедуры. При восстановлении процедуры, был указан несуществующий ID процедуры.<br />
<br />
'''Решение:''' Проверить причину ошибки можно в окне <span style='border-bottom:1px dotted #000;'>Каталог | Электронное декларирование | Открыть окно сообщений ЭД</span> и отфильтровав по идентификатору процедуры.<br/>Сравнить описанные выше данные у успешно отправленных сообщений и у сообщений, на которые вернулась ошибка.<br />
<br />
<br />
<br />
== Подан неполный набор первоначальных документов. Документ-контейнер не содержит обязательного набора документов. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00011.01)<br />
<br />
<br />
[[Файл:03.00011.01_1.png]]<br />
<br />
<br />
'''Описание:''' При отправке в контейнере отсутствует ДТС и/или Опись.<br/><br />
Опись при отправке ДТ должна присутствовать всегда. Наличие ДТС в ЭД контейнере обязательно, кроме тех случаев, когда платежи не зависят от стоимости товаров.<br/>Например, режим чистого экспорта, режим импорта при перемещении припасов.<br />
<br />
'''Решение:''' Создать ДТС и/или опись и отправить полный контейнер в таможню.<br />
<br />
<br />
<br />
== Подан неполный набор первоначальных документов. Признак подачи неполного контейнера не установлен. Документ-контейнер не содержит обязательного набора документов, либо не установлен флаг ''FullSetIndicator''. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00012.01)<br />
<br />
<br />
[[Файл:03.00012.01_1.png]]<br />
<br />
<br />
'''Описание:''' При отправке в контейнере отсутствует ДТС и/или Опись. Если ДТС не должна быть, то в контейнере отсутствует флаг ''FullSetIndicator''.<br />
<br />
'''Решение:''' Ошибка может встретиться, например, если декларант выгрузил ДТ в XML и из нее пытается открыть процедуру.<br />
<br />
<br />
<br />
== Внесение изменений в ДТ при необработанном предыдущем сообщении на изменение ДТ невозможно. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00021.01)<br />
<br />
'''Описание:''' На каждую отправленную ДТ должно быть сообщение с решением по данной ДТ. На передано ГТД ответом является протокол ошибок или присвоение номера, на повторно отправленную ДТ, «разрешено внести изменения» или «отказ во внесении изменений». Если у повторно отправленной ДТ стоит статус обрабатывается, это значит что на данное сообщение не было ответа от инспектора. При этом на повторную отправку декларантом контейнера, будет приходить подобная ошибка.<br />
<br />
<br />
[[Файл:03.00021.01_1.png]]<br />
<br />
<br />
'''Решение:''' Дождаться решения по декларации со статусом «Обрабатывается» и после этого выслать повторно с изменениями.<br />
<br />
<br />
<br />
== Превышен интервал ожидания ответа от архива декларанта. При работе сервиса электронного архива декларанта возникла ошибка. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00024.01)<br />
<br />
'''Описание:''' Не работает архив в таможне.<br />
<br />
'''Решение:''' Попробовать отправить запрос на создание архива или документ в архив позже.<br />
<br />
<br />
<br />
== Документы не прошли проверку ФЛК. Ошибка при работе сервиса проверки документов. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00100.00 03.00100.01)<br />
<br />
'''Описание:''' Кратковременный сбой в работе сервиса проверки таможенного сервера.<br />
<br />
'''Решение:''' Отправить документ повторно через некоторое время.<br />
<br />
<br />
<br />
== Обработка документов данного формата запрещена. Формат не вступил в действие.Обработка документов данного формата запрещена. Формат не вступил в действие. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00101.01)<br />
<br />
'''Описание:''' Используемый альбом форматов не вступил в действие. В настройках был выбран не вступивший в действие альбом форматов. Либо системная дата на компьютере установлена неверно, а в настройках выбора альбома форматов установлено «Авто (зависит от даты)».<br />
<br />
'''Решение:''' Войти в меню <span style='border-bottom:1px dotted #000;'>Настройка | Документы | ГТД</span>, вкладка «Выгрузка 1», В блоке «Выгрузка ГТД в формате XML» выбрать действующий на текущую дату альбом форматов. Либо установить верную системную дату.<br />
<br />
<br />
<br />
== Обработка документов данного формата запрещена. Истек срок действия формата. Истек срок действия версии альбома форматов, указанной в заголовке сообщения ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00102.01)<br />
<br />
'''Описание:''' Используемый альбом форматов не используется для ЭД в связи со вступлением в действие нового альбома форматов. В настройках указан альбом форматов с истекшим сроком действия. <br />
<br />
'''Решение:''' Войти в меню <span style='border-bottom:1px dotted #000;'>Настройка | Документы | ГТД</span>, вкладка «Выгрузка 1», В блоке «Выгрузка ГТД в формате XML» выбрать действующий на текущую дату альбом форматов.<br />
<br />
<br />
<br />
== Ошибка обработки сообщения. Системная ошибка. Процесс обработки или формирования сообщения завершился аварийно. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Коды возврата 09.00001.01 и 09.00005.05)<br />
<br />
'''Описание:''' Сбой в работе таможенного сервера.<br />
<br />
<br />
[[Файл:09.00001.01_09.00005.05_1.png]]<br />
<br />
<br />
'''Решение:''' Если ошибка пришла в ответ на «Запрос на открытие процедуры декларирования», то декларацию необходимо отозвать (на всякий случай), сдублировать и заново отправить. В случае, если ошибка вернулась в ответ на повторно отправленную ГТД либо на отправленный документ или контейнер после присвоения номера, то необходимо повторно выслать сообщение в рамках данной процедуры.<br />
<br />
<br />
<br />
== Несоответствие кода запрашиваемого документа(DocCode) и его DocumentModeID. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Коды возврата 09.00000.32)<br />
<br />
<br />
[[Файл:09.00000.32_1.png]]<br />
<br />
'''Описание:''' Документ, отправляемый в ответ на запрос инспектора в таможню, не соответствует коду запроса от инспектора.<br />
<br />
'''Решение:''' Необходимо в окне Привязка и отправка документов ЭД выделить строку с неверно привязанным документом и нажать на кнопку «Привязать документ». После этого выбрать необходимый тип документа и привязать готовый ЭД документ, после отправить в таможню.<br/><br />
В описи есть таблица соответствия документов альбома форматов классификатору видов документов, используемых при заявлении сведений в графе 44 ГТД. Открыть таблицу можно из Описи, нажав на синий кружок в заголовке столбца «Код». В левом столбце таблицы указан код, а в правом ЭД документ, который соответствует по альбому форматов данному коду.<br />
<br />
<br />
[[Файл:09.00000.32_2.png]]<br />
<br />
<br />
<br />
<br />
== Общая ошибка при работе системы. ==<br />
<br />
'''Код ошибки:''' CMN.09999 (Код возврата 99.99999.99)<br />
<br />
'''Описание:''' Временный сбой в таможне<br />
<br />
'''Решение:''' Попробовать повторить действия, на которые вернулась данная ошибка (отправка документа, открытие процедуры и т.д.) позже.<br />
<br />
<br />
<br />
== Невозможно заменить незаменяемый документ. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00017.01)<br />
<br />
<br />
[[Файл:03.00017.01_1.png]]<br />
<br />
<br />
'''Описание:''' В списке сообщений по декларации нарушена ссылочность. У последнего по дате успешно отправленного контейнера стоит неверный статус.<br />
<br />
'''Причина:''' Сбой в таможне при попытке повторно обработать одно и то же сообщение. При этом декларанту приходит «ошибка обработки сообщения» (возможно, несколько раз подряд). Также причиной может стать неверное выставление статусов вручную декларантом. <br />
<br />
'''Решение:''' Например, есть повторно отправленная декларация и в ответ с таможни пришли следующие по порядку сообщения: Получено, Обработано, Получено, Ошибка. Так как есть сообщения «получено» и «обработано», статус у повторно отправленной ДТ должен смениться на ОК. Но на самом деле у ДТ статус стоит «Не принято». При этом повторно отправленная ДТ ссылается не на описанное выше сообщение, а на предыдущее, вследствие чего приходит ошибка. Изменить неверный статус у сообщения на ОК и повторить отсылку сообщения.<br />
<br />
<br />
<br />
== Запрошенный документ отсутствует в БД. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 02.00001.01)<br />
<br />
<br />
[[Файл:02.00001.01_1.png]]<br />
<br />
<br />
'''Описание:''' При повторной отправке декларации по ЭД, контейнер ссылается на предыдущую отправленную ДТ. Но так как на сервере таможни предыдущего сообщения нет, таможенный сервер возвращает такую ошибку.<br/>Данная проблема схожа с ошибкой «Невозможно заменить незаменяемый документ». Основная причина может быть связана с нарушением ссылочности эд-сообщений. Реже – сбои в таможенной системе.<br />
<br />
'''Решение:''' Запросить историю процедуры. Если есть пропущенные – запросить их и после получения повторить отправку. Если ошибка повторилась – необходимо обратиться к специалистам техподдержки для разрешения проблемы с отправкой.<br />
<br />
<br />
----</div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:01.00041.01_1.png&diff=406
Файл:01.00041.01 1.png
2013-02-01T10:25:54Z
<p>Vetoshkin: Vetoshkin загружена новая версия «Файл:01.00041.01 1.png»</p>
<hr />
<div></div>
Vetoshkin
https://wiki.alta.ru/index.php?title=%D0%9E%D1%88%D0%B8%D0%B1%D0%BA%D0%B8_%D0%BF%D1%80%D0%B8_%D0%AD%D0%94-2&diff=405
Ошибки при ЭД-2
2013-02-01T10:21:54Z
<p>Vetoshkin: </p>
<hr />
<div>[[Категория:ЭД-2]][[Категория:Альта-ГТД]]<br />
<br />
<br />
== Документ отсутствует в альбоме форматов ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00071.04)<br />
<br />
'''Описание:''' По ЭД отправляют документ, отсутствующий в секции ЭД и не описанный в действующем альбоме форматов.<br />
<br />
'''Решение:''' Необходимо формализовать документ описанным в альбоме форматов ЭД документом и отправить в таможню.<br />
<br />
<br />
<br />
== В текущем статусном состоянии обработка данного сообщения невозможна. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 02.00081.01)<br />
<br />
'''Описание:''' На сервере таможни по процедуре стоит статус, при котором обработка сервером отправленного сообщения невозможна.<br />
<br />
<br />
Например: Нельзя отправлять документы или ДТ во время проведения досмотра или отвечать измененной ПРД на «Уведомление о прибытии товаров на СВХ…».<br/>Также эта ошибка может приходить после закрытия процедуры: ДТ отозвана, Переход на декларирование в общеустановленном порядке (На бумаге), отказ в регистрации ДТ.<br />
<br />
<br />
[[Файл:02.00081.01_1.png]]<br />
<br />
На примере выше, повторная отправка ДТ после отказа в регистрации возвращается с ошибкой.<br />
<br />
<br />
[[Файл:02.00081.01_2.png]]<br />
<br />
<br />
'''Решение:''' В указанном на картинке примере решением является в ответ на «Уведомление о прибытии товаров на СВХ…» отправка «Уведомления о прибытии товаров (ПРД)».<br />
<br />
<br />
[[Файл:02.00081.01_3.png]]<br />
<br />
<br />
Во время проведения досмотра отправка эд документов невозможна. Необходимо дождаться от инспектора акт таможенного досмотра.<br />
<br />
<br />
<br />
== Код КАСТО назначения не зарегистрирован в системе. ==<br />
<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.01)<br />
<br />
<br />
[[Файл:01.00038.01_1.png]]<br />
<br />
<br />
'''Описание:''' Пост, на который происходит отправка ДТ, не поддерживает электронное декларирование. Либо ДТ отправлена на несуществующий или устаревший пост.<br />
<br />
'''Решение:''' Электронное декларирование возможно только с постом, поддерживающим ЭД. Иначе декларирование на бумаге.<br />
<br />
<br />
<br />
== Код внутреннего таможенного органа отсутствует в списке ТО, участвующих в применении технологии удаленного выпуска. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.02)<br />
<br />
'''Описание:''' Пост, на который отправлена декларация не поддерживает удаленное декларирование.<br />
<br />
'''Решение:''' При такой ошибке отправка по ЭД на пост невозможна. Подать ДТ на бумаге. <br />
<br />
<br />
<br />
== Указанная комбинация внутренний ТО - приграничный ТО отсутствует списке ТО, участвующих в применении технологии удаленного выпуска. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00038.04)<br />
<br />
<br />
[[Файл:01.00038.04_1.png]]<br />
<br />
<br />
'''Описание:''' Пост, на который отправлена ДТ и пост, указанный в гр.7 ДТ «Код поста (удал. декл.)» не могут взаимодействовать друг с другом по технологии удаленного выпуска.<br />
<br />
'''Решение:''' Если в гр.7 ДТ «Код поста (удал. декл.)» стоит нужный пост и отсылка происходит на верный пост, то эти два поста не могут друг с другом взаимодействовать по технологии удаленного выпуска.<br/>Иначе, <br />
проверить на какой пост была выслана декларация. Возможно из-за некорректных настроек выбора поста при отправке по ЭД, ДТ была отправлена на неверный пост.<br />
<br />
<br />
<br />
== Процедура декларирования отсутствует в системе. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 01.00041.01)<br />
<br />
<br />
[[Файл:01.00041.01_1.png]]<br />
<br />
<br />
'''Описание:''' <br/><br />
После открытия процедуры декларирования изменились:<br/><br />
1. Версия альбома форматов. Например: процедура открыта в 5.0.8, сообщения отправляют в 5.0.9<br/><br />
2. Поле отправитель. Например, была изменена привязанная к ЭЦП фирма в меню «настройка сертификатов»<br/><br />
3. Код поста. Встречается при восстановлении процедуры декларирования.<br/><br />
4. Изменен тип декларации. Например, отправили ГТД, изменили на ПРД и продолжили.<br/><br />
5. Идентификатор процедуры. При восстановлении процедуры, был указан несуществующий ID процедуры.<br />
<br />
'''Решение:''' Проверить причину ошибки можно в окне <span style='border-bottom:1px dotted #000;'>Каталог | Электронное декларирование | Открыть окно сообщений ЭД</span> и отфильтровав по идентификатору процедуры.<br/>Сравнить описанные выше данные у успешно отправленных сообщений и у сообщений, на которые вернулась ошибка.<br />
<br />
<br />
<br />
== Подан неполный набор первоначальных документов. Документ-контейнер не содержит обязательного набора документов. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00011.01)<br />
<br />
<br />
[[Файл:03.00011.01_1.png]]<br />
<br />
<br />
'''Описание:''' При отправке в контейнере отсутствует ДТС и/или Опись.<br/><br />
Опись при отправке ДТ должна присутствовать всегда. Наличие ДТС в ЭД контейнере обязательно, кроме тех случаев, когда платежи не зависят от стоимости товаров.<br/>Например, режим чистого экспорта, режим импорта при перемещении припасов.<br />
<br />
'''Решение:''' Создать ДТС и/или опись и отправить полный контейнер в таможню.<br />
<br />
<br />
<br />
== Подан неполный набор первоначальных документов. Признак подачи неполного контейнера не установлен. Документ-контейнер не содержит обязательного набора документов, либо не установлен флаг ''FullSetIndicator''. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00012.01)<br />
<br />
<br />
[[Файл:03.00012.01_1.png]]<br />
<br />
<br />
'''Описание:''' При отправке в контейнере отсутствует ДТС и/или Опись. Если ДТС не должна быть, то в контейнере отсутствует флаг ''FullSetIndicator''.<br />
<br />
'''Решение:''' Ошибка может встретиться, например, если декларант выгрузил ДТ в XML и из нее пытается открыть процедуру.<br />
<br />
<br />
<br />
== Внесение изменений в ДТ при необработанном предыдущем сообщении на изменение ДТ невозможно. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00021.01)<br />
<br />
'''Описание:''' На каждую отправленную ДТ должно быть сообщение с решением по данной ДТ. На передано ГТД ответом является протокол ошибок или присвоение номера, на повторно отправленную ДТ, «разрешено внести изменения» или «отказ во внесении изменений». Если у повторно отправленной ДТ стоит статус обрабатывается, это значит что на данное сообщение не было ответа от инспектора. При этом на повторную отправку декларантом контейнера, будет приходить подобная ошибка.<br />
<br />
<br />
[[Файл:03.00021.01_1.png]]<br />
<br />
<br />
'''Решение:''' Дождаться решения по декларации со статусом «Обрабатывается» и после этого выслать повторно с изменениями.<br />
<br />
<br />
<br />
== Превышен интервал ожидания ответа от архива декларанта. При работе сервиса электронного архива декларанта возникла ошибка. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00024.01)<br />
<br />
'''Описание:''' Не работает архив в таможне.<br />
<br />
'''Решение:''' Попробовать отправить запрос на создание архива или документ в архив позже.<br />
<br />
<br />
<br />
== Документы не прошли проверку ФЛК. Ошибка при работе сервиса проверки документов. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00100.00 03.00100.01)<br />
<br />
'''Описание:''' Кратковременный сбой в работе сервиса проверки таможенного сервера.<br />
<br />
'''Решение:''' Отправить документ повторно через некоторое время.<br />
<br />
<br />
<br />
== Обработка документов данного формата запрещена. Формат не вступил в действие.Обработка документов данного формата запрещена. Формат не вступил в действие. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00101.01)<br />
<br />
'''Описание:''' Используемый альбом форматов не вступил в действие. В настройках был выбран не вступивший в действие альбом форматов. Либо системная дата на компьютере установлена неверно, а в настройках выбора альбома форматов установлено «Авто (зависит от даты)».<br />
<br />
'''Решение:''' Войти в меню <span style='border-bottom:1px dotted #000;'>Настройка | Документы | ГТД</span>, вкладка «Выгрузка 1», В блоке «Выгрузка ГТД в формате XML» выбрать действующий на текущую дату альбом форматов. Либо установить верную системную дату.<br />
<br />
<br />
<br />
== Обработка документов данного формата запрещена. Истек срок действия формата. Истек срок действия версии альбома форматов, указанной в заголовке сообщения ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00102.01)<br />
<br />
'''Описание:''' Используемый альбом форматов не используется для ЭД в связи со вступлением в действие нового альбома форматов. В настройках указан альбом форматов с истекшим сроком действия. <br />
<br />
'''Решение:''' Войти в меню <span style='border-bottom:1px dotted #000;'>Настройка | Документы | ГТД</span>, вкладка «Выгрузка 1», В блоке «Выгрузка ГТД в формате XML» выбрать действующий на текущую дату альбом форматов.<br />
<br />
<br />
<br />
== Ошибка обработки сообщения. Системная ошибка. Процесс обработки или формирования сообщения завершился аварийно. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Коды возврата 09.00001.01 и 09.00005.05)<br />
<br />
'''Описание:''' Сбой в работе таможенного сервера.<br />
<br />
<br />
[[Файл:09.00001.01_09.00005.05_1.png]]<br />
<br />
<br />
'''Решение:''' Если ошибка пришла в ответ на «Запрос на открытие процедуры декларирования», то декларацию необходимо отозвать (на всякий случай), сдублировать и заново отправить. В случае, если ошибка вернулась в ответ на повторно отправленную ГТД либо на отправленный документ или контейнер после присвоения номера, то необходимо повторно выслать сообщение в рамках данной процедуры.<br />
<br />
<br />
<br />
== Несоответствие кода запрашиваемого документа(DocCode) и его DocumentModeID. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Коды возврата 09.00000.32)<br />
<br />
<br />
[[Файл:09.00000.32_1.png]]<br />
<br />
'''Описание:''' Документ, отправляемый в ответ на запрос инспектора в таможню, не соответствует коду запроса от инспектора.<br />
<br />
'''Решение:''' Необходимо в окне Привязка и отправка документов ЭД выделить строку с неверно привязанным документом и нажать на кнопку «Привязать документ». После этого выбрать необходимый тип документа и привязать готовый ЭД документ, после отправить в таможню.<br/><br />
В описи есть таблица соответствия документов альбома форматов классификатору видов документов, используемых при заявлении сведений в графе 44 ГТД. Открыть таблицу можно из Описи, нажав на синий кружок в заголовке столбца «Код». В левом столбце таблицы указан код, а в правом ЭД документ, который соответствует по альбому форматов данному коду.<br />
<br />
<br />
[[Файл:09.00000.32_2.png]]<br />
<br />
<br />
<br />
<br />
== Общая ошибка при работе системы. ==<br />
<br />
'''Код ошибки:''' CMN.09999 (Код возврата 99.99999.99)<br />
<br />
'''Описание:''' Временный сбой в таможне<br />
<br />
'''Решение:''' Попробовать повторить действия, на которые вернулась данная ошибка (отправка документа, открытие процедуры и т.д.) позже.<br />
<br />
<br />
<br />
== Невозможно заменить незаменяемый документ. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 03.00017.01)<br />
<br />
<br />
[[Файл:03.00017.01_1.png]]<br />
<br />
<br />
'''Описание:''' В списке сообщений по декларации нарушена ссылочность. У последнего по дате успешно отправленного контейнера стоит неверный статус.<br />
<br />
'''Причина:''' Сбой в таможне при попытке повторно обработать одно и то же сообщение. При этом декларанту приходит «ошибка обработки сообщения» (возможно, несколько раз подряд). Также причиной может стать неверное выставление статусов вручную декларантом. <br />
<br />
'''Решение:''' Например, есть повторно отправленная декларация и в ответ с таможни пришли следующие по порядку сообщения: Получено, Обработано, Получено, Ошибка. Так как есть сообщения «получено» и «обработано», статус у повторно отправленной ДТ должен смениться на ОК. Но на самом деле у ДТ статус стоит «Не принято». При этом повторно отправленная ДТ ссылается не на описанное выше сообщение, а на предыдущее, вследствие чего приходит ошибка. Изменить неверный статус у сообщения на ОК и повторить отсылку сообщения.<br />
<br />
<br />
<br />
== Запрошенный документ отсутствует в БД. ==<br />
<br />
'''Код ошибки:''' CMN.00001 (Код возврата 02.00001.01)<br />
<br />
<br />
[[Файл:02.00001.01_1.png]]<br />
<br />
<br />
'''Описание:''' При повторной отправке декларации по ЭД, контейнер ссылается на предыдущую отправленную ДТ. Но так как на сервере таможни предыдущего сообщения нет, таможенный сервер возвращает такую ошибку.<br/>Данная проблема схожа с ошибкой «Невозможно заменить незаменяемый документ». Основная причина может быть связана с нарушением ссылочности эд-сообщений. Реже – сбои в таможенной системе.<br />
<br />
'''Решение:''' Запросить историю процедуры. Если есть пропущенные – запросить их и после получения повторить отправку. Если ошибка повторилась – необходимо обратиться к специалистам техподдержки для разрешения проблемы с отправкой.<br />
<br />
<br />
----</div>
Vetoshkin