...
Внимание!Идентификатор участника обмена который устанавливается в документе "УПД на приход", и "Накладная поставщика".Не передается в явном виде от провайдера электронного документооборота. В настоящее время для его модификации следует изменить схему объекта 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
...