Изменения документа Протокол интеграции систем внешних наливов с Топаз "Web Офис"
Редактировал(а) Dmitriy 2026/04/23 06:18
От версии 41.1
отредактировано Ярослава Ерина
на 2026/01/16 12:40
на 2026/01/16 12:40
Изменить комментарий:
К данной версии нет комментариев
Сводка
-
Свойства страницы (3 изменено, 0 добавлено, 0 удалено)
Подробности
- Свойства страницы
-
- Родительский документ
-
... ... @@ -1,1 +1,1 @@ 1 - vneshnie_api.vneshnie_nalivy2.WebHome1 +Внешние API.Внешние наливы.WebHome - Автор документа
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki.erin a_jv1 +XWiki.erin_ds - Содержимое
-
... ... @@ -11,7 +11,6 @@ 11 11 1. Список ip адресов, с которых будут приходить запросы от боевого окружения системы внешнего налива 12 12 1. Официальное название системы внешних наливов, которое будет указано в Топаз "Web Офис" 13 13 1. Иконку системы внешних наливов в формате svg с соотношением сторон 1:1 14 -1. Email, на который будет зарегистрирован личный кабинет интегратора 15 15 16 16 После получения информации по указанным пунктам, от ООО "Топаз-сервис" будет предоставлен тестовый доступ для настройки интеграции. 17 17 ... ... @@ -55,25 +55,25 @@ 55 55 {{code language="javascript" layout="LINENUMBERS"}} 56 56 { 57 57 // идентификатор станции АЗС 58 -string id57 +string Id 59 59 // статус станции: true – доступна, false – выключена 60 -bool enable,59 +bool Enable, 61 61 // наименование станции 62 -string name,61 +string Name, 63 63 // адрес станции 64 -string address,63 +string Address, 65 65 // гео точка на карте 66 -location location65 +location Location 67 67 { 68 -double lat,69 -double lon },67 +double Lat, 68 +double Lon }, 70 70 // словарь доступных ТРК 71 -Dictionary columns {70 +Dictionary Columns { 72 72 // номер колонки 73 73 (int32) Key: 74 74 { 75 75 // список доступных типов топлива 76 -" fuels": [ "a92", "a95", "diesel_premium", ... N ]75 +"Fuels": [ "a92", "a95", "diesel_premium", ... N ] 77 77 } 78 78 } ... N 79 79 } ... ... @@ -125,9 +125,9 @@ 125 125 126 126 {{code language="javascript"}} 127 127 { 128 -{" stationId": "0001", "productId": "a92", "price": 38.66, "fuelExtendedId": "92"},129 -{" stationId": "0001", "productId": "a95_premium", "price": 45.21, "fuelExtendedId": "95"},130 -{" stationId": "0002", "productId": "a92", "price": 38.98, , "fuelExtendedId": "92"},127 +{"StationId": "0001", "ProductId": "a92", "Price": 38.66}, 128 +{"StationId": "0001", "ProductId": "a95_premium", "Price": 45.21}, 129 +{"StationId": "0002", "ProductId": "a92", "Price": 38.98}, 131 131 } 132 132 {{/code}} 133 133 ... ... @@ -145,12 +145,10 @@ 145 145 { 146 146 // Идентификатор заказа 147 147 String Id 148 -// дата и время создания в UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' ,yyyy-MM-dd'T'HH:mm:ss.SSS'Z',либо yyyy-MM-dd HH:mm:ss147 +// дата и время создания в UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss 149 149 String DateCreate 150 150 // идентификатор станции АЗС 151 151 String StationExtendedId 152 -// Идентификатор АЗС в системе Интегратора (Необязательное поле) 153 -String StationId 154 154 // Тип заказа 155 155 String OrderType 156 156 // номер стороны (поста) ... ... @@ -167,7 +167,7 @@ 167 167 double SumPaid 168 168 // Статус заказа 169 169 OrderStatus Status 170 -// дата и время завершения заказа UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' ,yyyy-MM-dd'T'HH:mm:ss.SSS'Z',либо yyyy-MM-dd HH:mm:ss167 +// дата и время завершения заказа UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss 171 171 String DateEnd 172 172 // Идентификатор причины отмены заказа 173 173 String ReasonId ... ... @@ -228,14 +228,6 @@ 228 228 **FuelId **+ **PriceFuel **– в случае если стоимость топлива в Топаз "Web Офис" отличается от присланной, то Топаз "Web Офис" дает ответ **402.** 229 229 230 230 231 -== Отмена заказа == 232 - 233 -Отмена заказа возможна даже после его старта. Для инициации отмены необходимо отправить тот же заказ со статусом (% style="font-family: Courier New, Courier, monospace; background-color: rgb(221, 221, 221)" %)**UserCanceled**(%%). Если на момент получения запроса на отмену процесс налива ещё не начался, заказ будет отменён. 234 - 235 - 236 -В случае, если отмена инициирована после начала налива, система остановит процесс пролива и зафиксирует заказ как отменённый. В этом случае в ответе будет указано количество литров, фактически налитых до момента остановки. 237 - 238 - 239 239 == Проверка статуса работы станции == 240 240 241 241 Перед формирование заказ внешняя система делает запрос на станцию для определения доступности и готовности станции принять заказ **baseUrl **с префиксом