Отображение дочерних
- актуальная версия СуперМаг Плюс начиная с 30.10.2022г., определена как 1.049.1 сп1.
Работа с Честным знаком из Супермаг Плюс построена по принципу «работа из одного окна», т.е. сотрудникам, которые работают в Торговой системе и должны взаимодействовать с государственными системами (ЕГАИС, Честный знак) не нужно заходить в несколько программ. Все необходимые документы загружаются в Супермаг Плюс и появляется возможность создавать учетные документы на основании документов ФГИС. Дополнительная возможность сопоставлять номенклатуру ФГИС и учетную номенклатуру позволяет минимизировать ошибки, связанные с человеческим фактором.
...
Схемы объектов используемые в процессе обмена (будут актуализироваться, изменяться, предлагаться варианты).
Файл схемы.
(!эти файлы берем себе!)
Пример файла XML.
Комментарий.
OR.XSD
25.06.2021
21.01.2022
210625120745_12480_2_1.XML.1624601281.629194.xml
OE
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-документа не привел к успеху, то из штрихового кода удаляются лидирующие нули и выполняется повторный поиск артикула.
В функцию ArticleByBarcodeUI внесено такое же изменение, как в функцию ArticleByBarcode, а также добавлена возможность распознавать артикул по коду ОСУ. Для этого в перечень параметров функции добавлено поле osuCode.
(теперь задаётся три аргумента - штриховой код, код КИЗ, код ОСУ)
Изменен принцип приема УПД на приход.
Все наши попытки "исказить" документ при приеме, для для случая когда у поставщика 2+2=5 - отменены.
Документ УПД принимается в том виде, в котором его поставщик сформировал.
Добавили функцию 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 за исключением того, что в качестве аргументов для определения контрагента используются не данные о его ИНН и КПП, а код клиента Супермаг+.
SW_Требование на отбор.xml - В обмене с Тензор не участвует. Возможно использование для решения локальных задач. Один из способов применения - формирование документа на обмен товара (хлеб).
устарела
UICONFIRM.XSD
PACKAGE
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 варианта:
- Убрать из схемы упоминание тега SUPPLIERARTICLE
- Всем артикулам определить "артикул поставщика".
Необязательные патчи для версии 1.047 сп2-3.
Ошибка формирования файла ответа REPLY description_Результат приемки:
Sm.Post.Filters.Utd.1.047x64.7z
Неверный статус УПД при приеме немаркированного товара с расхождением:
Схема для версии 1.48.Схема для версии 1.49 и выше.
Схема для версии 1.49 сп2 и выше.
УПД фильтр. Формат данных XML. Содержание файла ответа с результатом приемки.
В файл ответа с результатом приемки добавлен тэг CREATEDATWI, который содержит дату приходной накладной. Например:
<CREATEDATWI>2022-09-27</CREATEDATWI>
Дата приходной накладной соответствует понятию «дата приема товара» и может не совпадать с датой УПД на приход.
В файл ответа также добавлен тэг SUPPLIERCORRECTINVOICE. Тэг содержит номер коррекции, на которую сформирован ответ. Например:
<SUPPLIERCORRECTINVOICE>1</SUPPLIERCORRECTINVOICE>
APPERAK_9836662436361_9813564954089_e9b4b64f_eae3_4aa1_8179_ef1b9af9e947.XML
Схема. Для использования переименовать в UD.XSD
UD_1049_1.xsd01.06.2022 от 1.048
20.06.2022 от 1.048
30.08.2022 от 1.048
01.09.2022 от 1.049
01.12.2022 от 1.049.1
Добавлен тег BARCODEEXTERNAL.
В XSD схему почтового объекта УПД на отгрузку добавлен тэг SMDOCTRANSPORT, содержащий информацию транспортного раздела.
Данные заполняются при создании документа из соответствующих полей расходной накладной.
Ответ СБИС на факт приемки покупателем продукции на основании УПД на отгрузку (полученного из СуперМаг Плюс). (от версии 1.049)
В рамках версии 1.049 мы ожидаем безоговорочного согласия от клиента ( <RESULT>1</RESULT>).
Или полного отказа от приемки <RESULT>2</RESULT>
Варианты связанные с согласованием разногласий пока не реализованы.
№ п.п. | Название объекта. | Тип объекта в СМ+ | Название файла. схемы | Файл схемы. (!эти файлы берем себе!) | Дата модификации. | Пример файла 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" /> | ||||||||||||
UI | UI.XSD | 25.09.2024 от 1.054 сп3 | Создана новая функция ClientByAnyGLNINN для обработки XML файлов при импорте документов. Функция возвращает код контрагента по его ИНН и КПП или GLN, в зависимости от того, что встретится во входном файле. Создана функция GenerateDocUIDateAnyGLNINN для обработки XML файлов при импорте документов. Функция генерирует номер документа Супермаг+ с использованием ИНН и КПП или GLN контрагента, в зависимости от того, что встретится во входном файле, а также КПП места хранения или GLN места хранения, в зависимости от того, что встретится во входном файле, и с контролем даты документа. Атрибуты функции: locationKpp КПП места хранения Примечание: контроль даты документа необходим в тех случаях, когда поставщик начинает нумерацию своих документов заново с некоторой даты, например, с начала года. | ||||||||||||
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" /> | ||||||||||||
UD | UD.XSD | 11.07.2024 от 1.054 | Расширено количество передаваемых данных. | 9||||||||||||
UD | UD. | Ответ СБИС на факт приемки покупателем продукции на основании УПД на отгрузку (полученного из СуперМаг Плюс). (от версии 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 | XSD | 25.02.2025 от 1.056 | Схема адаптирована для версии 1.055-1.056 | ||
UD | UD.XSD | 03.07.2025 от 1.057 сп 1 | Функция экспорта «ClientInfo» Создана функция для экспорта данных контрагента при создании почтовых пакетов в формате XML. Функция предназначена для документов и возвращает данные указанного контрагента, а при его отсутствии в документе - данные другого контрагента, который выбран в качестве дублирующего. Для УПД на отгрузку описание в файле UD.xsd полного набора полей с функцией «ClientInfo» может выглядеть следующим образом: <xs:element smexport:Function="ClientInfo(SMDOCUD.SHIPPER, SMDOCUD.OURSELFCLIENT).GLN" minOccurs="0" name="SHIPERGLN" type="xs:string" /> <xs:element smexport:Function="ClientInfo(SMDOCUD.SHIPPER, SMDOCUD.OURSELFCLIENT).INN" minOccurs="0" name="SHIPERINN" type="xs:string" /> <xs:element smexport:Function="ClientInfo(SMDOCUD.SHIPPER, SMDOCUD.OURSELFCLIENT).KPP" minOccurs="0" name="SHIPERKPP" type="xs:string" /> <xs:element smexport:Function="ClientInfo(SMDOCUD.SHIPPER, SMDOCUD.OURSELFCLIENT).Address" minOccurs="0" name=" NAMESIGNATORYSHIPERADDRESS" type="xs:string " minOccurs="0" /> …. |
2. Устарела.....бедует удалена...Схемы объектов используемые в процессе обмена (будут актуализироваться, изменяться, предлагаться варианты).
<xs:element smexport:Function="ClientInfo(SMDOCUD.SHIPPER, SMDOCUD.OURSELFCLIENT).FAddress" minOccurs="0" name="SHIPERFADDRESS" type="xs:string" /> <xs:element smexport:Function="ClientInfo(SMDOCUD.CONSIGNEE, SMDOCUMENTS.CLIENTINDEX).GLN" minOccurs="0" name="CONSIGNEEGLN" type="xs:string" /> <xs:element smexport:Function="ClientInfo(SMDOCUD.CONSIGNEE, SMDOCUMENTS.CLIENTINDEX).INN" minOccurs="0" name="CONSIGNEEINN" type="xs:string" /> <xs:element smexport:Function="ClientInfo(SMDOCUD.CONSIGNEE, SMDOCUMENTS.CLIENTINDEX).KPP" minOccurs="0" name="CONSIGNEEKPP" type="xs:string" /> <xs:element smexport:Function="ClientInfo(SMDOCUD.CONSIGNEE, SMDOCUMENTS.CLIENTINDEX).Address" minOccurs="0" name="CONSIGNEEADDRESS" type="xs:string" /> <xs:element smexport:Function="ClientInfo(SMDOCUD.CONSIGNEE, SMDOCUMENTS.CLIENTINDEX).FAddress" minOccurs="0" name="CONSIGNEEFADDRESS" type="xs:string" /> | ||||||
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" добавить тэги: | ||
Перечень готовых QR кодов для самопроверки, на основании UPD_Natur_Prod.xml → QR коды.docx
2. Требования для клиентов для подключения Интеграции СМ+
...