Файл Z звіта (*.TCUREP)

Z-звіт містить підсумкові значення за всіма торговими точками, які обслуговує Shopdesk, і колекцію Z-звітів по кожній із точок (окремо по фіскальній і нефіскальній касі).

Файл Z-звіту має XML-структуру, описану нижче. Перед передаванням торговому серверу файл упаковується в архів. Архіву надається ім’я згідно з шаблоном Z_REPORT_D5_F16_P1_U1_2015-12-18_16-41-10.tcurep.zip. У ньому після короткого позначення ідентифікатора вказується його значення. Ім’я завершується датою і часом створення документа:

  • D5 - документ №5
  • F16 - франчайзі №16
  • P1 - звіт по касах торгової точки №1
  • U1 - звіт випустив користувач облікової системи (касир) №1
  • 2015-12-18_16-41-10 - дата і час створення чека у форматі YYYY-MM-DD_HH-MM-SS


Таблиця 1. Опис файлу формату XML *.TCUREP

Назва елемента Тип даних Опис
ReportNumber Long ID підсумкового Z-звіту
FranchiseeId Long ID франчайзі
ReportGuid GUID GUID звіту
DateOfStart Date Дата першого документа зміни (дата відкриття зміни)
DateOfReport Date Дата створення Z-звіту
CreatedByUser Long ID користувача, який створив Z-звіт
CreatedByUserName String Логін користувача, який створив Z-звіт
CreatedByUserFullName String Повне ім’я користувача, який створив Z-звіт
DateOfIssue Date Дата випуску Z-звіту
IssuedByUser Long ID користувача, який випустив Z-звіт
IssuedByUserName String Логін користувача, який випустив Z-звіт
IssuedByUserFullName String Повне ім’я користувача, який випустив Z-звіт
NumberOfReceiptsSales Long Підсумкова кількість чеків продажу по всіх точках
NumberOfReceiptsReturn Long Підсумкова кількість чеків повернення по всіх точках
NumberOfReceiptsServicePayIn Long Підсумкова кількість чеків службових внесень по всіх точках
NumberOfReceiptsServicePayOut Long Підсумкова кількість чеків службових винесень по всіх точках
AmountOfSalesCash Double Сума оплат готівкою
AmountOfSalesCard Double Сума оплат картками
AmountOfSalesBonusCash Double Сума оплат бонусами при оплаті готівкою
AmountOfSalesBonusCard Double Сума оплат бонусами при оплаті картками
AmountOfReturnsCash Double Сума повернень готівкою
AmountOfReturnsCard Double Сума повернень на картки
AmountOfReturnsBonusCash Double Сума повернень бонусів при поверненні готівкою
AmountOfReturnsBonusCard Double Сума повернень бонусів при поверненні на картки
AmountOfServicePayIn Double Сума службових внесень
AmountOfServicePayOut Double Сума службових винесень
ArrayOfDetails Array Колекція Z-звітів по кожній торговій точці (касі) – див. нижче


Таблиця 2. ArrayOfDetails - колекція Z-звітів по кожній торговій точці (касі)

Назва елемента Тип даних Опис
Id Long ID Z-звіту
DepartmentId Long ID торгової точки (каси)
IsFiscal Byte 0 – нефіскальна каса, 1 – фіскальна каса
FiscalRegisterId String ID фіскального реєстратора (серійний номер). Необов’язкове значення
NumberOfReceiptsSales Long Кількість чеків продажу
NumberOfReceiptsReturn Long Кількість чеків повернення
NumberOfReceiptsServicePayIn Long Кількість чеків службових внесень
NumberOfReceiptsServicePayOut Long Кількість чеків службових винесень
AmountOfSalesCash Double Сума оплат готівкою
AmountOfSalesCard Double Сума оплат картками
AmountOfSalesBonusCash Double Сума оплат бонусами при оплаті готівкою
AmountOfSalesBonusCard Double Сума оплат бонусами при оплаті картками
AmountOfReturnsCash Double Сума повернень готівкою
AmountOfReturnsCard Double Сума повернень на картки
AmountOfReturnsBonusCash Double Сума повернень бонусів при поверненні готівкою
AmountOfReturnsBonusCard Double Сума повернень бонусів при поверненні на картки
AmountOfServicePayIn Double Сума службових внесень
AmountOfServicePayOut Double Сума службових винесень


Зразок файлу Z-звіту

У звіті відображено один продаж на 128,40 грн, одне службове внесення 10,00 грн і одне службове винесення 138,40 грн

<?xml version="1.0" encoding="windows-1251"?>

<ArrayOfReports xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

                xmlns:xsd="http://www.w3.org/2001/XMLSchema" 

                software="ShopDesk 4.9.398 ©ANDRIY.CO"> 

  <Report>

    <ReportNumber>5</ReportNumber>

    <FranchiseeId>16</FranchiseeId>

    <ReportGuid>{7AD6D952-5DEF-4254-87AB-A2886E3CA367}</ReportGuid>

    <DateOfStart>2015-12-18 08:02:10</DateOfStart>

    <DateOfReport>2015-12-18 16:41:10</DateOfReport>

    <CreatedByUser>1</CreatedByUser>

    <CreatedByUserName>sheva</CreatedByUserName>

    <CreatedByUserFullName>Шевченко Андрій</CreatedByUserFullName>

    <DateOfIssue>2015-12-18 16:41:10</DateOfIssue>

    <IssuedByUser>1</IssuedByUser>

    <IssuedByUserName>sheva</IssuedByUserName>

    <IssuedByUserFullName>Шевченко Андрій</IssuedByUserFullName>

    <NumberOfReceiptsSales>1</NumberOfReceiptsSales>

    <NumberOfReceiptsReturn>0</NumberOfReceiptsReturn>

    <NumberOfReceiptsServicePayIn>1</NumberOfReceiptsServicePayIn>

    <NumberOfReceiptsServicePayOut>1</NumberOfReceiptsServicePayOut>

    <AmountOfSalesCash>128.4</AmountOfSalesCash>

    <AmountOfSalesCard>0</AmountOfSalesCard>

    <AmountOfSalesBonusCash>0</AmountOfSalesBonusCash>

    <AmountOfSalesBonusCard>0</AmountOfSalesBonusCard>

    <AmountOfReturnsCash>0</AmountOfReturnsCash>

    <AmountOfReturnsCard>0</AmountOfReturnsCard>

    <AmountOfReturnsBonusCash>0</AmountOfReturnsBonusCash>

    <AmountOfReturnsBonusCard>0</AmountOfReturnsBonusCard>

    <AmountOfServicePayIn>10</AmountOfServicePayIn>

    <AmountOfServicePayOut>138.4</AmountOfServicePayOut>

    <ArrayOfDetails>

      <Detail>

        <Id>9</Id>

        <DepartmentId>1</DepartmentId>

        <IsFiscal>1</IsFiscal>

        <FiscalRegisterId>1234567890</FiscalRegisterId>

        <NumberOfReceiptsSales>0</NumberOfReceiptsSales>

        <NumberOfReceiptsReturn>0</NumberOfReceiptsReturn>

        <NumberOfReceiptsServicePayIn>0</NumberOfReceiptsServicePayIn>

        <NumberOfReceiptsServicePayOut>0</NumberOfReceiptsServicePayOut>

        <AmountOfSalesCash>0</AmountOfSalesCash>

        <AmountOfSalesCard>0</AmountOfSalesCard>

        <AmountOfSalesBonusCash>0</AmountOfSalesBonusCash>

        <AmountOfSalesBonusCard>0</AmountOfSalesBonusCard>

        <AmountOfReturnsCash>0</AmountOfReturnsCash>

        <AmountOfReturnsCard>0</AmountOfReturnsCard>

        <AmountOfReturnsBonusCash>0</AmountOfReturnsBonusCash>

        <AmountOfReturnsBonusCard>0</AmountOfReturnsBonusCard>

        <AmountOfServicePayIn>0</AmountOfServicePayIn>

        <AmountOfServicePayOut>0</AmountOfServicePayOut>

      </Detail>

      <Detail>

        <Id>10</Id>

        <DepartmentId>1</DepartmentId>

        <IsFiscal>0</IsFiscal>

        <FiscalRegisterId></FiscalRegisterId>

        <NumberOfReceiptsSales>1</NumberOfReceiptsSales>

        <NumberOfReceiptsReturn>0</NumberOfReceiptsReturn>

        <NumberOfReceiptsServicePayIn>1</NumberOfReceiptsServicePayIn>

        <NumberOfReceiptsServicePayOut>1</NumberOfReceiptsServicePayOut>

        <AmountOfSalesCash>128.4</AmountOfSalesCash>

        <AmountOfSalesCard>0</AmountOfSalesCard>

        <AmountOfSalesBonusCash>0</AmountOfSalesBonusCash>

        <AmountOfSalesBonusCard>0</AmountOfSalesBonusCard>

        <AmountOfReturnsCash>0</AmountOfReturnsCash>

        <AmountOfReturnsCard>0</AmountOfReturnsCard>

        <AmountOfReturnsBonusCash>0</AmountOfReturnsBonusCash>

        <AmountOfReturnsBonusCard>0</AmountOfReturnsBonusCard>

        <AmountOfServicePayIn>10</AmountOfServicePayIn>

        <AmountOfServicePayOut>138.4</AmountOfServicePayOut>

      </Detail>

    </ArrayOfDetails>

  </Report>

</ArrayOfReports>

Структура звіту та формат імені файлу можуть незначно відрізнятися (можуть бути додані нові сутності, типи даних тощо) від описаних у цьому розділі довідки.

Останнє оновлення:

5/9/2026 8:23:01 PM

218