Оглавление
Отображение дочерних
Введение
Управляющая система (УС) – программа (система), под управлением которой работает программа Mobile BayСуперМаг Мобайл.
Данный документ адресован техническим специалистам (программистам, бизнес-аналитикам) и предназначен для разработки кода в УС для интеграции с программой «Mobile Bay»СуперМаг Мобайл. Помимо данного документа, для интеграции используются результаты предпроектного исследования и XSD-схемы передаваемых объектов.
Объекты обмена
| Оглавление |
|---|
...
Справочник единиц измерения. RFSAMEASUREMENT
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
+
...
Идентификатор элемента справочника
...
DECIMAL[5]
...
11
...
PREC
...
+
...
Точность. Число знаков после запятой
...
DECIMAL[5]
...
3
...
ABBREV
...
+
...
Краткое название ЕИ
...
VARCHAR2[6]
...
шт
...
NAME
...
+
...
Полное название
...
VARCHAR2[20]
...
штука
...
MESTYPE
...
+
...
Признак весовой (мерной) единицы измерения:
1 – весовая;
0 – не весовая
...
CHAR[1]
...
0
...
CODE
...
-
...
Код (ОКЕИ) единицы измерения – Общероссийский классификатор единиц измерения
...
CHAR[3]
...
134
...
CODEISO
...
-
...
Код (ISO) единицы измерения – Международная классификация единиц измерения
...
CHAR[3]
...
KGM
...
Классификатор товаров (иерархия групп). RFSACARDCLASS
1. Классификатор товаров (карточек). SACARDCLASS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
-
...
Идентификатор узла
...
DECIMAL[10]
...
TREE
...
+
...
Код узла
...
STRING
...
NAME
...
+
...
Название
...
STRING
...
FLAGS
...
-
...
Битовая маска
...
DECIMAL[10]
...
CREATOR
...
-
...
Код пользователя, создавшего узел
...
DECIMAL[10]
2. Свойства, специфичные для узлов классификатора карточек. SACARDCLASSAUX
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
Идентификатор узла классификатора товаров
...
CASHLOAD
...
Признак «Грузить в кассу»
...
CASHNOSCALE
...
Если “1”, то грузить артикул в кассу без шкалы
...
CERTREQUIRED
...
Признак «Требуется сертификат»
...
3. Налоговые группы по регионам. SACARDCLASSTAX
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
Идентификатор узла классификатора
...
RGNID
...
Идентификатор региона
...
TAXGROUPID
...
Идентификатор группы налогов
4. Параметры расчета среднесуточной реализации. SACARDCLASSSALERATE
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
Идентификатор узла классификатора
...
DAYOFWEEKDETAIL
...
Идентификатор региона
...
HOLIDAYS
...
Идентификатор группы налогов
...
5. Дополнительные параметры расчета среднесуточной реализации. SACARDCLASSSALERATEOPERS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
Идентификатор узла классификатора
...
DOCTYPE
...
Тип документа
...
OPCODE
...
Идентификатор операции
6. Дополнительные параметры расчета среднесуточной реализации. SACARDCLASSSALERATEHOLIDAYS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
Идентификатор группы классификатора
...
7. Изображения, которые можно назначить группам классификатора товаров. SACARDCLASSIMAGE
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
Идентификатор группы классификатора
...
8. SMTIMELIMITSALES
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
IDCARDCLASS
...
DAYTYPELIMIT
...
TIMELIMITFROM1
...
TIMELIMITFROM2
...
Классификатор мест хранения (иерархия). RFSASTORECLASS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
Идентификатор
...
Классификатор поставщиков (иерархия). RFSASUPPLIERCLASS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
Идентификатор узла классификатора
...
TREE
...
Код узла дерева
...
NAME
...
Имя (название) узла
...
FLAGS
...
Битовая маска:
<0> – разряд не используется;
<1> – разряд не используется;
<2> – разряд:
0 – ввод новых элементов разрешен;
1 – ввод новых элементов запрещен.
Прим.: ввод новых дочерних узлов разрешен всегда.
...
CREATOR
...
-
...
Идентификатор пользователя, создавшего данный узел классификатора
Классификатор клиентов (иерархия). RFSACLIENTCLASS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
Идентификатор узла классификатора
...
TREE
...
Код узла дерева
...
NAME
...
Имя (название) узла
...
FLAGS
...
Битовая маска: <0> – разряд не используется;
<1> – разряд не используется;
<2> – разряд:
0 – ввод новых элементов разрешен; 1 – ввод новых элементов запрещен. Прим.: ввод новых дочерних узлов разрешен всегда.
...
CREATOR
...
Идентификатор пользователя, создавшего данный узел классификатора
Классификатор алкогольной продукции (иерархия). RFSASPIRITCODE
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
Идентификатор (первый ключ справочника)
...
CODE
...
Код группы
...
TITLE
...
Название группы
...
ISBEER
...
1, если группа относится к пиву или пивным напиткам
...
POSITION
...
Номер по порядку (для сортировки групп внутри отчета)
Карточки товаров. CD (карточка товара)
1. Заголовок документа (карточки складского учета). SMCARD
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ARTICLE
...
+
...
Артикул
...
STRING
...
ACCEPTED
...
-
...
Статус
...
DECIMAL
...
ALTNAME1
...
-
...
BASE64BINARY
...
ALTNAME2
...
-
...
BASE64BINARY
...
BORNIN
...
+
...
Код источника создания документа. Создается Mobile Bay в момент отправки
...
BASE64BINARY
...
2. Свойства артикула. SMCARDPROPERTIES
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ARTICLE
...
+
...
Артикул
...
STRING
...
PROPID
...
+
...
Идентификатор свойства
...
STRING
...
PROPVAL
...
+
...
Значение свойства
...
STRING
3. Параметры расчета среднесуточной реализации. SMCARDSALERATE
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ARTICLE
...
+
...
Артикул
...
STRING
...
DAYOFWEEKDETAIL
...
-
...
1, если в ходе расчета нужно получить не только общее значение ССР, но и детальные значения по дням недели
...
STRING
...
HOLIDAYS
...
-
...
Учитывать ли в расчете выходные дни
...
DECIMAL
...
4. Дополнительные параметры расчета среднесуточной реализации. SMCARDSALERATEOPERS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ARTICLE
...
+
...
Артикул
...
STRING
...
DOCTYPE
...
+
...
Тип документа
...
STRING
...
OPCODE
...
+
...
Идентификатор операции
...
DECIMAL
5. Изображения, которые можно назначить артикулам. SMCARDIMAGE
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ARTICLE
...
+
...
Артикул
...
STRING
...
CHECKSUM
...
-
...
Контрольная сумма
...
DECIMAL
...
DRAWINGIMAGE
...
-
...
Уменьшенное изображение товара
...
BASE64BINARY
...
6. История налоговых групп товаров. SMCARDTAX
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ARTICLE
...
+
...
Артикул
...
STRING
...
RGNID
...
-
...
Идентификатор региона
...
DECIMAL
...
DATEFROM
...
+
...
Дата начала действия группы ставок налога на данный товар
...
DATETIME
...
7. Компоненты составных артикулов. SMCOMPLEXARTICLES
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
COMPLEXARTICLE
...
+
...
Составной артикул
...
STRING
...
ARTICLE
...
+
...
Артикул
...
STRING
...
AMOUNT
...
+
...
Количество ARTICLE в COMPLEXARTICLE в единице измерения ARTICLE
...
DECIMAL
...
8. Таблица состава карточек ингредиентов. SMCARDINGREDIENT
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ARTICLE
...
+
...
Артикул
...
STRING
...
ARTSRC
...
+
...
Исходный артикул: может быть сопоставлен только одному ингредиенту, контролируется уникальным индексом
...
STRING
...
RATE
...
+
...
Количество ингредиента, получаемого из единицы исходного артикула
...
DECIMAL
9. Скидки на количество товара. SMDISCQUANTITY
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ARTICLE
...
+
...
Артикул
...
STRING
...
PRICEID
...
+
...
Идентификатор вида цены (прайс-листа)
...
DECIMAL
...
QUANTITY
...
+
...
Количество, начиная с которого действует скидка; если 0, то скидка применяется независимо от количества
...
DECIMAL
...
10. Пределы скидок. SMDISCLIMITS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ARTICLE
...
+
...
Артикул
...
STRING
...
PRICEID
...
+
...
Идентификатор вида цены (прайс-листа)
...
DECIMAL
...
PERCENT
...
+
...
Максимальный % скидки: 0 – скидки запрещены; 100 – скидки не ограничены: переопределяет значение для группы классификатора; при отсутствии записи предел скидки определяется группой классификатора
...
DECIMAL
11. SMUSETIMEDISCARTICLE
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ARTICLE
...
+
...
Артикул
...
STRING
...
PRICEID
...
+
...
Идентификатор вида цены (прайс-листа)
...
DECIMAL
...
PERCENT
...
+
...
DECIMAL
12. Альтернативные единицы измерения. SMALTUNITS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ARTICLE
...
+
...
Артикул
...
STRING
...
ALTUNIT
...
+
...
Альтернативная единица измерения
...
DECIMAL
...
13. Состав артикула IDT00001099. Форма 3-Торг Украина. SMCARDCOMPOSITION
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
COMPLEXARTICLE
...
+
...
Артикул, для которого описывается состав
...
STRING
...
ARTICLE
...
+
...
Артикул
...
STRING
...
14. Производители / импортёры карточки складского учета. SMCARDPRODUCERS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ARTICLE
...
+
...
Артикул
...
STRING
...
PRODUCERID
...
+
...
Идентификатор производителя/импортера
...
DECIMAL
...
15. SMARTICLEPACKS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ARTICLE
...
+
...
Артикул
...
STRING
...
PACKID
...
+
...
DECIMAL
...
Карточки товаров. IC (вложение для карточки товара). SMCARDBLOBFILES
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ARTICLE
...
Артикул товара
...
STRING
...
INSERTIONID
...
Идентификатор вложения
...
DECIMAL
...
FILENAME
...
Имя файла
...
THECONTENTS
...
Файл вложения (в виде потока байтов)
...
BASE64BINARY
...
TITLE
...
Описание вложения
...
STRING
Карточки товаров. ВС (штрихкод). SVSTOREUNITS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
Штриховой код
...
STRING
...
ARTICLE
...
Артикул
...
STRING
...
BARCODETYPE
...
Тип штрихкода
...
BOXID
...
Идентификатор короба
...
DECIMAL
...
FACEQUANTITY
...
Номинальное количество
...
DECIMAL
...
Карточки товаров. GL (предельные уровни складских запасов). SMSTOCKLEVELS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ARTICLE
...
Артикул товара
...
STORELOC
...
Место хранения
...
Максимальный уровень:
NULL – без ограничений;
0 – не везти товар со склада.
Это максимальные возможности магазина по хранению товара (например, большее количество не уместится в холодильнике)
...
Скорость продажи товаров = (единица измерения артикула) / (день):
0 – не установлена.
При расчете скорости продаж учитываются только действительно продажи, но не расходы типа внутренних перемещений или возвратов поставщику
...
Карточки товаров. AM (привязка карточек к группам классификатора номенклатур). SMCARDMATRIX
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
IDMATRIX
...
Идентификатор группы классификатора номенклатур
...
ARTICLE
...
Артикул
Карточки товаров. Описание дополнительных характеристик товаров.
1. RFSACARDPROPDEF
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
Идентификатор дополнительной характеристики
...
DATATYPE
...
Тип данных
...
2. SACARDPROPDEFVAL
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
VALID
...
Места хранения (магазины, склады). SH
1. Справочник мест хранения. SMSTORELOCATIONS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
Идентификатор места хранения
...
ACCEPTED
...
«Оприходованность»
...
2. Дополнительные характеристики контрагента. SMCLIENTPROPERTIES
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
IDCLIENT
...
Индекс клиента
...
PROPID
...
Идентификатор
...
3. Привязка видов цен к местам хранения. SMLOCPRICES
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
LOCID
...
Идентификатор хранилища
...
PRICETYPE
...
Идентификатор вида цены
...
4. Назначение номенклатуры производства месту хранения. SMASSORTMATRIXPRODLOC
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
STORELOC
...
Код места хранения
...
IDMATRIX
...
Код номенклатуры производства
5. SMASSORTMATRIXPRODZONE
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
STORELOC
...
IDMATRIX
...
6. Список магазинов, обслуживаемых локальным складом. SMSERVEDSHOP
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
LOCALSTOREID
...
Идентификатор локального склада
...
SERVEDSHOPID
...
Идентификатор места поставки
Контрагенты. CL
1. Данные о контрагенте. SMCLIENTINFO
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
Идентификатор клиента
...
ACCEPTED
...
Статус
...
Интервал усреднения для алгоритма.
Если данный контрагент не является партнером, то значение поля игнорируется
...
2. Дополнительные характеристики контрагента. SMCLIENTPROPERTIES
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
Индекс клиента
...
3. Банковские счета контрагента. SMCLIENTBANKS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
Идентификатор контрагента
...
4. Клиенты. SMCLIENTS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
Идентификатор клиента
...
5. Поставщики. SMSUPPLIERS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
Идентификатор поставщика
...
6. Адрес контрагента. SMCLIENTADDRS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
Идентификатор клиента
...
7. Центральные склады партнеров. SMPARTNERLOCS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
Идентификатор партнера
...
8. Места хранения, назначенные собственным контрагентам. SMOWNCLIENTLOCS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
Идентификатор собственного контрагента
...
9. Группы товаров, назначенные собственным контрагентам для указанного места хранения. SMOWNCLIENTCARDCLASS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
Код собственного контрагента
...
10. Привязки распределений цен поставки по пунктам шкалы к поставщикам. SMSCALEINCOSTSUPPL
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID поставщика
...
11. Места хранения филиалов. SMSUBSIDARYLOCS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
Клиент (место хранения или партнер)
...
Структура магазина (цеха). PZ
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
Идентификатор клиента
...
4. Клиенты. SMCLIENTS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
Идентификатор клиента
...
4. Клиенты. SMCLIENTS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
Идентификатор клиента
...
4. Клиенты. SMCLIENTS
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
Идентификатор клиента
...
Структура Магазина (цеха). PZ
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
+ (-1)
...
Идентификатор узла
...
NUMBER [10]
...
TREE
...
+
...
Код узла
...
VARCHAR2 [100]
...
NAME
...
+
...
Название
...
VARCHAR2 [255]
...
FLAGS
...
+ (0)
...
Битовая маска
...
NUMBER [10]
...
CREATOR
...
+ (-2)
...
Код пользователя, создавшего узел
...
NUMBER [10]
Виды цен. RFSMPRICETYPES
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
+ (-1)
...
Идентификатор узла
...
NUMBER [10]
...
TREE
...
+
...
Код узла
...
VARCHAR2 [100]
...
NAME
...
+
...
Название
...
VARCHAR2 [255]
...
FLAGS
...
+ (0)
...
Битовая маска
...
NUMBER [10]
...
CREATOR
...
+ (-2)
...
Код пользователя, создавшего узел
...
NUMBER [10]
Налоги, ставки, налоговые группы. RFSMTAXES
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
+ (-1)
...
Идентификатор узла
...
NUMBER [10]
...
TREE
...
+
...
Код узла
...
VARCHAR2 [100]
...
NAME
...
+
...
Название
...
VARCHAR2 [255]
...
FLAGS
...
+ (0)
...
Битовая маска
...
NUMBER [10]
...
CREATOR
...
+ (-2)
...
Код пользователя, создавшего узел
...
NUMBER [10]
Справочник стран. RFSACOUNTRIES
...
Элемент
...
Обязательность для «Mobile Bay»
...
Описание
...
Формат данных в «Mobile Bay»
...
Пример
...
ID
...
+ (-1)
...
Идентификатор узла
...
NUMBER [10]
...
TREE
...
+
...
Код узла
...
VARCHAR2 [100]
...
NAME
...
+
...
Название
...
VARCHAR2 [255]
...
FLAGS
...
+ (0)
...
Битовая маска
...
NUMBER [10]
...
CREATOR
...
+ (-2)
...
Код пользователя, создавшего узел
...
Во избежание терминологической путаницы, в дальнейшем под СуперМаг Мобайл понимается полнофункциональная система, которая используется, прежде всего, для поддержки бизнес-процессов ТСД, и где в инфраструктуре программного обеспечения торгового предприятия в качестве бэк-офиса используется 1С или другая бэк-офисная система.
Под стандартной интеграцией подразумевается такой обмен между СуперМаг Мобайл и 1С, при котором преобразование информации из представления СуперМаг Мобайл в представление 1С и наоборот выполняется штатными инструментами 1С. В тех случаях, когда этого механизма недостаточно, необходимо привлечение сотрудников сопровождения из нашей компании для дополнительных действий по настройке программ СуперМаг Мобайл.
Для обмена данными с 1С используется почтовый модуль с XML-фильтром.
Стандартный протокол обмена выглядит следующим образом. Каждый объект данных СуперМаг Мобайл описывается XSD-файлом. Стандартный набор таких файлов можно получить утилитой Создание схемы данных для XML-фильтра административного модуля:
Результатом работы утилиты являются XSD-файлы с описанием структуры XML-файлов:
Название файлов соответствует типам объектов СуперМаг Мобайл, например, WI – приходная накладная.
Посмотреть структуру объектов можно с помощью программы Редактор XML-схем из стандартной поставки СуперМаг Мобайл, которая позволяет описать схему почтового объекта в терминах понятных системе:
Если описанный таким образом объект принимается в первый раз, он будет принят в соответствии со схемой. Отсутствующие в схеме поля объекта после помещения его в базу данных будут либо пустыми, либо примут значение по умолчанию. Поля, которые в схеме присутствуют, но отсутствуют в XML-объекте, будут иметь значение в соответствии со схемой (NULL или DEFAULT). Если объект приходит во второй раз (то есть, он уже есть в БД), то поля, отсутствующие в схеме, но присутствующие в базе данных, не изменят своего значения. Поля, описанные в схеме, но отсутствующие в XML-объекте, будут трактоваться как пустое значение и будут обновлены в базе данных.
Опционально реализован вариант приема почтового объекта с произвольным содержанием, при котором все поля, отсутствующие в почтовом объекте и имеющиеся в стандартной схеме объекта, считаются именно отсутствующими, и их значения при обновлении объекта в базе данных не изменяются. Для того чтобы включить режим произвольного состава XML-объекта, надо в настройках почтового модуля отметить следующий флажок:
Этот режим работы XML-протокола имеет следующие ограничения:
1) В XML-объекте должны быть заполнены обязательные поля: как правило, это ключевые поля, которые нужны для идентификации объекта.
В одном XML-файле объекты одного типа должны иметь одну и ту же структуру. Или иначе: два объекта одного типа с разным набором полей должны передаваться в разных файлах. Такое ограничение связано с тем, что при приеме XML-файла фильтр почтового модуля фактически воссоздает схему объекта по содержанию файла и в дальнейшем использует эту схему при обработке именно этого файла. Такое же требование одинаковости структуры предъявляется к компонентам сложного объекта. То есть, его части должны иметь одинаковую структуру (например, в спецификации документа все строки должны иметь одинаковый набор полей). Опция позволяет получать обновления объектов в тех случаях, когда сторонняя система не имеет возможности передавать полный набор данных об объекте при его изменении.
Как правило, данных, которые предусмотрены приведенными выше схемами, достаточно, чтобы в 1С можно было принять XML-файлы через настраиваемые интерфейсы 1С.
Для формирования XML-файлов и передачи их в 1С, необходимо настроить почтовый модуль, то есть описать в нем каталоги обмена с 1С:
Затем нужно описать правила рассылки, то есть указать, что отсылать и при каком событии:
На этом стандартная интеграция завершена.
Примечание. Перечень данных, которые передаются из 1С в СуперМаг Мобайл, и из СуперМаг Мобайл в 1С (например, классификатор, товары, информация о заказах и т.д.), определяется перечнем бизнес-процессов ТСД. Правила рассылки настраиваются, исходя из такого перечня. Для тех клиентов, которые не приемлют файловый обмен и настаивают на использовании WEB-сервисов, можно предлагать сервер обмена данными, который имеет аналогичный функционал, но не имеет опыта многолетней эксплуатации.
Симметричный и несимметричный обмен при использовании XML-фильтра
При описании XSD-схемы почтового объекта в качестве полей объекта можно использовать функции, с помощью которых в поле добавляется значение, отсутствующее в исходном объекте, например, название артикула в строке спецификации документа.
Использование функций в описании объекта приводит к тому, что такое описание не может использоваться как для отсылки, так и для приема объекта в равной степени.
В редакторе присутствует понятие назначения файла схемы описания почтового объекта:
- для симметричного обмена, для принятия данных, то есть для импорта,
- и для отсылки данных, то есть для экспорта.
Симметричный обмен – это такой обмен, при котором схема почтового объекта одинакова как при его отсылке, так и при его приеме. При несимметричном обмене структура одного и того же объекта при отсылке и при приеме отличается.
В программе Редактор XML-схем на экране описания схемы объекта указаны элементы для выбора назначения схемы: Симметричный обмен/Импорт из XML/Экспорт в XML:
Тип или назначение схемы прописывается в заголовке XSD-файла, что позволяет помещать файлы разных типов в один каталог и корректно использовать их как при приеме, так и при отсылке данных.
Сохранено ограничение, согласно которому одному типу почтового объекта может соответствовать только один файл описания схемы объекта при обмене по одному направлению. Это означает, что при несимметричном обмене какими-либо объектами, объект может только отсылаться или только приниматься, то есть нельзя описать для одного и того же объекта разные схемы для приема и отсылки. Например: при обмене с поставщиком контрагенту можно отсылать заказы с дополнительными данными, такими как добавление артикулов контрагента в спецификацию документа. От контрагента при этом можно получать накладные поставщика, которые не содержат номер документа торговой системы. При этом нельзя одновременно получать заказ от поставщика или отсылать накладную поставщика тому же контрагенту по тому же направлению обмена.
Файлы описания схемы для симметричного обмена могут содержать только стандартные поля почтового объекта и простые поля, то есть такие поля, значения которых при приеме игнорируются, а при отсылке заполняются значением по умолчанию.
Объекты обмена
| Отображение дочерних |
|---|