7.5.Этап 2
В реализацию второго этапа интеграции входит разработка и отладка части модуля интеграции по выгрузке из КИС собственных фирм, справочника торговых представителей, привязки складов и собственных фирм к торговым представителям, справочника клиентов и торговых точек.
Собственные Фирмы
Собственные фирмы, на которые выписываются документы, выгружаются из КИС в файл DMT_Set_FirmEx.txt.
Таблица 8 Формат файла DMT_Set_FirmEx.txt
Порядок в файле txt
|
Наименование поля
|
Описание передаваемого параметра
|
1
|
exid
|
Идентификатор юр.лица в корпоративной системе
|
2
|
activeflag
|
Флаг активности (1 - активный/0 – помеченный как удаленный)
|
3
|
name
|
Наименование
|
4
|
shortname
|
Краткое наименование
|
5
|
address
|
Адрес (в текстовой форме)
|
6
|
prefix
|
Префикс номеров документов. Поля обязательное для заполнение, может быть заполнено константой.
|
7
|
uraddress
|
Юр. Адрес (в текстовой форме)
|
8
|
inn
|
ИНН
|
9
|
uflag
|
Признак:
0 — юр. лицо, для которого готовится пакет документации государственного образца
1 — юр. лицо, для которого готовится пакет внутренней документации
|
10
|
fvip
|
Главный бухгалтер
|
11
|
fpersone
|
Кассир
|
12
|
fcomment
|
Комментарий
|
13
|
okpo
|
Код по ОКПО
|
14
|
okonh
|
Код по ОКОНХ
|
15
|
fphone
|
Телефон
|
16
|
femail
|
Адрес электронной почты
|
17
|
otherfields
|
Дополнительные поля через # (необязательные, может передаваться пустая строка), строка начинается с символа # (т.е. первый параметр пропускается):
Название банка
Расчетный счет
БИК
Корреспондентский счет
Директор (для печати)
|
Торговые представители
Торговые представители выгружаются из КИС в файл DMT_Set_AgentEx.txt.
Таблица 9 Формат файла DMT_Set_AgentEx.txt
Порядок в файле txt
|
Наименование поля
|
Описание передаваемого параметра
|
1
|
exid
|
Идентификатор ТП в КИС.
|
2
|
activeflag
|
Признак активности записи о ТП (1/0). Если необходимо удалить запись, необходимо передать «0»
|
3
|
name
|
Наименование ТП (ФИО)
|
4
|
shortname
|
Сокращенное наименование ТП
|
5
|
prefix
|
Префикс номеров документов. Поля обязательное для заполнение, может быть заполнено константой.
|
6
|
storeidd
|
Идентификатор склада ТП в КИС. Для pre-sail ТП передавать пустое значение
|
7
|
personidd
|
Идентификатор ТП, как физического лица. Можно передавать null (пустое значение)
|
8
|
otherfields
|
Остальные поля через разделитель “#”: не использовать, вместо параметра передается пустое значение
|
Клиенты
В системе «ОПТИМУМ» есть три основных типа клиента
Точки — это то, что посещает торговый представитель (адреса доставки), документы в КПК выписываются на точку и данные по мерчандайзингу формируются на точках. Точки участвуют в маршрутах.
Хозяин идентичен физическому клиенту организации, по нему ведутся взаиморасчеты (долги).
Юридическое лицо — это то, что печатается в документах и принадлежит хозяину.
Соответственно существуют несколько комбинаций этих типов клиентов и наборов параметров, передаваемых в процедуру.
Выгрузка Хозяина
Параметр 1 — уникальный идентификатор хозяина (сети).
Параметр 8 = 7. – тип хозяин
Параметр 9 — уникальный идентификатор хозяина (сети).
Выгрузка точки (адрес доставки)
Параметр 1 — уникальный идентификатор точки (Адреса доставки)
Параметр 8 = 1. – тип точка
Параметр 9 — уникальный идентификатор хозяина (Сети).
Выгрузка юридического лица
Параметр 1 — уникальный идентификатор юридического лица
Параметр 8 = 8 – тип юр. лицо
Параметр 9 — уникальный идентификатор хозяина (Сети).
Выгрузка хозяин он же точка (единичный магазин с несколькими юридическими лицами)
Параметр 1 — уникальный идентификатор хозяина (Магазина)
Параметр 8 =11 – тип хозяин/точка
Параметр 9 — уникальный идентификатор хозяина (Магазина)
Выгрузка хозяин он же юр.лицо (сеть магазинов с одним юр. лицом)
Параметр 1 — уникальный идентификатор хозяина (сети)
Параметр 8 =10 – тип хозяин/Юр.лицо
Параметр 9 — уникальный идентификатор хозяина (сети)
Выгрузка хозяин он же точка он же юр.лицо (одиночный магазин с одним юр.лицом)
Параметр 1 — уникальный идентификатор хозяина
Параметр 8 = 9 – тип хозяин/Юр.лицо/точка
Параметр 9 — уникальный идентификатор хозяина
Все типы клиентов выгружаются в один файл - DMT_Set_ClientEx.txt, при этом есть отличия в заполнении отдельных полей («тип лица» и полей адреса). Хозяева (в случае если есть такое деление) должны следовать в файле до торговых точек, к ним относящихся, в противном случае при создании новой торговой точки может произойти ошибка из-за отсутствия в базе такого клиента.
Таблица 10 Формат файла DMT_Set_ClientEx.txt
Порядок в файле txt
|
Наименование поля
|
Описание передаваемого параметра
|
1
|
exid
|
Идентификатор клиента (в зависимости от того, какой объект выгружается)
|
2
|
exidrep
|
Идентификатор торгового представителя, к которому привязан клиент. В случае если точка может обслуживаться несколькими торговыми представителями, тогда целесообразнее в данном параметре передавать пустое значение а связь торговых представителей с точками осуществлять с помощью отдельного специализированного механизма - DMT_Set_MobFaces
|
3
|
activeflag
|
Флаг активности
|
4
|
name
|
Наименование
|
5
|
shortname
|
Сокращенное наименование
|
6
|
address
|
Адрес
|
7
|
inn
|
ИНН
|
8
|
ftype
|
Тип лица, число (существующие типы клиентов описаны выше)
|
9
|
exidowner
|
Идентификатор хозяина (возможные значения описаны выше)
|
10
|
fcomment
|
Комментарий
|
11
|
okpo
|
ОКПО
|
12
|
okonh
|
ОКОНХ
|
13
|
fphone
|
телефон
|
14
|
fvip
|
Главный бухгалтер
|
15
|
femail
|
эл. почта
|
16
|
furaddress
|
Юридический адрес
|
17
|
fpersone
|
Контактное лицо
|
18
|
otherfields
|
Дополнительные поля ч/з #, первый символ «#», т.е. первое поле пропущено:
fBankName - Название банка
fBankAccount - Расчетный счет
fBik - БИК
fCorrAccount - Корреспондентский счет
Данные поля необязательны для заполнения
|
Связи торговых точек с торговыми представителями могут выгружаются путем формирования файла DMT_Set_MobFaces.txt. Идентификатор ТТ указывается в этом случае в поле №2 файла DMT_Set_MobFaces. Выгрузка связей может быть осуществлена в файле DMT_Set_ClientEx.txt или проставлена вручную в интерфейсной части мобильной системы Оптимум.
Таблица 11 Формат файла DMT_Set_MobFaces.txt
Порядок в файле txt
|
Наименование поля
|
Описание передаваемого параметра
|
1
|
masterexid
|
Идентификатор ТП в КИС.
|
2
|
clientexid
|
Идентификатор привязываемого элемента (это может быть организация, склад, клиент, торговая точка)
|
3
|
activeflag
|
Флаг активности связи (1 – связь устанавливается, 0 - разрывается)
|
4
|
option
|
Признак того, что подчиненный элемент привязан только к одному главному элементу. Передавать «0».
|
5
|
moverouts
|
Признак того, что производится перенос маршрутов подчиненного элемента главному элементу. Передавать «0».
|
Атрибуты объектов системы
В рамках данного проекта необходимо выгружать некоторые дополнительные поля (атрибуты) клиентов.
Ниже представлены названия таких полей и номера атрибутов, соответствующих им в ОПТИМУМ.
Таблица 12 Обновляемые поля и номера атрибутов торговых точек
№ атрибута
|
Наименование поля
|
Тип атрибута
|
2002
|
Код Канала (справочник предоставляется компанией Воронежросагро)
|
Перечислимый
|
2003
|
Код Подканала (справочник предоставляется компанией Воронежросагро)
|
Перечислимый
|
548
|
Код Типа ТТ (справочник предоставляется компанией Воронежросагро)
|
Перечислимый
|
2004
|
Код Территории (справочник предоставляется компанией Воронежросагро)
|
Перечислимый
|
Запись значений полей осуществляется путем формирования файла DMT_Set_ObjectsAttribute.txt. Файл содержит отдельную строку для каждого из выгружаемых значений полей.
Таблица 13 Формат файла DMT_Set_ObjectsAttribute.txt
Порядок в файле txt
|
Наименование поля
|
Описание передаваемого параметра
|
1
|
dictid
|
2
|
2
|
exobjid
|
Идентификатор торговой точки в КИС.
|
3
|
exattrid
|
Пустое значение
|
4
|
attrid
|
Одно из значений «№ атрибута» из таблицы 12
|
5
|
exattrvalue
|
Значение поля, которое передаем
|
6
|
attrvalueid
|
Пустое значение
|
7
|
attrtext
|
Пустое значение
|
8
|
sort
|
1
|
9
|
option
|
Пустое значение
|
10
|
activeflag
|
1
|
11
|
ownerdistid
|
Пустое значение
|
12
|
cleanothervals
|
0
|
13
|
otherfields
|
Пустое значение
|
|
