Сервисы для обмена данными

Сервисы Regions

1. GetRegions

Сервис для получения массива регионов

Request

GET /api/Regions/GetRegions?userID={userID}

userID - уникальный идентификатор юзера

Response

[{"id":"e4da8d16-b16e-4973-93bd-0eff65bad872",// Уникальный ключ региона
"name":"Черкасская область"}// Название региона .....]

2. GetRegionByID

Сервис для получения названия региона

Request

GET /api/Regions/GetRegionByID?regionID={regionID}

regionID - уникальный идентификатор региона

{"id":"e4da8d16-b16e-4973-93bd-0eff65bad872",// Уникальный ключ региона
"name":"Черкасская область"}// Название региона .....

Сервис PriceList

1. GetPriceList

Сервис для получения списка продукции

Request

GET /api/PriceList/GetPriceList?userID={userID}

userID - уникальный идентификатор юзера

Response

[{"id":1578067.0, //Код продукции
"eanCode":4820163122793.0,//Штрих код продукции
"name":"Горілка \"Хортиця Абсолютна\" 0,2",//Название продукции
"groupCode":23,//Код групы
"groupName":"Водки ТМ \"Хортиця\"",//Название групы
"capacity":0.2,//Литраж
"countInBox":0,//Количество в коробке
"price":27.0},//Цена
.....]

2. GetClientAndPriceList

Сервис для получения клиента и списка продукции по клиенту

Request

GET /api/PriceList/GetClientAndPriceList?codDK={codDK}

codDK - уникальный идентификатор дебитора

Response

{ "debtorName": null,//Название дебитора
"debtorCode": 123123,//Код дебитора
"positions": [
{
"id": 1578840, //Код продукции
"eanCode": 4820163121574,//Штрих код продукции
"name": "Горілка особлива \"Хортиця Айс\" 0,5л, рест",//Название продукции
"groupCode": 23,//Код групы
"groupName": "Водки ТМ \"Хортиця\"",//Название групы
"capacity": 0.5,//Литраж
"countInBox": 0,//Количество в коробке
"price": 80.7//Цена
},
.....]

Сервис Orders

1. CreateOrder

Отправка заказа

Request

POST /api/Orders/CreateOrder

Данные передаются в теле запроса в формате json
contentType: "application/json"

{ "UserID":"9128c5cf-2dff-46ae-b17e-6bb26b7ab913",//Идентификатор юзера
"OutletID":0,//Код точки
"DeliveryDate":"2019-05-29T12:39:11.9206399+03:00"//Дата доставки,
"IsPrePayment":false,//Признак предоплаты
"Positions":
[{"PositionID":1578067,//Код позиции
"Amount":1//Количество
}]}

Response

Возвращает идентификатор заказа

2. GetOrder

Получить данные заказа

Request

GET /api/Orders/GetOrder?orderGuid={OrderGuid}

OrderGuid - уникальный идентификатор заказа

Response

{"userID":"8605e5e5-c09b-4a80-a939-2581437dd088",//Уникальный идентификатор юзера
"outletID":17688060,//Код торговой точки
"deliveryDate":"2019-06-01T00:00:00",//Дата доставки
"isPrePayment":false,//Признак предоплаты
"positions":
[{"positionID":1578850.0,//Код позиции
"amount":3//Количество},
....]}

Сервис Distribution

1. UpdateEmployees

Обновление данных сотрудников

Request

POST /api/Distribution/UpdateEmployees

Данные передаются в теле запроса в формате json
contentType: "application/json"

{"userID":"C4CE561C-9998-4FC6-97ED-0002257EE094",//уникальный идентификатор юзера
"employees":
[{"Name":"Иван Иванов",//ФИО сотрудника
"TabNumber":22,//Табельный номер сотрудника
"PositionID":"6DBABE7C-C17E-4328-ADDE-B3728F67DEE1"//Идентификатор позиции сотрудника
},
{"Name":"Иван Петров",//ФИО сотрудника
"TabNumber":23,//Табельный номер сотрудника
"PositionID":"6DBABE7C-C17E-4328-ADDE-B3728F67DEE1"//Идентификатор должности
},
{"Name":"Иван Петров",//ФИО сотрудника
"TabNumber":1,//Табельный номер сотрудника
"PositionID":"04814F73-A9ED-486E-A876-3E5DE27773D4"//Идентификатор позиции сотрудника
}]}

Response

Возвращает булевую переменную с признаком обновления данных

2. UpdateSubordinates

Обновление субординационных данных

Request

POST /api/Distribution/UpdateSubordinates

Данные передаются в теле запроса в формате json
contentType: "application/json"

{ "userID":"C4CE561C-9998-4FC6-97ED-0002257EE094"//Уникальный идентификатор юзера
, "subordinates":
[{"LeaderTabNumber":22,//Табельный номер руководителя
"SubordinateTabNumbers":[23,1]},//Массив табельных номеров подчененных
{"LeaderTabNumber":23,//Табельный номер руководителя
"SubordinateTabNumbers":[1]//Массив табельных номеров подчененных
}]}

Response

Возвращает булевую переменную с признаком обновления данных

3. UpdateTradeOutlets

Обновление данных по торговым точкам

Request

POST /api/Distribution/UpdateTradeOutlets

Данные передаются в теле запроса в формате json
contentType: "application/json"

{"userID":"C4CE561C-9998-4FC6-97ED-0002257EE094",//Уникальный идентификатор юзера
"outlets":
//Массив торговых точек [{"RegionID":"C5F3F3F7-551A-4C31-B25B-1126068EDC7C",//Идентификатор региона
"ResponsibleTabNumber":22,//Табельный номер ТА внесенный в справочник сотрудников(при отсутствии передавать 1)
"Name":"TestTT1",//Название торговой точки
"Address":"TestAddressTT1",//Адресс торговой точки
"CategoryCode":1,//Категория торговой точки (При отсутствии не передавать)
"FormatCode":1,//Формат торговой точки (При отсутствии не передавать)
"ChainCode":1,//Код сети в которую входит торговая точка (При отсутствии не передавать)
"Phone":0672222222,//Номер телефона (При отсутствии не передавать)
"Email":Test@gmail.com,//Email(При отсутствии не передавать)
},....]}

Response

Возвращает булевую переменную с признаком обновления данных

Сервис Rests

1. SendRests

Обновление данных сотрудников

Request

POST /api/Rests/SendRests

Данные передаются в теле запроса в формате json
contentType: "application/json"

{"userID":"C4CE561C-9998-4FC6-97ED-0002257EE094",//Уникальный идентификатор юзера
"rests"://Остатки
[{"WarehouseAddress":"TestAddress1",//Адрес точки на которой есть остатки
"OperationDate":"2019-06-04T21:00:00.000Z",//Дата остатков
"RestPositions"://Позиции остатков
[{"PositionID":1578067,//код позиции остатков
"Amount":2//Количество остатков по позиции
},{"PositionID":1579088,//код позиции остатков
"Amount":2//Количество остатков по позиции
}]},
{"WarehouseAddress":"TestAddress2",//Адрес точки на которой есть остатки
"OperationDate":"2019-06-04T21:00:00.000Z",//Дата остатков
"RestPositions"://Позиции остатков
[{"PositionID":1578067,//код позиции остатков
"Amount":2},//Количество остатков по позиции
{"PositionID":1579088,//код позиции остатков
"Amount":2//Количество остатков по позиции
}]}]}

Response

Возвращает булевую переменную с признаком обновления данных

Сервис Sales

1. SendSales

Обновление данных сотрудников

Request

POST /api/Sales/SendSales

Данные передаются в теле запроса в формате json
contentType: "application/json"

{"userID":"C4CE561C-9998-4FC6-97ED-0002257EE094",//Уникальный идентификатор юзера
"sales":[{//Продажи
"TradeOutletINN":112233,//ИНН клиента/Торговой Точки
"TradeOutletOKPO":"112233",// ОКПО клиента/Торговой Точки
"TradeOutletRegionID":"C5F3F3F7-551A-4C31-B25B-1126068EDC7C",//Уникальный идентификатор Региона в котором находится Торговая Точка из справочника Регионов
"TradeOutletAddress":"TestAddress1",//Полный адрес Торговой Точки
"TradeOutletCategoryCode":1,//Код категории Торговой Точки (При отсуцтвии пусто)
"TradeOutletFormatCode":1,//Код формата Торговой Точки (При отсуцтвии пусто)
"ChainCode":1//Код сети (При отсуцтвии пусто)
"OperationDate":"2019-06-02T21:00:00.000Z",// Дата продажи
"InvoiceNumber":"123",// Номер инвойса
"TradeOutletDebitorName":"TestName",//название дебитора с файлами продаж
"TradeOutletCode":1,// уникальный код ТТ
"SalePositions"://Список проданных позиций/продукции
[{"PositionID":1578067,//Уникальный идентификатор позиции/продукции из справочника продукции
"Amount":2,//Кол-тво шт. позиции/продукции
"SaleSumm":4},// Сумма этой продажи, грн.
{"PositionID":1579088,//Уникальный идентификатор позиции/продукции из справочника продукции
"Amount":2//Кол-тво шт. позиции/продукции,
"SaleSumm":4}// Сумма этой продажи, грн.
]},
....]}

Response

Возвращает булевую переменную с признаком обновления данных

2. UpdateSales

Обновление данных сотрудников

Request

POST /api/Sales/UpdateSales

Данные передаются в теле запроса в формате json
contentType: "application/json"

{"userID":"C4CE561C-9998-4FC6-97ED-0002257EE094",//Уникальный идентификатор юзера
"dateFrom":"2019-06-01T21:00:00.000Z",// Начальная дата обновления
"dateTill":"2019-06-06T21:00:00.000Z",// Конечная дата обновления
"sales":
"sales":[{//Продажи
"TradeOutletINN":112233,//ИНН клиента/Торговой Точки
"TradeOutletOKPO":"112233",// ОКПО клиента/Торговой Точки
"TradeOutletRegionID":"C5F3F3F7-551A-4C31-B25B-1126068EDC7C",//Уникальный идентификатор Региона в котором находится Торговая Точка из справочника Регионов
"TradeOutletAddress":"TestAddress1",//Полный адрес Торговой Точки
"TradeOutletCategoryCode":1,//Код категории Торговой Точки (При отсуцтвии пусто)
"TradeOutletFormatCode":1,//Код формата Торговой Точки (При отсуцтвии пусто)
"ChainCode":1//Код сети (При отсуцтвии пусто)
"OperationDate":"2019-06-02T21:00:00.000Z",// Дата продажи
"InvoiceNumber":"123",// Номер инвойса
"TradeOutletDebitorName":"TestName",//название дебитора с файлами продаж
"TradeOutletCode":1,// уникальный код ТТ
"SalePositions"://Список проданных позиций/продукции
[{"PositionID":1578067,//Уникальный идентификатор позиции/продукции из справочника продукции
"Amount":2,//Кол-тво шт. позиции/продукции
"SaleSumm":4},// Сумма этой продажи, грн.
{"PositionID":1579088,//Уникальный идентификатор позиции/продукции из справочника продукции
"Amount":2//Кол-тво шт. позиции/продукции,
"SaleSumm":4}// Сумма этой продажи, грн.
]},
....]}

Response

Возвращает булевую переменную с признаком обновления данных