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

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

Методы веб-сервиса для экспорта 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 - Getting issue details... STATUS

10.2.59.0

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

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

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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

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

Нет
countExpenseReceiptLong

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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

Да
countCashExpenseReceiptLong

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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

Да
countCashlessExpenseReceiptLong

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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

Да
amountByExpenseReceiptDecimal

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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

Да
amountByExpenseReceiptFiscalDecimal

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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

Да
amountByCashExpenseReceiptDecimal

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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

Да
amountByCashlessExpenseReceiptDecimal

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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

Да
incresentTotalExpenseStartLong

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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

Да
incresentTotalExpenseFinishLong

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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

Да
countReturnExpenseReceiptLong

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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

Да
countCashReturnExpenseReceiptLong

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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

Да
countCashlessReturnExpenseReceiptLong

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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

Да
amountByReturnExpenseReceiptDecimal

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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

Да
amountByReturnExpenseReceiptFiscalLong

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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

Да
amountByCashReturnExpenseReceiptDecimal

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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

Да
amountByCashlessReturnExpenseReceiptDecimal

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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

Да
incresentTotalReturnExpenseStartLong

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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

Да
incresentTotalReturnExpenseFinishLong

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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

Да

Группировка по типам товаров <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 - Getting issue details... STATUS

10.2.36.0

reports/zreport/payments

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

Тип данных

Описание

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

typeClass

String

Тип оплаты

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

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

Нет


Пример 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>

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

reports/zreport/taxes/tax

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

Тип данных

Описание

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

nds

Integer

Ставка НДС

Да

ndsSumSale

Decimal

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

Да

ndsSumReturn

Decimal

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

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


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

CR-3746 - Getting issue details... STATUS

SRTS-26 - Getting issue details... STATUS

10.2.97.0

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

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

reports/zreport/reversals/reversal

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

Тип данных

Описание

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

operation

Комплексный

Операция:

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

amount

Decimal

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

Нет

sum

Decimal

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

Нет