Интерфейс интеграции MobileBay с управляющей системой

Управляющая система (УС) – программа (система), под управлением которой работает программа «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
BASETYPE	-		DECIMAL[5]
RATEPARENT	-		DECIMAL
UNITNAME	-		VARCHAR2[20]
IDPARENT	-		DECIMAL[5]

Классификатор товаров (иерархия групп). RFSACARDCLASS

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
ID	-	Идентификатор узла	DECIMAL[10]
TREE	+	Код узла	STRING
NAME	+	Название	STRING
FLAGS	-	Битовая маска	DECIMAL[10]
CREATOR	-	Код пользователя, создавшего узел	DECIMAL[10]

Классификатор мест хранения (иерархия). RFSASTORECLASS

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
ID	+	Идентификатор	STRING
TREE	+	Код узла	STRING
NAME	-	Наименование узла	DECIMAL
FLAGS	-	Флаги	DECIMAL
CREATOR	-	Код пользователя, создавшего ветку классификатора	DECIMAL

Классификатор поставщиков (иерархия). RFSASUPPLIERCLASS

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
ID	-	Идентификатор узла классификатора	DECIMAL
TREE	+	Код узла дерева	STRING
NAME	+	Имя (название) узла	STRING
FLAGS	-	Битовая маска: <0> – разряд не используется; <1> – разряд не используется; <2> – разряд: 0 – ввод новых элементов разрешен; 1 – ввод новых элементов запрещен. Прим.: ввод новых дочерних узлов разрешен всегда.	DECIMAL
CREATOR	-	Идентификатор пользователя, создавшего данный узел классификатора	DECIMAL

Классификатор клиентов (иерархия). RFSACLIENTCLASS

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
ID	-	Идентификатор узла классификатора	DECIMAL
TREE	+	Код узла дерева	STRING
NAME	+	Имя (название) узла	STRING
FLAGS	-	Битовая маска: <0> – разряд не используется; <1> – разряд не используется; <2> – разряд: 0 – ввод новых элементов разрешен; 1 – ввод новых элементов запрещен. Прим.: ввод новых дочерних узлов разрешен всегда.	DECIMAL
CREATOR	-	Идентификатор пользователя, создавшего данный узел классификатора	DECIMAL

Классификатор алкогольной продукции (иерархия). RFSASPIRITCODE

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
ID	+	Идентификатор (первый ключ справочника)	DECIMAL
CODE	+	Код группы	STRING
TITLE	+	Название группы	DECIMAL
ISBEER	-	1, если группа относится к пиву или пивным напиткам	STRING
POSITION	-	Номер по порядку (для сортировки групп внутри отчета)	DECIMAL

Карточки товаров. CD (карточка товара)

1. Заголовок документа (карточки складского учета). SMCARD

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
ARTICLE	+	Артикул	STRING
ACCEPTED	-	Статус	DECIMAL
ALTNAME1	-	-	BASE64BINARY
ALTNAME2	-	-	BASE64BINARY
BORNIN	+	Код источника создания документа. Создается Mobile Bay в момент отправки	BASE64BINARY
CARDCOMMENT	-	Комментарий	STRING
CASHLOAD	-	Признак «грузить в кассу»	STRING
COUNTRY	-	Страна происхождения, если NULL, то РФ	STRING
CUTPRICEDAYS	-	Срок уценки в днях, 0 – автоматическая уценка не производится	DECIMAL
DATASUBTYPE	-	-	DECIMAL
DATATYPE	-	Тип карточки	DECIMAL
DEADLINE	-	Срок реализации в днях, NULL – не ограничен	DECIMAL
FLAGS	-	Битовая маска	DECIMAL
GLOBALARTICLE	-	Артикул центрального офиса	STRING
HEIGHT	-	Высота единицы товара в ед. изм.	DECIMAL
ICING	-	% глазури	DECIMAL
IDCLASS	+	Идентификатор узла классификатора товаров, к которому приписан данный артикул	DECIMAL
IDCODETNVED	-	-	DECIMAL
IDLOSSESGROUP	-	Идентификатор классификатора норм естественной убыли	DECIMAL
IDMARKETINGGROUP	-	Идентификатор классификатора маркетинговых групп	DECIMAL
IDMEASDIM	-	Ед. изм. для линейных размеров	DECIMAL
IDMEASUREMENT	+	Идентификатор единицы измерения	DECIMAL
IDMEASWEIGHT	-	Ед. изм. для веса	DECIMAL
IDONETORG	-	Идентификатор классификатора 1-торг	DECIMAL
IDSCALE	-	Идентификатор шкалы	DECIMAL
IDSPIRITCODE	-	Идентификатор классификатора алкогольной продукции	DECIMAL
IDTHREETORG	-	Идентификатор классификатора 3-торг	DECIMAL
LENGTH	-	Длина единицы товара в ед. изм.	DECIMAL
LOSSES	-	% естественной убыли	DECIMAL
MESABBREV	-	Синоним названия аббревиатуры единицы измерения	STRING
MESNAME	-	Синоним названия единицы измерения	STRING
MINPROFIT	-	Граница рентабельности	DECIMAL
NAME	+	Название карточки	STRING
NOMINALVALUE	-	-	DECIMAL
QUANTITYDEVIATION	-	Максимальное отклонение количества между фактическим и заказанным	DECIMAL
RECEIPTOK	-	Признак «Разрешен прием» (он же – «Разрешен к заказу у поставщика»)	STRING
SCALELOAD	-	Признак «Грузить в весы»	STRING
SCRAP	-	% технологических отходов	DECIMAL
SHORTNAME	-	Краткое название товара, например, для загрузки в оборудование, если NULL, то использовать NAME	STRING
STATEREGULATION	-	Вид государственного регулирования (LEGISLATION_BYELORUSSIA)	DECIMAL
STORAGE	-	Условия хранения	DECIMAL
SUBARTICLE	-	Субартикул	STRING
SUPPLYPRICEPERCENTM	-	Допустимый % занижения цены в приходе от цены последней поставки	DECIMAL
SUPPLYPRICEPERCENTP	-	Допустимый % превышения цены в приходе от цены последней поставки	DECIMAL
USETIME	-	Срок годности артикула	DECIMAL
USETIMEDIM	-	Размерность срока годности артикула	DECIMAL
WASTE	-	% нормы отходов	DECIMAL
WEIGHT	-	Вес единицы товара в ед. изм.	DECIMAL
WIDTH	-	Ширина единицы товара в ед. изм.	DECIMAL

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
INCLUDEDAYS	-	Дни, которые рассматриваются алгоритмом расчета среднесуточной реализации	STRING
MANUALTRACKING	-	1, если артикулы данной группы нужно исключать из автоматического расчета среднесуточной реализации	STRING
SALERATECALC	-	Алгоритм автоматического расчета среднесуточной реализации	DECIMAL
SALERATERANGE	-	Период расчета: последние SALERATERANGE дней (без учета текущего дня)	DECIMAL
SPECIALDAYS	-	Учитывать ли в расчете особые дни	DECIMAL
WITHMARKETING	-	-	STRING

4. Дополнительные параметры расчета среднесуточной реализации. SMCARDSALERATEOPERS

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
ARTICLE	+	Артикул	STRING
DOCTYPE	+	Тип документа	STRING
OPCODE	+	Идентификатор операции	DECIMAL

5. Изображения, которые можно назначить артикулам. SMCARDIMAGE

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
ARTICLE	+	Артикул	STRING
CHECKSUM	-	Контрольная сумма	DECIMAL
DRAWINGIMAGE	-	Уменьшенное изображение товара	BASE64BINARY
FILENAME	-	Название файла вложения	STRING
THEIMAGE	-	Изображение товара (в виде потока байтов)	BASE64BINARY

6. История налоговых групп товаров. SMCARDTAX

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
ARTICLE	+	Артикул	STRING
RGNID	-	Идентификатор региона	DECIMAL
DATEFROM	+	Дата начала действия группы ставок налога на данный товар	DATETIME
DATETO	+	Дата окончания действия группы ставок налога на данный товар	DATETIME
TAXGROUPID	+	Идентификатор группы ставок налогов	DECIMAL

7. Компоненты составных артикулов. SMCOMPLEXARTICLES

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
COMPLEXARTICLE	+	Составной артикул	STRING
ARTICLE	+	Артикул	STRING
AMOUNT	+	Количество ARTICLE в COMPLEXARTICLE в единице измерения ARTICLE	DECIMAL
ISDEPENDENT	-	Подчинённый компонент: не участвует в заказе	STRING
PRICEPERCENT	+	Процент цены	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
PERCENT	+	Скидка в %; 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
USETIME	+	-	DECIMAL
PERCENT	+	-	DECIMAL

12. Альтернативные единицы измерения. SMALTUNITS

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
ARTICLE	+	Артикул	STRING
ALTUNIT	+	Альтернативная единица измерения	DECIMAL
RATE	+	Коэффициент пересчета	DECIMAL

13. Состав артикула IDT00001099. Форма 3-Торг Украина. SMCARDCOMPOSITION

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
COMPLEXARTICLE	+	Артикул, для которого описывается состав	STRING
ARTICLE	+	Артикул	STRING
AMOUNT	+	Количество ARTICLE в COMPLEXARTICLE в ед. измерения ARTICLE	DECIMAL
ISDEPENDENT	-	Подчинённый компонент, «Залоговая тара»	STRING

14. Производители / импортёры карточки складского учета. SMCARDPRODUCERS

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
ARTICLE	+	Артикул	STRING
PRODUCERID	+	Идентификатор производителя/импортера	DECIMAL
ISDEFAULT	-	1 – данный производитель/импортер будет использоваться по умолчанию при формировании алкогольной декларации. Среди всех производителей карточки только один должен быть отмечен этим флагом	STRING

15. SMARTICLEPACKS

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
ARTICLE	+	Артикул	STRING
PACKID	+	-	DECIMAL
HEIGHT	-	-	DECIMAL
IDMEASDIM	-	-	DECIMAL
IDMEASWEIGHT	-	-	DECIMAL
LENGTH	-	-	DECIMAL
MAXY	-	-	DECIMAL
QUANTITY	+	-	DECIMAL
TITLE	+	-	STRING
WEIGHT	-	-	DECIMAL
WEIGHTNETTO	-	-	DECIMAL
WIDTH	-	-	DECIMAL

Карточки товаров. IC (вложение карточки)

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
ARTICLE		Артикул товара	STRING
INSERTIONID		Идентификатор вложения	DECIMAL
FILENAME		Имя файла	STRING
THECONTENTS		Файл вложения (в виде потока байтов)	BASE64BINARY
TITLE		Описание вложения	STRING

Карточки товаров. BC (ШК)

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
BARCODE		Штриховой код	STRING
ARTICLE		Артикул	STRING
BARCODETYPE		Тип штрих-кода	DECIMAL
BOXID		Идентификатор короба	DECIMAL
FACEQUANTITY		Номинальное количество	DECIMAL
FLAGS		Флаги (битовая маска)	DECIMAL
MAXY		Макс. количество упаковок в штабеле (сколько можно ставить друг на друга)	DECIMAL
PACKID		Идентификатор упаковки	DECIMAL
QUANTITY		Количество	DECIMAL
SUBARTICLE		Субартикул	STRING
TAREHEIGHT		Высота тары	DECIMAL
TARELENGTH		Длина тары	DECIMAL
TAREWEIGHT		Вес тары	DECIMAL
TAREWIDTH		Ширина тары	DECIMAL
UNITNAME		Наименование единицы хранения	STRING
WEIGHT		Вес брутто	DECIMAL

Карточки товаров. GL (уровни складских запасов)

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
ID	+ (-1)	Идентификатор узла	NUMBER [10]
TREE	+	Код узла	VARCHAR2 [100]
NAME	+	Название	VARCHAR2 [255]
FLAGS	+ (0)	Битовая маска	NUMBER [10]
CREATOR	+ (-2)	Код пользователя, создавшего узел	NUMBER [10]

Карточки товаров. AM (номенклатура МХ)

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
ID	+ (-1)	Идентификатор узла	NUMBER [10]
TREE	+	Код узла	VARCHAR2 [100]
NAME	+	Название	VARCHAR2 [255]
FLAGS	+ (0)	Битовая маска	NUMBER [10]
CREATOR	+ (-2)	Код пользователя, создавшего узел	NUMBER [10]

Карточки товаров. RFSACARDPROPDEF (доп. характеристики)

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
ID	+ (-1)	Идентификатор узла	NUMBER [10]
TREE	+	Код узла	VARCHAR2 [100]
NAME	+	Название	VARCHAR2 [255]
FLAGS	+ (0)	Битовая маска	NUMBER [10]
CREATOR	+ (-2)	Код пользователя, создавшего узел	NUMBER [10]

Места хранения (магазины, склады). SH

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
ID	+ (-1)	Идентификатор узла	NUMBER [10]
TREE	+	Код узла	VARCHAR2 [100]
NAME	+	Название	VARCHAR2 [255]
FLAGS	+ (0)	Битовая маска	NUMBER [10]
CREATOR	+ (-2)	Код пользователя, создавшего узел	NUMBER [10]

Контрагенты. CL

Элемент	Обязательность для «Mobile Bay»	Описание	Формат данных в «Mobile Bay»	Пример
ID	+ (-1)	Идентификатор узла	NUMBER [10]
TREE	+	Код узла	VARCHAR2 [100]
NAME	+	Название	VARCHAR2 [255]
FLAGS	+ (0)	Битовая маска	NUMBER [10]
CREATOR	+ (-2)	Код пользователя, создавшего узел	NUMBER [10]

Структура Магазина (цеха). 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)	Код пользователя, создавшего узел	NUMBER [10]

Дерево страниц