Реализованные методы
- LOGIN - Аутентификация мастер системы
- GET_DEPT - Получение информации по департаменту
- SET_DEPT - Добавление нового департамента
- DCT_LIST - Получение списка объектов справочников
- REC_LIST - Получение списка элементов справочника
- REC_DATA - Получение записи из справочника по GUID
- MON_DATA - Получение последней точки транспортного средства с указанием времени точки и координат
- DCT_DESC - Получение набора полей справочника с описаниями
- UPD_REC - Обновление данных записи справочника по GUID
- METHODS - Список методов API с описаниями
- UPD_GUID - Обновление ключа GUID, зная ID записи в ведомой системе
- INS_REC - Вставка новой записи справочника
- GET_PL - Получение информации по путевому листу
- SET_PL - Добавление нового путевого листа из мастер системы
- GET_PL_LIST_RD - Метод получения списка путевых листов созданных в Агроаналитика IOT, без постановки задач внешней системы
- GET_PL_RD - Получение информации по рассчитанному путевому листу созданного в Агроаналитика IOT
SET_PL_LOCK - Смена статуса путевого листа "Выгружен и заблокирован от изменений"SET_PL_RTEXPORT
SET_PL_RTEXPORT - Смена статуса путевого листа "Готов к выгрузке"
SET_PL_UNLOCK - Смена статуса путевого листа "Доступен для исправлений"
GET_TECHOP_LIST - Получение списка технологических операций в АА
GET_MT - Получение списка используемых материалов.
GET_EI - Получение списка единиц измерения
GET_CR - Получение списка культур
- GET_MT_RS - Получение списанных материалов за период
- SET_MT_LOCK - Смена стауса записи информации о материале
- GET_MT_SAL - Получение списка начисленной заработной платы в разрезе работ
- SET_MT_LOCK - Блокирование записи списания материалов от изменений
- SET_MT_PRICE - Добавление и изменение учетной цены материала
- GET_TR - Получение данных о выгрузках готовой продукции.
- GET_CL_LIST - Получение данных учётного листа
Основные ответы API на запросы связанные с данными и не подразумевающие возврат набора данных объекта
SUCCESS
Успешное выполнение метода
возврат: { "res_code":-X ,"res_desc":"result description" }
res_code: код результата
res_desc: описание результата
FAIL
Неуспешное выполнение метода
возврат: { "err_code":-X ,"err_desc":"error description" }
err_code: код ошибки
err_desc: описание ошибки
Метод LOGIN
Осуществляет формирование сессии в ведомой системе АА. При формировании сессии генерируется уникальный токен, который является идентификатором сессии.
Общий вид запроса:
{"cmd":"login", "login":"...", "password":"..."}, вместо многоточий необходимо указать реальные данные.
Исходные данные:
cmd (команда) = login
login (логин пользователя системы, зарегистрированного для работы с API)
password (пароль пользователя системы, зарегистрированного для работы с API)
Возвращаемые значения:
{ "r":"TRUE" ,"token":"74F63D8B77B14630115017D9139E4D5C" }
r (ключ значения результата вызова). Возможные значения TRUE, FALSE
token (токен сформированной на сервере сессии). Необходим для дальнейшей работы с API.
Метод GET_DEPT
Осуществляет запрос данных о подразделении по его GUID.
Общий вид запроса:
{"cmd": "get_dept","token":"...","dept_guid":"..."}, вместо многоточий необходимо указать реальные данные.
Исходные данные:
cmd (команда) = get_dept
token (token активной сессии пользователя)
dept_guid (GUID интересующего нас подразделения)
Обновление времени жизни токена
При выполнении запроса происходит увеличение "времени жизни" токена сессии до исходных значений. Другими словами: начало срока жизни сдвигается на текущее время.
Возвращаемые значения:
{ "id":39090 ,"jurperson":3862 ,"dept_name":"\u0410\u0432\u0442\u043E\u043F\u0430\u0440\u043A \u041E\u043B\u044C\u0445\u043E\u0432\u0430\u0442\u0441\u043A\u043E\u0435" ,"dept_pid":77748 ,"dept_type":2 ,"doc_pref":"2018" ,"guid":"B6BCD969FA9011E7810B9C8E964CC207" } (значения справочника подразделения)
id - идентификатор записи
jurperson - идентификатор юридического лица
dept_name - наименование подразделения
dept_pid - идентификатор родительской записи
dept_type - тип подразделения
doc_pref - префикс
guid - GUID глобальный идентификатор подразделения
Метод SET_DEPT
Осуществляет вставку подразделения в систему.
Общий вид запроса:
{"cmd": "set_dept","token":"78F9F10349145205E05017D9139E1054","jurperson_id":"...","dept_name":"..","dept_guid":"...","dept_pguid":"...","dept_type":"...","doc_pref":"..."}, вместо многоточий необходимо указать реальные данные.
Исходные данные:
cmd (команда) = set_dept
token - token активной сессии пользователя
jurperson_id - идентификатор юридического лица
dept_name - наименование подразделения
dept_guid - GUID подразделения
dept_pguid - идентификатор родительской записи
dept_type - тип подразделения
doc_pref - префикс
Обновление времени жизни токена
При выполнении запроса происходит увеличение "времени жизни" токена сессии до исходных значений. Другими словами: начало срока жизни сдвигается на текущее время.
Возвращаемые значения:
SUCCES или FAIL
Метод DCT_LIST
Метод получения списка справочников добавленных в API обмен.
Общий вид запроса:
{"cmd": "DCT_LIST","token":"..."}, вместо многоточий необходимо указать реальные данные.
Исходные данные:
cmd (команда) = dct_list
token - token активной сессии пользователя
Обновление времени жизни токена
При выполнении запроса происходит увеличение "времени жизни" токена сессии до исходных значений. Другими словами: начало срока жизни сдвигается на текущее время.
Возвращаемые значения:
SUCCES, при успешном выполнении команды возвращается массив элементов
массив DICTIONARY_LIST
{ "DICTIONARY_LIST":[ { "object":"..." ,"description":"..." },...]}
object - наименование объекта
description - детальное описание
FAIL, возвращается если token некорректен { "err_code":-4 ,"err_desc":"invalid token" }
Метод REC_LIST
Осуществляет запрос данных списка элементов справочника.
Общий вид запроса:
{"cmd":"rec_list", "token":"...", "table_name":"..."}, вместо многоточий необходимо указать реальные данные.
Исходные данные:
cmd (команда) = rec_list
token (token активной сессии пользователя)
table_name (имя объекта API. Допустимые значения получаем при выполнении метода DCT_LIST)
Обновление времени жизни токена
При выполнении запроса происходит увеличение "времени жизни" токена сессии до исходных значений. Другими словами: начало срока жизни сдвигается на текущее время.
Возвращаемые значения:
массив record_list
{ "record_list":[ { "ID":3349 ,"name":"..." ,"GUID":"71BB3BF40E39AD98E05017D9159E3D63" }]}
id - идентификатор записи в рамках системы АА
name - наименование
guid - GUID глобальный идентификатор записи
Метод REC_DATA
Осуществляет запрос данных одного элемента справочника по его GUID
Общий вид запроса:
{"cmd":"rec_data", "token":"...", "table_name":"...", "guid":"..."}, вместо многоточий необходимо указать реальные данные.
Исходные данные:
cmd (команда) = rec_list
token (token активной сессии пользователя)
table_name (имя объекта API. Допустимые значения получаем при выполнении метода DCT_LIST)
Обновление времени жизни токена
При выполнении запроса происходит увеличение "времени жизни" токена сессии до исходных значений. Другими словами: начало срока жизни сдвигается на текущее время.
Возвращаемые значения:
объект с полями записи из запрашиваемого ресурса
Метод MON_DATA
Осуществляет запрос объектов, зарегистрированных в мониторинге транспорта, с детализацией
Общий вид запроса:
{"cmd":"MON_DATA","token":"..."}, вместо многоточий необходимо указать реальные данные.
Исходные данные:
cmd (команда) = rec_list
token (token активной сессии пользователя)
Обновление времени жизни токена
При выполнении запроса происходит увеличение "времени жизни" токена сессии до исходных значений. Другими словами: начало срока жизни сдвигается на текущее время.
Возвращаемые значения:
массив record_list объектов мониторинга с детализацией
{ "record_list":[ { "ID":24184671 ,"name":"..." ,"GUID":"..." ,"last_msg_date":"2018-10-08T16:21:11Z" ,"X":39.4122567 ,"Y":52.0316967 }]}
ID - идентификатор записи в рамках системы АА=
name - наименование
GUID - GUID глобальный идентификатор записи
last_msg_date - время последнего сообщения
X - координата X из последнего сообщения
Y - координата Н из последнего сообщения
Метод DCT_DESC
Метод запроса описания объекта API (поле, тип, описание)
Общий вид запроса:
{"cmd":"DCT_DESC","token":"...","table_name":"..."}, вместо многоточий необходимо указать реальные данные.
Исходные данные:
cmd (команда) = DCT_DESC
token (token активной сессии пользователя)
table_name - имя объекта в API
Обновление времени жизни токена
При выполнении запроса происходит увеличение "времени жизни" токена сессии до исходных значений. Другими словами: начало срока жизни сдвигается на текущее время.
Возвращаемые значения:
объект с описанием полей. Пример, объект TECHS
{ "TABLE_FIELDS":[ { "col_name":"TECHMAKE" ,"col_type":"NUMBER" ,"comment":"\u041C\u043E\u0434\u0435\u043B\u044C" } ,{ "col_name":"REGNUMB" ,"col_type":"NVARCHAR2" ,"comment":"\u0413\u043E\u0441\u043D\u043E\u043C\u0435\u0440" } ,{ "col_name":"DEPT_ID" ,"col_type":"NUMBER" ,"comment":"\u041F\u043E\u0434\u0440\u0430\u0437\u0434\u0435\u043B\u0435\u043D\u0438\u0435" } ,{ "col_name":"MYEAR" ,"col_type":"NUMBER" } ,{ "col_name":"DESCR" ,"col_type":"NVARCHAR2" } ,{ "col_name":"PROD_VPSN" ,"col_type":"NVARCHAR2" ,"comment":"VIN\u005CPIN\u005CSN" } ,{ "col_name":"INV_NUMB" ,"col_type":"NVARCHAR2" } ,{ "col_name":"CLIENT_ID" ,"col_type":"NUMBER" } ] }
Метод UPD_REC
Метод обновления записи объекта API по GUID записи
Производит обновление полей записи, обновлению подлежат все поля, в том числе и те, которые не переданы в команде. Идентификация записи производится по GUID.
Общий вид запроса:
{"cmd":"UPD_REC","token":"790DB5696E901811E45017D9139E5107","table_name":"TECHS","regnum":"...","dept_guid":"...","myear":"...","descr":"...","prod_vpsn":"...","inv_num":"..."}, вместо многоточий необходимо указать реальные данные.
"table_name":"TECHS" - для обновления записи в другой таблице следует указать нужное имя таблицы.
Обновление времени жизни токена
При выполнении запроса происходит увеличение "времени жизни" токена сессии до исходных значений. Другими словами: начало срока жизни сдвигается на текущее время.
Внимание
Т.к. данный метод затрагивает внутреннюю работу БД приложения АА, следует использовать его с особой осторожностью. Рекомендуется консультироваться со специалистами технической поддержки, с целью понимания выполняемых действий, дабы не нарушить целостность данных.
Возвращаемые значения:
SUCCESS или FAIL
Метод METHODS
Получение описания методов в формате JSON, исключительно для ознакомительных целей.
Общий вид запроса:
{"cmd":"methods","token":"790FCD6232E4419EE05017D9139E3B23"}
Обновление времени жизни токена
При выполнении запроса происходит увеличение "времени жизни" токена сессии до исходных значений. Другими словами: начало срока жизни сдвигается на текущее время.
Возвращаемые значения:
Объект содержащий описание в формате JSON
Метод UPD_GUID
Метод обновления GUID для записи объекта API.
Производит обновление GUID записи. Идентификация записи производится по ID записи, который получить возможно используя команду REC_LIST.
Общий вид запроса:
{"cmd":"upd_guid","token":"790FCD6232E4419EE05013D9139E5B23","table_name":"TECHS","guid":"...","id":"..."}, вместо многоточий необходимо указать реальные данные.
Обновление времени жизни токена
При выполнении запроса происходит увеличение "времени жизни" токена сессии до исходных значений. Другими словами: начало срока жизни сдвигается на текущее время.
Возвращаемые значения:
SUCCESS или FAIL
Метод INS_REC
Метод добавления записи объекта API
Общий вид запроса:
{"cmd":"ins_rec","token":"790FCD6232E4419EE05013D9139E5B23","table_name":"TECHS","guid":"...", <набор значений полей>}, вместо многоточий необходимо указать реальные данные.
Обновление времени жизни токена
При выполнении запроса происходит увеличение "времени жизни" токена сессии до исходных значений. Другими словами: начало срока жизни сдвигается на текущее время.
Возвращаемые значения:
SUCCESS или FAIL
Метод SET_PL
Метод постановки задачи для расчета путевого листа.
Формирует задачу для Агроаналитки поиска информации для заполнения путевого листа с указанными в запросе параметрами. Все используемые в запросе элементы должны быть в обязательном порядке синхронизированы между двумя системами.
Общий вид запроса:
{"cmd":"set_pl","token":"790FCD6232E4419EE05013D9139E5B23","pl_number":"...","date":"...","pl_guid":"...","driver_guid","...","transport_guid":"...","trailer_guid":"...","dep_guid":"..."}, вместо многоточий необходимо указать реальные данные.
Исходные данные:
cmd (команда) = set_pl
token (token активной сессии пользователя)
pl_number - номер путевого листа в мастер системе
date - дата формирования путевого листа в мастер системе (дата в рамках которой будет производится поиск информации в системе Агроаналитика)
pl_guid - GUID путевого листа
driver_guid - GUID водителя
transport_guid - GUID транспорта
trailer_guid - GUID прицепа
dep_guid - GUID подразделения
Обновление времени жизни токена
При выполнении запроса происходит увеличение "времени жизни" токена сессии до исходных значений. Другими словами: начало срока жизни сдвигается на текущее время.
Возвращаемые значения:
SUCCESS или FAIL
Метод GET_PL_LIST
Метод получения списка путевых листов поставленных как задачи внешней системой.
Запрашивает у системы Агроаналитика список ПЛ, по которым ранее были поставлены задания
Общий вид запроса:
{"cmd": "get_pl_list","token":"..."}, вместо многоточий необходимо указать реальные данные.
Исходные данные:
cmd (команда) = get_pl_list
token (token активной сессии пользователя)
Обновление времени жизни токена
При выполнении запроса происходит увеличение "времени жизни" токена сессии до исходных значений. Другими словами: начало срока жизни сдвигается на текущее время.
Возвращаемые значения:
Массив объектов, каждый из которых представляет собой запись о путевом листе
Пример записи ПЛ:
{ "pl_guid":"7A143B04B94F3566E04017D9139E0C67" ,"pl_date":"2018-10-10T00:00:00Z" ,"pl_numb":"PL_NUMBER" ,"drv_guid":"7999D4D474DF3518E05017D9139E2427" ,"tech_guid":"7999D4D474BD3510E05017D9139E2427" ,"tr_guid":"7A143B04B9563566E050A7D9139E0C67" ,"dept_guid":"7999D4D474B4351D305017D9139E2427" }
Для получения детально информации по ПЛ реализован метод GET_PL.
Метод GET_PL
Метод получения расчитанного путевого листа.
Запрашивает у системы Агроаналитика путевой лист по GUID, с которым ранее было поставлено задание
Общий вид запроса:
{"cmd":"get_pl","token":"...","pl_guid":"..."}, вместо многоточий необходимо указать реальные данные.
Описание записи ПЛ:
pl_guid - GUID путевого листа
pl_numb - номер путевого листа в мастер системе
drv_guid - GUID водителя
tech_guid - GUID техники
tr_guid - GUID прицепного оборудования
Исходные данные:
cmd (команда) = get_pl
token (token активной сессии пользователя)
pl_guid - GUID путевого листа
Обновление времени жизни токена
При выполнении запроса происходит увеличение "времени жизни" токена сессии до исходных значений. Другими словами: начало срока жизни сдвигается на текущее время.
Возвращаемые значения:
Объект с расчетными данными путевого листа или FAIL
Пример объекта, возвращаемого при выполнении запроса:
{ "works":[ { "ws":"12.04.2018 09:41:29" ,"wf":"12.04.2018 10:49:52" ,"op":"6784108DA9E7EAD9E05017D9139E3824" ,"dm":"\u0413\u0410" ,"sl":"156C28B9BFC611E39C179C8E994CC207" ,"fl":"58559247A83B11E2BF3678E3B5079091" ,"cr":"687971BCAA9D0073E05017D9139E29AD" ,"mi":8.9 ,"fc":16 ,"mh":4103 ,"wv":16.7 } ,{ "ws":"12.04.2018 10:56:38" ,"wf":"12.04.2018 13:51:23" ,"op":"6784108DA9E7EAD9E05017D9139E3824" ,"dm":"\u0413\u0410" ,"sl":"156C28B9BFC611E39C179C8E994CC207" ,"fl":"58559244A83B11E2BF3678E3B5079091" ,"cr":"687971BCAA9D0073E05017D9139E29AD" ,"mi":24 ,"fc":11.3 ,"mh":8145 ,"wv":38.4 } ,{ "ws":"12.04.2018 15:17:45" ,"wf":"12.04.2018 16:19:37" ,"op":"6784108DA9E7EAD9E05017D9139E3824" ,"dm":"\u0413\u0410" ,"sl":"156C28B9BFC611E39C179C8E994CC207" ,"fl":"58559242A83B11E2BF3678E3B5079091" ,"cr":"687971BCAA9D0073E05017D9139E29AD" ,"mi":14.6 ,"fc":20 ,"mh":3712 ,"wv":25.3 } ,{ "ws":"12.04.2018 13:51:34" ,"wf":"12.04.2018 15:17:33" ,"op":"6784108DA9E7EAD9E05017D9139E3824" ,"dm":"\u0413\u0410" ,"sl":"156C28B9BFC611E39C179C8E994CC207" ,"fl":"58559243A83B11E2BF3678E3B5079091" ,"cr":"687971BCAA9D0073E05017D9139E29AD" ,"mi":15.1 ,"fc":10 ,"mh":5159 ,"wv":24.9 } ] ,"tp":2 ,"th":"65C8E6EFB80807EBE05017D9139E2C07" ,"dr":"67703904A2178196E05017D9139E1EC3" ,"ws":"12.04.2018 07:00:00" ,"wf":"12.04.2018 19:00:00" ,"mi":85 ,"fc":79 ,"fs":266 ,"ff":187 ,"fl":0 ,"fic":0 ,"mh":27750 ,"dt":26789 ,"dtn":0 }
works - массив работ
Описание записи массива works
ws - начало работы
wf - окончание работы
op - GUID техоперации
ov - GUID вида работы
dm - единица измерения
sl - прицепное
fl - GUID поля
cr - GUID культуры
mi - пробег в км
fc - расход топлива в л
mh - моточасы операции в сек
wv - площадь обработки в га
Параметры относящиеся к путевому листу
tp - тип путевого листа: 0 - тракториста, 1 - авто, 2 - тракториста и авто
th -GUID техики
dr -GUID водителя
ws -начало работы
wf -окончание работы
mi - пробег в км
fc -расход топлива в л
fs - начальный уровень топлива в л
ff - конечный уровень топлива в л
fl - всего заправлено в л
fic - количество заправок
mh - моточасы операции в сек
dt - длительность простоя (секунды)
dtn - длительность простоя (секунды) в ночную смену
Метод GET_PL_LIST_RD
Метод получения списка путевых листов созданных в Агроаналитике, без постановки задач внешней системы.
Запрашивает у системы Агроаналитика список ПЛ, которые были подвержены.
Общий вид запроса:
{"cmd": "get_pl_list","token":"..."}, вместо многоточий необходимо указать реальные данные.
Исходные данные:
cmd (команда) = get_pl_list_rd
token (token активной сессии пользователя)
Обновление времени жизни токена
При выполнении запроса происходит увеличение "времени жизни" токена сессии до исходных значений. Другими словами: начало срока жизни сдвигается на текущее время.
Возвращаемые значения:
Массив объектов, каждый из которых представляет собой запись о путевом листе
Пример записи ПЛ:
{ "pl_guid":"7A143B04B94F3566E04017D9139E0C67" ,"pl_date":"2018-10-10T00:00:00Z" ,"pl_numb":"PL_NUMBER" ,"drv_guid":"7999D4D474DF3518E05017D9139E2427" ,"tech_guid":"7999D4D474BD3510E05017D9139E2427" ,"dept_guid":"7999D4D474B4351D305017D9139E2427" }
Для получения детально информации по ПЛ реализован метод GET_PL_RD.
Метод GET_PL_RD
Метод получения рассчитанного путевого листа.
Запрашивает у системы Агроаналитика путевой лист по GUID, созданный без задания внешней системы.
Общий вид запроса:
{"cmd":"get_pl_rd","token":"...","pl_guid":"..."}, вместо многоточий необходимо указать реальные данные.
Описание записи ПЛ:
pl_guid - GUID путевого листа
pl_numb - номер путевого листа в мастер системе
drv_guid - GUID водителя
tech_guid - GUID техники
tr_guid - GUID прицепного оборудования
Исходные данные:
cmd (команда) = get_pl_rd
token (token активной сессии пользователя)
pl_guid - GUID путевого листа
Обновление времени жизни токена
При выполнении запроса происходит увеличение "времени жизни" токена сессии до исходных значений. Другими словами: начало срока жизни сдвигается на текущее время.
Возвращаемые значения:
Объект с расчетными данными путевого листа или FAIL
Пример объекта, возвращаемого при выполнении запроса:
{ "works":[ { "ws":"12.04.2018 09:41:29" ,"wf":"12.04.2018 10:49:52" ,"op":"6784108DA9E7EAD9E05017D9139E3824" ,"dm":"\u0413\u0410" ,"sl":"156C28B9BFC611E39C179C8E994CC207" ,"fl":"58559247A83B11E2BF3678E3B5079091" ,"cr":"687971BCAA9D0073E05017D9139E29AD" ,"mi":8.9 ,"fc":16 ,"mh":4103 ,"wv":16.7 } ,{ "ws":"12.04.2018 10:56:38" ,"wf":"12.04.2018 13:51:23" ,"op":"6784108DA9E7EAD9E05017D9139E3824" ,"dm":"\u0413\u0410" ,"sl":"156C28B9BFC611E39C179C8E994CC207" ,"fl":"58559244A83B11E2BF3678E3B5079091" ,"cr":"687971BCAA9D0073E05017D9139E29AD" ,"mi":24 ,"fc":11.3 ,"mh":8145 ,"wv":38.4 } ,{ "ws":"12.04.2018 15:17:45" ,"wf":"12.04.2018 16:19:37" ,"op":"6784108DA9E7EAD9E05017D9139E3824" ,"dm":"\u0413\u0410" ,"sl":"156C28B9BFC611E39C179C8E994CC207" ,"fl":"58559242A83B11E2BF3678E3B5079091" ,"cr":"687971BCAA9D0073E05017D9139E29AD" ,"mi":14.6 ,"fc":20 ,"mh":3712 ,"wv":25.3 } ,{ "ws":"12.04.2018 13:51:34" ,"wf":"12.04.2018 15:17:33" ,"op":"6784108DA9E7EAD9E05017D9139E3824" ,"dm":"\u0413\u0410" ,"sl":"156C28B9BFC611E39C179C8E994CC207" ,"fl":"58559243A83B11E2BF3678E3B5079091" ,"cr":"687971BCAA9D0073E05017D9139E29AD" ,"mi":15.1 ,"fc":10 ,"mh":5159 ,"wv":24.9 } ] ,"tp":2 ,"th":"65C8E6EFB80807EBE05017D9139E2C07" ,"dr":"67703904A2178196E05017D9139E1EC3" ,"ws":"12.04.2018 07:00:00" ,"wf":"12.04.2018 19:00:00" ,"mi":85 ,"fc":79 ,"fs":266 ,"ff":187 ,"fl":0 ,"fic":0 ,"mh":27750 ,"dt":26789 ,"dtn":0 }
works - массив работ
Описание записи массива works
ws - начало работы
wf - окончание работы
op - GUID техоперации
ov - GUID вида работы
dm - единица измерения
sl - прицепное
fl - GUID поля
cr - GUID культуры
mi - пробег в км
fc - расход топлива в л
mh - моточасы операции в сек
wv - площадь обработки в га
Параметры относящиеся к путевому листу
tp - тип путевого листа: 0 - тракториста, 1 - авто, 2 - тракториста и авто
th -GUID техики
dr -GUID водителя
ws -начало работы
wf -окончание работы
mi - пробег в км
fc -расход топлива в л
fs - начальный уровень топлива в л
ff - конечный уровень топлива в л
fl - всего заправлено в л
fic - количество заправок
mh - моточасы операции в сек
dt - длительность простоя (секунды)
dtn - длительность простоя (секунды) в ночную смену
Метод SET_PL_LOCK
Смена статуса путевого листа "Выгружен и заблокирован от изменений"
Меняет статус путевого листа с 11 на 4 по GUID
{"cmd":"set_pl_lock","token":"...","pl_guid":"..."}
Метод SET_PL_RTEXPORT
Смена статуса путевого листа "Готов к выгрузке"
Меняет статус путевого листа с 4 на 11 по GUID
{"cmd":"set_pl_rtexport","token":"...","pl_guid":"..."}
Метод SET_PL_UNLOCK
Смена статуса путевого листа "Доступен для исправлений"
Удаляет списанные затраты по топливу.
Меняет статус путевого листа с 11 на 6 по GUID
{"cmd":"set_pl_unlock","token":"...","pl_guid":"..."}
Метод GET_TECHOP_LIST
Получение списка технологических операций в АА
Общий вид запроса:
{"cmd": "GET_TECHOP_LIST","token":"..."}, вместо многоточий необходимо указать реальные данные.
Исходные данные:
cmd (команда) = GET_TECHOP_LIST
token - token активной сессии пользователя
Обновление времени жизни токена
При выполнении запроса происходит увеличение "времени жизни" токена сессии до исходных значений. Другими словами: начало срока жизни сдвигается на текущее время.
Возвращаемые значения:
SUCCES, при успешном выполнении команды возвращается массив элементов
массив TECHOPER_LIST
{ "TECHOPER_LIST":[ { "uid":"..." ,"name":"...", "edate":"..." },...]}
uid - Uid технологической операции
name - Название операции
edate - Дата создания операции
FAIL, возвращается если token некорректен { "err_code":-4 ,"err_desc":"invalid token" }
Метод GET_MT
Получение списка используемых материалов
{"cmd":"get_mt", "token":"..."}
Метод GET_EI
Получение списка единиц измерения
{"cmd":"get_ei", "token":"..."}
Метод GET_CR
Получение списка культур
{"cmd":"get_CR", "token":"..."}
Возвращаемые значения:
SUCCES, при успешном выполнении команды возвращается массив элементов
массив result
{ "result":[ { "cr":"..." ,"uid":"...", },...]}
cr- название культуры
uid - uid культуры
Метод GET_MT_RS
Получение списка списанных материалов в АА за период
{ "cmd": "GET_MT_RS", "datefrom":"2019-08-15T00:00:00Z", "dateto":"2019-08-25T00:00:00Z", "token":"......."}
Указание времени в параметрах "datefrom" и "dateto" не обязательно.
Исходные данные:
cmd (команда) = GET_MT_RS
datefrom - дата начала периода в формате гг-мм-дд
dateto - дата окончания периода в формате гг-мм-дд
token - token активной сессии пользователя
Обновление времени жизни токена
При выполнении запроса происходит увеличение "времени жизни" токена сессии до исходных значений. Другими словами: начало срока жизни сдвигается на текущее время.
Возвращаемые значения:
SUCCES, при успешном выполнении команды возвращается массив элементов
массив material_consumption
{ "material_consumption":[ { "techoper":"..." ,"findate":"...", "tasknumb":"...", "matid":"...", "mesuretid":"...", "quant":"...", "cropuid":"...", },...]}
"techoper": "....." - uid техоперации
"findate": "2019-08-20T13:28:13Z" - дата списания
"tasknumb": 1043 - номер производственного здания в АА
"matid": 401 - id материала
"mesuretid": 402 - id единицы измерения
"quant": 421 - количество списанного материала
"cropuid": "....." - uid культуры
"matlinkid":"..." - id записи списания материала
FAIL, возвращается если token некорректен { "err_code":-4 ,"err_desc":"invalid token" }
Метод SET_MT_LOCK
Смена статуса записи о списание материала.
Меняет статус записи на "1" по id записи, запрещает редактирование и убирает из списка для передачи во внешнею систему
{"cmd":"set_mt_lock", "lock":"true", "id":"...""token":"..."}
Меняет статус записи на "0" по id записи, разрешает редактирование и добавляет в список для передачи во внешнею систему
{"cmd":"set_mt_lock", "lock":"false", "id":"...""token":"..."}
Метод GET_MT_SAL
Получение списка заработной платы за каждую работу из АА за период
{ "cmd": "GET_MT_SAL", "start_date":"2019-08-15T00:00:00Z", "end_date":"2019-08-25T00:00:00Z", "driver_uid":"......", "techop_uid":"......", "token":"......."}
параметры driver_uid, techop_uid не обязательны, так же не обязательно времени в параметрах "start_date" и "end_date".
Исходные данные:
cmd (команда) = GET_MT_SAL
start_date - дата начала периода в формате гг-мм-дд
end_date- дата окончания периода в формате гг-мм-дд
driver_uid - uid механизатора(водителя)
techop_uid - uid техоперации
token - token активной сессии пользователя
Обновление времени жизни токена
При выполнении запроса происходит увеличение "времени жизни" токена сессии до исходных значений. Другими словами: начало срока жизни сдвигается на текущее время.
Возвращаемые значения:
SUCCES, при успешном выполнении команды возвращается массив элементов
массив result
{ "result":[ { "techop_uid":"..." ,"techop_uid":"...", "sal_val":"...", "sal_date":"...", "culture_uid":"...", "id":"..." },...]}
"techop_uid": "...." - uid техоперации
"techop_uid": "...." - uid механика(водителя)
"sal_val": 132.63 - заработная плата
"sal_date": "2019-04-23T00:00:00Z" - дата
"culture_uid": "...." - uid культуры
"id": 98487968 - id записи списания материала
FAIL, возвращается если token некорректен { "err_code":-4 ,"err_desc":"invalid token" }
Метод SET_MT_LOCK
Смена статуса записи о заработной плате.
Меняет статус записи на "1" по id записи, запрещает редактирование и убирает из списка для передачи во внешнею систему
{"cmd":"set_mt_lock", "lock":"true", "id":"...""token":"..."}
Меняет статус записи на "0" по id записи, разрешает редактирование и добавляет в список для передачи во внешнею систему
{"cmd":"set_mt_lock", "lock":"false", "id":"...""token":"..."}
Метод SET_MT_PRICE
Добавление и изменение учётной цены материала.
{"cmd": "SET_MT_PRICE","token":"...","material_id":...,"dmcode_id":...,"start_date":"...","end_date":"...","price_val":...}
В случае наличия цены за такой же период - цена обновляется.
В случае наложения периодов - ошибка - наложения периодов.
material_id - ID материала
dmcode_id - ID единицы измерения
start_date - дата начала действия цены dd.mm.yyyy
end_date - дата окончания действия цены dd.mm.yyyy
price_val - значение цены 000.0
пример запроса:
{"cmd": "SET_MT_PRICE","token":"","material_id":44757990,"dmcode_id":402,"start_date":"15.03.2019","end_date":"27.11.2019","price_val":1034.00}
Возвращаемые значения:
invalid 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 - ошибка обновления цены
цена установлена
ВЫГРУЗКИ ГОТОВОЙ ПРОДУКЦИИ
Метод 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 - ошибка обновления цены