Метод GET_TR
Взвешивания получаются по одному (метод GET_TR).
Пример объекта, возвращаемого при выполнении запроса:
{
"id": 106347905,
"docnum": 1,
"wh": "17472ec4a4fd11e3a990ce060c6a533e",
"tr": "5b441c39239c11e9b28d7ed30a686b1f",
"dr": "BE74F4A2684C4554B86EE30E36140F58",
"ws": "15.08.2019",
"full": 20360,
"empty": 9300,
"takeouts": [{
"tr": "98cef874812511e9b28f7ed30a686b1f",
"dr": "FA768A55F6F811E880BB466AA649DD6D",
"field": "92914424037C11E980CAE91190B03EF5",
"crop": "efd5911a035a11e980cae91190b03ef5",
"volpct": 80,
"vol": 5600
}, {
"tr": "ab0a55660f3211e980cae91190b03ef5",
"dr": "91AC41BCE8DD11E4A62FBCEE7B748322",
"field": "92914424037C11E980CAE91190B03EF5",
"crop": "efd5911a035a11e980cae91190b03ef5",
"volpct": 80,
"vol": 6400
}]
}
Для получения следующего рейса у предыдущего необходимо установить отметку о получении (метод SET_TR_LOCK)
Метод GET_TR
Получить приход на склад
{"cmd":"get_tr","token":"..."}
Параметры относящиеся к приходу на склад
id - идентификатор
docnum - номер документа
wh - GUID склада
tr - GUID транспорта
dr - GUID водителя
ws - дата взвешивания
full - вес полного транспорта
empty - вес пустого транспорта
takeouts - массив выгрузок из комбайнов
Описание записи массива takeouts
tr - GUID транспорта
dr - GUID водителя
field - GUID поля
crop - GUID культуры
volpct - процент заполнения бункера в процентах
vol - объем выгрузки в литрах
Метод SET_TR_LOCK
Смена статуса прихода на склад "Выгружен во внешнюю систему"
Меняет статус прихода на склад с 11 на 1 по GUID
{"cmd":"set_tr_lock","token":"...","tr_id":...}
Метод SET_TR_UNLOCK
Смена статуса прихода на склад "Доступен для выгрузки во внешнюю систему"
Меняет статус прихода на склад с 1 на 0 по ID
{"cmd":"set_tr_unlock","token":"...","tr_id":...}
Пример полного цикла взаимодействия для тестирования:
Логинимся получаем токен:
{"cmd":"login", "login":"login", "password":"password"}
ответ:
{ "r": "TRUE",
"token": "90000D1400003A2DE055000000000001" }
получаем рейс
{"cmd":"get_tr","token":"90000D1400003A2DE055000000000001"}
помечаем рейс полученным
{"cmd":"set_tr_lock","token":"90000D1400003A2DE055000000000001","tr_id":106347905}
получаем следующий рейс
{"cmd":"get_tr","token":"90000D1400003A2DE055000000000001"}
помечаем рейс полученным
{"cmd":"set_tr_lock","token":"90000D1400003A2DE055000000000001","tr_id":106348139}
получаем следующий рейс
{"cmd":"get_tr","token":"90000D1400003A2DE055000000000001"} - ответ пустой (все рейсы переданы)
помечаем рейс неполученным (для перезагрузки)
{"cmd":"set_tr_unlock","token":"90000D1400003A2DE055000000000001","tr_id":106347905}
получаем неполученный рейс
{"cmd":"get_tr","token":"90000D1400003A2DE055000000000001"}
Возможные ошибки:
- nvalid token - неправильный токен
- parameter format error - неправильный формат у параметров (строка вместо числа, ошибка в дате)
- parameters must be not null - если хотя бы один из параметров пустой
- period error - дата начала больше даты окончания
- material_id not found - не найден id материала
- dmcode_id not found - не найден id ЕИ
- intersecting periods - пересечение периодов цен
- can't set price - ошибка при добавлении цены
- can't update price - ошибка обновления цены