Запрос на получение данных реализации за смену — различия между версиями

Материал из Wiki
Перейти к: навигация, поиск
Строка 9: Строка 9:
 
|
 
|
 
* auto_unload_confirm - опциональный параметр. Указывает необходимость автоподтверждения установки флага выгруженности смены. Значения: on(по умолчанию); off(если нужно отключить автоподтверждение)
 
* auto_unload_confirm - опциональный параметр. Указывает необходимость автоподтверждения установки флага выгруженности смены. Значения: on(по умолчанию); off(если нужно отключить автоподтверждение)
−
* enable_club_card_customers - опциональный параметр. Указывает необходимость разворачивать данные типа оплаты "Клубные карты", в разрезе контрагентов Значения: on(по умолчанию); off(если нужно отключить вывод)  
+
* enable_club_card_customers - опциональный параметр. Указывает необходимость разворачивать данные типа оплаты "Клубные карты", в разрезе контрагентов Значения: on(по умолчанию); off(если нужно отключить вывод)
 +
* enable_extra_analitcs - опциональный параметр. Активирует генерацию узла "extra_analytics", который содержит данные по расширенной аналитики по кассовой смене.
 
* S1 – Id первой смены в запросе
 
* S1 – Id первой смены в запросе
 
* S2 – Id второй смены в запросе
 
* S2 – Id второй смены в запросе
Строка 15: Строка 16:
 
|-
 
|-
 
|Пример запроса
 
|Пример запроса
−
|<nowiki>http://localhost:9870/</nowiki><b>xml_unload_session</b>?s1=1&s2=3&s3=34&s4=36
+
|<nowiki>http://localhost:9870/</nowiki><b>xml_unload_session</b>?s1=1&s2=3&s3=34&s4=36&enable_extra_analitcs=on&auto_unload_confirm=on&enable_club_card_customers=on
 
|-
 
|-
 
|Пример ответа
 
|Пример ответа
Строка 191: Строка 192:
 
</store>
 
</store>
 
</discardings>
 
</discardings>
 +
                        <extra_analytics>
 +
                          <cashier>Петрова А.А.</cashier>
 +
                          <checks cash_sales="10"
 +
                                  cash_returns="1"
 +
                                  none_cash_sales="20"
 +
                                  none_cash_returns="0"
 +
                                  avg_pos="3.2"/>
 +
                          <taxes>
 +
                              <tax cash="true"  sum="10.10" ext_code="001" name="НДС 18"/>
 +
                              <tax cash="true"  sum="4.10" ext_code="002" name="НДС 10"/>
 +
                              <tax cash="false" sum="2.10" ext_code="001" name="НДС 18"/>
 +
                              <tax cash="false" sum="1.10" ext_code="002" name="НДС 10"/>
 +
                          </taxes> 
 +
 +
                        </extra_analytics>
 
</session>
 
</session>
 
</ef_to_back>
 
</ef_to_back>

Версия 10:15, 11 января 2017

API интеграции с учетной системой

Страница xml_unload_session
Параметры
  • auto_unload_confirm - опциональный параметр. Указывает необходимость автоподтверждения установки флага выгруженности смены. Значения: on(по умолчанию); off(если нужно отключить автоподтверждение)
  • enable_club_card_customers - опциональный параметр. Указывает необходимость разворачивать данные типа оплаты "Клубные карты", в разрезе контрагентов Значения: on(по умолчанию); off(если нужно отключить вывод)
  • enable_extra_analitcs - опциональный параметр. Активирует генерацию узла "extra_analytics", который содержит данные по расширенной аналитики по кассовой смене.
  • S1 – Id первой смены в запросе
  • S2 – Id второй смены в запросе
  • SN – Id N-ой смены в запросе
Пример запроса http://localhost:9870/xml_unload_session?s1=1&s2=3&s3=34&s4=36&enable_extra_analitcs=on&auto_unload_confirm=on&enable_club_card_customers=on
Пример ответа 
<?xml version="1.0" encoding="UTF-8"?>
<response datetime="2015-07-02 12:03:44">
	<result>ok</result>
	<ef_to_back dateuploading="2015-07-02 12:03:43">
                <!-- Session - Акт реализации по кассовой смене 
                     kkm - Наименование кассы
                     kkm_code - Код кассы
                     num - Кассовый номер смены (Порядковый номер Z отчета)
                     start_datetime - Дата/Время начала смены (Дата/Время первого чека)
                     finish_datetime - Дата/Время завершения смены (Дата/Время последнего чека(для незакрытой смены) или Z отчета)
                     sum - Балансовая сумма смены (Сумма всех продаж минус сумма всех возвратов)
                     cash - Балансовая сумма оплаты наличностью (программная)
                     bank_card - Балансовая сумма оплаты банковской карты (программная)
                     income_sum - Сумма средств по операции "Внесение в кассу" за смену
                     outcome_sum - Сумма средств по операции "Изъятие из кассы" за смену
                     fr_cash - Балансовая сумма оплаты наличностью (из ккм)
                     fr_bank_card - Балансовая сумма оплаты наличностью (из ккм)
                     fr_check_count - Количество чеков продажи и возвратов (из ккм)
                     cash_accumulation - Остаток наличности на момент закрытия смены в ккм (из ккм)
                     front_version - текущая (на момент запроса) версия кассового фронта
                     last_time_active - дата/время (на момент запроса) последнего соединения кассы с сервером
                     total_sale_sum - Сумма продаж по кассе
                     total_return_sum - Сумма возвратов по кассе
                -->
		<session id="98000" 
                         kkm="Касса Магазин Волжск-1, Ленина" 
                         kkm_code="001"
                         num="455" 
                         start_datetime="2015-06-27 18:52:28" 
                         finish_datetime="2015-06-28 20:01:15" 
                         sum="62462.03"
                         cash="61070.79" 
                         bank_card="1391.24" 
                         income_sum="0" 
                         outcome_sum="60000" 
                         fr_cash="61070.79" 
                         fr_bank_card="1391.24" 
                         fr_check_count="197" 
                         cash_accumulation="18385.67" 
                         front_version="1.87.11" 
                         last_time_active="2015-07-02 12:01:02" 
                         total_sale_sum="62603.73" 
                         total_return_sum="141.70">
                        <!-- sales - группировка продаж по типу оплаты 
                             payment - наименование типа оплаты
                          -->
			<sales payment="Наличные">
                                <!-- store - группировка по месту хранения
                                     name - наименование места хранения
                                 -->
				<store name="Волжск-1, Ленина Магазин">
                                        <!-- nom_element - проданная товарная единица
                                             barcode - код товара
                                             parentcode - Код родительской группы
                                             name - Наименование товара
                                             type - Наименование типа товара
                                             type_index - Номер типа товара (1-"Услуга",2-"Блюдо",3-"Товар")
                                             category - Категория товара
                                             unit - Единица измерения
                                             price - Цена продажи/возврата
                                             quantity - Кол-во проданного
                                             discount - Сумма скидки на проданные товары     
                                             sum - Сумма проданных товаров (price x quantity)
                                             return - Кол-во возвращенных единиц
                                             return_discount - Сумма скидки на возвращенные товары     
                                             return_sum - Сумма возвращенных товаров (price x return)
                                          -->
					<nom_element barcode="00-00046854" 
                                                     parentcode="00-00045652" 
                                                     name="584 Пломбир на сливках в пергаменте 70г 1/48" 
                                                     type="Товар" 
                                                     type_index="3" 
                                                     category="" 
                                                     unit="шт" 
                                                     price="25" 
                                                     quantity="3" 
                                                     discount="0" 
                                                     sum="75" 
                                                     return="0" 
                                                     return_discount="0" 
                                                     return_sum="0"/>
					<nom_element barcode="00-00000680" 
                                                     parentcode="00-00045921" 
                                                     name="Батон нарезной 400гр" 
                                                     type="Товар" 
                                                     type_index="3" 
                                                     category="" 
                                                     unit="шт" 
                                                     price="22" 
                                                     quantity="7" 
                                                     discount="0" 
                                                     sum="154" 
                                                     return="0" 
                                                     return_discount="0" 
                                                     return_sum="0"/>
                                   ...
				</store>
			</sales>
                        <sales payment="Банк.карты">
				<store name="Волжск-1, Ленина Магазин">
					<nom_element barcode="00-00021801" 
                                                     parentcode="00-00045920" 
                                                     name="Булочка СДОБНАЯ 100г" 
                                                     type="Товар" 
                                                     type_index="3" 
                                                     category="" 
                                                     unit="шт" 
                                                     price="13" 
                                                     quantity="2" 
                                                     discount="0" 
                                                     sum="26" 
                                                     return="0" 
                                                     return_discount="0" 
                                                     return_sum="0"/>
					<nom_element barcode="00-00020261" 
                                                     parentcode="00-00045692" 
                                                     name="Кекс ВОЛЖСКИЙ 75г" 
                                                     type="Товар" 
                                                     type_index="3" 
                                                     category="" 
                                                     unit="шт" 
                                                     price="14" 
                                                     quantity="6" 
                                                     discount="0" 
                                                     sum="84" 
                                                     return="0" 
                                                     return_discount="0" 
                                                     return_sum="0"/>
                                   ...
				</store>
			</sales>
                        <!-- discardings - Элемент содержит списания товаров, не прошедших через кассу 
                             sum - Сумма позиций эквивалентная продаже по списанию
                             reason - Наименование причины списания                                  
                          -->
			<discardings sum="0" reason="Discount 100%">
                                <!-- store - группировка по месту хранения
                                     name - наименование места хранения
                                 -->
				<store name="Волжск-1, Ленина Магазин">
                                        <!-- nom_element - проданная товарная единица
                                             barcode - код товара
                                             parentcode - Код родительской группы
                                             name - Наименование товара
                                             type - Наименование типа товара
                                             type_index - Номер типа товара (1-"Услуга",2-"Блюдо",3-"Товар")
                                             category - Категория товара
                                             unit - Единица измерения
                                             price - Цена продажи/возврата
                                             quantity - Кол-во проданного
                                             discount - Сумма скидки на проданные товары     
                                             sum - Сумма проданных товаров (price x quantity)
                                             return - Кол-во возвращенных единиц
                                             return_discount - Сумма скидки на возвращенные товары     
                                             return_sum - Сумма возвращенных товаров (price x return)
                                          -->
					<nom_element sum="0.01" 
					             name="Нулевой чек" 
					             return_sum="0" 
					             return_discount="0" 
					             return="0" 
					             discount="0.01" 
					             quantity="1" 
					             price="0.01" 
					             unit="шт" 
					             category="" 
					             type_index="3" 
					             type="Товар" 
					             parentcode="00-00002853" 
					             barcode="00-00002854"/>
				</store>
			</discardings>
                        <extra_analytics>
                           <cashier>Петрова А.А.</cashier>
                           <checks cash_sales="10" 
                                   cash_returns="1" 
                                   none_cash_sales="20" 
                                   none_cash_returns="0" 
                                   avg_pos="3.2"/>
                           <taxes>
                              <tax cash="true"  sum="10.10" ext_code="001" name="НДС 18"/>
                              <tax cash="true"  sum="4.10" ext_code="002" name="НДС 10"/>
                              <tax cash="false" sum="2.10" ext_code="001" name="НДС 18"/> 
                              <tax cash="false" sum="1.10" ext_code="002" name="НДС 10"/>
                           </taxes>  
 
                        </extra_analytics>
		</session>
	</ef_to_back>
</response>
Источник — «https://wiki.wgear.online/index.php?title=Запрос_на_получение_данных_реализации_за_смену&oldid=927»