Изменения документа Протокол интеграции систем внешних наливов с Топаз "Web Офис"
Редактировал(а) Dmitriy 2026/04/23 06:18
От версии 14.1
отредактировано Ярослава Ерина
на 2024/07/30 06:44
на 2024/07/30 06:44
Изменить комментарий:
К данной версии нет комментариев
К версии 1.1
отредактировано Ярослава Ерина
на 2024/07/17 12:36
на 2024/07/17 12:36
Изменить комментарий:
К данной версии нет комментариев
Сводка
-
Свойства страницы (1 изменено, 0 добавлено, 0 удалено)
Подробности
- Свойства страницы
-
- Содержимое
-
... ... @@ -24,32 +24,38 @@ 24 24 25 25 **...** 26 26 27 -{{code language="javascript"}} 28 -{ 29 -// идентификатор станции АЗС 30 -string Id 31 -// статус станции: true – доступна, false – выключена 32 -bool Enable, 33 -// наименование станции 34 -string Name, 35 -// адрес станции 36 -string Address, 37 -// гео точка на карте 38 -location Location 39 -{ 40 -double Lat, 41 -double Lon }, 42 -// словарь доступных ТРК 43 -Dictionary Columns { 44 -// номер колонки 45 -(int32) Key: 46 -{ 47 -// список доступных типов топлива 48 -"Fuels": [ "a92", "a95", "diesel_premium", ... N ] 49 -} 50 -} ... N 51 -} 52 -{{/code}} 27 +{{{{ 28 + // идентификатор станции АЗС 29 + string Id 30 + // статус станции: true – доступна, false – выключена 31 + bool Enable, 32 + // наименование станции 33 + string Name, 34 + // адрес станции 35 + string Address, 36 + // гео точка на карте 37 + location Location { 38 + double Lat, 39 + double Lon 40 + }, 41 + // словарь доступных ТРК 42 + Dictionary Columns 43 + { 44 + // номер колонки (int32) 45 + Key: { 46 + // список доступных типов топлива 47 + "Fuels": [ 48 + "a92", 49 + "a95", 50 + "diesel_premium", 51 + ... 52 + N 53 + ] 54 + } 55 + } 56 + ... 57 + N 58 +}}}} 53 53 54 54 **Возможные идентификаторы топлива** 55 55 ... ... @@ -72,34 +72,28 @@ 72 72 73 73 Внешняя система опрашивает Топаз "Web Офис" для получения прайс-листа **HTTP **запросом на **url **с префиксом **/integration/price?apikey={apikey} **, запрос типа **GET **, timeout 10секунд. 74 74 75 -В ответ Топаз "Web Офис" дает ответ в формате **JSON** {{{}}}81 +В ответ Топаз "Web Офис" дает ответ в формате **JSON** 76 76 77 -{{code language="javascript"}} 78 -{ 79 - { 80 - // идентификатор станции внутри Топаз "Web Офис" 81 - string StationId, 82 - // идентификатор топлива 83 - string ProductId, 84 - // цена за 1 литр 85 - double Price 86 - }, 87 -…. N 88 -} 89 -{{/code}} 83 +{{{{ 84 + { 85 + // идентификатор станции внутри Топаз "Web Офис" 86 + string StationId, 87 + // идентификатор топлива 88 + string ProductId, 89 + // цена за 1 литр 90 + double Price 91 + }, 92 + …. N 93 +}}}} 90 90 95 +**Пример ответа** 91 91 97 +{{{{ 98 + {“StationId”: “0001”, “ProductId”: “a92”, “Price”: 38.66}, 99 + {“StationId”: “0001”, “ProductId”: “a95_premium”, “Price”: 45.21}, 100 + {“StationId”: “0002”, “ProductId”: “a92”, “Price”: 38.98}, 101 +}}}} 92 92 93 -**Пример ответа**{{{}}} 94 - 95 -{{code language="javascript"}} 96 -{ 97 -{“StationId”: “0001”, “ProductId”: “a92”, “Price”: 38.66}, 98 -{“StationId”: “0001”, “ProductId”: “a95_premium”, “Price”: 45.21}, 99 -{“StationId”: “0002”, “ProductId”: “a92”, “Price”: 38.98}, 100 -} 101 -{{/code}} 102 - 103 103 == Обработка заказа == 104 104 105 105 [[image:https://wiki.topazelectro.ru/download/attachments/1179735/image2023-1-19_16-21-33.png?version=1&modificationDate=1716374642000&api=v2]] ... ... @@ -107,46 +107,44 @@ 107 107 Информирование Топаз "Web Офис" о заказе и их статусах осуществляется **HTTP **запросом на **url **с префиксом **/integration/order **, запрос типа **POST **, timeout 10 секунд. 108 108 109 109 110 -**Тело запроса содержит JSON вида Order** {{{}}}110 +**Тело запроса содержит JSON вида Order** 111 111 112 -{{code language="none"}} 113 -{ 114 -// идентификатор заказа 115 -string Id 116 -// дата и время создания в UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss 117 -String DateCreate 118 -// значение заказа 119 -double OrderVolume 120 -// идентификатор станции АЗС 121 -string StationExtendedId 122 -// номер колонки 123 -int ColumnId 124 -// идентификатор топлива 125 -string FuelId 126 -// стоимость 1 литра топлива 127 -double PriceFuel 128 -// сумма заказа 129 -double Sum 130 -// кол-во литров 131 -double Litre 132 -// итого оплачено 133 -double SumPaid 134 -// статус заказа 135 -OrderStatus Status 136 -// дата и время завершения заказа UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss 137 -String DateEnd 138 -// идентификатор причины отмены заказа 139 -string ReasonId 140 -// причина отмены 141 -string Reason 142 -// итого сумма литров залито 143 -double LitreCompleted 144 -// итого оплачено по завершению заказа 145 -double SumPaidCompleted 146 -// идентификатор договора 147 -string ContractId 148 -} 149 -{{/code}} 112 +{{{{ 113 + // идентификатор заказа 114 + string Id 115 + // дата и время создания в UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss 116 + String DateCreate 117 + // значение заказа 118 + double OrderVolume 119 + // идентификатор станции АЗС 120 + string StationExtendedId 121 + // номер колонки 122 + int ColumnId 123 + // идентификатор топлива 124 + string FuelId 125 + // стоимость 1 литра топлива 126 + double PriceFuel 127 + // сумма заказа 128 + double Sum 129 + // кол-во литров 130 + double Litre 131 + // итого оплачено 132 + double SumPaid 133 + // статус заказа 134 + OrderStatus Status 135 + // дата и время завершения заказа UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss 136 + String DateEnd 137 + // идентификатор причины отмены заказа 138 + string ReasonId 139 + // причина отмены 140 + string Reason 141 + // итого сумма литров залито 142 + double LitreCompleted 143 + // итого оплачено по завершению заказа 144 + double SumPaidCompleted 145 + // идентификатор договора 146 + string ContractId 147 +}}}} 150 150 151 151 Параметр **OrderType **– тип заказа может принимать следующие значения: 152 152 ... ... @@ -153,6 +153,7 @@ 153 153 * **Money **– заправка на фиксированную сумму, **OrderVolume **– сумма рублей 154 154 * **Liters **– заправка на литры, **OrderVolume **– кол-вол литров 155 155 154 + 156 156 Параметр **Status **– статус заказа может принимать следующие значения 157 157 158 158 * **OrderCreated **– заказ создан и полностью оплачен ... ... @@ -161,6 +161,7 @@ 161 161 * **StationCanceled **– заказ отменен оператором АЗС или же Топаз "Web Офис" 162 162 * **UserCanceled **– заказ отменен пользователем 163 163 163 + 164 164 Параметр **ContractId **– стандартными типами договора, по которому обрабатывается заказ 165 165 166 166 * **Individual **– договор возмездного оказания услуг (физические лица)