Элемент | Обязательность для «СуперМаг Мобайл» | Описание | Формат данных в «СуперМаг Мобайл» | Пример | Детальное описание (простыми словами) |
---|
Карточка складского учета SMCARD:
ACCEPTED | - | Статус | DECIMAL[5] | 1 | В Торговой системе Супермаг Плюс (далее СМ+) имеется 3 типа активности карточки - новая, активная, исключённая. Подэто выделено 3 значения. новая - 0 , активная -1, исключённая - 2. Другие значения не используются и зарезервированы на будущее. Карточка с ACCEPTED=1, является карточкой с которой можно проделывать большинство операций. Другие активности назначенные на карточку, ограничивают ее применение. |
CASHLOAD | - | Признак «Грузить в кассу» | CHAR[1] | 1 | Признак разрешающий \ запрещающий использовать данную карточку для загрузки в кассовую систему. CASHLOAD=1, можно использовать как значение по умолчанию. Явно хуже от этого не будет. |
DATATYPE | - | Тип карточки | DECIMAL[5] | 0 | 0 - товар DATATYPE=0, можно использовать как значение по умолчанию. Применение других типов не обсуждалось. |
FLAGS | - | Битовая маска | DECIMAL[10] | 6208 | Тут все не так просто. Желательно создать самостоятельно, либо с помощью нашего аналитика одну карточку. Проставить ей необходимые атрибуты наличие которых и формирует битовую маску. Получено число зафиксировать и использовать во всех товарах. /* bits for SMCard.Flags */ #define SMCARDFLAG_MARK_EAC SMSQLLONG(4096) /* Маркировка товара ЕАС */ #define SMCARDFLAG_MAX SMSQLLONG(16384)/* максимальный текущий флаг артикула */ |
GLOBALARTICLE | - | Артикул центрального офиса | VARCHAR2[50] | 002118 | Используется при наличии распределённых баз данных. В случае использования единственной БД = ARTICLE |
IDMEASDIM | - | Ед. изм. для линейных размеров | DECIMAL[5] | 3 | Используется для функционала Доставка. Для всех других случаев должно быть равно = NULL |
IDMEASWEIGHT | - | Ед. изм. для веса | DECIMAL[5] | 4 | Используется для функционала Доставка. Для всех других случаев должно быть равно = NULL |
IDONETORG | - | Идентификатор классификатора 1-торг | DECIMAL[10] | null | Ссылка на вспомогательный классификатор. Для интеграции СММобайл должно быть равно = NULL |
IDSCALE | - | Идентификатор шкалы | DECIMAL[5] | null | Используется для управления списками для загрузки весов. Для интеграции СММобайл должно быть равно = NULL |
IDTHREETORG | - | Идентификатор классификатора 3-торг | DECIMAL[10] | null | Ссылка на вспомогательный классификатор. Для интеграции СММобайл должно быть равно = NULL |
MINPROFIT | - | Граница рентабельности | DECIMAL[19,4] | 0 | Минимальная цена товара. Используется для выгрузки на кассу. Для интеграции СММобайл должно быть равно = 0 |
QUANTITYDEVIATION | - | Максимальное отклонение количества между фактическим и заказанным | DECIMAL[14,3] | 0 | Используется для функционала Автозаказ. Для интеграции СММобайл должно быть равно = 0 |
RECEIPTOK | - | Признак «Разрешен прием» (он же – «Разрешен к заказу у поставщика») | CHAR[1] | 1 | Используется для управлениями разрешением принимать товарную карточку в накладных. Для интеграции СММобайл должно быть равно = 1 |
SCALELOAD | - | Признак «Грузить в весы» | CHAR[1] | 0 | Используется для управления списками для загрузки весов. Для интеграции СММобайл должно быть равно = 0 |
STATEREGULATION | - | Вид государственного регулирования (LEGISLATION_BYELORUSSIA) | DECIMAL[5] | null | Используется для республики Беларусь. Для России = NULL |
STORAGE | - | Условия хранения | DECIMAL[5] | 0 | Условия хранения товара. Для интеграции СММобайл должно быть равно = 0 |
WIDTH | - | Ширина единицы товара в ед. изм. | DECIMAL[13,4] | null | Используется для функционала Доставка. Для всех других случаев должно быть равно = NULL |
Справочник мест хранения. SMSTORELOCATIONS
FORMATID | - | Код формата | DECIMAL[10] | null | И используется для функционала динамическое ценообразование. Для интеграции СММобайл должно быть равно = NULL |
GLN | - | Номер GLN | VARCHAR2[13] | Используется при обмене EDI. Для интеграции СММобайл должно быть равно = NULL | |
ORDERALG | - | Алгоритм по умолчанию для генерации заказов поставщикам | VARCHAR2[255] | * | Используется для функционала Автозаказ. Для интеграции СММобайл должно быть равно = * |
RGNID | - | Идентификатор региона | DECIMAL[10] | -1 | Номер региона местах хранения. Для интеграции СММобайл должно быть равно = -1 (минус 1) |
SUGGESTORDERALG | - | Алгоритм расчёта предложения заказа | VARCHAR2[50] | EFFECTIVE | Используется для функционала Автозаказ. Для интеграции СММобайл должно быть равно = EFFECTIVE |
Данные о контрагенте. SMCLIENTINFO
ACCEPTED | - | Статус | DECIMAL[5] | 1 | В Торговой системе СМ+ имеется 3 типа активности контрагента - новая, активный, исключённый. Под это выделено 3 значения. новая - 0 , активная -1, исключённая - 2. Другие значения не используются и зарезервированы на будущее. Контрагент с ACCEPTED=1, является объектом с которым можно проделывать большинство операций. Другие активности назначенные на контрагенту, ограничивают его применение. |
FIFOALG | - | Алгоритм расчета ТД для МХ данного партнера | DECIMAL[10] | null | Используется для определения алгоритма расчета товародвижения. Для интеграции СММобайл должно быть равно = NULL |
HEADQUARTERS | - | Штаб-квартира: не физ. лицо не может быть филиалом, поэтому HEADQUARTERS должно быть NULL для филиалов и не NULL – для физ. лиц | DECIMAL[10] | null | Используется для определения кем является контрагент - физическим или юридическим лицом. Для интеграции СММобайл должно быть равно = NULL |
IDENT | - | Дополнительный идентификатор клиента | VARCHAR2[20] | null | Используется при обмене EDI. Для интеграции СММобайл должно быть равно = NULL |
IDGLOBAL | - | ID клиента, которым был замещен данный клиент или NULL, если данный клиент не замещен | DECIMAL[10] | null | Используется при наличии распределённых баз данных. В случае использования единственной БД = NULL |
OWNBALANCE | - | Признак «Собственный баланс», может быть 0 только для филиалов | CHAR[1] | 1 | Используется для функционала Платежи. Для интеграции СММобайл должно быть равно = 1 |
OWNCLIENT | - | 1 – собственный контрагент | CHAR[1] | 0 | Используется для функционала Платежи. Для интеграции СММобайл должно быть равно = 0 |
PRIMEALG | - | Алгоритм расчета себестоимости для МХ данного партнера | DECIMAL[10] | null | Используется для определения алгоритма расчета товародвижения. Для интеграции СММобайл должно быть равно = NULL |
REGIONCODE | - | Код региона | CHAR[2] | null | Используется при обмене EDI. Для интеграции СММобайл должно быть равно = NULL |
VATPAYER | - | Плательщик НДС | CHAR[1] | 1 | Определяет является ли контрагент плательщиком НДС. Для интеграции СММобайл должно быть равно = 1 |
WAVGPERIOD | - | Интервал усреднения для алгоритма. Если данный контрагент не является партнером, то значение поля игнорируется | DECIMAL[10] | null | Используется для определения алгоритма расчета товародвижения. Для интеграции СММобайл должно быть равно = NULL |
Свойства, специфичные для узлов классификатора карточек. SACARDCLASSAUX
CERTREQUIRED | - | Признак «Требуется сертификат» | CHAR[1] | null | Используется для определения необходимости указания номера сертификата соответствия для товара входящего в данную группу. Для интеграции СММобайл должно быть равно = NULL |
DATATYPE | - | Тип данных по умолчанию для новой карточки | DECIMAL[5] | null | Тип карточки которая она унаследует при ее создании в данной группе классификатора. Для интеграции СММобайл должно быть равно = NULL |
NAMEFORMID | - | Ссылка на форму ввода названия | DECIMAL[5] | null | Ссылка на шаблон названий товаров, который будет участвовать при создании товарной карточки. Для интеграции СММобайл должно быть равно = NULL |
ORDERVARFACTOR | - | Коэффициент вариативности | DECIMAL[3,2] | null | Коэффициент для товарной карточки которая она унаследует при ее создании в данной группе классификатора. Для интеграции СММобайл должно быть равно = NULL |
Корневая таблица. SMDOCUMENTS
DOCSTATE | + | Статус документа | DECIMAL[5] | 3 | Определяет состояние документа. А само состояние влияет на действие этого документа в системе. В СМ+ имеется 4 статуса: 0 -заблокирован. 1- черновик. 2 - принят \ отпущен. 3 - полностью проведен \ закрыт Чаще всего при передачи документа из внешне системы его передают в статусе 3. Т.к. никакие действия с ним уже не нужны, он готов для использования. Исключение составляет документа АКТ переоценки, его нужно передавать в статусе 2. Именно такой статус будет расценен системой СМ+, как команда к действию. СМ+ проанализирует документ, исполнит цены (назначит товарам), и закроет (переведет в статус 3). Все это она сделает автоматически при получении его Сервером обмена данных. |
,OPCODE | + | Код операции документа: 1 – нет операции | DECIMAL[5] | -1 | Существует целы справочник операций в СМ+. Разделы - Настройка - Операции. Операция определяет суть документа. Для некоторых документов она обязательна, для некоторых носит формальный характер. Например , для Акта переоценки- операция - не определяется и должна быть равна = -1 |
PRICEROUNDMODE | + | Режим округления цен или сумм | DECIMAL[5] | 0 | В спецификации документа, например Приходная накладная, есть такие колонки как - "Цена", "Цена без "НДС", "НДС", "Сумма НДС", "Полная сумма", "Сумма без НДС". В большинстве случаев НДС добавленная к "Цене без НДС" не дает "Цену" с точностью до копеек. При этом форма бухгалтерской отчетности требует соблюдения правила, указывающего, что минимальная денежная единица это 1 копейка. Для соблюдения математических правил, в СМ+ введено такое понятие как округление. Округление – порядок округления до точности валюты выбором из списка: Полная цена / Цена без налогов / Полная сумма / Сумма без налогов. Указывая правило округления, мы заставляет систему проводить округление документа до точности валюты, но только тех колонок и значений которые указаны в правиле, остальные же колонки и их значения будут рассчитаны с максимальной точностью. (4 знака после запятой). Акт переоценки оперирует с "готовыми" ценами, в нем ничего не нужно округлять, и поэтому правило округления у него всегда равно = 0. |
.
Акт переоценки (параметры). SMACTS
Элемент | Обязательность для «СуперМаг Мобайл» | Описание | Формат данных в «СуперМаг Мобайл» | Пример | |
EXECIF | + | Условие исполнения | DECIMAL[10] | 0 | Акт переоценки может исполнится сразу, а может подождать определённой даты и времени. 0 - исполнить сразу. 1 - дождаться даты и времени. Акт переоценки полученный из внешней системы, не принимает решений о своем исполнении. За него уже все решили. Поэтому у него EXECIF = 0. |
REASON | + | Причина переоценки | DECIMAL[10] | 0 | Причин переоценки может быть множество. Вручную, По Факту прихода, По наступлению акции. Акт переоценки полученный из внешней системы, не принимает решений о причине своей переоценки. За него уже все решили. Поэтому у него REASON= 0. |
Штриховые коды SVSTOREUNITS
Элемент | Формат данных в «СуперМаг Мобайл» | Обязательность для «СуперМаг Мобайл» | Комментарий |
BARCODE | VARCHAR2 (50 Byte) | Y | Штриховой код |
BARCODETYPE | NUMBER (5) | Y | Тип штриховых кодов. Для большинства товаров BARCODETYPE = 7 Для весовых товаров BARCODETYPE=6 1 EAN 13 Штрихкод EAN-13. Содержит 13 цифр, включая контрольный разряд. Используется для уникальной идентификации товара и его количества в упаковке. 2 EAN 8 Штрихкод EAN-8. Содержит 8 цифр, включая контрольный разряд. Используется для уникальной идентификации товара и его количества в упаковке. 3 UPC E Штрихкод UPC E. Содержит 8 цифр, включая контрольный разряд. Используется для уникальной идентификации товара и его количества в упаковке. 4 UPC A Штрихкод UPC A. Содержит 12 цифр, включая контрольный разряд. Используется для уникальной идентификации товара и его количества в упаковке. 5 короткий Короткий код для ручного ввода. Используется для визуальной идентификации товаров на которые невозможно нанести штрихкод. 6 весовой Штрихкод EAN-13 для весового товара. Содержит 13 цифр, из которых первые 7 используются для уникальной идентификации товара, следующие 5 - вес товара в граммах и последняя цифра - контрольный разряд. В БД хранятся первые 7 цифр штрихкода. 7 внешний Штриховой код, нанесённый производителем товара. Обычно EAN-13, EAN-8 или UPC. 8 недопустимый Используется для указания недопустимого в торговой системе штрихового кода 9 простой Штриховой код, содержащий цифры и буквы, обычно использующийся для идентификации нетоварных сущностей, например, дисконтных карт. 10 внешний весовой Штриховой код EAN-13, нанесённый производителем товара и содержащий вес товара. Содержит 13 цифр, из которых первые 7 используются для уникальной идентификации товара, следующие 5 - вес товара в граммах и последняя цифра - контрольный разряд. В БД хранятся первые 7 цифр штрихкода. 11 со сроком годности Секционный штрихкод, содержащий код EAN-13, идентифицирующий товар, и срок годности товара. Имеет длину 24 символа и формат "020(код поставщика EAN-13)15(срок годности ГГММДД)". 12 документ Штриховой код Code-128 в печатной форме документа Супермага. Содержит тип и номер документа и используется для быстрого поиска документа по его печатной форме. 13 серия марки ЕГАИС Штрихкод серии и номера акцизной или федеральной специальной марки ЕГАИС. Идентифицирует партию алкогольной продукции, но не конкретную бутылку. Имеет длину 15, 16, 33 или 34 символа. 14 код марки ЕГАИС (ст) Штрихкод акцизной или федеральной специальной марки ЕГАИС для идентификации каждой единицы маркируемой алкогольной продукции. Имеет длину 68 символов (цифры и латинские буквы). Содержит в своём составе код алкогольной продукции. Использовался для маркировки алкогольной продукции, произведённой до 2019 года. 15 код марки ЕГАИС Штрихкод акцизной или федеральной специальной марки ЕГАИС для идентификации каждой единицы маркируемой алкогольной продукции. Имеет длину 150 символов (цифры и латинские буквы). Содержит в своём составе серию и номер АМ/ФСМ. 16 ср. годности, партия Секционный штрихкод, содержащий код EAN-13, идентифицирующий товар, партию и срок годности товара. Имеет длину 29 символов и формат "010(ШК поставщика EAN-13)10(Номер партиии 5 символов)15(Срок годности формата ГГММ)". 17 пачка табака DataMatrix штрихкод пачки табака. Идентифицирует товар, серию и максимальную розничную цену товара. Имеет длину 29 символов. 18 блок табака в УПД Секционный штрихкод блока табака. Идентифицирует товар, серию и максимальную розничную цену товара. Имеет длину 25, 29, 35 или 41 символ. 19 Весовой ШК18 Штриховой код, нанесённый производителем товара и содержащий вес товара. Содержит 18 цифр, из которых первые 13 используются для уникальной идентификации товара, следующие 5 - вес товара в граммах. Может иметь префикс, совпадающий со штучными штрихкодами. 20 групповая тара ЕГАИС Групповая тара ЕГАИС. Цифровой, Code 128, имеет длину 26 символов (короб) или 18 символов (палетта). 21 маркировка GS1 Секционный штрихкод GS1. Идентифицирует товар и содержит дополнительные данные. 22 Весовой + дата ШК20 Секционный штрихкод, нанесённый производителем товара и содержащий вес и дату производства товара. Содержит 20 цифр, из которых первые 8 используются для уникальной идентификации товара, следующие 5 - вес товара в граммах, далее - 6 цифр – дата производства ДДММГГ. Последний символ – контрольный разряд. Может иметь префикс, совпадающий со штучными штрихкодами. 23 Весовой без ун. преф Штриховой код EAN-13, нанесённый производителем товара и содержащий вес товара. Содержит 13 цифр, из которых первые 7 используются для уникальной идентификации товара, следующие 5 - вес товара в граммах и последняя цифра - контрольный разряд. В БД хранятся первые 7 цифр штрихкода. Может иметь префикс, совпадающий со штучными штрихкодами. |
UNITNAME | VARCHAR2 (50 Byte) | Y | Название единицы измерения штрихового кода. Текстовое поле. Для большинства товаров UNITNAME = шт Для весовых товаров UNITNAME = кг |
ARTICLE | VARCHAR2 (50 Byte) | Y | Артикул, код товара. |
QUANTITY | NUMBER (14,3) | N | Количество которое «несет» ШК Для большинства товаров QUANTITY = 1 Для весовых товаров QUANTITY = null |
FACEQUANTITY | NUMBER (14,3) | N | Номинальное количество которое «несет» ШК Для большинства товаров FACEQUANTITY = 1 Для весовых товаров FACEQUANTITY = null |
FLAGS | NUMBER (10) | Y | Для всех товаров FLAGS =1 |
SUBARTICLE | VARCHAR2 (255 Byte) | N | Для всех товаров = null |
BOXID | NUMBER (5) | N | Для всех товаров = null |
NESTEDBAR | VARCHAR2 (50 Byte) | N | Для всех товаров = null |
WEIGHT | NUMBER | N | Для всех товаров = null |
TAREWEIGHT | NUMBER | N | Для всех товаров = null |
TAREWIDTH | NUMBER | N | Для всех товаров = null |
TARELENGTH | NUMBER | N | Для всех товаров = null |
TAREHEIGHT | NUMBER | N | Для всех товаров = null |
MAXY | NUMBER | N | Для всех товаров = null |
PACKID | NUMBER | N | Для всех товаров = null |
Таблица SMWAYBILLSEXT (Используется для Накладных поставщика (WE) и УПД на приход (UI))
Элемент | Обязательность для «СуперМаг Мобайл» | Описание | Формат данных в «СуперМаг Мобайл» | Пример | Детальное описание (простыми словами) |
---|---|---|---|---|---|
ID | + | Номер документа | Varchar2[50] | 12345 | |
DOCTYPE | + | Тип доукмента | Char[2] | WE | |
CONSIGNEE | - | /* Грузополучатель (ид. контрагента) */ | Decimal[10] | null | |
DELIVERYTOTALSUM | - | /* общая стоимость доставки товара от производителя (транспортные расходы) (BY) */ | Decimal[19,4] | null | |
DEVIATIONREASON | + | /* общая стоимость доставки товара от производителя (транспортные расходы) (BY) */ | Decimal[5] | 0 | |
EDOID | - | /* идентификатор документа в системе ЭДО */ | Varchar2[255] | null | |
EXCHANGEERRORTEXT | - | /* текст ошибки обмена с системой ЭДО */ | Varchar2[4000] | null | |
EXCHANGESTATE | - | /* состояние обмена с системой ЭДО */ | Decimal[5] | null | |
GOODSOWNER | + | /* собственник товара (SMGOODSOWNER_XXX) */ | Decimal[5] | 0 | |
OURSELFCLIENT | - | /* собственный контрагент (покупатель) */ | Decimal[10] | null | |
OURUTDID | - | /* Собственный идентификатор участника обмена УПД */ | Varchar2[50] | null | |
PAYCASH | + | /* вид платежа (нал=1,б/нал=0) */ | Char[1] | 0 | |
SHIPPER | - | /* Грузоотправитель (ид. контрагента) */ | Decimal[10] | null | |
SUPPLIERCORRECTCREATE | - | /* Дата исправления УПД/УКД (ДатаИспрСчФ) */ | Date | null | |
SUPPLIERCORRECTINVOICE | - | /* Номер исправления УПД/УКД (НомИспрСчФ) */ | Decimal[5] | null | |
SUPPLIERDOC | - | /* накладная поставщика (номер УПД для UI) */ | Varchar2[255] | null | |
SUPPLIERINVOICE | - | /* счет-фактура поставщика */ | Varchar2[255] | null | |
SUPPLIERUTDID | - | /* Идентификатор участника обмена УПД поставщика */ | Varchar2[50] | null | |
SUPPLINVOICECREATE | - | /* дата счета-фактуры поставщика */ | Date | null | |
UTDDATE | - | /* дата УПД на который ссылается УКД (только для UI с операцией SMOP_UTD_INCOME_CORR) */ | Date | null | |
UTDFUNCTION | - | /* функция УПД */ | Varchar2[50] | null | |
UTDSUPPDOC | - | /* номер УПД (SupplierDoc) на который ссылается УКД (только для UI с операцией SMOP_UTD_INCOME_CORR) */ | Varchar2[255] | null |