Файл 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>
Структура отчета и формат имени файла могут незначительно отличаться (могут быть добавлены новые сущности, типы данных и др.) от описанных в этом разделе справки.