Перейти к содержимому
Редактировал(а) Dmitriy 2026/04/23 06:18
От версии 1.1
отредактировано Ярослава Ерина
на 2024/07/17 12:36
Изменить комментарий: К данной версии нет комментариев
К версии 13.1
отредактировано Ярослава Ерина
на 2024/07/30 06:36
Изменить комментарий: К данной версии нет комментариев

Сводка

Подробности

Свойства страницы
Содержимое
... ... @@ -24,38 +24,32 @@
24 24  
25 25  **...**
26 26  
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 -}}}}
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}}
59 59  
60 60  **Возможные идентификаторы топлива**
61 61  
... ... @@ -78,28 +78,47 @@
78 78  
79 79  Внешняя система опрашивает Топаз "Web Офис" для получения прайс-листа **HTTP **запросом на **url **с префиксом **/integration/price?apikey={apikey} **, запрос типа **GET **, timeout 10секунд.
80 80  
81 -В ответ Топаз "Web Офис" дает ответ в формате **JSON**
75 +В ответ Топаз "Web Офис" дает ответ в формате **JSON**{{{}}}
82 82  
83 -{{{{
84 - {
85 - // идентификатор станции внутри Топаз "Web Офис"
86 - string StationId,
87 - // идентификатор топлива
88 - string ProductId,
89 - // цена за 1 литр
90 - double Price
91 - },
92 - …. N
93 -}}}}
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}}
94 94  
95 -**Пример ответа**
96 96  
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 +{{code language="javascript"}}
93 +{
94 +{
95 +// идентификатор станции внутри Топаз "Web Офис"
96 +string StationId, 
97 +// идентификатор топлива 
98 +string ProductId, 
99 +// цена за 1 литр 
100 +double Price 
101 +}, …. N 
102 +}
103 +{{/code}}
102 102  
105 +
106 +**Пример ответа**{{{}}}
107 +
108 +{{code language="javascript"}}
109 +{
110 +{“StationId”: “0001”, “ProductId”: “a92”, “Price”: 38.66},
111 +{“StationId”: “0001”, “ProductId”: “a95_premium”, “Price”: 45.21},
112 +{“StationId”: “0002”, “ProductId”: “a92”, “Price”: 38.98},
113 +}
114 +{{/code}}
115 +
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,44 +107,46 @@
107 107  Информирование Топаз "Web Офис" о заказе и их статусах осуществляется **HTTP **запросом на **url **с префиксом **/integration/order **, запрос типа **POST **, timeout 10 секунд.
108 108  
109 109  
110 -**Тело запроса содержит JSON вида Order**
123 +**Тело запроса содержит JSON вида Order**{{{}}}
111 111  
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 -}}}}
125 +{{code language="none"}}
126 +{
127 +// идентификатор заказа
128 +string Id
129 +// дата и время создания в UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss
130 +String DateCreate
131 +// значение заказа
132 +double OrderVolume
133 +// идентификатор станции АЗС
134 +string StationExtendedId
135 +// номер колонки
136 +int ColumnId
137 +// идентификатор топлива
138 +string FuelId
139 +// стоимость 1 литра топлива
140 +double PriceFuel
141 +// сумма заказа
142 +double Sum
143 +// кол-во литров
144 +double Litre
145 +// итого оплачено
146 +double SumPaid
147 +// статус заказа
148 +OrderStatus Status
149 +// дата и время завершения заказа UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss
150 +String DateEnd
151 +// идентификатор причины отмены заказа
152 +string ReasonId
153 +// причина отмены
154 +string Reason
155 +// итого сумма литров залито
156 +double LitreCompleted
157 +// итого оплачено по завершению заказа
158 +double SumPaidCompleted
159 +// идентификатор договора
160 +string ContractId
161 +}
162 +{{/code}}
148 148  
149 149  Параметр **OrderType **– тип заказа может принимать следующие значения:
150 150  
... ... @@ -151,7 +151,6 @@
151 151  * **Money **– заправка на фиксированную сумму, **OrderVolume **– сумма рублей
152 152  * **Liters **– заправка на литры, **OrderVolume **– кол-вол литров
153 153  
154 -
155 155  Параметр **Status **– статус заказа может принимать следующие значения
156 156  
157 157  * **OrderCreated **– заказ создан и полностью оплачен
... ... @@ -160,7 +160,6 @@
160 160  * **StationCanceled **– заказ отменен оператором АЗС или же Топаз "Web Офис"
161 161  * **UserCanceled **– заказ отменен пользователем
162 162  
163 -
164 164  Параметр **ContractId **– стандартными типами договора, по которому обрабатывается заказ
165 165  
166 166  * **Individual **– договор возмездного оказания услуг (физические лица)