Различия

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

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
doc:dev:api:zreport [05.06.2017 17:15]
sshevchuk
doc:dev:api:zreport [02.06.2018 10:42] (текущий)
Строка 12: Строка 12:
  
 ==== Параметры запроса на получение данных ==== ==== Параметры запроса на получение данных ====
 +Параметры,​ которые не отмечены как **get only**, могут быть переданы как get- или как post-параметры.
   * **apikey** - Секретный ключ для доступа к данным. Обязательный параметр.   * **apikey** - Секретный ключ для доступа к данным. Обязательный параметр.
  
-  * **format** - формат,​ в котором сервер отдаст данные. Может принимать значения "​xml"​ или "​json"​. Необязательный параметр.+  * **format** ​(get only) - формат,​ в котором сервер отдаст данные. Может принимать значения "​xml"​ или "​json"​. Необязательный параметр.
  
-  * **date** - Дата, за которую надо вернуть данные. Формат:​ ГГГГММДД. Необязательный параметр.+  * **date** ​(get only) - Дата, за которую надо вернуть данные. Формат:​ ГГГГММДД. Необязательный параметр.
  
-  * **warehouse_id** - код магазина,​ для которого надо вернуть отчеты. Если не указан,​ то возвращаются данные обо всех магазинах. Необязательный параметр.+  * **warehouse_id** ​(get only) - код магазина,​ для которого надо вернуть отчеты. Если не указан,​ то возвращаются данные обо всех магазинах. Необязательный параметр.
  
-  * **ext_warehouse_id** - код магазина во внешней системе (например,​ в 1С). Параметр игнорируется,​ если передан warehouse_id. Необязательный параметр.+  * **ext_warehouse_id** ​(get only) - код магазина во внешней системе (например,​ в 1С). Параметр игнорируется,​ если передан warehouse_id. Необязательный параметр.
  
-  * **terminal_id** - код кассового места. Необязательный параметр.+  * **terminal_id** ​(get only) - код кассового места. Необязательный параметр.
  
-  * **fiscal_number** - серийный номер фискального регистратора. Игнорируется,​ если передан terminal_id. Необязательный параметр.+  * **fiscal_number** ​(get only) - серийный номер фискального регистратора. Игнорируется,​ если передан terminal_id. Необязательный параметр.
  
-  * **session** - номер смены. Необязательный параметр.+  * **session** ​(get only) - номер смены. Необязательный параметр.
  
  
Строка 43: Строка 43:
     <​success>​1</​success>​     <​success>​1</​success>​
     <​type>​zreport</​type>​     <​type>​zreport</​type>​
-    <​count>​24</​count>​+    <​count>​1</​count>​
     <​zreports>​     <​zreports>​
         <​zreport>​         <​zreport>​
             <​id>​1138</​id>​             <​id>​1138</​id>​
             <​terminal_id>​27</​terminal_id>​             <​terminal_id>​27</​terminal_id>​
 +            <​terminal_number>​101</​terminal_number>​
 +            <​warehouse_external_id>​111</​warehouse_external_id>​
             <​fiscal_number>​00517929</​fiscal_number>​             <​fiscal_number>​00517929</​fiscal_number>​
             <​guid>​CE007AB6-EE10-A771-81CC-14996C8083E4</​guid>​             <​guid>​CE007AB6-EE10-A771-81CC-14996C8083E4</​guid>​
Строка 55: Строка 57:
             <​open_user_id>​32</​open_user_id>​             <​open_user_id>​32</​open_user_id>​
             <​close_user_id>​32</​close_user_id>​             <​close_user_id>​32</​close_user_id>​
 +            <​open_user_corp_code>​CBX-1111</​open_user_corp_code>​
 +            <​close_user_corp_code>​CBX-1111</​close_user_corp_code>​
 +            <​open_user_fio>​Алексей Р. ..</​open_user_fio>​
 +            <​close_user_fio>​Алексей Р. ..</​close_user_fio>​
             <​open_datetime>​2016-10-26 21:​58:​48</​open_datetime>​             <​open_datetime>​2016-10-26 21:​58:​48</​open_datetime>​
             <​close_datetime>​2016-10-26 21:​58:​48</​close_datetime>​             <​close_datetime>​2016-10-26 21:​58:​48</​close_datetime>​
 +            <​device_model_name>​ШТРИХ-ФР-01Ф</​device_model_name>​
 +            <​device_model_version>​S C.1 34378 13.01.2017 0 0 01.01.1980 1.14 4</​device_model_version>​
 +            <​short_fiscal_serial_number>​234234</​short_fiscal_serial_number>​
             <​fp_reg_oper_sale_counts>​2</​fp_reg_oper_sale_counts>​             <​fp_reg_oper_sale_counts>​2</​fp_reg_oper_sale_counts>​
             <​fp_reg_cash_sale_sum>​4300.00</​fp_reg_cash_sale_sum>​             <​fp_reg_cash_sale_sum>​4300.00</​fp_reg_cash_sale_sum>​
Строка 99: Строка 108:
             <​fp_reg_cash_sale_sum_discount>​0.00</​fp_reg_cash_sale_sum_discount>​             <​fp_reg_cash_sale_sum_discount>​0.00</​fp_reg_cash_sale_sum_discount>​
             <​fp_reg_oper_sale_counts_discount>​0</​fp_reg_oper_sale_counts_discount>​             <​fp_reg_oper_sale_counts_discount>​0</​fp_reg_oper_sale_counts_discount>​
 +            <​fp_reg_cash_total_sale_sum>​0</​fp_reg_cash_total_sale_sum>​
 +            <vat>
 +                        <​sale>​
 +                                    <​vat10_sum>​0.00</​vat10_sum>​
 +                                    <​vat18_sum>​253.98</​vat18_sum>​
 +                        </​sale>​
 +                        <​return>​
 +                                    <​vat10_sum/>​
 +                                    <​vat18_sum/>​
 +                        </​return>​
 +            </​vat>​
 +            <​sum_with_vat>​
 +                        <​sale>​
 +                                    <​sum_with_vat_none/>​
 +                                    <​sum_with_vat0/>​
 +                                    <​sum_with_vat10>​91.00</​sum_wuth_vat10>​
 +                                    <​sum_with_vat18>​285.00</​sum_wuth_vat18>​
 +                        </​sale>​
 +                        <​return>​
 +                                    <​sum_with_vat_none/>​
 +                                    <​sum_with_vat0/>​
 +                                    <​sum_with_vat10/>​
 +                                    <​sum_with_vat18/>​
 +                        </​return>​
 +            </​sum_with_vat>​
 +            <​discount_misc>​0</​discount_misc>​
         </​zreport>​         </​zreport>​
     </​zreports> ​   ​     </​zreports> ​   ​
Строка 115: Строка 150:
  
 **terminal_id** – номер принтера чеков в системе **terminal_id** – номер принтера чеков в системе
 +
 +**terminal_number** - номер кассы в зале
 +
 +**warehouse_external_id** - идентификатор магазина во внешней системе
  
 **fiscal_number** - заводской номер принтера чеков **fiscal_number** - заводской номер принтера чеков
Строка 129: Строка 168:
  
 **close_user_id** - ID пользователя,​ закрывшего смену **close_user_id** - ID пользователя,​ закрывшего смену
 +
 +**open_user_corp_code** – корпоративный код пользователя,​ открывшего смену
 +
 +**close_user_corp_code** - корпоративный код пользователя,​ закрывшего смену
 +
 +**open_user_fio** – ФИО пользователя,​ открывшего смену
 +
 +**close_user_fio** - ФИО пользователя,​ закрывшего смену
  
 **open_datetime** – дата и время открытия смены **open_datetime** – дата и время открытия смены
  
 **close_datetime** – дата и время закрытия смены **close_datetime** – дата и время закрытия смены
 +
 +**device_model_name** - наименование модели ККМ
 +
 +**device_model_version** - версия модели ККТ
 +
 +**short_fiscal_serial_number** - краткий серийный номер ККТ
  
 **fp_reg_oper_sale_counts** – количество всех регистраций по всем типам чеков **fp_reg_oper_sale_counts** – количество всех регистраций по всем типам чеков
Строка 216: Строка 269:
 **fp_reg_oper_sale_counts_discount** – не используется **fp_reg_oper_sale_counts_discount** – не используется
  
 +**fp_reg_cash_total_sale_sum** - необнуляемая сумма на конец смены
  
- +**discount_misc** - cумма продаж по купонам и сертификатам ​
  
  
Строка 244: Строка 297:
 **9** – чек коррекции расхода;​ **9** – чек коррекции расхода;​
  
-**10** – чек коррекции возврата расхода. ​+**10** – чек коррекции возврата расхода. ​
  
  
Строка 251: Строка 304:
 === Тип закрытия чека === === Тип закрытия чека ===
  
 +**0** - наличными;​
  
 +**1** - тип оплаты 1;
  
 +**2** - тип оплаты 2;
  
 +**3** - тип оплаты 3 – по банковской карте;
  
-**0** - наличными;+**4** - тип оплаты 4;
  
-**1** - тип оплаты ​1;+**5** - тип оплаты ​5.
  
-
**2** - тип оплаты 2; 
  
-**3** - тип оплаты 3 – по банковской карте
;​ 
  
-**4** - тип оплаты 4; 
  
-**5** - тип оплаты ​5.
+=== Данные по итоговым на смену суммам НДС === 
 + 
 +**vat/sale** - данные о продажах:​ 
 + 
 +**vat/​sale/​vat10_sum** - сумма НДС по ставке 10% 
 + 
 +**vat/​sale/​vat18_sum** - сумма НДС ​по ставке 18% 
 + 
 +**vat/​return** - данные о возвратах:​ 
 + 
 +**vat/​return/​vat10_sum** - сумма НДС ​по ставке 10% 
 + 
 +**vat/​return/​vat18_sum** - сумма НДС по ставке 18% 
 + 
 + 
 + 
 + 
 +=== Данные по итоговым на смену суммам чеков, в разрезе различных ставок НДС и типов чеков === 
 + 
 +**sum_with_vat/​sale** - данные о продажах:​ 
 + 
 +**sum_with_vat/​sale/​sum_with_vat_none** - сумма продаж по ставке "​НДС не облагается"​ 
 + 
 +**sum_with_vat/​sale/​sum_with_vat0** - сумма продаж по ставке НДС 0%
  
 +**sum_with_vat/​sale/​sum_with_vat10** - сумма продаж по ставке НДС 10%
  
 +**sum_with_vat/​sale/​sum_with_vat18** - сумма продаж по ставке НДС 18%
  
 +**sum_with_vat/​return** - данные о возвратах:​
  
 +**sum_with_vat/​return/​sum_with_vat_none** - сумма возвратов по ставке "​НДС не облагается"​
  
 +**sum_with_vat/​return/​sum_with_vat0** - сумма возвратов по ставке НДС 0%
  
 +**sum_with_vat/​return/​sum_with_vat10** - сумма возвратов по ставке НДС 10%
  
 +**sum_with_vat/​return/​sum_with_vat18** - сумма возвратов по ставке НДС 18%