Файл 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>

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

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

05.10.2025 15:26:00