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

Экспорт изъятий из SetRetail10 в ERP (веб-сервис на стороне SetRetail10)

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

Методы веб-сервиса для экспорта изъятий

За операционный день

МетодgetWithdrawalsByOperday
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле

Тип данных

Описание

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

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

operday

date

Операционный день в формате YYYY-MM-DD

Нет

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

return

base64Binary

Изъятия за операционный день


Описание формата выгрузки внесений

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getWithdrawalsByOperday>
         <!--Optional:-->
         <operday>2019-05-13</operday>
      </plug:getWithdrawalsByOperday>
   </soapenv:Body>
</soapenv:Envelope>

-

За период

МетодgetWithdrawalsByPeriod
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле

Тип данных

Описание

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

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

fromDate

date

Начало диапазона в формате YYYY-MM-DD

Нет

toDate

date

Конец диапазона YYYY-MM-DD

Нет

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

return

base64Binary

Изъятия за период


Описание формата выгрузки внесений

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getWithdrawalsByPeriod>
         <!--Optional:-->
         <fromDate>2019-05-01</fromDate>
         <!--Optional:-->
         <toDate>2019-05-30</toDate>
      </plug:getWithdrawalsByPeriod>
   </soapenv:Body>
</soapenv:Envelope>

Изъятия <withdrawals>

withdrawals

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

Тип данных

Описание

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

сount

Long

Количество изъятий в данном документе

Да
Наименование элементаТип данныхОписаниеОбязательное
withdrawalКомплексныйСписок изъятийДа

Экземпляр изъятия <withdrawal>

withdrawals/withdrawal

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

Тип данных

Описание

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

amount

Double

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

Да

regtime

String

Время регистрации документа

Да

number

Long

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

Да
shiftIntegerНомер сменыДа
cashIntegerНомер кассыДа

shop

Integer

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

Да
operDayStringОперационный деньДа
currencyStringВалютаДа

username

String

ФИО кассира, который зарегистрировал первый чек в смене

  • Неважно какие настройки включены, так как первое изъятие делается минимум после первого чека (если не было чеков, то берётся сотрудник выполняющий операцию).
  • Также это поле будет заполняться данными ФИО кассира который зарегистрировал первый чек в смене для всех изъятий сделанных в смене.
Да

tabNumber

String

Табельный номер кассира, который зарегистрировал первый чек в смене

  • Неважно какие настройки включены, так как первое изъятие делается минимум после первого чека (если не было чеков, то берётся сотрудник выполняющий операцию).
  • Также это поле будет заполняться данными табельного номера который зарегистрировал первый чек в смене для всех изъятий сделанных в смене.
Да

exchangeResidue

Boolean

Признак разменного остатка

Нет
innStringИНН юридического лицаНет

cashierName


String

ФИО кассира в зависимости от настроек:

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

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

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

10.3.1.0


  • ФИО кассира первого фискального чека (либо сотрудник, который выполняет операцию если ещё не было чеков).
  • ФИО кассира последнего фискального чека (имеется ввиду последнего сделанного перед операцией внесения/изъятия).
  • Авторизованный пользователь (т.е. тот кто выполняет операцию).
  • По умолчанию, если настройки не указаны, берётся кассир, который выполняет операцию.
Да

cashierTabNumber



String

Табельный номер кассира в зависимости от настроек:

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

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

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

10.3.1.0


  • Табельный номер кассира первого фискального чека (либо сотрудник, который выполняет операцию если ещё не было чеков).
  • Табельный номер последнего фискального чека (имеется ввиду последнего сделанного перед операцией внесения/изъятия).
  • Авторизованный пользователь (т.е. тот кто выполняет операцию).
  • По умолчанию, если настройки не указаны, берётся кассир, который выполняет операцию.
Да
Наименование элементаТип данныхОписаниеОбязательное
inventoryКомплексныйБрикетНет
plugin-propertyКомплексныйСписок "плагинных" (расширенных, не базовых) свойств.








Может отсутствовать.
Нет
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<withdrawals count="1">
	<withdrawal 
		amount="72030.0" 
		regtime="2021-01-03T13:56:54.443" 
		number="5" 
		shift="18" 
		cash="1" 
		shop="3382" 
		operDay="2021-01-03" 
		currency="RUB" 
		userName="Иванов Иван Иванович" 
		tabNumber="1" 
		exchangeResidue="false"
		cashierName="Иванов Иван Иванович" 
		cashierTabNumber="1"/>
</withdrawals>

Брикет <inventory>

10.2.94.0

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

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

  • Только для экспорта через веб-сервис.
  • Экземпляр данных по брикетам не выгружается в xml-файлы экспорта изъятий.

Подробнее SetRetail10 ▪️ Клавиатурная касса ▪️ Номер брикета (лотка) при инкассации.

withdrawals/withdrawal/inventory

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

Тип данных

Описание

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

inventory

Комплексный

Брикет

Да





briquetNumberString

Номер брикета

Начиная с версии 10.4.0.0 поле становится необязательным для заполнения при настройке export.inventory.without.briquet.number=true в таблице sales_management_properties.

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

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

10.4.0.0

Да

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

valueLongНоминал c копейкамиНет

countLongКоличествоНет
Наименование элементаТип данныхОписаниеОбязательное

coinКомплексный

Монеты

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

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

10.4.2.0

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

Для экспорта через веб-сервис (метод getWithdrawalsByOperday или на стороне ERP) 

export.set10wsclient.withdrawals.version = 1.4


Настройка на сервере SetRetail/SetCentrum в базе данных set таблица sales_management_properties:

export.inventory.without.briquet.number = true



Нет
Наименование атрибутаТип данныхОписаниеОбязательное

valueLong

Номинал

Нет

countLongКоличествоНет
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<withdrawals count="1">
    <withdrawal 
		amount="72030.0" 
		regtime="2021-01-03T13:56:54.443" 
		number="5" 
		shift="18" 
		cash="1" 
		shop="3382" 
		operDay="2021-01-03" 
		currency="RUB" 
		userName="Иванов Иван Иванович" 
		tabNumber="1" 
		exchangeResidue="false"
        inn="7802781104">
        <inventory>
            <briquetNumber>1</briquetNumber>
            <bankNotes value="5000" count="2"/>
            <bankNotes value="500000" count="12"/>
            <bankNotes value="1000" count="33"/>
            <bankNotes value="200000" count="2"/>
            <bankNotes value="100000" count="2"/>
            <bankNotes value="50000" count="3"/>
            <bankNotes value="20000" count="14"/>
            <bankNotes value="10000" count="13"/>
        </inventory>
    </withdrawal>
</withdrawals>

Плагинные свойства экземпляра изъятия <plugin-property>

withdrawals/withdrawal/plugin-property

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

Данные по кассирам

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

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

10.3.20.0

Функциональность для клиентов CSI.

По включению уточняйте у менеджера.

Наименование плагинного свойстваОписание
SESSION_IDНомер сессии кассира
CASHIER_TAB_NUMBER

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

CASHIER_NAMEФИО кассира
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<withdrawals count="1">
    <withdrawal 
		amount="775.0" 
		regtime="2023-03-02T12:51:12.411" 
		number="15" 
		shift="3" 
		cash="60" 
		shop="1123" 
		operDay="2023-03-02" 
		currency="RUB" 
		userName="Иванов Иван Иванович" 
		tabNumber="1" 
		exchangeResidue="false" 
		cashierName="Иванов Иван Иванович" 
		cashierTabNumber="1" 
		inn="7802781104">
        <plugin-property key="SESSION_ID" value="000000010012220230111"/>
        <plugin-property key="CASHIER_TAB_NUMBER" value="1"/>
        <plugin-property key="CASHIER_NAME" value="Иванов Иван Иванович"/>
    </withdrawal>
</withdrawals>

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

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