Публичный ресурс

Экспорт Z-отчетов из SetRetail10 в ERP (веб-сервис на стороне ERP)

ВЕРСИЯ WEB-СЕРВИСА 1.8

Методы веб-сервиса для экспорта Z-отчетов

Метод

processZReports - без обратной связи

processZReportsWithTI - с обратной связью

URLhttp://Любой_IP-адрес_на стороне_ERP_сервера/Set10ZReportsService
WSDLhttp://Любой_IP-адрес_на стороне_ERP_сервера/Set10ZReportsService.wsdl

Поле

Тип данных

Описание

Обязательное

Принимаемые параметры

zreports

base64Binary

Список Z-отчетов в формате XML, закодированный в base64

Да

version

string

Версия xsd схемы выдаваемых данных

Нет

Возвращаемые параметры

return

boolean

True в случае успешной обработки пакета

Да

Описание формата выгружаемых Z-отчётов

Z-отчёты <reports>

reports

Наименование атрибута

Тип данных

Описание

Обязательное

count

Long

Количество Z-отчётов

Да

Наименование элемента

Тип данных

Описание

Обязательное

zreport

Комплексный

Данные Z-отчётов

Да

Состав Z-отчёта <zreport>

reports/zreport

Наименование элемента

Тип данных

Описание

Обязательное

reportType

String

Тип отчёта (Zreport, Xreport)

Да

shiftNumber

Long

Номер смены

Да

shopNumber

Long

Номер магазина

Да

docNumber

Long

Номер документа

Да

cashNumber

Long

Номер кассы

Да

serialCashNumber

String

Серийный номер ФР

Да

userTabNumber

Long

Табельный номер кассира

Да

userName

String

ФИО кассира

Да

dateOperDay

dateTime

Дата и время операционного дня

Да

dateShiftClose

dateTime

Дата и время закрытия смены

Да

dateShiftOpen

dateTime

Дата и время открытия смены

Да

countCashPurchase

Long

Количество чеков продаж за наличные

Да

countCashlessPurchase

Long

Количество чеков продаж за б/наличные

Да

countPurchase

Long

Количество чеков продаж

Да

countCashReturn

Long

Количество чеков возврата за наличные

Да

countCashlessReturn

Long

Количество чеков возврата за б/наличные

Да

countReturn

Long

Количество чеков возврата

Да

counterIncoming

Long

Количество внесений в кассу

Да

counterWithdrawal

Long

Количество изъятий из кассы

Да

amountByCashPurchase

Decimal

Сумма продаж за наличные

Да

amountByCashlessPurchase

Decimal

Сумма продаж за б/наличные

Да

amountByPurchaseFiscal

Decimal

Сумма продаж из ФП

Да

amountByCashReturn

Decimal

Сумма возвратов наличных

Да

amountByCashlessReturn

Decimal

Сумма возвратов б/наличных

Да

amountByReturnFiscal

Decimal

Сумма возвратов из ФП

Да

amountCashIn

Decimal

Сумма внесений

Да

amountCashOut

Decimal

Сумма изъятий

Да

amountCashDiscount

Decimal

Сумма скидок

Да

returnDiscountCashPay

Decimal

Сумма скидок по возвратам

Да

incresentTotalStart

Long

Накопительный счётчик продаж на начало смены (в копейках)

Да

incresentTotalFinish

Long

Накопительный счётчик продаж на конец смены (в копейках)

Да

incresentTotalReturnStart

Long

Накопительный счётчик возвратов на начало смены (в копейках)

Да

incresentTotalReturnFinish

Long

Накопительный счётчик возвратов на начало смены (в копейках)

Да

products

Комплексный

Информация по количеству чеков и продажам разных типов товаров

Нет

factoryCashNumber

String

Заводской номер ФР

Да

cashName

String

Наименование модели ФР

Да
innStringИНН юридического лицаНет
paymentsКомплексныйИнформация по количеству типов оплат на каждый чекНет
taxesКомплексный

Сумма налогов за смену

ESB-27 - Получение подробных данных проблемы… СТАТУС

10.2.59.0

Версия веб-сервиса 1.3

Нет
reversalsКомплексный

Список операций по чеку расхода.

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Описание работы расходных операций в непубличной статье.

Нет
countExpenseReceiptLong

Количество чеков расхода

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Да
countCashExpenseReceiptLong

Количество наличных чеков расхода

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Да
countCashlessExpenseReceiptLong

Количество безналичных чеков расхода

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Да
amountByExpenseReceiptDecimal

Сумма чеков расхода

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Да
amountByExpenseReceiptFiscalDecimal

Сумма чеков расхода в ФР

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Да
amountByCashExpenseReceiptDecimal

Сумма наличных чеков расхода

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Да
amountByCashlessExpenseReceiptDecimal

Сумма безналичных чеков расхода

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Да
incresentTotalExpenseStartLong

Нарастающий итог расхода на начало смены

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Да
incresentTotalExpenseFinishLong

Нарастающий итог расхода на конец смены

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Да
countReturnExpenseReceiptLong

Количество чеков возврата расхода

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Да
countCashReturnExpenseReceiptLong

Количество наличных чеков возврата расхода

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Да
countCashlessReturnExpenseReceiptLong

Количество безналичных чеков возврата расхода

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Да
amountByReturnExpenseReceiptDecimal

Сумма чеков возврата расхода

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Да
amountByReturnExpenseReceiptFiscalLong

Сумма чеков возврата расхода в ФР

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Да
amountByCashReturnExpenseReceiptDecimal

Сумма наличных чеков возврата расхода

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Да
amountByCashlessReturnExpenseReceiptDecimal

Сумма безналичных чеков возврата расхода

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Да
incresentTotalReturnExpenseStartLong

Нарастающий итог возврата расхода на начало смены

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Да
incresentTotalReturnExpenseFinishLong

Нарастающий итог возврата расхода на конец смены

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Да
sumCashBeginDecimal

Сумма в денежном ящике на начало смены

SRTS-1776 - Получение подробных данных проблемы… СТАТУС

CR-8824 - Получение подробных данных проблемы… СТАТУС

10.3.28.0

Версия веб-сервиса 1.8

Да
sumCashEndDecimal

Сумма в денежном ящике на конец смены

SRTS-1776 - Получение подробных данных проблемы… СТАТУС

CR-8824 - Получение подробных данных проблемы… СТАТУС

10.3.28.0

Версия веб-сервиса 1.8

Да
plugin-propertyКомплексный

Список "плагинных" (расширенных, не базовых) свойств этого отчета.
Может отсутствовать.

SRTS-1138 - Получение подробных данных проблемы… СТАТУС

CR-7962 - Получение подробных данных проблемы… СТАТУС

10.3.18.0

Версия веб-сервиса 1.7

Нет

Группировка по типам товаров <product>

Для включения экспорта группировки по типам товаров выполните скрипт в базе данных set  

UPDATE public.sales_management_properties
   SET property_value='true'
 WHERE property_key='export.set10wsclient.zreports.include.products';

reports/zreport/products/product

Наименование атрибута

Тип данных

Описание

Обязательное

typeClass

String

Тип товара

Нет

amountPurchase

Decimal

Сумма продажи

Нет

amountReturn

Decimal

Сумма возвратов

Нет


Группировка по типам оплат <payments>

SRTE-1182 - Получение подробных данных проблемы… СТАТУС

10.2.36.0

reports/zreport/payments

Наименование атрибута

Тип данных

Описание

Обязательное

typeClass

String

Тип оплаты

Нет
amountPurchaseDecimalСумма продажНет
amountReturnDecimal

Сумма возвратов

Нет
amountExpenseDecimalСумма чека расходаНет
amountReturnExpenseDecimalСумма чека расхода по возвратуНет


Пример XML:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<reports count="1">
    <zreport>
        <reportType>ZReport</reportType>
        <shiftNumber>9</shiftNumber>
        <shopNumber>6417</shopNumber>
        <docNumber>6</docNumber>
        <cashNumber>10</cashNumber>
        <serialCashNumber>NFM.6417.10.0.1505978075854</serialCashNumber>
        <userTabNumber>1</userTabNumber>
        <userName>CASHIE USER TEST</userName>
        <dateOperDay>2017-09-28T00:00:00.000+03:00</dateOperDay>
        <dateShiftClose>2017-09-28T12:15:36.608</dateShiftClose>
        <dateShiftOpen>2017-09-28T12:14:27.908</dateShiftOpen>
        <countCashPurchase>1</countCashPurchase>
        <countCashlessPurchase>1</countCashlessPurchase>
        <countPurchase>1</countPurchase>
        <countCashReturn>1</countCashReturn>
        <countCashlessReturn>1</countCashlessReturn>
        <countReturn>2</countReturn>
        <counterIncoming>1</counterIncoming>
        <counterWithdrawal>1</counterWithdrawal>
        <amountByCashPurchase>300.46</amountByCashPurchase>
        <amountByCashlessPurchase>1914.46</amountByCashlessPurchase>
        <amountByPurchaseFiscal>2214.92</amountByPurchaseFiscal>
        <amountByCashReturn>157.23</amountByCashReturn>
        <amountByCashlessReturn>300.23</amountByCashlessReturn>
        <amountByReturnFiscal>457.46</amountByReturnFiscal>
        <amountCashIn>100.0</amountCashIn>
        <amountCashOut>100.0</amountCashOut>
        <amountCashDiscount>0.0</amountCashDiscount>
        <returnDiscountCashPay>0.0</returnDiscountCashPay>
        <incresentTotalStart>837991</incresentTotalStart>
        <incresentTotalFinish>1059483</incresentTotalFinish>
        <incresentTotalReturnStart>30023</incresentTotalReturnStart>
        <incresentTotalReturnFinish>75769</incresentTotalReturnFinish>
        <factoryCashNumber>00000641710</factoryCashNumber>
        <cashName>Fiscal printer emulator 0</cashName>
        <inn>7802781104</inn>
        <payments>
            <payment typeClass="CashPaymentEntity" amountPurchase="300.46" amountReturn="157.23"/>
            <payment typeClass="ExternalBankTerminalPaymentEntity" amountPurchase="300.00"/>
            <payment typeClass="BankCardPaymentEntity" amountPurchase="314.46" amountReturn="300.23"/>
            <payment typeClass="ChildrenCardPaymentEntity" amountPurchase="1300.00"/>
        </payments>
    </zreport>
</reports>

Группировка по типам оплат <subPayment>

SRTS-1776 - Получение подробных данных проблемы… СТАТУС

CR-8824 - Получение подробных данных проблемы… СТАТУС

10.3.28.0

reports/zreport/payments/subPayment

Наименование атрибута

Тип данных

Описание

Обязательное

typeSubClass

String

Тип подтипа оплаты

Нет

frcode

String

Код ФР

Нет
amountPurchaseDecimalСумма продажНет

amountReturn

Decimal

Сумма возвратов

Нет


Сумма налогов за смену <taxes>

Начиная с верси 10.4.4.0 актуализирован экспорт налогов.

Пример экспорта.

CR-11870 - Получение подробных данных проблемы… СТАТУС

SRTS-2833 - Получение подробных данных проблемы… СТАТУС

reports/zreport/taxes/tax

Наименование элемента

Тип данных

Описание

Обязательное
taxКомплексныйСтавка налогаДа
Наименование атрибутаТип данныхОписаниеОбязательное

nds

Integer

Ставка НДС

Да

ndsSumSale

Decimal

Сумма налога по всем проданным товарам за смену по ставке НДС

Да

ndsSumReturn

Decimal

Сумма налога по всем возвращённым товарам за смену по ставке НДС

Да
sumPositionDecimalСумма всех товаров за смену по ставке НДСДа

Список операций по чеку расхода <reversals>

CR-3746 - Получение подробных данных проблемы… СТАТУС

SRTS-26 - Получение подробных данных проблемы… СТАТУС

10.2.97.0

Версия веб-сервиса 1.4

Описание работы расходных операций в SetRetail10 ◾️ Mastercard ◾️ Выдача наличных на кассе.

reports/zreport/reversals/reversal

Наименование элемента

Тип данных

Описание

Обязательное
reversalКомплексныйДанные о типах расходных операций кроме выдачи/продажиНет
Наименование атрибутаТип данныхОписаниеОбязательное

operation

Комплексный

Операция:

  • ANNULMENT - операция аннулирования чека целиком.
  • CANCEL - операция отмены добавления позиции, то есть, отмены товара из подвала чека.
  • STORNO - операция удаления товарной позиции из чека.
Нет

amount

Decimal

Количество товаров по данной операции.

Нет

sum

Decimal

Сумма стоимости товаров по данной операции.

Нет

Плагинные свойства отчета <plugin-property>

SRTS-1138 - Получение подробных данных проблемы… СТАТУС

CR-7962 - Получение подробных данных проблемы… СТАТУС

10.3.18.0

Версия веб-сервиса 1.7

reports/zreport/plugin-property

Наименование атрибутаТип данныхОписаниеОбязательное
keyStringНаименование плагинного свойстваДа
valueStringЗначение плагинного свойстваНет

Фискальные данные

SRTS-1138 - Получение подробных данных проблемы… СТАТУС

SRTZ-1973 - Получение подробных данных проблемы… СТАТУС

CR-7962 - Получение подробных данных проблемы… СТАТУС

10.3.18.0

Версия веб-сервиса 1.7

Наименование плагинного свойстваОписание
FISCAL_DOC_IDПорядковый номер фискального документа
FN_NUMНомер фискального накопителя или его аналога
FPDФискальный признак документа

Пробег термоголовки Пирит 2Ф

SRTZ-2299 - Получение подробных данных проблемы… СТАТУС

CR-8572 - Получение подробных данных проблемы… СТАТУС

10.3.24.0

Версия веб-сервиса 1.7

Только для ФР Пирит 2Ф

Наименование плагинного свойстваОписание
THERMO_HEAD_RESOURCE_TOTAL

Общий ресурс термоголовки. Представляет собой общий расход чековой ленты в миллиметрах, на основании которого может быть рассчитан суточный расход

Особенности работы:

  • при перевыгрузке Z-отчета данные по расходу чековой ленты буду обновленными, т.к. расчет идет накопительным итогом;

  • при смене принтера данные по расходу чековой ленты будут обнулены.

Пример XML:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<reports count="1">
    <zreport>
        <reportType>ZReport</reportType>
        <shiftNumber>1</shiftNumber>
        <shopNumber>1162</shopNumber>
        <docNumber>8</docNumber>
        <cashNumber>61</cashNumber>
        <serialCashNumber>NFM.1162.61.0.1670846994294</serialCashNumber>
        <userTabNumber>1</userTabNumber>
        <userName>Администраторов Администратор Администраторович</userName>
        <dateOperDay>2022-12-12+03:00</dateOperDay>
        <dateShiftClose>2022-12-12T15:18:54.497</dateShiftClose>
        <dateShiftOpen>2022-12-12T15:18:04.119</dateShiftOpen>
        <countCashPurchase>6</countCashPurchase>
        <countCashlessPurchase>0</countCashlessPurchase>
        <countPurchase>6</countPurchase>
        <countCashReturn>0</countCashReturn>
        <countCashlessReturn>0</countCashlessReturn>
        <countReturn>0</countReturn>
        <counterIncoming>1</counterIncoming>
        <counterWithdrawal>0</counterWithdrawal>
        <amountByCashPurchase>4109.03</amountByCashPurchase>
        <amountByCashlessPurchase>0.00</amountByCashlessPurchase>
        <amountByPurchaseFiscal>4109.03</amountByPurchaseFiscal>
        <amountByCashReturn>0.00</amountByCashReturn>
        <amountByCashlessReturn>0.00</amountByCashlessReturn>
        <amountByReturnFiscal>0.00</amountByReturnFiscal>
        <amountCashIn>195487.00</amountCashIn>
        <amountCashOut>0.00</amountCashOut>
        <amountCashDiscount>0.00</amountCashDiscount>
        <returnDiscountCashPay>0.00</returnDiscountCashPay>
        <incresentTotalStart>0</incresentTotalStart>
        <incresentTotalFinish>410903</incresentTotalFinish>
        <incresentTotalReturnStart>0</incresentTotalReturnStart>
        <incresentTotalReturnFinish>0</incresentTotalReturnFinish>
        <factoryCashNumber>00000116261</factoryCashNumber>
        <cashName>Fiscal printer emulator 0</cashName>
        <inn>7802781104</inn>
        <payments>
            <payment typeClass="CashPaymentEntity" amountPurchase="4109.03"/>
        </payments>
        <reversals/>
        <countExpenseReceipt>0</countExpenseReceipt>
        <countCashExpenseReceipt>0</countCashExpenseReceipt>
        <countCashlessExpenseReceipt>0</countCashlessExpenseReceipt>
        <amountByExpenseReceipt>0.00</amountByExpenseReceipt>
        <amountByExpenseReceiptFiscal>0.00</amountByExpenseReceiptFiscal>
        <amountByCashExpenseReceipt>0.00</amountByCashExpenseReceipt>
        <amountByCashlessExpenseReceipt>0.00</amountByCashlessExpenseReceipt>
        <incresentTotalExpenseStart>0</incresentTotalExpenseStart>
        <incresentTotalExpenseFinish>0</incresentTotalExpenseFinish>
        <countReturnExpenseReceipt>0</countReturnExpenseReceipt>
        <countCashReturnExpenseReceipt>0</countCashReturnExpenseReceipt>
        <countCashlessReturnExpenseReceipt>0</countCashlessReturnExpenseReceipt>
        <amountByReturnExpenseReceipt>0.00</amountByReturnExpenseReceipt>
        <amountByReturnExpenseReceiptFiscal>0.00</amountByReturnExpenseReceiptFiscal>
        <amountByCashReturnExpenseReceipt>0.00</amountByCashReturnExpenseReceipt>
        <amountByCashlessReturnExpenseReceipt>0.00</amountByCashlessReturnExpenseReceipt>
        <incresentTotalReturnExpenseStart>0</incresentTotalReturnExpenseStart>
        <incresentTotalReturnExpenseFinish>0</incresentTotalReturnExpenseFinish>
        <plugin-property key="FISCAL_DOC_ID" value="9"/>
        <plugin-property key="FN_NUM" value="3701669721244726"/>
        <plugin-property key="FPD" value="1000009"/>
		<plugin-property key="THERMO_HEAD_RESOURCE_TOTAL" value="563018"/>
    </zreport>
</reports>


© 1994-2024, ООО "Кристалл Сервис Интеграция".
Все права защищены.

Политика обработки персональных данных