Различия

Здесь показаны различия между двумя версиями данной страницы.

--- doc:dev:api:cashflow [09.09.2016 17:20]
rlysov
+++ doc:dev:api:cashflow [02.06.2018 10:42] (текущий)
@@ Строка 2: / Строка 2: @@
 В системе реализован программный интерфейс для получения данных движении денежных средств на кассовом рабочем месте. Данные выгружаются по http протоколу. Формат на выбор - xml или json.
+Пользовательский интерфейс для просмотра движения денег на кассе доступен в административной панели, меню **Кассовые места** -> **Рабочее кассовое место** -> **Движение денежных средств**
 ===== Типы денежных операций =====
@@ Строка 10: / Строка 12: @@
   * **outcome** - выплата наличных денег из кассы
   * **income** - внесение наличных денег в кассу
+  * **to_strongbox** - перемещение в главную кассу
+  * **from_strongbox** - перемещение из главной кассы
 ===== Параметры запроса на получение данных =====
-Параметры запроса данных:
+Параметры запроса данных (все параметры передаются как get-параметры):
   * int **terminalid** - ID кассы. Если не указан, то будут отданы данные по всем кассам
   * int  **warehouseid** - ID точки продаж (магазина), данные о которой надо получить. Будут отданы данные обо всех кассах этого магазина. Параметр игнорируется, если указан terminalid
@@ Строка 27: / Строка 31: @@
 Пример запроса на получение данных о движении денежных средств на всех кассах за последние два дня:
- http://mycompany.virtpos.ru/api/cashflow?apikey=MySecret&days=2
+ http://mycompany.virtpos.ru/api/cashFlow?apikey=MySecret&days=2&type=income,outcome
@@ Строка 42: / Строка 46: @@
 		<user_id>3</user_id>
 		<user_login>ivanov</user_login>
+		<user_corp_code>CBX-0000</user_corp_code>
 		<created_date>2016-09-07 19:42:42</created_date>
 		<last_update_date>2016-09-07 19:42:42</last_update_date>
 		<src_terminal_id>13</src_terminal_id>
 		<dst_terminal_id/>
+		<src_machine_number>0515309</src_machine_number>
+		<dst_machine_number/>
 		<src_warehouse_id>6</src_warehouse_id>
 		<dst_warehouse_id/>
@@ Строка 57: / Строка 64: @@
 		<comment/>
 		<receipt_id>363</receipt_id>
+		<guid>803ad8b6-688c-11e7-849d-74d435ee6043</guid>
+		<src_terminal_open_datetime/>
+		<dst_terminal_open_datetime>2017-07-19 13:56:52</dst_terminal_open_datetime>
+		<src_terminal_session/>
+		<dst_terminal_session>0</dst_terminal_session>
 	</transaction>
 </root>
@@ Строка 63: / Строка 75: @@
 ===== Формат ответа =====
-  * id - уникальный номер операции
+  * **id** - уникальный номер операции
-  * user_id - ID пользователя, совершившего операцию
+  * **user_id** - ID пользователя, совершившего операцию
-  * user_login - Логин пользователя, совершившего операцию
+  * **user_login** - Логин пользователя, совершившего операцию
-  * created_date - Дата создания операции
+  * **user_corp_code** - Корпоративный код пользователя, совершившего операцию
-  * last_update_date - Дата обновления этой записи. Должна совпадать с created_date
+  * **created_date** - Дата создания операции
-  * src_terminal_id - Уникальный идентификатор кассового рабочего места, откуда осуществлялось изъятие денег
+  * **last_update_date** - Дата обновления этой записи. Должна совпадать с created_date
-  * dst_terminal_id - Уникальный идентификатор кассового рабочего места, в которую осуществлено поступление денег
+  * **src_terminal_id** - Уникальный идентификатор кассового рабочего места, откуда осуществлялось изъятие денег
-  * src_warehouse_id - Уникальный идентификатор точки продаж, откуда осуществлялось изъятие денег
+  * **dst_terminal_id** - Уникальный идентификатор кассового рабочего места, в которую осуществлено поступление денег
-  * dst_warehouse_id - Уникальный идентификатор точки продаж, в которую осуществлено поступление денег
+  * **src_machine_number** - Регистрационный номер кассы, откуда осуществлялось изъятие денег
-  * src_warehouse_ext_id - аналог src_warehouse_id, но хранит код точки продаж во внешней системе
+  * **dst_machine_number** - Регистрационный номер кассы, в которую осуществлено поступление денег
-  * dst_warehouse_ext_id - аналог dst_warehouse_id, но хранит код точки продаж во внешней системе
+  * **src_warehouse_id** - Уникальный идентификатор точки продаж, откуда осуществлялось изъятие денег
-  * type - тип операции
+  * **dst_warehouse_id** - Уникальный идентификатор точки продаж, в которую осуществлено поступление денег
-  * subtype - подтип операции. ВОзможные значения зависят от настроек системы
+  * **src_warehouse_ext_id** - аналог src_warehouse_id, но хранит код точки продаж во внешней системе
-  * cash_before - сумма наличных денег в кассе до операции
+  * **dst_warehouse_ext_id** - аналог dst_warehouse_id, но хранит код точки продаж во внешней системе
-  * cash_after - сумма наличных денег в кассе после операции
+  * **type** - тип операции
-  * cash_change - сальдо операции
+  * **subtype** - подтип операции. Возможные значения зависят от настроек системы
-  * comment - комментрий, который оставил продавец при осуществлении операции
+  * **cash_before** - сумма наличных денег в кассе до операции
-  * receipt_id - ID чека. Заполняется для типов операций "продажа" и "возврат"
+  * **cash_after** - сумма наличных денег в кассе после операции
+  * **cash_change** - сальдо операции
+  * **comment** - комментарий, который оставил продавец при осуществлении операции
+  * **receipt_id** - ID чека. Заполняется для типов операций "продажа" и "возврат"
+  * **guid** - GUID операции
+  * **src_terminal_open_datetime** - дата открытия смены на кассе, откуда осуществлялось изъятие денег
+  * **dst_terminal_open_datetime** - дата открытия смены на кассе, в которую осуществлено поступление денег
+  * **src_terminal_session** - номер смены на кассе, откуда осуществлялось изъятие денег
+  * **dst_terminal_session** - номер смены на кассе, в которую осуществлено поступление денег