API ЖД Тариф - Описание протокола обмена данными с системой расчета провозной платы на жд от Альта-Софт: различия между версиями
Строка 1: | Строка 1: | ||
− | == Описание протокола обмена данными с системой расчета провозной платы на жд от Альта-Софт == | + | == Описание протокола обмена данными с системой расчета провозной платы на жд (жд тарифа) от Альта-Софт == |
<b>Обмен данными между сервисом Альта-Софт и сторонними ресурсами осуществляется по протоколу http, транспорт xml. <br/> | <b>Обмен данными между сервисом Альта-Софт и сторонними ресурсами осуществляется по протоколу http, транспорт xml. <br/> | ||
Строка 61: | Строка 61: | ||
</ul> | </ul> | ||
</li> | </li> | ||
− | </ol> | + | </ol> |
+ | |||
+ | == Расчет ЖД Тарифа == | ||
+ | |||
+ | <ul> | ||
+ | <li>fst- 5-и значный код станции отправления</li> | ||
+ | <li>tst -5-и значный код станции назначения</li> | ||
+ | <li>fre - 5-и значный код груза ЕТСНГ</li> | ||
+ | <li>frg - 6-и значный код груза ГНГ</li> | ||
+ | <li>fstate - код страны отправления</li> | ||
+ | <li>tstate - код страны назначения</li> | ||
+ | <li>w - вес груза в килограммах</li> | ||
+ | <li>gp - грузоподъемность в тоннах</li> | ||
+ | <li>empt - [0|1], default - 0. Порожняя отправка - 1, груженая - 0.</li> | ||
+ | <li>return - [0|1], default - 0. Рассчитывать возврат - 1, не рассчитывать - 0.</li> | ||
+ | <li>van - код вагона из дерева перевозочных средств</li> | ||
+ | <li>owner - [0|1] default - 0. Принадлежность перевозочного средства, 0 - общего парка, 1 - собств. (арендованный)</li> | ||
+ | <li>route - [0|1], default = 1. Включить нитку маршрута в отчет - 1, не включать - 0.<br /> | ||
+ | <strong>Пример</strong>: http://tax.alta.ru:81/rail.xml?type=calc&fst=01100&tst=22022&fre=01100&frg=10019000&fstate=20&tstate=20&van=200&w=60000&gp=66&owner=0&return=0&empt=0&pi_key=[вставьте ваш api_key]</li> | ||
+ | </ul> |
Версия 21:09, 11 сентября 2017
Содержание
Описание протокола обмена данными с системой расчета провозной платы на жд (жд тарифа) от Альта-Софт
Обмен данными между сервисом Альта-Софт и сторонними ресурсами осуществляется по протоколу http, транспорт xml.
Все запросы в системе – GET.
Для всех запросов необходимо указывать обязательный параметр - api_key.
Api_key выдается клиенту после оплаты доступа к api-функционалу и имеет ограниченный период действия (6 мес или год).
По окончании срока действия ключа (если не было оплачено продление) доступ к функционалу приостанавливается.
Выполнение запроса на выбор из справочника грузов ЕТСНГ и ГНГ
Запрос выбор из справочников грузов состоит из обязательного параметра type и других параметров, завясящих от type.
Для запроса необходимо выполнить GET-запрос на адрес http://tax.alta.ru:81/rail.xml
Возможные значения type:
- type = [fre|frg] Получить список грузов ЕТСНГ (fre) или грузов ГНГ (frg) в формате XML
index = [код или первые символы кода груза или наименование или часть наименования]
corr = [yes|no] Указывет серверу, надо ли искать соответствие ЕТСНГ-ГНГ. По умолчанию yes.
Пример 1: http://tax.alta.ru:81/rail.xml?type=fre&index=011&encoding=utf-8&api_key=[вставьте ваш api_key] (получить список грузов ЕТСНГ код которых начинается на "011" и соответствующих им грузов ГНГ)
Пример 2: http://tax.alta.ru:81/rail.xml?type=frg&index=пшен&encoding=utf-8&corr=no&api_key[вставьте ваш api_key] (получить список грузов ГНГ наименование который содержит "пшен". НЕ чуствителен к регистру. НЕ будет выводить соответствующие грузы из справочника ЕТСНГ)
Выполнение запроса на выбор из справочника станций
Запрос выбор из справочников грузов состоит из обязательного параметра type и других параметров, завясящих от type.
Для запроса необходимо выполнить GET-запрос на адрес http://tax.alta.ru:81/rail.xml
Возможные значения type:
- type = [fst|tst] Получить список станций назначения (fst) или отправления (tst) в формате XML
index = [код или первые символы кода станции или наименование или часть наименования],
Пример 1: http://tax.alta.ru:81/rail.xml?type=tst&index=104&encoding=utf-8&api_key=[вставьте ваш api_key] (получить список станций назначения код которых начинается на "104")
Пример 2: http://tax.alta.ru:81/rail.xml?type=fst&index=моск&encoding=utf-8&api_key=[вставьте ваш api_key] (получить список станций отправления наименование который содержит "моск". НЕ чуствителен к регистру)
Выполнение запроса на выбор из справочника государств
Послать запрос вида:
http://tax.alta.ru:81/rail.xml?type=states
Выполнение запроса на получение дерева отправок и перевозочных средств
- type = [van_tree] Получить дерево перевозочных средств.
- kind = xml (дерево пс в виде xml, по умолчанию)
- kind = html (дерево пс в виде html-тегов ul-li для удобного отображения с использованием плагина jQuery - Treeview)
Пример: http://tax.alta.ru:81/rail.xml?type=van_tree&kind=ul&encoding=utf-8
Расчет ЖД Тарифа
- fst- 5-и значный код станции отправления
- tst -5-и значный код станции назначения
- fre - 5-и значный код груза ЕТСНГ
- frg - 6-и значный код груза ГНГ
- fstate - код страны отправления
- tstate - код страны назначения
- w - вес груза в килограммах
- gp - грузоподъемность в тоннах
- empt - [0|1], default - 0. Порожняя отправка - 1, груженая - 0.
- return - [0|1], default - 0. Рассчитывать возврат - 1, не рассчитывать - 0.
- van - код вагона из дерева перевозочных средств
- owner - [0|1] default - 0. Принадлежность перевозочного средства, 0 - общего парка, 1 - собств. (арендованный)
- route - [0|1], default = 1. Включить нитку маршрута в отчет - 1, не включать - 0.
Пример: http://tax.alta.ru:81/rail.xml?type=calc&fst=01100&tst=22022&fre=01100&frg=10019000&fstate=20&tstate=20&van=200&w=60000&gp=66&owner=0&return=0&empt=0&pi_key=[вставьте ваш api_key]