Изменения документа Протокол интеграции систем внешних наливов с Топаз "Web Офис"
Редактировал(а) Dmitriy 2026/04/23 06:18
От версии 5.1
отредактировано Ярослава Ерина
на 2024/07/30 05:21
на 2024/07/30 05:21
Изменить комментарий:
К данной версии нет комментариев
К версии 14.1
отредактировано Ярослава Ерина
на 2024/07/30 06:44
на 2024/07/30 06:44
Изменить комментарий:
К данной версии нет комментариев
Сводка
-
Свойства страницы (1 изменено, 0 добавлено, 0 удалено)
Подробности
- Свойства страницы
-
- Содержимое
-
... ... @@ -24,10 +24,33 @@ 24 24 25 25 **...** 26 26 27 -**{{code language="javascript" layout="LINENUMBERS"}}{ // идентификатор станции АЗС 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 }{{/code}}** 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}} 28 28 29 -{{{{ // идентификатор станции АЗС 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 }}}} 30 - 31 31 **Возможные идентификаторы топлива** 32 32 33 33 |ID|Марка ... ... @@ -49,14 +49,34 @@ 49 49 50 50 Внешняя система опрашивает Топаз "Web Офис" для получения прайс-листа **HTTP **запросом на **url **с префиксом **/integration/price?apikey={apikey} **, запрос типа **GET **, timeout 10секунд. 51 51 52 -В ответ Топаз "Web Офис" дает ответ в формате **JSON** 75 +В ответ Топаз "Web Офис" дает ответ в формате **JSON**{{{}}} 53 53 54 -{{{{ { // идентификатор станции внутри Топаз "Web Офис" string StationId, // идентификатор топлива string ProductId, // цена за 1 литр double Price }, …. N }}}} 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}} 55 55 56 -**Пример ответа** 57 57 58 -{{{{ {“StationId”: “0001”, “ProductId”: “a92”, “Price”: 38.66}, {“StationId”: “0001”, “ProductId”: “a95_premium”, “Price”: 45.21}, {“StationId”: “0002”, “ProductId”: “a92”, “Price”: 38.98}, }}}} 59 59 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 + 60 60 == Обработка заказа == 61 61 62 62 [[image:https://wiki.topazelectro.ru/download/attachments/1179735/image2023-1-19_16-21-33.png?version=1&modificationDate=1716374642000&api=v2]] ... ... @@ -64,9 +64,46 @@ 64 64 Информирование Топаз "Web Офис" о заказе и их статусах осуществляется **HTTP **запросом на **url **с префиксом **/integration/order **, запрос типа **POST **, timeout 10 секунд. 65 65 66 66 67 -**Тело запроса содержит JSON вида Order** 110 +**Тело запроса содержит JSON вида Order**{{{}}} 68 68 69 -{{{{ // идентификатор заказа 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}} 70 70 71 71 Параметр **OrderType **– тип заказа может принимать следующие значения: 72 72