GetZReportByDate: відмінності між версіями

Матеріал з expertsolution
Перейти до навігації Перейти до пошуку
 
(Не показано одну проміжну версію цього користувача)
Рядок 1: Рядок 1:
=='''Функція повертає дані Z-звіту по терміналу'''==
=='''Функція повертає дані Z-звіту по ПРРО'''==


  Розділ містить методи, необхідні для отримання даних Z-звіту по терміналу
  Розділ містить методи, необхідні для отримання даних Z-звіту по '''ПРРО'''
<br>
<br>


Рядок 66: Рядок 66:
|<span style="color:#ff0000"><center>*</center></span>
|<span style="color:#ff0000"><center>*</center></span>
| CashRegisterNumber
| CashRegisterNumber
| Bool
| Int64
| true - Лише рахунки доставки;<br> false - Лише рахунки НЕ доставки;<br> Null - Всі як зараз;<br>
| Фіскальний номер ПРРО<br>Якщо передано значення - повертаються Z-звіти тільки по вказаній ПРРО;<br>Null - повертаються Z-звіти по всіх ПРРО;<br>
|-
|-
!style="width:50%; background:#accae4;" scope="row" colspan="4"| * Позначення обов’язкового параметру
!style="width:50%; background:#accae4;" scope="row" colspan="4"| * Позначення обов’язкового параметру
Рядок 163: Рядок 163:


{| class="wikitable sortable mw-collapsible"
{| class="wikitable sortable mw-collapsible"
! style="width:90%; background:#accae4;" scope="row" colspan="4"| '''Типи даних Response'''
! style="width:90%; background:#accae4;" scope="row" colspan="4"| '''Типи даних Response'''
|-
|-
! scope="col" style="width:5px;"| *
! scope="col"; class="wikitable"; style="width:5px; | *
! scope="col"| Параметр
! scope="col"| Параметр
! scope="col"| Тип
! scope="col"| Тип
Рядок 172: Рядок 172:
|
|
| Error
| Error
| String []
| Опис помилки, що виникла
|-
|  <!-- <center style="color:#ff0000">*</center>  -->                                    <!-- ЗАКОМЕНТОВАНИЙ ПРИЗНАК ОБОВЯЗКОВОГО ПОЛЯ -->
| Success
| Bool
| Успіх виконання запиту
|-
|
| ClientTime
| String / DateTime
| Дата та час виконання запиту на стороні клієнта
|-
|
| <span style="color:#ff0000">ZReports</span>
|  <span style="color:#ff0000">ZReport[  ] </span>
| Список Z-звітів:
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> CashDeskNum
| Int
| Номер каси
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> CashRegisterNum
| Int
| Фіскальний номер ПРРО
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> Cashier
| String
| Ім’я касира
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> DocClass
| Int
| Клас документа
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> Ipn
| String
| ІПН організації
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> Mac
| String
| MAC / ідентифікатор пристрою або каси
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> OrderDate
| String / DateTime
| Дата та час формування документа
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> OrderNum
| Int
| Номер документа
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> OrgName
| String
| Назва організації
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> PointAddr
| String
| ID  Адреса торгової точки
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> PointName
| String
| Назва торгової точки
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> PrevDocHash
| String / Null
| Хеш попереднього документа
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> PrintSettings
| Object / Null
| Налаштування друку
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> PrinterSettings
| Object / Null
| Налаштування принтера
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> Tin
| String
| Податковий номер організації
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> Uid
| String / GUID
| Унікальний ідентифікатор документа
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> XML
| String / Null
| XML-представлення документа
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> CloseBalance
| Decimal
| Баланс на момент закриття зміни
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> FooterText
| String / Null
| Текст футера документа
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> LastCheckOrderTaxNum
| String
| Фіскальний номер останнього чека
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> Offline
| Bool
| Ознака офлайн-режиму
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> OpenBalance
| Decimal
| Баланс на момент відкриття зміни
|-
|
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> OrderTaxNum
| String
| String
 
| Фіскальний номер Z-звіту
| Опис помилки, що виникла                                                                                                                            |                                     |
|-
| ---------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
|  
|                                                                                                                                                      |                                      |
| <span style="color:#ff0000">Realiz</span>
| Success                                                                                                                                              |                                      |
|  <span style="color:#ff0000">ZReportOperation[  ] </span>
| Bool                                                                                                                                                |                                      |
| Дані по реалізації:
| Успіх виконання запиту                                                                                                                              |                                      |
|-
| -                                                                                                                                                   |                                      |
|
|                                                                                                                                                      |                                      |
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> OrdersCount
| ClientTime                                                                                                                                          |                                     |
| Int
| DateTime                                                                                                                                            |                                      |
| Кількість чеків / операцій
| Дата та час виконання запиту                                                                                                                        |                                      |
|-
| -                                                                                                                                                   |                                      |
|
|                                                                                                                                                      |                                      |
| <span style="color:#ff0000">Pays</span>
| ErrorCode                                                                                                                                            |                                     |
|  <span style="color:#ff0000">Pay [  ] </span>
| Int                                                                                                                                                  |                                      |
| Список оплат:
| Код помилки                                                                                                                                          |                                      |
|-
| -                                                                                                                                                    |                                      |
|
|                                                                                                                                                      |                                      |
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span>&nbsp; <span style="color:#9966CC">'''|'''</span> PayFormCode
| <span style="color:#ff0000">ZReports</span>                                                                                                         |                                     |
| Int
| <span style="color:#ff0000">ZReport [ ]</span>                                                                                                       |                                      |
| Код форми оплати
| Список Z-звітів. Елементи масиву з наступними полями:                                                                                                |                                      |
|-
| -                                                                                                                                                    |                                      |
|
|                                                                                                                                                      |                                      |
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span>&nbsp; <span style="color:#9966CC">'''|'''</span> PayFormName
|     <span style="color:#ff0000">'''|'''</span> CashDeskNum                                                                                          |                                      |
| String
| Int64                                                                                                                                                |                                      |
| Назва форми оплати
| Номер каси                                                                                                                                          |                                      |
|-
| -                                                                                                                                                    |                                      |
|  
|                                                                                                                                                     |                                     |
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span>&nbsp; <span style="color:#9966CC">'''|'''</span> PaymentSystem
|     <span style="color:#ff0000">'''|'''</span> CashRegisterNum                                                                                      |                                      |
| String / Null
| Int64                                                                                                                                                |                                      |
| Назва платіжної системи
| Фіскальний номер каси / ПРРО                                                                                                                        |                                     |
|-
| -                                                                                                                                                   |                                      |
|  
|                                                                                                                                                     |                                     |
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span>&nbsp; <span style="color:#9966CC">'''|'''</span> Provided
|     <span style="color:#ff0000">'''|'''</span> Cashier                                                                                              |                                      |
| Decimal
| String                                                                                                                                              |                                      |
| Сума, надана клієнтом
| Ім’я касира                                                                                                                                          |                                      |
|-
| -                                                                                                                                                   |                                      |
|  
|                                                                                                                                                     |                                     |
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span>&nbsp; <span style="color:#9966CC">'''|'''</span> RRN
|     <span style="color:#ff0000">'''|'''</span> DocClass                                                                                              |                                      |
| String / Null
| Int                                                                                                                                                  |                                      |
| RRN банківської операції
| Клас документа                                                                                                                                      |                                      |
|-
| -                                                                                                                                                   |                                      |
|  
|                                                                                                                                                      |                                      |
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span>&nbsp; <span style="color:#9966CC">'''|'''</span> Remains
|     <span style="color:#ff0000">'''|'''</span> Ipn                                                                                                  |                                      |
| Decimal
| String                                                                                                                                              |                                      |
| Решта
| ІПН організації                                                                                                                                      |                                      |
|-
| -                                                                                                                                                   |                                      |
|  
|                                                                                                                                                     |                                     |
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span>&nbsp; <span style="color:#9966CC">'''|'''</span> Sum
|     <span style="color:#ff0000">'''|'''</span> Mac                                                                                                  |                                     |
| Decimal
| String                                                                                                                                              |                                      |
| Сума оплати
| MAC / ідентифікатор каси або пристрою                                                                                                                |                                      |
|-
| -                                                                                                                                                   |                                      |
|  
|                                                                                                                                                      |                                      |
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> RoundDownSum
|     <span style="color:#ff0000">'''|'''</span> OrderDate                                                                                            |                                      |
| Decimal
| DateTime                                                                                                                                            |                                      |
| Сума округлення в меншу сторону
| Дата та час формування документа                                                                                                                    |                                      |
|-
| -                                                                                                                                                   |                                      |
|  
|                                                                                                                                                     |                                     |
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> RoundUpSum
|     <span style="color:#ff0000">'''|'''</span> OrderNum                                                                                              |                                      |
| Decimal
| Int                                                                                                                                                  |                                      |
| Сума округлення в більшу сторону
| Номер документа                                                                                                                                      |                                      |
|-
| -                                                                                                                                                   |                                      |
|  
|                                                                                                                                                     |                                     |
| <span style="color:#ff0000">Taxes</span>
|     <span style="color:#ff0000">'''|'''</span> OrgName                                                                                              |                                     |
| <span style="color:#ff0000">Tax [  ] </span>
| String                                                                                                                                              |                                      |
| Список податків. Якщо податки відсутні, повертається порожній масив
| Назва організації                                                                                                                                    |                                     |
|-
| -                                                                                                                                                    |                                      |
|  
|                                                                                                                                                      |                                      |
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> Total 
|     <span style="color:#ff0000">'''|'''</span> PointAddr                                                                                            |                                      |
| Decimal
| String                                                                                                                                               |                                      |
| Загальна сума
| Адреса торгової точки                                                                                                                                |                                      |
|-
| -                                                                                                                                                   |                                      |
|  
|                                                                                                                                                     |                                     |
| <span style="color:#ff0000">Return</span>
|     <span style="color:#ff0000">'''|'''</span> PointName                                                                                            |                                      |
| <span style="color:#ff0000">Return [  ] </span>
| String                                                                                                                                               |                                      |
| Дані по поверненнях
| Назва торгової точки                                                                                                                                |                                      |
|-
| -                                                                                                                                                   |                                      |
|  
|                                                                                                                                                     |                                     |
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> ServiceInput
|     <span style="color:#ff0000">'''|'''</span> PrevDocHash                                                                                          |                                      |
| Decimal
| String                                                                                                                                              |                                      |
| Службове внесення
| Хеш попереднього документа                                                                                                                          |                                      |
|-
| -                                                                                                                                                    |                                      |
|  
|                                                                                                                                                     |                                     |
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> ServiceOutput
|     <span style="color:#ff0000">'''|'''</span> PrintSettings                                                                                        |                                      |
| Decimal
| Object                                                                                                                                              |                                      |
| Службова видача
| Налаштування друку                                                                                                                                  |                                      |
|-
| -                                                                                                                                                   |                                      |
|  
|                                                                                                                                                     |                                     |
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> ShiftCloseDate
|     <span style="color:#ff0000">'''|'''</span> PrinterSettings                                                                                      |                                      |
| String / DateTime
| Object                                                                                                                                              |                                      |
| Дата та час закриття зміни
| Налаштування принтера                                                                                                                                |                                      |
|-
| -                                                                                                                                                   |                                      |
|  
|                                                                                                                                                     |                                     |
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> ShiftEnd
|     <span style="color:#ff0000">'''|'''</span> Tin                                                                                                  |                                      |
| String / DateTime
| String                                                                                                                                               |                                      |
| Дата та час завершення зміни
| Податковий номер організації                                                                                                                        |                                      |
|-
| -                                                                                                                                                    |                                      |
|  
|                                                                                                                                                      |                                      |
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> ShiftLocalNum
|     <span style="color:#ff0000">'''|'''</span> Uid                                                                                                  |                                      |
| Int
| Guid                                                                                                                                                |                                      |
| Локальний номер зміни
| Унікальний ідентифікатор документа                                                                                                                  |                                      |
|-
| -                                                                                                                                                    |                                      |
|  
|                                                                                                                                                      |                                      |
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> ShiftOpenDate
|     <span style="color:#ff0000">'''|'''</span> XML                                                                                                  |                                      |
| String / DateTime
| String                                                                                                                                              |                                      |
| Дата та час відкриття зміни
| XML-представлення документа                                                                                                                          |                                      |
|-
| -                                                                                                                                                    |                                      |
|  
|                                                                                                                                                      |                                      |
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> ShiftOpened
|     <span style="color:#ff0000">'''|'''</span> CloseBalance                                                                                          |                                      |
| Bool
| Decimal                                                                                                                                              |                                      |
| Ознака відкритої зміни
| Баланс на момент закриття зміни                                                                                                                      |                                      |
|-
| -                                                                                                                                                    |                                      |
|  
|                                                                                                                                                      |                                      |
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> ShiftStart
|     <span style="color:#ff0000">'''|'''</span> FooterText                                                                                            |                                      |
| String / DateTime
| String                                                                                                                                              |                                      |
| Дата та час початку зміни
| Текст футера документа                                                                                                                              |                                      |
|-
| -                                                                                                                                                    |                                      |
|
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span> LastCheckOrderTaxNum                                                                                  |                                      |
| String                                                                                                                                              |                                      |
| Фіскальний номер останнього чека                                                                                                                    |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span> Offline                                                                                              |                                      |
| Bool                                                                                                                                                |                                      |
| Ознака офлайн-режиму                                                                                                                                |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span> OpenBalance                                                                                          |                                      |
| Decimal                                                                                                                                              |                                      |
| Баланс на момент відкриття зміни                                                                                                                    |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span> OrderTaxNum                                                                                          |                                      |
| String                                                                                                                                              |                                      |
| Фіскальний номер Z-звіту                                                                                                                            |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span> <span style="color:#008000">Realiz</span>                                                            |                                      |
| <span style="color:#008000">ZReportOperation</span>                                                                                                  |                                      |
| Дані по реалізації                                                                                                                                  |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span>  <span style="color:#008000">'''|'''</span> OrdersCount                                              |                                      |
| Int                                                                                                                                                  |                                      |
| Кількість чеків / операцій реалізації                                                                                                                |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span>  <span style="color:#008000">'''|'''</span> <span style="color:#9966CC">Pays</span>                  |                                      |
| <span style="color:#9966CC">Pay [ ]</span>                                                                                                          |                                      |
| Список оплат по реалізації                                                                                                                          |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span>  <span style="color:#008000">'''|'''</span>  <span style="color:#9966CC">'''|'''</span> PayFormCode  |                                      |
| Int                                                                                                                                                  |                                      |
| Код форми оплати                                                                                                                                    |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span>  <span style="color:#008000">'''|'''</span>  <span style="color:#9966CC">'''|'''</span> PayFormName  |                                      |
| String                                                                                                                                              |                                      |
| Назва форми оплати                                                                                                                                  |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span>  <span style="color:#008000">'''|'''</span>  <span style="color:#9966CC">'''|'''</span> PaymentSystem |                                      |
| String                                                                                                                                              |                                      |
| Назва платіжної системи                                                                                                                              |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span>  <span style="color:#008000">'''|'''</span>  <span style="color:#9966CC">'''|'''</span> Provided      |                                      |
| Decimal                                                                                                                                              |                                      |
| Сума, надана клієнтом                                                                                                                                |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span>  <span style="color:#008000">'''|'''</span>  <span style="color:#9966CC">'''|'''</span> RRN          |                                      |
| String                                                                                                                                              |                                      |
| RRN банківської операції                                                                                                                            |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span>  <span style="color:#008000">'''|'''</span>  <span style="color:#9966CC">'''|'''</span> Remains      |                                      |
| Decimal                                                                                                                                              |                                      |
| Решта                                                                                                                                                |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span>  <span style="color:#008000">'''|'''</span>  <span style="color:#9966CC">'''|'''</span> Sum          |                                      |
| Decimal                                                                                                                                              |                                      |
| Сума оплати                                                                                                                                          |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span>  <span style="color:#008000">'''|'''</span> RoundDownSum                                              |                                      |
| Decimal                                                                                                                                              |                                      |
| Сума округлення в меншу сторону                                                                                                                      |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span>  <span style="color:#008000">'''|'''</span> RoundUpSum                                                |                                      |
| Decimal                                                                                                                                              |                                      |
| Сума округлення в більшу сторону                                                                                                                    |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span>  <span style="color:#008000">'''|'''</span> Taxes                                                    |                                      |
| Tax [ ]                                                                                                                                              |                                      |
| Список податків по реалізації                                                                                                                        |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span>  <span style="color:#008000">'''|'''</span> Total                                                    |                                      |
| Decimal                                                                                                                                              |                                      |
| Загальна сума реалізації                                                                                                                            |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span> <span style="color:#FFBF00">Return</span>                                                            |                                      |
| <span style="color:#FFBF00">ZReportOperation</span>                                                                                                  |                                      |
| Дані по поверненнях                                                                                                                                  |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span>  <span style="color:#FFBF00">'''|'''</span> OrdersCount                                              |                                      |
| Int                                                                                                                                                  |                                      |
| Кількість чеків / операцій повернення                                                                                                                |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span>  <span style="color:#FFBF00">'''|'''</span> Pays                                                      |                                      |
| Pay [ ]                                                                                                                                              |                                      |
| Список оплат по поверненнях                                                                                                                          |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span>  <span style="color:#FFBF00">'''|'''</span> RoundDownSum                                              |                                      |
| Decimal                                                                                                                                              |                                      |
| Сума округлення в меншу сторону                                                                                                                      |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span>  <span style="color:#FFBF00">'''|'''</span> RoundUpSum                                                |                                      |
| Decimal                                                                                                                                              |                                      |
| Сума округлення в більшу сторону                                                                                                                    |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span>  <span style="color:#FFBF00">'''|'''</span> Taxes                                                    |                                      |
| Tax [ ]                                                                                                                                              |                                      |
| Список податків по поверненнях                                                                                                                      |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span>  <span style="color:#FFBF00">'''|'''</span> Total                                                    |                                      |
| Decimal                                                                                                                                              |                                      |
| Загальна сума повернень                                                                                                                              |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span> ServiceInput                                                                                          |                                      |
| Decimal                                                                                                                                              |                                      |
| Службове внесення                                                                                                                                    |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span> ServiceOutput                                                                                        |                                      |
| Decimal                                                                                                                                              |                                      |
| Службова видача                                                                                                                                      |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span> ShiftCloseDate                                                                                        |                                      |
| DateTime                                                                                                                                            |                                      |
| Дата та час закриття зміни                                                                                                                          |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span> ShiftEnd                                                                                              |                                      |
| DateTime                                                                                                                                            |                                      |
| Дата та час завершення зміни                                                                                                                        |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span> ShiftLocalNum                                                                                        |                                      |
| Int                                                                                                                                                  |                                      |
| Локальний номер зміни                                                                                                                                |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span> ShiftOpenDate                                                                                        |                                      |
| DateTime                                                                                                                                            |                                      |
| Дата та час відкриття зміни                                                                                                                          |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span> ShiftOpened                                                                                          |                                      |
| Bool                                                                                                                                                |                                      |
| Ознака відкритої зміни                                                                                                                              |                                      |
| -                                                                                                                                                    |                                      |
|                                                                                                                                                      |                                      |
|     <span style="color:#ff0000">'''|'''</span> ShiftStart                                                                                            |                                      |
| DateTime                                                                                                                                             |                                      |
| Дата та час початку зміни                                                                                                                           |                                      |
| -                                                                                                                                                    |                                      |
| ! style="width:50%; background:#accae4;" scope="row" colspan="4"                                                                                    | * Позначення обов’язкового параметру |
| -                                                                                                                                                   |                                      |
| }                                                                                                                                                    |                                      |

Поточна версія на 11:20, 3 липня 2026

Функція повертає дані Z-звіту по ПРРО

Розділ містить методи, необхідні для отримання даних Z-звіту по ПРРО


Опис Отримання даних Z-звіту.
Метод POST
URL /POSExternal/GetZReportByDate



Request Headers
KEY VALUE
Content-Type application/json
AccessToken



Body raw (json)
{
  "StartDate": "2024-08-01 08:00:00",
  "EndDate": "2024-08-01 23:00:00",
  "CashRegisterNumber": null
 }



Типи даних Body
* Параметр Тип Опис
*
BeginDate DateTime Початкова дата та час
*
EndDate DateTime Дата та час закінчення
*
CashRegisterNumber Int64 Фіскальний номер ПРРО
Якщо передано значення - повертаються Z-звіти тільки по вказаній ПРРО;
Null - повертаються Z-звіти по всіх ПРРО;
* Позначення обов’язкового параметру



Response (json)
{
    "Error": "",
    "Success": true,
    "ClientTime": "2026-07-03 11:24:41",
    "ErrorCode": 0,
    "ZReports": [
        {
            "CashDeskNum": 7770000000,
            "CashRegisterNum": 7770000000,
            "Cashier": "Тестовий касир",
            "DocClass": 1,
            "Ipn": "12345678",
            "Mac": "ac6bd5b030c84ca22c6a01b287b36517",
            "OrderDate": "03.07.2026 11:24:17",
            "OrderNum": 1785,
            "OrgName": "Тестова організація",
            "PointAddr": "м.Київ, Подільський район,  Тестова, 39г",
            "PointName": "Тестова",
            "PrevDocHash": null,
            "PrintSettings": null,
            "PrinterSettings": null,
            "Tin": "12345678",
            "Uid": "d7d8892a-8d5f-4cc2-b069-563b34954053",
            "XML": null,
            "CloseBalance": 15743027.99,
            "FooterText": null,
            "LastCheckOrderTaxNum": "eb4a47c0",
            "Offline": false,
            "OpenBalance": 15742327.99,
            "OrderTaxNum": "7ce6dbc3",
            "Realiz": {
                "OrdersCount": 11,
                "Pays": [
                    {
                        "PayFormCode": 0,
                        "PayFormName": "ГОТІВКА_3",
                        "PaymentSystem": null,
                        "Provided": 0.0,
                        "RRN": null,
                        "Remains": 0.0,
                        "Sum": 700.00
                    },
                    {
                        "PayFormCode": 1,
                        "PayFormName": "ПЛАТІЖНА КАРТКА",
                        "PaymentSystem": null,
                        "Provided": 0.0,
                        "RRN": null,
                        "Remains": 0.0,
                        "Sum": 290.00
                    }
                ],
                "RoundDownSum": 0.00,
                "RoundUpSum": 0.00,
                "Taxes": [],
                "Total": 990.00
            },
            "Return": {
                "OrdersCount": 0,
                "Pays": [],
                "RoundDownSum": 0.00,
                "RoundUpSum": 0.00,
                "Taxes": [],
                "Total": 0.0
            },
            "ServiceInput": 0.00,
            "ServiceOutput": 0.00,
            "ShiftCloseDate": "03.07.2026 11:24:17",
            "ShiftEnd": "03.07.2026 11:24:17",
            "ShiftLocalNum": 0,
            "ShiftOpenDate": "01.07.2026 14:10:36",
            "ShiftOpened": false,
            "ShiftStart": "01.07.2026 14:10:36"
        }
    ]
}



Типи даних Response
* Параметр Тип Опис
Error String [] Опис помилки, що виникла
Success Bool Успіх виконання запиту
ClientTime String / DateTime Дата та час виконання запиту на стороні клієнта
ZReports ZReport[ ] Список Z-звітів:
     | CashDeskNum Int Номер каси
     | CashRegisterNum Int Фіскальний номер ПРРО
     | Cashier String Ім’я касира
     | DocClass Int Клас документа
     | Ipn String ІПН організації
     | Mac String MAC / ідентифікатор пристрою або каси
     | OrderDate String / DateTime Дата та час формування документа
     | OrderNum Int Номер документа
     | OrgName String Назва організації
     | PointAddr String ID Адреса торгової точки
     | PointName String Назва торгової точки
     | PrevDocHash String / Null Хеш попереднього документа
     | PrintSettings Object / Null Налаштування друку
     | PrinterSettings Object / Null Налаштування принтера
     | Tin String Податковий номер організації
     | Uid String / GUID Унікальний ідентифікатор документа
     | XML String / Null XML-представлення документа
     | CloseBalance Decimal Баланс на момент закриття зміни
     | FooterText String / Null Текст футера документа
     | LastCheckOrderTaxNum String Фіскальний номер останнього чека
     | Offline Bool Ознака офлайн-режиму
     | OpenBalance Decimal Баланс на момент відкриття зміни
     | OrderTaxNum String Фіскальний номер Z-звіту
Realiz ZReportOperation[ ] Дані по реалізації:
     | OrdersCount Int Кількість чеків / операцій
Pays Pay [ ] Список оплат:
     |  | PayFormCode Int Код форми оплати
     |  | PayFormName String Назва форми оплати
     |  | PaymentSystem String / Null Назва платіжної системи
     |  | Provided Decimal Сума, надана клієнтом
     |  | RRN String / Null RRN банківської операції
     |  | Remains Decimal Решта
     |  | Sum Decimal Сума оплати
     | RoundDownSum Decimal Сума округлення в меншу сторону
     | RoundUpSum Decimal Сума округлення в більшу сторону
Taxes Tax [ ] Список податків. Якщо податки відсутні, повертається порожній масив
     | Total Decimal Загальна сума
Return Return [ ] Дані по поверненнях
     | ServiceInput Decimal Службове внесення
     | ServiceOutput Decimal Службова видача
     | ShiftCloseDate String / DateTime Дата та час закриття зміни
     | ShiftEnd String / DateTime Дата та час завершення зміни
     | ShiftLocalNum Int Локальний номер зміни
     | ShiftOpenDate String / DateTime Дата та час відкриття зміни
     | ShiftOpened Bool Ознака відкритої зміни
     | ShiftStart String / DateTime Дата та час початку зміни