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

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

За операционный день
Метод	getWithdrawalsByOperday
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://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	Номер документа	Да
shift	Integer	Номер смены	Да
cash	Integer	Номер кассы	Да
shop	Integer	Номер магазина	Да
operDay	String	Операционный день	Да
currency	String	Валюта	Да
username	String	ФИО кассира, который зарегистрировал первый чек в смене Неважно какие настройки включены, так как первое изъятие делается минимум после первого чека (если не было чеков, то берётся сотрудник выполняющий операцию). Также это поле будет заполняться данными ФИО кассира который зарегистрировал первый чек в смене для всех изъятий сделанных в смене.	Да
tabNumber	String	Табельный номер кассира, который зарегистрировал первый чек в смене Неважно какие настройки включены, так как первое изъятие делается минимум после первого чека (если не было чеков, то берётся сотрудник выполняющий операцию). Также это поле будет заполняться данными табельного номера который зарегистрировал первый чек в смене для всех изъятий сделанных в смене.	Да
exchangeResidue	Boolean	Признак разменного остатка	Нет
inn	String	ИНН юридического лица	Нет
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			Комплексный	Брикет	Да
Наименование элемента			Тип данных	Описание	Обязательное
	briquetNumber		String	Номер брикета Начиная с версии 10.4.0.0 поле становится необязательным для заполнения при настройке `export.inventory.without.briquet.number=true` в таблице sales_management_properties. SRTS-2402 - Получение подробных данных проблемы… СТАТУС CR-10014 - Получение подробных данных проблемы… СТАТУС 10.4.0.0	Да
	bankNotes		Комплексный	Номинал банкноты	Нет
Наименование атрибута			Тип данных	Описание	Обязательное
		value	Long	Номинал c копейками	Нет
		count	Long	Количество	Нет

<?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

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

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

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>

Интеграция

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

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

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

За период

Изъятия `<withdrawals>`

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

Брикет `<inventory>`

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

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

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

За период

Изъятия <withdrawals>

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

Брикет <inventory>

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

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

Изъятия `<withdrawals>`

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

Брикет `<inventory>`

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