Вебсайт ANDRIY.CO

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

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

Вверх
След.
Пред.