Это старая версия документа.


API :: CashFlow. Движение денежных средств на кассе

В системе реализован программный интерфейс для получения данных движении денежных средств на кассовом рабочем месте. Данные выгружаются по http протоколу. Формат на выбор - xml или json.

Типы денежных операций

Доступны данные о следующих типах операций:

  • sale - поступление наличных денег от продажа товара
  • return - выплата за возврат товара на кассе
  • collection - инкассация
  • outcome - выплата наличных денег из кассы
  • income - внесение наличных денег в кассу

Параметры запроса на получение данных

Параметры запроса данных:

  • int terminalid - ID кассы. Если не указан, то будут отданы данные по всем кассам
  • int warehouseid - ID точки продаж (магазина), данные о которой надо получить. Будут отданы данные обо всех кассах этого магазина. Параметр игнорируется, если указан terminalid
  • string warehouseextid - ID точки продаж во внешней системе (например, в 1С). Параметр игнорируется, если указан terminalid или warehouseid
  • string type - типы операций, которые надо вернуть. Полный перечень типов указан выше. Если необходимо вернуть данные о нескольких типах сразу, то можно указать их через запятую. Пример: income,outcome,collection
  • int lastid - если указан, то возвращаются все денежные транзакции, которые были после указанного lastId. Используется для получения только новых данных с момента последнего обращения
  • int limit - возвращает не более указанного количества записей. По умолчанию установлен лимит 100 записей
  • int days - возвращает данные за последние количество дней.

Пример запроса на получение данных

Пример запроса на получение данных о движении денежных средств на всех кассах за последние два дня:

http://mycompany.virtpos.ru/api/cashflow?apikey=MySecret&days=2

Пример ответа

<?xml version="1.0" encoding="UTF-8"?>
<root>
	<success>1</success>
	<type>cashflow</type>
	<count>3</count>
	<transactions>
		<transaction>
		<id>375</id>
		<user_id>3</user_id>
		<user_login>ivanov</user_login>
		<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_warehouse_id>6</src_warehouse_id>
		<dst_warehouse_id/>
		<src_warehouse_ext_id/>
		<dst_warehouse_ext_id/>
		<type>sale</type>
		<subtype/>
		<cash_before>437.00</cash_before>
		<cash_after>759.50</cash_after>
		<cash_change>322.50</cash_change>
		<comment/>
		<receipt_id>363</receipt_id>
	</transaction>
</root>