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

Матеріал з expertsolution
Перейти до навігації Перейти до пошуку
Немає опису редагування
Немає опису редагування
Рядок 356: Рядок 356:
|-
|-
|  
|  
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span>&nbsp; <span style="color:#9966CC">'''|'''</span> RoundDownSum
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> RoundDownSum
| Decimal
| Decimal
| Сума округлення в меншу сторону
| Сума округлення в меншу сторону
|-
|-
|  
|  
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span>&nbsp; <span style="color:#9966CC">'''|'''</span> RoundUpSum
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> RoundUpSum
| Decimal
| Decimal
| Сума округлення в більшу сторону
| Сума округлення в більшу сторону
Рядок 376: Рядок 376:
|-
|-
|  
|  
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span>&nbsp; <span style="color:#9966CC">'''|'''</span> Return
| <span style="color:#ff0000">Return</span>
| ZReportOperation
<span style="color:#ff0000">Return [  ] </span>
| Дані по поверненнях
| Дані по поверненнях
|-
|-
|  
|  
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span>&nbsp; <span style="color:#9966CC">'''|'''</span> ServiceInput
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> ServiceInput
| Decimal
| Decimal
| Службове внесення
| Службове внесення
|-
|-
|  
|  
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span>&nbsp; <span style="color:#9966CC">'''|'''</span> ServiceOutput
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> ServiceOutput
| Decimal
| Decimal
| Службова видача
| Службова видача
|-
|-
|  
|  
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span>&nbsp; <span style="color:#9966CC">'''|'''</span> ShiftCloseDate
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> ShiftCloseDate
| String / DateTime
| String / DateTime
| Дата та час закриття зміни
| Дата та час закриття зміни
|-
|-
|  
|  
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span>&nbsp; <span style="color:#9966CC">'''|'''</span> ShiftEnd
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> ShiftEnd
| String / DateTime
| String / DateTime
| Дата та час завершення зміни
| Дата та час завершення зміни
|-
|-
|  
|  
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span>&nbsp; <span style="color:#9966CC">'''|'''</span> ShiftLocalNum
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> ShiftLocalNum
| Int
| Int
| Локальний номер зміни
| Локальний номер зміни
|-
|-
|  
|  
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span>&nbsp; <span style="color:#9966CC">'''|'''</span> ShiftOpenDate
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> ShiftOpenDate
| String / DateTime
| String / DateTime
| Дата та час відкриття зміни
| Дата та час відкриття зміни
|-
|-
|  
|  
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span>&nbsp; <span style="color:#9966CC">'''|'''</span> ShiftOpened
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> ShiftOpened
| Bool
| Bool
| Ознака відкритої зміни
| Ознака відкритої зміни
|-
|-
|  
|  
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span>&nbsp; <span style="color:#9966CC">'''|'''</span> ShiftStart
| |&nbsp;&nbsp;&nbsp;&nbsp; <span style="color:#ff0000">'''|'''</span> ShiftStart
| String / DateTime
| String / DateTime
| Дата та час початку зміни
| Дата та час початку зміни
|-
|-
|
|

Версія за 11:16, 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 / Return 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 Дата та час початку зміни