Перейти к содержимому
Редактировал(а) Dmitriy 2026/04/23 06:18
От версии 20.3
отредактировано Dmitriy
на 2024/12/03 12:21
Изменить комментарий: К данной версии нет комментариев
К версии 23.1
отредактировано Dmitriy
на 2024/12/06 10:17
Изменить комментарий: К данной версии нет комментариев

Сводка

Подробности

Свойства страницы
Содержимое
... ... @@ -39,7 +39,7 @@
39 39  
40 40  **...**
41 41  
42 -{{code language="javascript"}}
42 +{{code language="javascript" layout="LINENUMBERS"}}
43 43  {
44 44  // идентификатор станции АЗС
45 45  string Id
... ... @@ -89,7 +89,7 @@
89 89  
90 90  В ответ Топаз "Web Офис" дает ответ в формате **JSON**{{{}}}
91 91  
92 -{{code language="javascript"}}
92 +{{code language="javascript" layout="LINENUMBERS"}}
93 93  {
94 94   {
95 95   // идентификатор станции внутри Топаз "Web Офис"
... ... @@ -122,47 +122,67 @@
122 122  Информирование "Топаз-Web Office" о заказе и их статусах осуществляется **HTTP **запросом на **baseUrl **с префиксом **/order **, запрос типа **POST **, timeout 10 секунд.
123 123  
124 124  
125 -**Тело запроса содержит JSON вида Order**{{{}}}
125 +**Тело запроса содержит JSON вида Order{{{}}}**
126 126  
127 -{{code language="javascript"}}
127 +{{code language="javascript" layout="LINENUMBERS"}}
128 128  {
129 -// идентификатор заказа
130 -string Id
129 +// Идентификатор заказа
130 +String Id
131 131  // дата и время создания в UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss
132 -String DateCreate
133 -// значение заказа
134 -double OrderVolume
132 +String DateCreate
135 135  // идентификатор станции АЗС
136 -string StationExtendedId
137 -// номер колонки
134 +String StationExtendedId
135 +// Тип заказа
136 +String OrderType
137 +// номер стороны (поста)
138 138  int ColumnId
139 -// идентификатор топлива
140 -string FuelId
141 -// стоимость 1 литра топлива
139 +// Идентификатор топлива
140 +String FuelId
141 +// Стоимость 1 литра топлива
142 142  double PriceFuel
143 -// сумма заказа
143 +// Сумма заказа
144 144  double Sum
145 -// кол-во литров
145 +// Размер заказа в литрах
146 146  double Litre
147 -// итого оплачено
147 +// Итого оплачено
148 148  double SumPaid
149 -// статус заказа
149 +// Статус заказа
150 150  OrderStatus Status
151 151  // дата и время завершения заказа UTC, формат даты yyyy-MM-dd'T'HH:mm:ss.SSSSSSS'Z' либо yyyy-MM-dd HH:mm:ss
152 152  String DateEnd
153 -// идентификатор причины отмены заказа
154 -string ReasonId
155 -// причина отмены
156 -string Reason
157 -// итого сумма литров залито
153 +// Идентификатор причины отмены заказа
154 +String ReasonId
155 +// Причина отмены
156 +String Reason
157 +// Итого заправлено
158 158  double LitreCompleted
159 -// итого оплачено по завершению заказа
159 +// Итого оплачено по завершению заказа
160 160  double SumPaidCompleted
161 -// идентификатор договора
162 -string ContractId
161 +// Идентификатор договора
162 +String ContractId
163 +// Способ оплаты
164 +String PayType
163 163  }
164 164  {{/code}}
165 165  
168 +**Обязательными полями при создании нового заказа являются:**
169 +
170 +{{code layout="LINENUMBERS" language="javascript"}}
171 +{
172 + "Id": "string",
173 + "DateCreate": "string",
174 + "OrderType": "Money",
175 + "StationExtendedId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
176 + "ColumnId": 0,
177 + "FuelId": "diesel"
178 + "PriceFuel": 0,
179 + "Sum": 0,
180 + "Litre": 0,
181 + "Status": "OrderCreated"
182 + "ContractId": "string"
183 +}
184 +{{/code}}
185 +
166 166  Параметр **OrderType **– тип заказа может принимать следующие значения:
167 167  
168 168  * **Money **– заправка на фиксированную сумму
... ... @@ -190,6 +190,8 @@
190 190  
191 191  == Передача статусов о заказе ==
192 192  
213 +Для получения статусов Интегратору необходимо со своей стороны реализовать сервис для их получения и обработки
214 +
193 193  === Статус Accepted ===
194 194  
195 195  Данный статус сообщает внешней системе о том, что заказ принят и обработан в "Топаз-Web Office"
... ... @@ -198,8 +198,10 @@
198 198  
199 199  В случае если внешняя система дала ответ, отличный от **200 ОК **, то "Топаз-Web Office" отсылает статус Canceled и прекращает обработку заказ
200 200  
201 -**baseUrl + /api/order/accept POST**
223 +**baseUrl + /api/order/accept**
202 202  
225 +**POST**
226 +
203 203  **apikey={apikey}&orderId={ordeId}**
204 204  
205 205  все параметры являются обязательными
... ... @@ -212,8 +212,10 @@
212 212  
213 213  В случае если внешняя система дала ответ, отличный от **200 ОК **, то "Топаз-Web Office" отсылает статус Canceled и прекращает обработку заказ
214 214  
215 -**baseUrl + /api/order/fueling POST**
239 +**baseUrl + /api/order/fueling**
216 216  
241 +**POST**
242 +
217 217  **apikey={apikey}&orderId={ordeId}**
218 218  
219 219  все параметры являются обязательными
... ... @@ -240,10 +240,8 @@
240 240  
241 241  **baseUrl + /api/order/completed POST**
242 242  
243 -**apikey={apikey}&orderId={ordeId}&litre={litre}&extendedOrderId={extendedOrderId}&**
269 +**apikey={apikey}&orderId={ordeId}&litre={litre}&extendedOrderId={extendedOrderId}&extendedDate={extendedDate}**
244 244  
245 -**extendedDate={extendedDate}**
246 -
247 247  все параметры являются обязательными
248 248  
249 249  **litre **– кол-во пролитых литров, указывается как **double **с разделителем точка **extendedOrderId **– идентификатор заказа в АСУ сети
... ... @@ -270,10 +270,12 @@
270 270  
271 271  Перед формирование заказ внешняя система делает запрос на станцию для определения доступности и готовности станции принять заказ **baseUrl **с префиксом
272 272  
273 -**/ping?apikey={apikey}&stationId={stationId}&columnId={columnId}, stationId **– идентификатор станции
297 +**/ping?apikey={apikey}&stationId={stationId}&columnId={columnId},**
274 274  
275 -**columnId **– идентификатор ТРК
299 +**stationId **– идентификатор станции
276 276  
301 +**columnId **– идентификатор стороны ТРК
302 +
277 277  запрос типа **GET **, timeout 10 секунд.
278 278  
279 279  == Статусы ответов ==