Изменения документа Протокол интеграции систем внешних наливов с Топаз "Web Офис"

Сводка

• Свойства страницы (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,40 +72,27 @@
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
91		-
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}}
104		-
105		-
106	106	**Пример ответа**
107	107
108		-{{{{ {“StationId”: “0001”, “ProductId”: “a92”, “Price”: 38.66}, {“StationId”: “0001”, “ProductId”: “a95_premium”, “Price”: 45.21}, {“StationId”: “0002”, “ProductId”: “a92”, “Price”: 38.98}, }}}}
	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	+}}}}
109	109
110	110	== Обработка заказа ==
111	111
...	...	@@ -116,7 +116,42 @@
116	116
117	117	**Тело запроса содержит JSON вида Order**
118	118
119		-{{{{ // идентификатор заказа 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	+{{{{
	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	+}}}}
120	120
121	121	Параметр **OrderType **– тип заказа может принимать следующие значения:
122	122
...	...	@@ -123,6 +123,7 @@
123	123	* **Money **– заправка на фиксированную сумму, **OrderVolume **– сумма рублей
124	124	* **Liters **– заправка на литры, **OrderVolume **– кол-вол литров
125	125
	154	+
126	126	Параметр **Status **– статус заказа может принимать следующие значения
127	127
128	128	* **OrderCreated **– заказ создан и полностью оплачен
...	...	@@ -131,6 +131,7 @@
131	131	* **StationCanceled **– заказ отменен оператором АЗС или же Топаз "Web Офис"
132	132	* **UserCanceled **– заказ отменен пользователем
133	133
	163	+
134	134	Параметр **ContractId **– стандартными типами договора, по которому обрабатывается заказ
135	135
136	136	* **Individual **– договор возмездного оказания услуг (физические лица)