Инструменты пользователя

Инструменты сайта


formats
no way to compare when less than two revisions

Различия

Показаны различия между двумя версиями страницы.


Предыдущая версия
Следующая версия
formats [2018/11/02 13:12] – [ORD<КодАгента>.CFG, ORDER.CFG – файл настроек] salnikov
Строка 1: Строка 1:
 +=====Файлы обмена:=====
 +
 +
 +====ORD<КодАгента>.CFG, ORDER.CFG – файл настроек====
 +
 +Файл содержит общую для всех мобильных устройств информацию, необходимую для обмена.
 +
 +Файл состоит из строк вида Ключ = Значение.
 +
 +
 +**Ключи файла настроек**
 +
 +//Организация// – задает список продавцов, значения перечисляются через ';'
 +
 +  Организация = Фирма1;Фирма2;Фирма3  
 +
 +//ВидЦены// – задает названия для колонок цен из прайс-листа. Количество перечисленных значений должно совпадать с количеством колонок в прайс-листе.
 +
 +  ВидЦены = Цена1;Цена2;Цена3  
 +
 +//МожноИзменятьЦену// – позволяет задать условие, может ли торговый агент изменять тип цены в заявках. Значение 0 – тип цена не может быть изменен. 1 – торговый агент может изменять тип цены в заявках.
 +
 +  МожноИзменятьЦену = 1  
 +
 +//ДатаДоставки=0// – дата доставки при создании заявки 0 - сегодня, 1 - следующий день, 2 - следующий рабочий день.
 +
 +//ОстаткиФономМин=5// - прием остатков в фоне каждые 5 минут. 0 — нет приема остатков.
 +
 +//ADMPWD=пароль// - закладка GPS в настройках мобильной части открывается после корректно введенного пароля.
 +  
 +  
 +====USERS.DBF – файл пользователей====
 +
 +Файл содержит информацию о пользователях и их КПК. Все пользователи должны быть прописаны в этом файле. 
 +
 +**Поля**
 +
 +^Название ^Тип ^Описание^
 +|ID |Char(20) |Идентификатор пользователя (табельный номер), уникальный для каждого пользователя.|
 +|NAME |Char(100) |ФИО пользователя.|
 +|LOGIN |Char(30) |Логин пользователя.|
 +|PASSWORD |Char(30) |Пароль пользователя.|
 +
 +
 +====WAREHOUS.DBF, W<идентификатор пользователя>.DBF – файл товаров====
 +
 +Файл содержит список товаров с ценами и текущими остатками. Если существует файл для пользователя (например, **w001.dbf**, для пользователя с идентификатором 001), информация о товаре берется из него, в остальных случаях из общего файла **warehous.dbf**.
 +
 +Количество колонок с ценой товара не ограничено. Важно, чтобы колонки с ценой нумеровались последовательно. Для выбора цены необходимо также в файл ORDER.CFG добавить название видов цен в ключ //ВидЦены.//
 + 
 +**Поля**
 +
 +^Название ^Тип ^Описание ^
 +|ID |Char(15) |Идентификатор товара, уникальный для товара.|
 +|FOLDER |Char (15) |Идентификатор папки товара.|
 +|NAME |Char(100) |Название товара.|
 +|COST1 |Numeric(10;2) |Цена товара 1.|
 +|COST2 |Numeric(10;2) |Цена товара 2.|
 +|COST3 |Numeric(10;2) |Цена товара 3.|
 +|INPACK |Numeric(8;3) |Количество товара в упаковке (коробке).|
 +|QTY |Numeric(10;3) |Количество товара на складе в штуках.|
 +|WEIGHT |Numeric(10;3) |Вес единицы товара.|
 +|PATH |Char(250) |**В базовых проектах это поле не используется, презентор создается в РМР**. Имя файла картинки товара. Файл формата JPEG. Пишется или полное имя (с учетом того, что файл будет читаться сервером), или частичное – в этом случае началом пути будет папка обмена. Использовать картинки размером больше 50 кБайт не рекомендуется. Если несколько товаров имеют одну картинку – имя картинки в каждом товаре должно быть одинаковым. В этом случае на КПК придет только одна картинка.|
 +
 +====FOLDERS.DBF, F<идентификатор пользователя>.DBF – файл папок товара====
 +
 +Файл содержит список папок товара. Папки товара будут отображаться на КПК в том же порядке, в котором эти папки находятся в этом файле. Если существует файл для пользователя (например, **f001.dbf**, для пользователя с идентификатором 001) информация о товаре берется из него, в остальных случаях из общего файла **folders.dbf**. 
 +
 +Общий файл папок используется в отчетах программы НаполеонМенеджер.
 +
 +**Поля**
 +^Название ^Тип ^Описание ^
 +|ID |Char(15) |Код папки.|
 +|LEVEL |Numeric(6) |Уровень (для иерархических папок), начиная с нуля.|
 +|NAME |Char(50) |Название папки.|
 +
 +
 +====ORGS.DBF, O<идентификатор пользователя>.DBF – файл контрагентов====
 +
 +Файл содержит список организаций для пользователя. Если существует файл для пользователя (например, **o001.dbf**, для пользователя с идентификатором 001) информация о товаре берется из него, в остальных случаях из общего файла **orgs.dbf**. 
 +Общий файл контрагентов используется в отчетах программы НаполеонМенеджер.
 +
 +**Поля**
 +
 +^Название ^Тип ^Описание ^
 +|ID |Char(20) |Код организации, уникальный для организации.|
 +|NAME |Char(55) |Название контрагента.|
 +|ADDRESS|Char(100) |Адрес организации.|
 +|COSTYPE|Numeric(2)     |Колонка прайса для контрагента начиная с 0 (0 цена берется из поля COST1, 1 – COST2 и т.д.)|
 +|BLOCK  |Numeric(1)     |Принзак блокировки контрагента 1 — заявку на контрагента нельзя создать.|
 +|STOP   |Numeric(1)     |Признак стоп-листа. 1 — перед созданием заявки будет показано предупреждение о нахождении клиента в стоп-листе.|
 +====CONTACTS.DBF, C<идентификатор пользователя>.DBF – файл контактов====
 +
 +Файл содержит список контактов организаций: номера телефонов, ФИО контактного лица.
 +
 +**Поля**
 +
 +^Название ^Тип ^Описание ^
 +|ID |Char(25) |Код организации.|
 +|FIO |Char(100) |ФИО контакта.|
 +|PHONE |Char(50) |Телефон.|
 +
 +====DLV<идентификатор пользователя>.DBF, DELIVERY.DBF – файл накладных====
 +
 +Файл с накладными. Для ввода накладных на Коммуникатор.
 +
 +**Поля**
 +
 +^Название ^Тип ^Описание ^
 +|ID |Char(20) |Код организации.|
 +|NUM |Char (10) |Номер накладной.|
 +|DATE |Date |Дата накладной.|
 +|PAYDATE| Date          |Дата оплаты накладной.|
 +|ID_I |Char(15) |Код товара.|
 +|QTY |Numeric(10;3) |Количество в накладной.|
 +|SUM |Numeric(10;2) |Сумма по данному товару.|
 +|SUMD |Numeric(10;2) |Сумма долга по накладной.|
 +|CREATED |Char(15) |Код заявки для связи накладной с заявкой (поле CREATED заявки).|
 +
 +
 +====PAY<идентификатор пользователя>.DBF, PAYMENT.DBF – файл оплат====
 +
 +Файл с начальным сальдо клиента. По каждому клиенту, у которого сальдо не равно нулю на начало период выгрузки документов, записывается информация о сумме долга. Если контрагент является должником, сумма положительная, если у контрагента есть переплата – сумма отрицательная.
 +
 +**Поля**
 +
 +^Название ^Тип ^Описание^
 +|ID |Char(20) |Код организации.|
 +|NUM |Char (10) |Слова «Нач.сальдо».|
 +|DATE |Date |Дата начала периода.|
 +|SUM |Numeric(10;2) |Сумма долга или переплаты.|
 +
 +
 +====ORD<идентификатор пользователя>.DBF – файл заявок====
 +
 +Файл с заявками от пользователя. Сервер никогда не переписывает этот файл. Если файла нет, то создается новый, а если файл уже есть, то сервер добавляет  в него пришедший заказ. Кроме того, сервер не проверяет заявки в этом файле на дублирование.
 +То есть если принятая заявка уже содержится в этом файле, она все равно будет добавлена в файл еще раз. Перед обработкой файла КИС должна переименовать его, а после обработки удалить.
 +
 +**Поля**
 +
 +^Название ^Тип ^Описание^
 +|CREATED |Char(15) |Дата и время создания заказа в формате ГодМесяцДеньЧасМинСек  все числа, кроме года двузначные. |
 +|TIMEZONE       |Number(9)      |Смещение зоны Гринвича от времени на КПК в минутах.|
 +|NUM |Char(15) |Номер заказа (совпадает с полем CREATED).|
 +|DATE |Date |Дата заказа.|
 +|DELAY |Number(9) |Отсрочка платежа.|
 +|ID |Char(20) |Код контрагента.|
 +|ID_I |Char(20) |Код товара.|
 +|QTY |Numeric(10;2) |Количество товара в заказе.|
 +|COST |Numeric(10;2) |Цена товара в заказе.|
 +|REMARK |Char(255) |Примечание по заказу.|
 +|CTYPE |Char(50) |Тип цены (название типа цены из файла Order.cfg).|
 +|FIRMA |Char(50) |Название фирмы продавца.|
 +|ORDFLAG |Numeric(1) |Признак начала заказа 1 – в первой строке заказа, 0 в остальных.|
 +|PACK |Numeric(1) |Признак упаковками 1 — галочка упаковками была нажата в заказе|
 +|CASH |Numeric(1) |Галочка «Наличные» в заказе 1 – установлена.|
 +|LATITUDE |Numeric(10;5) |Широта, на которой была принята заявка.|
 +|LONGITUDE |Numeric(10;5) |Долгота, на которой была принята заявка.|
 +
 +
 +====Incass<идентификатор пользователя>.DBF – файл инкассаций====
 +
 +Файл с инкассациями от торговых агентов. Сервер никогда не переписывает этот файл. Если файла нет, то создается новый, а если файл уже есть, то сервер добавляет  в него пришедший документ. Кроме того, сервер не проверяет документы в этом файле на дублирование. Перед обработкой файла КИС должна переименовать его, а после обработки удалить.
 +
 +**Поля**
 +
 +^Название ^Тип ^Описание ^
 +|CREATED |Char(15) |Дата и время создания документа в формате ГодМесяцДеньЧасМинСек  все числа, кроме года двузначные.| 
 +|TIMEZONE       |Char(50) |Смещение зоны Гринвича от времени на КПК в минутах|
 +|DATE           |Date           |Дата документа|
 +|ID             |Char(20)       |Код контрагента|
 +|SUM         |Numeric(10;2) |Сумма|
 +|REMARK         |Char(255)      |Примечание по заказу|
 +|LATITUDE       |Numeric(10;5)  |Широта, на которой была принята заявка|
 +|LONGITUDE      |Numeric(10;5)  |Долгота , на которой была принята заявка|
 +
 +
 +
 +====PRD<идентификатор пользователя>.DBF – файл загрузки заявок====
 +
 +Файл создается и заполняется 1с при приеме заявок из файлов ORD*.DBF. Файл содержит список кодов заявок (поле CREATED) и соответствующих номеров (или уникальны идентификаторов) документов КИС. Используется программой Наполеон менеджер для контроля загрузки заявок в КИС.
 +
 +**Поля**
 +
 +^Название ^Тип ^Описание ^
 +|CREATED |Char(15) |Дата и время создания заказа в формате ГодМесяцДеньЧасМинСек  все числа, кроме года двузначные.| 
 +|NUMBER   |Char(50) |Номер заказа (совпадает с полем CREATED)|
 +
 +====POD<идентификатор пользователя>.DBF – файл подтверждения заявки====
 +
 +Файл подтверждения заявки формируется КИС при приеме заявки. После загрузки этого файла на КПК статус заявки меняется на «в обработке».
 +
 +**Поля**
 +
 +^Название ^Тип ^Описание ^
 +|CREATED |Char(15) |Код заявки (поле CREATED в заявке)| 
 +|NUMBER   |Char(50) |Примечание; если оно не пустое, то значение этого поля будет отражаться в статусе заявки вместо слов «в обработке».|
 +
 +
 +=====Формирование файлов обмена=====
 +Формировать файлы обмена рекомендуется следующим способом:
 +Выгружаем данные в файлы с временным именем, затем, после полного заполнения переименовываем в рабочие файлы. 
 +Файл USERS.DBF нельзя блокировать и удалять т. к. сервер использует этот файл для аутентификации пользователей. 
 +При обработке файлов переданных с КПК (заявки, инкассация и т.д.) необходимо перед обработкой переименовать файл, а после обработки удалить.
  
formats.txt · Последнее изменение: 2023/02/14 13:09 — salnikov