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

Материал из Wiki
Перейти к: навигация, поиск
 
(не показаны 4 промежуточные версии этого же участника)
Строка 8: Строка 8:
 
|Параметры
 
|Параметры
 
|
 
|
−
* auto_unload_confirm - опциональный параметр. Указывает необходимость автоподтверждения установки флага выгруженности смены. Значения: on(по умолчанию); off(если нужно отключить автоподтверждение)
+
* <b>auto_unload_confirm</b> - опциональный параметр. Указывает необходимость автоподтверждения установки флага выгруженности смены. Значения: on(по умолчанию); off(если нужно отключить автоподтверждение)
−
* enable_club_card_customers - опциональный параметр. Указывает необходимость разворачивать данные типа оплаты "Клубные карты", в разрезе контрагентов Значения: on(по умолчанию); off(если нужно отключить вывод)
+
* <b>enable_club_card_customers</b> - опциональный параметр. Указывает необходимость разворачивать данные типа оплаты "Клубные карты", в разрезе контрагентов Значения: on(по умолчанию); off(если нужно отключить вывод)
−
* enable_extra_analitcs - опциональный параметр. Активирует генерацию узла "extra_analytics", который содержит данные по расширенной аналитики по кассовой смене.
+
* <b>enable_extra_analitcs</b> - опциональный параметр. Активирует генерацию узла "extra_analytics", который содержит данные по расширенной аналитики по кассовой смене. Значение "on" включает вывод ; "off" - выключает (по умолчанию)
 
* S1 – Id первой смены в запросе
 
* S1 – Id первой смены в запросе
 
* S2 – Id второй смены в запросе
 
* S2 – Id второй смены в запросе
Строка 16: Строка 16:
 
|-
 
|-
 
|Пример запроса
 
|Пример запроса
−
|<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
+
|<nowiki>http://localhost:9870/</nowiki><b>xml_unload_session</b>?s1=1&s2=3&s3=34&s4=36&<b>enable_extra_analitcs</b>=on&<b>auto_unload_confirm</b>=on&<b>enable_club_card_customers</b>=on
 
|-
 
|-
 
|Пример ответа
 
|Пример ответа
Строка 86: Строка 86:
 
                                             return_discount - Сумма скидки на возвращенные товары     
 
                                             return_discount - Сумма скидки на возвращенные товары     
 
                                             return_sum - Сумма возвращенных товаров (price x return)
 
                                             return_sum - Сумма возвращенных товаров (price x return)
 +
                                            tax_name - Наименование налоговый ставки
 +
                                            tax_uid - ID Налоговой ставки
 +
                                            tax_value - Сумма рассчитанного налога продаж по ставке
 +
                                            return_tax_value - Сумма рассчитанного налога возврата по ставке
 
                                           -->
 
                                           -->
 
<nom_element barcode="00-00046854"  
 
<nom_element barcode="00-00046854"  
Строка 192: Строка 196:
 
</store>
 
</store>
 
</discardings>
 
</discardings>
 +
                        <!-- Узел содержит дополнительную аналитику по смене вывод узла регулируется параметром enable_extra_analitcs-->
 
                         <extra_analytics>
 
                         <extra_analytics>
 +
                          <!-- Узел содержит имя кассира работавшего за смену. (Если несколько кассиров, то их имена выведутся через ";") -->
 
                           <cashier>Петрова А.А.</cashier>
 
                           <cashier>Петрова А.А.</cashier>
 +
                          <!-- Количественные показатели по чекам.
 +
                              cash_sales - количество чеков продажи наличными
 +
                              cash_returns - количество чеков возврата наличными
 +
                              none_cash_sales - количество чеков продажи безналом
 +
                              none_cash_returns - количество чеков возврата безналом
 +
                              avg_pos - среднее количество позиций в чеке
 +
                            -->
 
                           <checks cash_sales="10"  
 
                           <checks cash_sales="10"  
 
                                   cash_returns="1"  
 
                                   cash_returns="1"  
Строка 199: Строка 212:
 
                                   none_cash_returns="0"  
 
                                   none_cash_returns="0"  
 
                                   avg_pos="3.2"/>
 
                                   avg_pos="3.2"/>
 +
                          <!-- Аналитика по налогам -->
 
                           <taxes>
 
                           <taxes>
 +
                              <!-- Сумма налогов в разрезе типа оплаты и налоговой ставки
 +
                                  cash - логический признак наличный тип оплаты или нет
 +
                                  sum="10.10" - сумма налогов
 +
                                  ext_code="001"  - Код обмена налоговой ставки
 +
                                  name="НДС 18" - Наименование налоговой ставки
 +
                              -->
 
                               <tax cash="true"  sum="10.10" ext_code="001" name="НДС 18"/>
 
                               <tax cash="true"  sum="10.10" ext_code="001" name="НДС 18"/>
 
                               <tax cash="true"  sum="4.10" ext_code="002" name="НДС 10"/>
 
                               <tax cash="true"  sum="4.10" ext_code="002" name="НДС 10"/>

Текущая версия на 14:21, 6 августа 2018

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

Страница xml_unload_session
Параметры
  • auto_unload_confirm - опциональный параметр. Указывает необходимость автоподтверждения установки флага выгруженности смены. Значения: on(по умолчанию); off(если нужно отключить автоподтверждение)
  • enable_club_card_customers - опциональный параметр. Указывает необходимость разворачивать данные типа оплаты "Клубные карты", в разрезе контрагентов Значения: on(по умолчанию); off(если нужно отключить вывод)
  • enable_extra_analitcs - опциональный параметр. Активирует генерацию узла "extra_analytics", который содержит данные по расширенной аналитики по кассовой смене. Значение "on" включает вывод ; "off" - выключает (по умолчанию)
  • 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)
                                             tax_name - Наименование налоговый ставки 
                                             tax_uid - ID Налоговой ставки
                                             tax_value - Сумма рассчитанного налога продаж по ставке
                                             return_tax_value - Сумма рассчитанного налога возврата по ставке
                                          -->
					<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>
                        <!-- Узел содержит дополнительную аналитику по смене вывод узла регулируется параметром enable_extra_analitcs-->
                        <extra_analytics>
                           <!-- Узел содержит имя кассира работавшего за смену. (Если несколько кассиров, то их имена выведутся через ";") -->
                           <cashier>Петрова А.А.</cashier>
                           <!-- Количественные показатели по чекам.
                              cash_sales - количество чеков продажи наличными
                              cash_returns - количество чеков возврата наличными
                              none_cash_sales - количество чеков продажи безналом
                              none_cash_returns - количество чеков возврата безналом
                              avg_pos - среднее количество позиций в чеке
                            -->
                           <checks cash_sales="10" 
                                   cash_returns="1" 
                                   none_cash_sales="20" 
                                   none_cash_returns="0" 
                                   avg_pos="3.2"/>
                           <!-- Аналитика по налогам -->
                           <taxes>
                              <!-- Сумма налогов в разрезе типа оплаты и налоговой ставки 
                                   cash - логический признак наличный тип оплаты или нет
                                   sum="10.10" - сумма налогов
                                   ext_code="001"  - Код обмена налоговой ставки
                                   name="НДС 18" - Наименование налоговой ставки
                               -->
                              <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=1044»