Дерево страниц
Перейти к концу метаданных
Переход к началу метаданных

Вы просматриваете старую версию данной страницы. Смотрите текущую версию.

Сравнить с текущим просмотр истории страницы

« Предыдущий Версия 19 Текущий »

Элемент

Обязательность для «СуперМаг Мобайл»

Описание

Формат данных в «СуперМаг Мобайл»

Пример

Детальное описание (простыми словами)

Карточка складского учета SMCARD:


ACCEPTED

-

Статус

DECIMAL[5]

1

В Торговой системе Супермаг Плюс (далее СМ+) имеется 3 типа активности карточки -  новая, активная, исключённая. Подэто выделено 3 значения.

новая - 0 ,

активная -1,

исключённая - 2.

Другие значения не используются и зарезервированы на будущее.

Карточка с ACCEPTED=1, является карточкой с которой можно проделывать большинство операций.

Другие активности назначенные на карточку, ограничивают ее применение.

CASHLOAD

-

Признак «Грузить в кассу»

CHAR[1]

1

Признак разрешающий \ запрещающий использовать данную карточку для загрузки в кассовую систему. 

CASHLOAD=1, можно использовать как значение по умолчанию. Явно хуже от этого не будет.

DATATYPE

-

Тип карточки

DECIMAL[5]

0

0 - товар
1 - услуга
2 - деньги
3 - тара
4 - инвентарь
5 - набор

DATATYPE=0, можно использовать как значение по умолчанию. Применение других типов не обсуждалось.

FLAGS

-

Битовая маска

DECIMAL[10]

6208

Тут все не так просто. Желательно создать самостоятельно, либо с помощью нашего аналитика одну карточку.

Проставить ей необходимые атрибуты наличие  которых и формирует битовую маску. Получено число зафиксировать и использовать во всех товарах. 

/* bits for SMCard.Flags */
#define SMCARDFLAG_WHRQPACKS SMSQLLONG(1) /* if set then automatic
store orders generation will round up
quantities to pack sizes
*/
#define SMCARDFLAG_CASHNOSCALE SMSQLLONG(2) /* if set then scale info is not
loaded to cash desk, flag ignored if article has no scale attached
*/
#define SMCARDFLAG_PRICERSFORTENTH SMSQLLONG(4) /* цены на ценнике за 0.1 единицы измерения */
//#define флаг свободен SMSQLLONG(8) /* ранее обозначал "Спец. товар", убран в версии 1.027.5 */
#define SMCARDFLAG_IGNORE_RATE SMSQLLONG(16) /* Скорость продаж игнорируется при генерации заказов
(т.е. как если бы она была равна 0)
*/
#define SMCARDFLAG_FIXED_PRICE SMSQLLONG(32) /*
Фиксированная цена на артикул.
Артикул не участвует в ценообразовании.
*/
#define SMCARDFLAG_NONINGREDIENT SMSQLLONG(64) /* запрещен к использованию в производстве
*/
#define SMCARDFLAG_ONEXCISE SMSQLLONG(128) /* акцизный товар */
#define SMCARDFLAG_CERTREQUIRED SMSQLLONG(256) /* требуется сертификат соответствия (в документе прихода) */
#define SMCARDFLAG_INGREDIENT SMSQLLONG(512) /* артикул может использоваться как ингредиент */
#define SMCARDFLAG_GIFT SMSQLLONG(1024) /* разрешена безвозмездная передача: артикулы с таким флагом могут грузиться в кассу даже с нулевой ценой */
#define SMCARDFLAG_FOOD SMSQLLONG(2048) /* продовольственный товар */

#define SMCARDFLAG_MARK_EAC SMSQLLONG(4096) /* Маркировка товара ЕАС */
#define SMCARDFLAG_MARK_CTM SMSQLLONG(8192) /* Маркировка товара CTM */
#define SMCARDFLAG_MARK_KVI SMSQLLONG(16384)/* Маркировка товара KVI */

#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

ЭлементФормат данных в «СуперМаг Мобайл»Обязательность для «СуперМаг Мобайл»Комментарий
BARCODEVARCHAR2 (50 Byte)Y Штриховой код
BARCODETYPENUMBER (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 цифр штрихкода. Может иметь префикс, совпадающий со штучными штрихкодами.
UNITNAMEVARCHAR2 (50 Byte)Y Название единицы измерения штрихового кода. Текстовое поле.
Для большинства товаров UNITNAME = шт
Для весовых товаров UNITNAME = кг
ARTICLEVARCHAR2 (50 Byte)Y Артикул, код товара.
QUANTITYNUMBER (14,3)N Количество которое «несет» ШК
Для большинства товаров QUANTITY = 1
Для весовых товаров QUANTITY = null
FACEQUANTITYNUMBER (14,3)NНоминальное количество которое «несет» ШК
Для большинства товаров FACEQUANTITY = 1
Для весовых товаров FACEQUANTITY = null
FLAGSNUMBER (10)Y Для всех товаров FLAGS =1
SUBARTICLEVARCHAR2 (255 Byte)N Для всех товаров = null
BOXIDNUMBER (5)N Для всех товаров = null
NESTEDBARVARCHAR2 (50 Byte)N Для всех товаров = null
WEIGHTNUMBERN Для всех товаров = null
TAREWEIGHTNUMBERN Для всех товаров = null
TAREWIDTHNUMBERN Для всех товаров = null
TARELENGTHNUMBERN Для всех товаров = null
TAREHEIGHTNUMBERN Для всех товаров = null
MAXYNUMBERN Для всех товаров = null
PACKIDNUMBERN Для всех товаров = 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]1
PAYCASH+/* вид платежа (нал=1,б/нал=0) */Char[1]0
SHIPPER-/* Грузоотправитель (ид. контрагента) */Decimal[10]null
SUPPLIERCORRECTCREATE-/* Дата исправления УПД/УКД (ДатаИспрСчФ) */Datenull
SUPPLIERCORRECTINVOICE-/* Номер исправления УПД/УКД (НомИспрСчФ) */Decimal[5]null
SUPPLIERDOC-/* накладная поставщика (номер УПД для UI) */Varchar2[255]null
SUPPLIERINVOICE-/* счет-фактура поставщика */Varchar2[255]null
SUPPLIERUTDID-/* Идентификатор участника обмена УПД поставщика */Varchar2[50]null
SUPPLINVOICECREATE-/* дата счета-фактуры поставщика */Datenull
UTDDATE-/* дата УПД на который ссылается УКД (только для UI с операцией SMOP_UTD_INCOME_CORR) */Datenull
UTDFUNCTION-/* функция УПД */Varchar2[50]null
UTDSUPPDOC-/* номер УПД (SupplierDoc) на который ссылается УКД (только для UI с операцией SMOP_UTD_INCOME_CORR) */Varchar2[255]null
  • Нет меток