Содержание
Файлы обмена:
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. |
| COSTX | Numeric(10;2) | Цена товара X. |
| 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 уникальным (Чаще всего вида: ID Контрагента+TAB+ID торговой точки).
Поля
| Название | Тип | Описание |
|---|---|---|
| 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) | Долгота , на которой был создан документ |
| NUM_I | Char(20) | Номер накладной |
| DATE_I | Date(20) | Дата накладной |
| SUM_I | Numeric(10;2) | Сумма |
PRD<идентификатор пользователя>.DBF – файл загрузки заявок
Файл создается и заполняется 1с при приеме заявок из файлов ORD*.DBF. Файл содержит список кодов заявок (поле CREATED) и соответствующих номеров (или уникальны идентификаторов) документов КИС. Используется программой Наполеон менеджер для контроля загрузки заявок в КИС.
Поля
| Название | Тип | Описание |
|---|---|---|
| CREATED | Char(15) | Дата и время создания заказа в формате ГодМесяцДеньЧасМинСек все числа, кроме года двузначные. |
| NUMBER | Char(50) | Номер заказа (совпадает с полем CREATED) |
POD<идентификатор пользователя>.DBF – файл подтверждения заявки
Файл подтверждения заявки формируется КИС при приеме заявки. После загрузки этого файла на КПК статус заявки меняется на «в обработке».
Поля
| Название | Тип | Описание |
|---|---|---|
| CREATED | Char(15) | Код заявки (поле CREATED в заявке) |
| TYPE | Char(50) | Тип документа Order или пустая строка для заявок Incass для инкассаций |
| REMARK | Char(50) | Примечание; если оно не пустое, то значение этого поля будет отражаться в статусе заявки вместо слов «в обработке». |
RLST<идентификатор пользователя>.DBF, REPLIST .DBF– файл список отчетов
Файл содержит список отчетов доступных для заказа агенту.
Поля
| Название | Тип | Описание |
|---|---|---|
| ID | Char(55) | Код |
| NAME | Char(150) | Название |
RRQ<идентификатор пользователя>.DBF – файл запрос отчетов
Файл содержит список запросов отчетов с КПК агента.
Поля
| Название | Тип | Описание |
|---|---|---|
| ID | Char(55) | Код |
| ID_O | Char(55) | Код организации |
| DATE | Char(15) | Дата время создания |
| START | DATE | Дата начала отчета |
| END | DATE | Дата окончания отчета |
RPT<идентификатор пользователя>.DBF – файл отчетов
Файл содержит список сгенерированных отчетов для передачи на КПК.
Поля
| Название | Тип | Описание |
|---|---|---|
| ID | Char(55) | Код |
| FILE | Char(250) | Путь к файлу отчета |
| ENCODE | Char(15) | Кодировка отчета |
GPS<идентификатор пользователя>.DBF – координаты ТТ
Файл содержит координаты ТТ.
Поля
| Название | Тип | Описание |
|---|---|---|
| CREATED | Char(15) | Дата и время создания документа в формате ГодМесяцДеньЧасМинСек все числа, кроме года двузначные. |
| TIMEZONE | Number(9) | Смещение зоны Гринвича от времени на КПК в минутах |
| DATE | DATE | Дата документа |
| ID | Char(20) | Код клиента |
| LATITUDE | Numeric(10;5) | Широта, на которой был создан документ |
| LONGITUDE | Numeric(10;5) | Долгота, на которой был создан документ |
| ACC | Numeric(10;5) | Точность |
Формирование файлов обмена
Формировать файлы обмена рекомендуется следующим способом: Выгружаем данные в файлы с временным именем, затем, после полного заполнения переименовываем в рабочие файлы. Файл USERS.DBF нельзя блокировать и удалять т. к. сервер использует этот файл для аутентификации пользователей. При обработке файлов переданных с КПК (заявки, инкассация и т.д.) необходимо перед обработкой переименовать файл, а после обработки удалить.