summarizeZReport. Z-отчёты

Метод возвращает электронные Z-отчёты — итоги закрытых смен фискальных регистраторов: суммы и количество чеков продаж, возвратов, покупок, внесений и выплат, налоги, данные о кассирах. Отчёты можно только читать.

Все параметры, кроме ключа apikey и формата format, принимаются и в адресной строке, и в теле POST.

GET https://[компания].myvirtualpos.ru/api/zreport?apikey=MySecret&warehouse_id=2&date=20260925

Условия объединяются по «и». Отчёты возвращаются по убыванию id: новые первыми. Даты передаются строго в формате ГГГГММДД, иначе метод вернёт ошибку Incorrect date format.

Пустые значения в JSON приходят как null, в XML — как пустой элемент.

Смена и касса

Итоги продаж

Регистры фискального регистратора. Названия полей построены по схеме fp_reg_<что>_<вид операции>_<…>: oper — количество операций, cash — денежные суммы; вид операции — sale (продажи), saleret (возвраты продаж), buy (покупки), buyret (возвраты покупок). Значения -1 означают, что регистратор не передаёт этот регистр.

Налоги

{
  "success": 1,
  "type": "zreport",
  "count": 1,
  "zreports": [
    {
      "zreport": {
        "id": 19046,
        "terminal_id": 36,
        "terminal_number": 1,
        "warehouse_external_id": "WH-2",
        "fiscal_number": "00106701382709",
        "guid": "CC2CDC05-B0DB-9BE5-6CDD-57AC2726E91E",
        "salesamount": "1429.00",
        "saleschecks": 2,
        "session": 1,
        "open_user_id": 6,
        "close_user_id": 6,
        "open_user_corp_code": "",
        "close_user_corp_code": "",
        "open_user_fio": "Иванов И. И.",
        "close_user_fio": "Иванов И. И.",
        "open_datetime": "2026-09-25 09:04:01",
        "close_datetime": "2026-09-25 20:11:37",
        "device_model_name": "",
        "device_model_version": "",
        "short_fiscal_serial_number": "138270",
        "fp_reg_oper_sale_counts": 2,
        "fp_reg_cash_sale_sum": "1429.00",
        "fp_reg_cash_sale_sum_cash": "1429.00",
        "fp_reg_cash_sale_sum_card": "0.00",
        "fp_reg_oper_saleret_counts": 0,
        "fp_reg_cash_saleret_sum": "0.00",
        "fp_reg_cash_allcash_sum": "1429.00",
        "vat": {
          "sale": { "vat10_sum": "0.00", "vat18_sum": "0.00", "vat20_sum": "0.00" },
          "return": { "vat10_sum": null, "vat18_sum": null, "vat20_sum": null }
        },
        "sum_with_vat": {
          "sale": { "sum_with_vat_none": "1080.00", "sum_with_vat0": null, "sum_with_vat10": null, "sum_with_vat18": null, "sum_with_vat20": null },
          "return": { "sum_with_vat_none": null, "sum_with_vat0": null, "sum_with_vat10": null, "sum_with_vat18": null, "sum_with_vat20": null }
        },
        "discount_misc": "0.00"
      }
    }
  ]
}

В примере для краткости опущены часть регистров фискального регистратора: покупки, возвраты покупок, внесения, выплаты, аннулирования. Структура и названия полей — как в таблице выше. Тот же ответ при format=xml (сокращённо):

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <success>1</success>
  <type>zreport</type>
  <count>1</count>
  <zreports>
    <zreport>
      <id>19046</id>
      <terminal_id>36</terminal_id>
      <session>1</session>
      <open_datetime>2026-09-25 09:04:01</open_datetime>
      <close_datetime>2026-09-25 20:11:37</close_datetime>
      <salesamount>1429.00</salesamount>
      <!-- остальные поля отчёта -->
      <vat>
        <sale><vat10_sum>0.00</vat10_sum><vat18_sum>0.00</vat18_sum><vat20_sum>0.00</vat20_sum></sale>
        <return><vat10_sum/><vat18_sum/><vat20_sum/></return>
      </vat>
    </zreport>
  </zreports>
</root>

Ошибка авторизации и общие ошибки описаны в статье Общие сведения.

Если по условиям ничего не найдено, метод возвращает успешный ответ с count равным 0 и пустым списком zreports.