Изменения документа Протокол интеграции систем внешних наливов с Топаз "Web Офис"
Редактировал(а) Dmitriy 2026/04/23 06:18
От версии 10.1
отредактировано Ярослава Ерина
на 2024/07/30 05:36
на 2024/07/30 05:36
Изменить комментарий:
К данной версии нет комментариев
К версии 14.1
отредактировано Ярослава Ерина
на 2024/07/30 06:44
на 2024/07/30 06:44
Изменить комментарий:
К данной версии нет комментариев
Сводка
-
Свойства страницы (1 изменено, 0 добавлено, 0 удалено)
Подробности
- Свойства страницы
-
- Содержимое
-
... ... @@ -24,7 +24,8 @@ 24 24 25 25 **...** 26 26 27 -{{code language="javascript"}}{ 27 +{{code language="javascript"}} 28 +{ 28 28 // идентификатор станции АЗС 29 29 string Id 30 30 // статус станции: true – доступна, false – выключена ... ... @@ -47,10 +47,9 @@ 47 47 "Fuels": [ "a92", "a95", "diesel_premium", ... N ] 48 48 } 49 49 } ... N 50 -}{{/code}} 51 +} 52 +{{/code}} 51 51 52 -{{{{ // идентификатор станции АЗС string Id // статус станции: true – доступна, false – выключена bool Enable, // наименование станции string Name, // адрес станции string Address, // гео точка на карте location Location { double Lat, double Lon }, // словарь доступных ТРК Dictionary Columns { // номер колонки (int32) Key: { // список доступных типов топлива "Fuels": [ "a92", "a95", "diesel_premium", ... N ] } } ... N }}}} 53 - 54 54 **Возможные идентификаторы топлива** 55 55 56 56 |ID|Марка ... ... @@ -72,29 +72,34 @@ 72 72 73 73 Внешняя система опрашивает Топаз "Web Офис" для получения прайс-листа **HTTP **запросом на **url **с префиксом **/integration/price?apikey={apikey} **, запрос типа **GET **, timeout 10секунд. 74 74 75 -В ответ Топаз "Web Офис" дает ответ в формате **JSON** 75 +В ответ Топаз "Web Офис" дает ответ в формате **JSON**{{{}}} 76 76 77 -{{{{ { // идентификатор станции внутри Топаз "Web Офис" string StationId, // идентификатор топлива string ProductId, // цена за 1 литр double Price }, …. N }}}} 78 - 79 - 80 80 {{code language="javascript"}} 81 81 { 82 -{ 83 -// идентификатор станции внутри Топаз "Web Офис" 84 -string StationId, 85 -// идентификатор топлива 86 -string ProductId, 87 -// цена за 1 литр 88 -double Price 89 -}, …. N 79 + { 80 + // идентификатор станции внутри Топаз "Web Офис" 81 + string StationId, 82 + // идентификатор топлива 83 + string ProductId, 84 + // цена за 1 литр 85 + double Price 86 + }, 87 +…. N 90 90 } 91 91 {{/code}} 92 92 93 93 94 -**Пример ответа** 95 95 96 - {{{{{“StationId”: “0001”, “ProductId”: “a92”, “Price”: 38.66},{“StationId”: “0001”, “ProductId”: “a95_premium”, “Price”: 45.21},{“StationId”: “0002”, “ProductId”: “a92”, “Price”: 38.98},}}}}93 +**Пример ответа**{{{}}} 97 97 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 + 98 98 == Обработка заказа == 99 99 100 100 [[image:https://wiki.topazelectro.ru/download/attachments/1179735/image2023-1-19_16-21-33.png?version=1&modificationDate=1716374642000&api=v2]] ... ... @@ -102,9 +102,46 @@ 102 102 Информирование Топаз "Web Офис" о заказе и их статусах осуществляется **HTTP **запросом на **url **с префиксом **/integration/order **, запрос типа **POST **, timeout 10 секунд. 103 103 104 104 105 -**Тело запроса содержит JSON вида Order** 110 +**Тело запроса содержит JSON вида Order**{{{}}} 106 106 107 -{{{{ // идентификатор заказа string Id // дата и время создания в UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss String DateCreate // значение заказа double OrderVolume // идентификатор станции АЗС string StationExtendedId // номер колонки int ColumnId // идентификатор топлива string FuelId // стоимость 1 литра топлива double PriceFuel // сумма заказа double Sum // кол-во литров double Litre // итого оплачено double SumPaid // статус заказа OrderStatus Status // дата и время завершения заказа UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss String DateEnd // идентификатор причины отмены заказа string ReasonId // причина отмены string Reason // итого сумма литров залито double LitreCompleted // итого оплачено по завершению заказа double SumPaidCompleted // идентификатор договора string ContractId }}}} 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}} 108 108 109 109 Параметр **OrderType **– тип заказа может принимать следующие значения: 110 110