...
В решении Супермаг Плюс есть возможность подключить электронный документооборот через сервис ПО СБИС (от компании Тензор).
Файл схемы.
(!эти файлы берем себе!)
Пример файла XML.
Комментарий.
OR.XSD
OE
Внимание!Идентификатор участника обмена который устанавливается в документе "УПД на приход", и "Накладная поставщика".Не передается в явном виде от провайдера электронного документооборота. В настоящее время для его модификации следует изменить схему объекта UI.XSD Оптимально (но не обязательно!), если его значение будет равно значению переменной в файле UI.XML. Значение может принимать любое значение (цифра, набор цифр, какой-то код), главное, чтобы он был уникальным. Для случая, если одна БД обслуживает несколько ЮР лиц.Или используется распределенная БД, работа с УПД в которых подразумевает, что используется более одной БД для обмена(чаще всего это одна Центральная БД) с документами УПД, и использует для получения свои почтовые каталоги (настроенные УПД фильтры).Из практики: <SMWAYBILLSEXT> После того, как изменена схема, установлено значение по умолчанию (или оставили все как есть, т.е. "1"). Проверьте настройку в почтовом модуле, параметр "Собственный идентификатор участника документооборота" - должен быть равен этому значению. Зачем это сделано?Сценарий таков:
|
---|
Здесь и далее, предлагается общая инструкция по настройке обмена электронными документами через провайдера Тензор (решение СБИС).
Схемы объектов используемые в процессе обмена (будут актуализироваться, изменяться, предлагаться варианты).
<xs:element msdata:Locale="ru" name="SMWAYBILLSEXT">
После того, как изменена схема, установлено значение по умолчанию (или оставили все как есть, т.е. "1"). Проверьте настройку в почтовом модуле, параметр "Собственный идентификатор участника документооборота" - должен быть равен этому значению. Зачем это сделано?Сценарий таков:
|
---|
Здесь и далее, предлагается общая инструкция по настройке обмена электронными документами через провайдера Тензор (решение СБИС).
Схемы объектов используемые в процессе обмена (будут актуализироваться, изменяться, предлагаться варианты).
№ п.п. | Название объекта. | Тип объекта в СМ+ | Название файла. схемы | Файл схемы. (!эти файлы берем себе!) | Дата модификации. | Пример файла XML. Комментарий. |
---|---|---|---|---|---|---|
1. | Заказ поставщику. | OR | OR.XSD | OR.XSD | 21.01.2022 | 210625120745_12480_2_1.XML.1624601281.629194.xml |
OR_Заказ поставщику.XML | ||||||
2. | Подтверждение заказа поставщику. | OE | OE.XSD | 25.06.2021 | ||
3. | Накладная поставщика. | WE | WE.XSD | 25.06.2021 | В обмене с Тензор не участвует. (устарела). Возможно участие при использовании структуры с распределенными БД Супермаг. | |
4. | УПД на приход. | UI | UI.XSD | UI.XSD | 14.10.2022 от 1.049 сп3 | Функция ArticleByBarcode заменена функцией ArticleByBarcodeUI В функцию ArticleByBarcode внесено следующее изменение: если поиск артикула по штриховому коду из спецификации XML-документа не привел к успеху, то из штрихового кода удаляются лидирующие нули и выполняется повторный поиск артикула. (теперь задаётся три аргумента - штриховой код, код КИЗ, код ОСУ) Изменен принцип приема УПД на приход. Добавили функцию ArticleBySupplierCodeUI для определения артикула по артикулу Супермага,
<xs:element smimport:Function="ArticleBySupplierCodeUI(SMSPECWE.BARCODE, SMDOCUMENTS.CLIENTINN, SMDOCUMENTS.CLIENTKPP, SMSPECTOBACCOWE.MARKCODE, SMSPECOSUCODEWE.OSUCODE)" name="ARTICLE" type="xs:string" /> В перечень функций импорта данных из XML файлов добавлена функция ArticleByAnyCodeUI. Функция аналогична функции ArticleBySupplierCodeUI за исключением того, что в качестве аргументов для определения контрагента используются не данные о его ИНН и КПП, а код клиента Супермаг+. |
UI | UI.XSD | UI_1.051.XSD | 15.08.2023 | Удален лишний тег <xs:element name="UTDSUPPDOC" type="xs:string" /> | ||
UI | UI.XSD | 01.11.2023 от 1.052 | В XSD схеме до версии 1.052 УПД на приход (UI.XSD) имеется тег с явным указанием значения по умолчанию, например: Внесено изменение содержащее значение Собственного идентификатора участника документооборота из настроек почтового модуля: Внесено изменение для фиксирования в УПД данных в поле "Ключ товара из УПД" <xs:element smimport:Function="Decode(BARCODE, BARCODE)" name="CARDKEY" type="xs:string" /> | |||
UI | UI.XSD | 01.03.2024 от 1.053 | При обработке XML-файла входящего УПД на приход имелась, но не была декларирована возможность заполнять поле документа УПД OURUTDID (собственный идентификатор участника обмена УПД) значением атрибута «Собственный идентификатор участника документооборота» почтового ящика, в который пришел документ. Для этого необходимо, чтобы во входящем XML-файле значение тэга OURUTDID отсутствовало, а в XSD-схеме строка с описанием тэга выглядела следующим образом: <xs:element default="$(DOCEXCHID)" name="OURUTDID" type="xs:string" /> Где параметр $(DOCEXCHID) замещается значением «Собственный идентификатор участника документооборота» почтового ящика. Замещение выполняется внутри алгоритма почтового модуля в ходе импорта содержания XSD-файла для его использования при обработке XML-файла. | |||
UI | UI.XSD | 17.04.2024 от 1.053 сп2 | Функция импорта «ArticleKeyByVariousUI». Для документа УПД на приход, в спецификации которого есть поле «Ключ товара из УПД», создана функция импорта «ArticleKeyByVariousUI». Функция позволяет из перечня полей исходного документа - артикул Супермаг+, артикул контрагента, штриховой код, КИЗ или ОСУ, взять первое попавшееся непустое значение и поместить его в заданное поле (Ключ товара из УПД). Функция используется для того, чтобы в случае, когда оказалось невозможным автоматически определить артикул по данным документа поставщика, поместить в УПД в специальное поле некоторое значение, по которому можно было бы в дальнейшем определить этот артикул. Функция импорта «ArticleByVariousUI». Артикул товара по информации об артикуле Супермаг+, артикуле контрагента, штриховом коде, КИЗ или ОСУ. Функция позволяет определить артикул по любому набору данных, который будет присутствовать во входном XML-файле и может быть использован для поиска артикула. Функция имеет 7 параметров:
В XSD-схеме должны быть описаны все поля, которые требуются для задания аргументов функции. В XML-файле почтового пакета могут присутствовать только те поля, которых достаточно для определения артикула. Если для определения артикула используются данные контрагента (артикул контрагента, ИНН и КПП), то в XML-файле поле «КПП» может отсутствовать, если для однозначного определения контрагента достаточно только ИНН. | |||
UI | UI.XSD | 29.05.2024 от 1.053 сп2 | В структуру файла подтверждения приема УПД и файла УПД на отгрузку добавлены тэги INNSIGNATORY и NAMESIGNATORY – ИНН подписанта и имя подписанта. <xs:element name="INNSIGNATORY" type="xs:string" minOccurs="0" /> | |||
5. | Требование на отбор | SW | SW.XSD | 21.01.2022 | SW_Требование на отбор.xml - В обмене с Тензор не участвует. Возможно использование для решения локальных задач. Один из способов применения - формирование документа на обмен товара (хлеб). | |
6. | Ответ системы СМ+ на факт приемки. | PACKAGE | UICONFIRM.XSD | UICONFIRM.XSD | 10.10.2022 от 1.049 сп2 | УПД фильтр. Формат данных XML. Содержание файла ответа с результатом приемки. |
PACKAGE | UICONFIRM.XSD | 01.11.2023 от 1.052 | В документы «УПД на приход» и «УПД на отгрузку» на закладку «Грузораспорядители» добавлены атрибуты «Подписант» и «ИНН». Атрибуты заполняются именем и ИНН подписанта ЭДО – сотрудника подтверждающего УПД на приход, или отправляющего УПД на отгрузку. | |||
7. | Квитанция провайдера ЭДО. Протокол обмена дополнен получением технической квитанции в ответ на отсылку файла с результатом приемки. Квитанция имеет смысл подтверждения успешности обработки и пересылки провайдером ЭДО файла подтверждения. | - | - | - | 14.03.2022 | |
8. | УПД на расход. | UD | UD.XSD | UD_1049_1.xsd | 01.12.2022 от 1.049.1 | Добавлен тег BARCODEEXTERNAL.
В XSD схему почтового объекта УПД на отгрузку добавлен тэг SMDOCTRANSPORT, содержащий информацию транспортного раздела. Данные заполняются при создании документа из соответствующих полей расходной накладной. |
UD | UD.XSD | 01.11.2023 от 1.052 | В структуру файла подтверждения приема УПД и файла УПД на отгрузку добавлены тэги INNSIGNATORY и NAMESIGNATORY – ИНН подписанта и имя подписанта. <xs:element name="INNSIGNATORY" type="xs:string" minOccurs="0" /> | |||
9. | Ответ СБИС на факт приемки покупателем продукции на основании УПД на отгрузку (полученного из СуперМаг Плюс). (от версии 1.049) | <xs:element name="REPLY"> | UDCONFIRM.xsd | 10.10.2022 от 1.049 | В рамках версии 1.049 мы ожидаем безоговорочного согласия от клиента ( <RESULT>1</RESULT>). Или полного отказа от приемки <RESULT>2</RESULT> Варианты связанные с согласованием разногласий пока не реализованы. | |
<xs:element name="REPLY"> | UDCONFIRM.xsd | UDCONFIRM_1.051.xsd | 21.08.2023 от 1.051 | Внимательно прочитать! Для отсылки информации о подписанте в УПД на отгрузку, необходимо в файл описания структуры XML пакета (UD.xsd) в тэг ="SMDOCUD" добавить тэги: | ||
2. Устарела.....бедует удалена...Схемы объектов используемые в процессе обмена (будут актуализироваться, изменяться, предлагаться варианты).
№ п.п. | Название объекта. | Тип объекта в СМ+ | Название файла. схемы | Файл схемы. (!эти файлы берем себе!) | Дата модификации. | Пример файла XML. Комментарий. |
---|---|---|---|---|---|---|
1. | Заказ поставщику. | OR | OR.XSD | 25.06.2021 21.01.2022 | ||
2. | Подтверждение заказа поставщику. | OE | OE.XSD | 25.06.2021 | ||
3. | Накладная поставщика. | WE | WE.XSD | 25.06.2021 | В обмене с Тензор не участвует. (устарела). Возможно участие при использовании структуры с распределенными БД Супермаг. | |
4. | УПД на приход. | UI | UI.XSD | 25.06.2021 21.01.2022 до 1.048 01.06.2022 от 1.048 01.09.2022 от 1.049 20.09.2022 от 1.049 сп1 11.10.2022 от 1.049 сп3 14.10.2022 от 1.049 сп3 | UPD_Natur_Prod.xml Изменено значение в схеме для OURUTDID UPD_Natur_Prod_SMALL.xml ; UPD_Natur_Prod_SMALL2.xml UPD_Natur_Prod_SMALL5_UKD.XML - УКД UPD_Natur_Prod_SMALL5.XML - УПД Представленная схема является универсальной, т.е. предполагает использование и УПД и УКД. Внимание! для успешной приемки УПД на приход в версии 1.049 - требуется установка патча на сервер. Sm.Post.Filters.Utd.1.049x64.7z В версию 1.049 сп1 и выше, это изменение уже включено, патч НЕ требуется. Функция ArticleByBarcode заменена функцией ArticleByBarcodeUI В функцию ArticleByBarcode внесено следующее изменение: если поиск артикула по штриховому коду из спецификации XML-документа не привел к успеху, то из штрихового кода удаляются лидирующие нули и выполняется повторный поиск артикула. (теперь задаётся три аргумента - штриховой код, код КИЗ, код ОСУ) Изменен принцип приема УПД на приход. Добавили функцию ArticleBySupplierCodeUI для определения артикула по артикулу Супермага,
Для версии 1.49 сп2, можно использовать патч. <xs:element smimport:Function="ArticleBySupplierCodeUI(SMSPECWE.BARCODE, SMDOCUMENTS.CLIENTINN, SMDOCUMENTS.CLIENTKPP, SMSPECTOBACCOWE.MARKCODE, SMSPECOSUCODEWE.OSUCODE)" name="ARTICLE" type="xs:string" /> В перечень функций импорта данных из XML файлов добавлена функция ArticleByAnyCodeUI. Функция аналогична функции ArticleBySupplierCodeUI за исключением того, что в качестве аргументов для определения контрагента используются не данные о его ИНН и КПП, а код клиента Супермаг+. | |
5. | Требование на отбор | SW | SW.XSD | 21.01.2022 | SW_Требование на отбор.xml - В обмене с Тензор не участвует. Возможно использование для решения локальных задач. Один из способов применения - формирование документа на обмен товара (хлеб). | |
6. | Ответ системы СМ+ на факт приемки. (до версии 1.045) | PACKAGE | UICONFIRM.XSD | устарела | 25.06.2021 | |
7. | Ответ системы СМ+ на факт приемки. (от версии 1.046) | PACKAGE | UICONFIRM.XSD | 29.09.21 | нет примера | |
8. | Ответ системы СМ+ на факт приемки. (от версии 1.046) | PACKAGE | UICONFIRM.XSD | 29.09.21 | ||
9. | Ответ системы СМ+ на факт приемки. (от версии 1.046) | PACKAGE | UICONFIRM.XSD | 29.09.21 | нет примера | |
10. | Ответ системы СМ+ на факт приемки. (от версии 1.046) | PACKAGE | UICONFIRM.XSD | 31.03.2022 01.09.2022 01.09.2022 от 1.049 10.10.2022 от 1.049 сп2 | Из схемы исключён элемент <xs:element name="SUPPLIERARTICLE" type="xs:string" /> Поскольку, отсутствие у карточки артикула поставщика, приводило к ошибке: ----- Причина исключения, уровень вложения 1 ----- Для обхода ошибки, есть 2 варианта:
Необязательные патчи для версии 1.047 сп2-3. Ошибка формирования файла ответа REPLY description_Результат приемки: Sm.Post.Filters.Utd.1.047x64.7z Неверный статус УПД при приеме немаркированного товара с расхождением: Схема для версии 1.48. Схема для версии 1.49 и выше. Схема для версии 1.49 сп2 и выше. УПД фильтр. Формат данных XML. Содержание файла ответа с результатом приемки. | |
11. | Квитанция провайдера ЭДО. Протокол обмена дополнен получением технической квитанции в ответ на отсылку файла с результатом приемки. Квитанция имеет смысл подтверждения успешности обработки и пересылки провайдером ЭДО файла подтверждения. | - | - | - | 14.03.2022 | |
12. | УПД на расход. | UD | UD.XSD | UD_1049_1.xsd | 01.06.2022 от 1.048 20.06.2022 от 1.048 30.08.2022 2022 от 1.048 01.09.2022 от 1.049 01.12.2022 от 1.049.1 | Добавлен тег BARCODEEXTERNAL.
В XSD схему почтового объекта УПД на отгрузку добавлен тэг SMDOCTRANSPORT, содержащий информацию транспортного раздела. Данные заполняются при создании документа из соответствующих полей расходной накладной. |
13. | Ответ СБИС на факт приемки покупателем продукции на основании УПД на отгрузку (полученного из СуперМаг Плюс). (от версии 1.049) | <xs:element name="REPLY"> | UDCONFIRM.xsd | 10.10.2022 от 2022 от 1.049 | В рамках версии 1.049 мы ожидаем безоговорочного согласия от клиента ( <RESULT>1</RESULT>). Или полного отказа от приемки <RESULT>2</RESULT> Варианты связанные с согласованием разногласий пока не реализованы. |
Перечень готовых QR кодов для самопроверки, на основании UPD_Natur_Prod.xml → QR коды.docx
...