Различия

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

--- doc:dev:api:zreport [07.07.2017 12:30]
dchuprunov
+++ doc:dev:api:zreport [22.10.2025 12:13] (текущий)
rlysov
@@ Строка 9: / Строка 9: @@
 Пример запроса на получение данных о Z-отчетах:
- http://mycompany.virtpos.ru/api/zreport?apikey=MySecret&format=xml&warehouseid=1
+ https://[company].myvirtualpos.ru/api/zreport?apikey=MySecret&format=xml&warehouseid=1
 ==== Параметры запроса на получение данных ====
+Параметры, которые не отмечены как **get only**, могут быть переданы как get- или как post-параметры.
   * **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>
     <type>zreport</type>
-    <count>24</count>
+    <count>1</count>
     <zreports>
         <zreport>
@@ Строка 59: / Строка 59: @@
             <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>
             <close_datetime>2016-10-26 21:58:48</close_datetime>
@@ Строка 117: / Строка 119: @@
                         </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>
     </zreports>
@@ Строка 155: / Строка 172: @@
 **close_user_corp_code** - корпоративный код пользователя, закрывшего смену
+**open_user_fio** – ФИО пользователя, открывшего смену
+**close_user_fio** - ФИО пользователя, закрывшего смену
 **open_datetime** – дата и время открытия смены
@@ Строка 250: / Строка 271: @@
 **fp_reg_cash_total_sale_sum** - необнуляемая сумма на конец смены
+**discount_misc** - cумма продаж по купонам и сертификатам
@@ Строка 296: / Строка 317: @@
-== Данные по итоговым на смену суммам НДС ==
+=== Данные по итоговым на смену суммам НДС ===
 **vat/sale** - данные о продажах:
@@ Строка 313: / Строка 336: @@
+=== Данные по итоговым на смену суммам чеков, в разрезе различных ставок НДС и типов чеков ===
+**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%