{{keywords>мобильные решения Наполеон}} {{description>Формат файлового обмена АСМТ Наполеон }} =====Файлы обмена:===== ====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 нельзя блокировать и удалять т. к. сервер использует этот файл для аутентификации пользователей. При обработке файлов переданных с КПК (заявки, инкассация и т.д.) необходимо перед обработкой переименовать файл, а после обработки удалить.