/
Веб-сервисы импорта данных из ERP в SetRetail10

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

Веб-сервисы импорта данных из ERP в SetRetail10

нояб. 02, 2020

    Описание

    Данный вариант импорта предполагает обмен данными на основе веб-сервисов, предоставляемых SetRetail10, при которых активной стороной запроса является ERP, то есть ERP должна отправлять данные в SetRetail10. 

    Внимание:

    • Пакет данных, передаваемый в SetRetail10 должен преобразовываться в кодировку BASE64. (Кроме кассиров)

    • Обмен происходит по порту 8090

    Методы веб-сервиса для импорта товарного справочника

    Внимание:

    При импорте данных в методах getGoodsCatalogWithTi и getGoodsCatalog пакеты всегда добавляются с приоритетом 0, то есть с самым наименьшим приоритетом.

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

    Метод

    getGoodsCatalog

    URL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport

    WSDL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport?wsdl

    Поле

    Тип данных

    Описание

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

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

    goodsCatalogXML

    base64Binary

    Товарный справочник в формате XML

    Да

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

    Return

    Boolean

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

     

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

    Данный метод не поддерживается при интеграции по SetESB

    Метод

    getGoodsCatalogWithTi

    URL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport

    WSDL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport?wsdl

    Поле

    Тип данных

    Описание

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

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

    getGoodsCatalog

    base64Binary

    Товарный справочник в формате XML

    Да

    ti

    string

    Transaction Id - номер передаваемого пакета данных, по которому можно будет получить обратную связь.

    Нет

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

    return

    boolean

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

     

    Описание формата данных товарного справочника

    Важно

    Идентификатор пакета ti

    Transaction Id – является уникальным идентификатором этого пакета в SetRetail10, что накладывает определённые ограничения на повторный импорт пакета и загрузку разных типов данных с одним идентификатором.

    -

    C приоритетом обработки пакетов

    Метод

    getGoodsCatalogWithParams

    URL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport

    WSDL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport?wsdl

    Комментарий

    Приоритет является первым полем в сортировке при выборке пакетов на обработку.

    Вторым полем в сортировке является дата/время импорта пакета.

    Принцип обработки пакетов: в одну итерацию выборки пакетов должны попадать сначала все с самым наивысшим приоритетом, далее со следующим более низким приоритетом, и так далее вплоть до самого наименьшего приоритета, т.е. пакеты с приоритетом 0, всегда обрабатываются в последнюю очередь.

    Поле

    Тип данных

    Описание

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

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

    getGoodsCatalog

    base64Binary

    Товарный справочник в формате XML

    Да

    ti

    string

    Transaction Id - номер передаваемого пакета данных, по которому можно будет получить обратную связь.

    Нет

    priority

    int

    Приоритет обработки пакета от 0 до 9. 0 самый наименьший. По умолчанию 0. Более высокий приоритет обрабатывается раньше.

    Нет

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

    return

    boolean

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

     

    Описание формата данных товарного справочника

    Методы веб-сервиса для импорта данных о производителе и наборов альтернативных свойств товаров

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

    Метод

    importGoodsProducers

    URL

    http://IP-адрес_сервера:8090/SET-Producer/WSGoodsProducersImport

    WSDL

    http://IP-адрес_сервера:8090/SET-Producer/WSGoodsProducersImport?wsdl

    Поле

    Тип данных

    Описание

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

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

    producersXML

    base64Binary

    Данные о производителе и набор альтернативных свойств товара в формате XML

    Да

    ti

    string

    Transaction Id - Номер передаваемого пакета данных, по которому можно будет получить обратную связь.

    Нет

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

    return

    boolean

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

     

    Формат данных о производителе и наборов альтернативных свойств товаров

    Методы web-сервиса для импорта кассиров

    Внимание:

    • При импорте кассиров не нужно преобразовывать данные в base64.

    • Блок кассиров должен быть представлен в виде well formed XML в блоке CDATA.

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

    Метод

    importCashiers

    URL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/CashiersImport

    WSDL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/CashiersImport?wsdl

    Поле

    Тип данных

    Описание

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

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

    xml

    XML (CDATA)

    Справочник кассиров в формате XML

    Да

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

     

     

    Метод без обратной связи, в случае успешной или неуспешной загрузки ответа не будет.

     

    Описание формата данных кассиров

     

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

    Метод

    importCashiersWithTi

    URL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/CashiersImport

    WSDL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/CashiersImport?wsdl

    Поле

    Тип данных

    Описание

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

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

    xml

    XML (CDATA)

    Справочник кассиров в формате XML

    Да

    ti

    string

    Transaction Id - номер передаваемого пакета данных, по которому можно будет получить обратную связь.

    Нет

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

    return

    boolean

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

     

    Описание формата данных кассиров

    Важно

    Идентификатор пакета ti

    Transaction Id – является уникальным идентификатором этого пакета в SetRetail10, что накладывает определённые ограничения на повторный импорт пакета и загрузку разных типов данных с одним идентификатором.

    -

    Методы веб-сервиса для импорта справочника продавцов

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

    Метод

    importSellers

    URL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/SellersImportWS

    WSDL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/SellersImportWS?wsdl

    Поле

    Тип данных

    Описание

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

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

    xml

    base64Binary

    Справочник продавцов в формате XML, кодированный с помощью base64Binary

    Да

    ti

    String

    Transaction Id - Номер передаваемого пакета данных, по которому можно будет получить обратную связь.

    Нет

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

    return

    boolean

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

     

    Описание формата данных продавцов

    Важно

    Идентификатор пакета ti

    Transaction Id – является уникальным идентификатором этого пакета в SetRetail10, что накладывает определённые ограничения на повторный импорт пакета и загрузку разных типов данных с одним идентификатором.

    Методы веб-сервиса для импорта дисконтных карт и анкет клиентов

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

    Метод

    getCardsCatalog

    URL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSCardsCatalogImport

    WSDL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSCardsCatalogImport?wsdl

    Поле

    Тип данных

    Описание

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

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

     

     

     

    cardsCatalogXML

    base64Binary

    Справочник карт и анкет клиентов в формате XML, кодированный с помощью base64Binary

    Да

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

    return

    boolean

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

     

    Описание формата данных карт

     

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

    Метод

    getCardsCatalogWithTi

    URL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSCardsCatalogImport

    WSDL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/SET/WSCardsCatalogImport?wsdl

    Поле

    Тип данных

    Описание

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

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

    cardsCatalogXML

    base64Binary

    Справочник карт в формате XML кодированный с помощью base64Binary

    Да

    ti

    String

    Transaction Id - Номер передаваемого пакета данных, по которому можно будет получить обратную связь.

    Нет

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

    return

    boolean

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

     

    Описание формата данных карт

    Важно

    Идентификатор пакета ti

    Transaction Id – является уникальным идентификатором этого пакета в SetRetail10, что накладывает определённые ограничения на повторный импорт пакета и загрузку разных типов данных с одним идентификатором.

    Начисление бонусных баллов через веб-сервис

    Для начисления бонусных баллов из ERP системы используйте веб-сервис и методы из статьи SetRetail10 ◾️ Ручное начисление бонусов.

    Методы веб-сервиса для импорта рекламных акций

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

    Метод

    importActions

    URL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/AdvertisingActionsImport

    WSDL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/AdvertisingActionsImport?wsdl

    Поле

    Тип данных

    Описание

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

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

    xmlData

    base64Binary

    Рекламные акции в формате XML

    Да

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

    return

    boolean

    Ответ об успешном прохождении валидации пакета данных и принятии его в обработку

     

    Описание формата рекламных акций

     

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

    Метод

    importActionsWithTi

    URL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/AdvertisingActionsImport

    WSDL

    http://IP-адрес_сервера:8090/SET-ERPIntegration/AdvertisingActionsImport?wsdl

    Поле

    Тип данных

    Описание

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

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

    xmlData

    base64Binary

    XML в формате данных Рекламных акций, кодированный с помощью base64Binary

    Да

    ti

    String

    Transaction Id - номер передаваемого пакета данных, по которому можно будет получить обратную связь.

    Нет

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

    return

    boolean

    В случае успешной обработки пакета возвращается:

    <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:importActionsResponse xmlns:ns2="http://ws.discounts.ERPIntegration.crystals.ru/"/> </soap:Body> </soap:Envelope>

     

    True возвращается случае успешной обработки пакета в случаях:

    1. Корректная структура xml, валидные данные.

    2. Корректная структура xml, невалидные данные. Например: номер магазина, отправляемого в пакете, отсутствует на сервере

    3. Корректная структура xml, валидные данные, повторяющийся ti пакета:

    <return>true</return> </ns2:importActionsResponse>

     

    Описание формата рекламных акций

    Важно

    Идентификатор пакета ti

    Transaction Id – является уникальным идентификатором этого пакета в SetRetail10, что накладывает определённые ограничения на повторный импорт пакета и загрузку разных типов данных с одним идентификатором.