...
Схемы объектов используемые в процессе обмена (будут актуализироваться, изменяться, предлагаться варианты).
№ п.п. | Название объекта. | Тип объекта в СМ+ | Название файла. схемы | Файл схемы. (!эти файлы берем себе!) | Дата модификации. | Пример файла 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. |
SW_Требование на отбор.xml - В обмене с Тензор не участвует. Возможно использование для решения локальных задач. Один из способов применения - формирование документа на обмен товара (хлеб).
PACKAGE
УПД фильтр. Формат данных XML. Содержание файла ответа с результатом приемки.
В файл ответа с результатом приемки добавлен тэг CREATEDATWI, который содержит дату приходной накладной. Например:
<CREATEDATWI>2022-09-27</CREATEDATWI>
Дата приходной накладной соответствует понятию «дата приема товара» и может не совпадать с датой УПД на приход.
В файл ответа также добавлен тэг SUPPLIERCORRECTINVOICE. Тэг содержит номер коррекции, на которую сформирован ответ. Например:
<SUPPLIERCORRECTINVOICE>1</SUPPLIERCORRECTINVOICE>
Добавлен тег BARCODEEXTERNAL.
- На закладке "Штрихкоды", для одного ШК - атрибут "Обмен с EDI", именно этот ШК будет участвовать в отсылке контрагенту. Алгоритм выбора ШК для отправки клиенту работает по следующему правилу: По умолчанию передается ШК контрагента, заранее заявленный в системе СМ+ (раздел контрагенты, закладка артикулы поставщика), если список артикулов и ШК у поставщика пуст. То передается ШК из раздела - карточка товара, который имеет признак - "Использовать при с EDI обмене". Если ни один штриховой код не отмечен, штриховой код будет подобран по правилу "первый попавшийся".
- .......
В XSD схему почтового объекта УПД на отгрузку добавлен тэг SMDOCTRANSPORT, содержащий информацию транспортного раздела.
Данные заполняются при создании документа из соответствующих полей расходной накладной.
Ответ СБИС на факт приемки покупателем продукции на основании УПД на отгрузку (полученного из СуперМаг Плюс). (от версии 1.049)
В рамках версии 1.049 мы ожидаем безоговорочного согласия от клиента ( <RESULT>1</RESULT>).
Или полного отказа от приемки <RESULT>2</RESULT>
Варианты связанные с согласованием разногласий пока не реализованы.
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
...