37
Описание протокола обмена данными ПО Мобильный агент 3.1.5 Передача данных на устройство Передача данных на устройство осуществляется двумя видами обмена, обмен через сервер FTP, обмен через кабель USB (интерфейс adb). Для обмена через USB необходимо убедиться, что в устройстве установлен флаг «Отладка по USB» а также установлены драйвера под устройство в операционной системе. В противном случае автоматический обмен данными посредством кабеля будет невозможен (в тоже время остается возможность напрямую записывать файл загрузки на SD карту) Файл загрузки на устройство является текстом XML кодировки UTF-8 запакованным архиватором ZIP. Имя файла XML всегда должно иметь вид «УникальныйКодПользователя(UUID).xml», имя запакованного файла может быть разным в зависимости от вариантов необходимых действий: А) Создание начальной загрузки на «чистое» устройство: - имя файла (уже запакованного) может быть любым (как правило имя файла = ФИО пользователя) и иметь расширение «mbsi», именно по данному расширению устройство будет искать файл начальной выгрузки, т.к. уникальный идентификатор еще неизвестен. - при загрузке начальной выгрузки, устройство очистит все таблицы, и данные которые там могли быть Пример наименования файла начальной выгрузки «Петров Иван.mbsi» Б) Последующий обмен с устройством: - после создания начальной выгрузки загрузка данным на устройство осуществляется файлом с именем: Уникальный идентификатор пользователя (UUID) + расширение «mbsl» - номер сообщения должен быть равен номеру последнего сообщения, принятому с устройства (если передаются только измененные данные) Пример имени файла последующего обмена «1f262d8c-7047-11e2-8085- 0018fe7ab10e.mbsl» Формат файлов для начального и последующего обмена одинаковый, разница только в имени и расширении файла. Формат файла для передачи на устройство: Объявления XML <?xml version="1.0" encoding="UTF-8"?> Заголовок <mobile_sales version_code="1" message_number="0" last_time_coords="1363620203036" count="13"> versoin_code – код версии протокола, int должен быть «1» message_number – номер сообщения, int, при начальной выгрузке должен быть «0» если номер сообщения равен «0», база данных очищается полностью, удаляются все документы и справочники. если номер сообщения равен «-1», устройство не будет увеличивать номер сообщения (используется, например, когда передаются данные без загрузки с устройства) если номер сообщения равен «-2», устройство не будет увеличивать номер сообщения и очистит все справочные данные: номенклатура, клиенты, долги, договора,

mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

  • Upload
    others

  • View
    8

  • Download
    0

Embed Size (px)

Citation preview

Page 1: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

Описание протокола обмена данными 3.1.5ПОМобильный агент

Передача данныхна устройствоПередача данных на устройство осуществляется двумя видами обмена, обмен через сервер FTP, обмен

через кабель USB (интерфейс adb). Для обмена через USB необходимо убедиться, что в устройстве установлен флаг «Отладка по USB» а также установлены драйвера под устройство в операционной системе. В противном случае автоматический обмен данными посредством кабеля будет невозможен (в тоже время остается возможность напрямую записывать файл загрузки на SD карту)

Файл загрузки на устройство является текстом XML кодировки UTF-8 запакованным архиватором ZIP. Имя файла XML всегда должно иметь вид «УникальныйКодПользователя(UUID).xml», имя запакованного файла может быть разным в зависимости от вариантов необходимых действий:А) Создание начальной загрузки на «чистое» устройство:

- имя файла (уже запакованного) может быть любым (как правило имя файла = ФИО пользователя) и иметь расширение «mbsi», именно по данному расширению устройство будет искать файл начальной выгрузки, т.к. уникальный идентификатор еще неизвестен.

- при загрузке начальной выгрузки, устройство очистит все таблицы, и данные которые там могли бытьПример наименования файла начальной выгрузки «Петров Иван.mbsi»Б) Последующий обмен с устройством:

- после создания начальной выгрузки загрузка данным на устройство осуществляется файлом с именем: Уникальный идентификатор пользователя (UUID) + расширение «mbsl»

- номер сообщения должен быть равен номеру последнего сообщения, принятому с устройства (если передаются только измененные данные)

Пример имени файла последующего обмена «1f262d8c-7047-11e2-8085-0018fe7ab10e.mbsl»Формат файлов для начального и последующего обмена одинаковый, разница только в имени и

расширении файла.

:Форматфайла дляпередачи на устройствоОбъявления XML<?xml version="1.0" encoding="UTF-8"?>Заголовок<mobile_sales version_code="1" message_number="0" last_time_coords="1363620203036" count="13">versoin_code – код версии протокола, int должен быть «1»message_number – номер сообщения, int, при начальной выгрузке должен быть «0»

если номер сообщения равен «0», база данных очищается полностью, удаляются все документы и справочники.

если номер сообщения равен «-1», устройство не будет увеличивать номер сообщения (используется, например, когда передаются данные без загрузки с устройства)

если номер сообщения равен «-2», устройство не будет увеличивать номер сообщения и очистит все справочные данные: номенклатура, клиенты, долги, договора, ассортимент Документы и другие данные внесенные пользователем на устройстве не удаляются.

last_time_coords – последнее принятых координат в базе данных, long count – количество всех элементов передаваемых в сообщении, intversion_name – версия программы, stringroot – признак того что устройство рутировано, booleanfake_location – признак того что пользователь использовал фиктивные местоположения, boolean

Page 2: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

Настройки пользователя<settings><user_name>Василий</user_name> - ФИО пользователя, string<user_guid>49a6ceda-643a-11e1-b890-1c4bd69d8841</user_guid> - GUID, string<control_of_packaging>1</control_of_packaging> Контроль фасовки, 0 или 1<control_of_receivables>0</control_of_receivables>Контроль задолженности, 0 или 1<control_of_store_check>0</control_of_store_check> Контроль снятия сторчека, 0 или 1<control_of_price>0</control_of_price> запрет изменения цены, 0 или 1 <control_of_location>1</control_of_location> снятие координат, 0 или 1<track_interval>7</track_interval>интервал снятия координат в секундах, int<track_start_time>245404800000</track_start_time>время начала трека 24*Часы*Минуты*60*1000, long<track_end_time>245448000000</track_end_time> время окончания трека 24*Часы*Минуты*60*1000, long<track_day_of_week>12345</track_day_of_week> дни недели для снятия трека 1-понедельник, 2-вторник и т.д., string<control_of_settings>0</control_of_settings> запрет на изменение настроек, 1 или 0<text_currency>руб</text_currency> название валюты, string<ftp_server_name>xxx.xxx.dp.ua</ftp_server_name> имя сервера FTP, string <ftp_server_login>xxx</ftp_server_login> имя пользователя FTP, string<ftp_server_password>xxx</ftp_server_password> пароль пользователя FTP, string<ftp_directory>Тест</ftp_directory> директория FTP, string<bussines_name>Наша фирма</bussines_name>наименование фирмы для вывода в PDF, string<control_price_change >0</control_price_change >запретить ручное изменение цен, 0 или 1 <control_discount>0</control_discount>запретить ручное изменение скидки, 0 или 1<blocking_priority>0</blocking_priority>блокирующий приоритет, 0 или 1 (обязательная приоритетная позиция в заказе)<control_upload_documents>10</control_upload_documents>максимальное количество невыгруженных заказов, после которого будет запрещено оформление новых, 0 – неограниченно, integer<livetime_archive>3</livetime_archive>максимальное время жизни архивных копий базы данных в днях, 0 – неограниченно, integer<easy_storecheck >0</ easy_storecheck > снимать сторчек в одно касание , 1 или 0<disable_new_client>0</disable_new_client> запретить создание новых контрагентов , 0 или 1<barcode_title>0</barcode_title> показывать штрих код в названии номенклатуры , 0 или 1<control_price_change >0</control_price_change >запретить ручное изменение цен, 0 или 1 <control_balance>0</control_balance> пропускать номенклатуру без остатка, 0 или 1 < bind_nomenclature_warehouse>0</ bind_nomenclature_warehouse> привязывать номенклатуру к складу, 0 или 1 <disable_ordering_on_the_couch>0</disable_ordering_on_the_couch> запретить оформлять заказы находясь не в торговой точке, 0 или 1 <disable_change_coord>0</disable_change_coord> запретить изменять координаты торговой точки, 0 или 1 <disable_edit_client>0</disable_edit_client> запретить изменять данные торговой точки, 0 или 1 <minimum_balance>10</minimum_balance>остаток меньше которого отображать количество красным, int<option_sort_hierarchy>0</ option_sort_hierarchy>сортировать номенклатуру на устройстве, 0 или 1 <messages_server_name>127.0.0.1 </messages_server_name> имя сервера сообщений , string<messages_server_port>4444</messages_server_port> порт сервера сообщений, integer<email_address>[email protected]</email_address> адрес почты куда отправится выгрузка в случае недоступности сервера FTP , string<user_group>Общая</user_group> имя сервера сообщений , string<one_reason_return>1</one_reason_return> использовать одну причину возврата на документ: 1 или использовать причину возврата для каждой номенклатуры: 0 <guaranteed_delivery>1</ guaranteed_delivery>гарантированная доставка (документы будут выгружаться программой постоянно, пока не будет подтверждения по каждому документу, 0 или 1 <support_email>[email protected]</ support_email> электронный адрес поддержки приложения <support_tel>+380675221080</support_tel> телефон поддержки приложения <support_skype>chegal_serg </support_skypel> скайп поддержки приложения <changes_remnants>1</ changes_remnants> разрешить акту инвентаризации менять остатки на складе , 0 или 1<control_check_print>1</ control_check_print> запретить изменять или удалять документы на которые распечатан чек, 0 или 1<track_buzzler>1</ track_buzzler> подавать звуковой сигнал при отключении GPS, 0 или

Page 3: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

<storecheck_bbd>1</storecheck_bbd>Возможность заполнять дату изготовления в сторчеке и инвентаризации, 0 или 1<disable_returns_without_base>1</disable_returns_without_base>Запретить возвраты без основания, 0 или 1<show_number_keyboard_on_scan>1</ show_number_keyboard_on_scan >Показывать ввод количества при сканировании IR сканером, 0 или 1 (если 0 – просто добавляется +1)

Так же есть возможность устанавливать доступность настроек путем передачи значения состоящего из имени настройки и слова “enabled”Например, необходимо скрыть настройку «control_of_price», для этого передаем значение<control_of_price_enabled>0</control_of_price_enabled>Аналогично можно разрешить редактирование одной опции из группы «Контроль» при запрете изменения настроек: <control_of_settings>1</control_of_settings> <control_of_price_enabled>1</control_of_price_enabled>different_types_of_prices_for_rows<different_types_of_prices_for_rows>1</different_types_of_prices_for_rows> Использовать отдельный прайс для каждой строки номенклатуры в заказе <control_selling>1</control_selling> Возможность оформлять оплаты в заказе

</settings>

Так же в настройках можно передавать свойство <clear_table>Имя таблицы</clear_table>Данное свойство приводит к очищению соответствующей таблицы, например инструкция, <clear_table>T_NOMENCLATURE</clear_table> очистит таблицу номенклатуры.Данное действие необходимо в том случает, если в устройство передается каждый раз полный набор данных.Т.е. для того чтобы очистить справочники перед повторной загрузкой необходимо перед тегом </settings>добавить строки:<clear_table>T_NOMENCLATURE</clear_table> <clear_table>T_CLIENT</clear_table> <clear_table>T_PRICE_NAME</clear_table> <clear_table>T_PRICE</clear_table> <clear_table>T_CONTRACT</clear_table> <clear_table>T_DEBTS</clear_table>

« » (T_NOMENCLATURE)Таблица НоменклатураТаблица передается последовательно, для соблюдения иерархии необходимо в запросе 1С ставить условие «УПОРЯДОЧИТЬ ПО Наименование ИЕРАРХИЯ»<T_NOMENCLATURE><N_ID>000000003</N_ID> Уникальный код номенклатуры, string<N_NAME>Товары</N_NAME> Наименование, string<N_ISGROUP>1</N_ISGROUP> это группа, 1 или 0<N_PARENTID></N_PARENTID> Уникальный код родителя в иерархии, string<N_BARCODE >4820078773691</N_BARCODE > Шрих код, string<N_PACKING>5</N_PACKING> Количество номенклатуры в 1-й упаковке, float<N_BALANCE>100</N_BALANCE>Количество номенклатуры на остатке, float (используется если не ведется учет по разным складам)<N_SORTORDER>1</N_SORTORDER> Значение упорядочивания, int<N_ASSORTMENTID>000000001</N_ASSORTMENTID> Уникальный код таблицы «Ассортимент», string<N_BASIC_UNIT_NAME>шт.</N_BASIC_UNIT_NAME>Наименование базовой единицы, string<N_SHOWCASE>3.5</ N_SHOWCASE>Рекомендуемая цена продажи, float<N_HIDE_IN_ORDER>1</N_HIDE_IN_ORDER >Не показывать в заказах, 0 или 1 <N_HIDE_IN_STORECHEK>0</N_HIDE_IN_STORECHEK >Не показывать в сторчеке, 0 или 1<N_HIDE_IN_RETURN>0</N_HIDE_IN_RETURN>Не показывать в возвратах, 0 или 1 <N_BG_COLOR>1</N_BG_COLOR> Цвет фона номенклатуры, int<N_TEXT_COLOR>1</N_TEXT_COLOR> Цвет текста номенклатуры, int

Page 4: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

<N_TOP_LIST>1</N_TOP_LIST>Показывать в разделе «Приоритет», 0 или 1 <N_CHARACTER_NAME>Состав: 40 гр муки, 10 гр. сахара</N_CHARACTER_NAME> Дополнительное поле для информации по номенклатуре, string

</T_NOMENCLATURE>

Таблица «Клиенты» (T_CLIENT )Таблица клиенты может иметь структуру подчинения Контрагент – Торговая точка в том случае, если у одного контрагента в базе данных может быть несколько адресов доставки<T_CLIENT><N_ID>000000001</N_ID> Уникальный код торговой точки (адреса доставки), string<N_PARENTID>000000001</N_PARENTID> Уникальный код контрагента, string<N_NAME>ЧП Иванова</N_NAME> Наименование клиента, string<N_GROUP_NAME>Покупатели</N_GROUP_NAME> Наименование группы клиента, string<N_OBJECT>ресторан</N_OBJECT> Объект, string<N_ADDRESS>ул. Кирова 101</N_ADDRESS> Адрес доставки, string<N_CONTACT>Светлана</N_CONTACT>Контактное лицо, string<N_DEFAULT_PRICEID>000000001</N_DEFAULT_PRICEID>Уникальный код таблицы «Тип цен» подставляемый по умолчанию для клиента, string<N_DEFAULT_CONTRACTID>000000002</N_DEFAULT_CONTRACTID>Уникальный код таблицы «Договора» подставляемый по умолчанию для клиента, string<N_DEFAULT_UNITID>000000002</N_DEFAULT_UNITID>Уникальный код таблицы «Единицы» подставляемый по умолчанию для клиента, string<N_LOGISTICID>Розница</N_LOGISTICID>Тип торговой точки по логистике, string<N_SORTORDER></N_SORTORDER> Порядок сортировки, int<N_CLIENTTYPEID>Магазин А</N_CLIENTTYPEID>Тип клиента, string<N_DAYS_OF_WEEK>001000000000000000000</N_DAYS_OF_WEEK>Дни недели и порядок для маршрута, stringДни недели поделены на триады чисел, т.е. 000 000 000 000 000 000 000 Каждая триада соответствует одному дню недели, по порядку начиная с понедельника, в качестве числа триады передается порядок обхода торговой точкис выравниванием до 3-х символов. Например, шифр 001003000000000000000 будет обработан как: торговая точка участвует в маршруте в понедельник и вторник, причем в понедельник она будет первой по порядку, а во вторник третьей, в другие дни недели торговая точка не обходится<N_TASK></N_TASK>Задача торговому представителю, string<N_LNG>45.332455</N_LNG>Долгота расположения торговой точки, double<N_LAT>30.324321</N_LAT>Широта расположения торговой точки, double<N_PRIORITY></N_PRIORITY>Коды приоритетной номенклатуры, string<N_EXCEPTIONS></N_EXCEPTIONS>Коды номенклатуры которая должна быть недоступна для данного клиента, string<N_PHONE>911</N_PHONE>Телефон, string<N_EMAIL>testmail.ru</N_EMAIL> электронная почта, string<N_ADVANCED>Лицензия №1232137</N_ADVANCED> дополнительная информация по клиенту, string<N_EVEN_WEEK>0120000</ N_EVEN_WEEK > порядок посещений по неделям (четная/нечетная) в дни недели, string<N_DEFAULT_ASSORTMENT>00001</N_DEFAULT_ASSORTMENT> Код ассортимента по умолчанию, string<N_MAX_DEBT>100.99</ N_MAX_DEBT> Максимальный долг клиента после которого нельзя создавать заказы, float</T_CLIENT>

Таблица «Ассортимент» (T_ASSORTMENT)<T_ASSORTMENT><N_ID>000000001</N_ID> Уникальный код ассортимента, string<N_NAME>Общий</N_NAME>Наименование, string</T_ASSORTMENT>

Page 5: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

« » (Таблица Типыценноменклатуры T_PRICE_NAME)<T_PRICE_NAME><N_ID>000000001</N_ID>Уникальный код типа цены, string <N_NAME>Розница</N_NAME>Наименование типы цена, string</T_PRICE_NAME>

« » (T_PRICE)Таблица Ценыноменклатуры<T_PRICE><N_PRICEID>000000002</N_PRICEID>Уникальный код типа цены, string<N_NOMENID>000000002</N_NOMENID>Уникальный код номенклатуры, string<N_PRICE>4</N_PRICE>Цена номенклатуры, float</T_PRICE>

Таблица «Договора» (T_CONTRACT)<T_CONTRACT><N_ID>83903aba-8fb5-11e2-8411-005056c00008</N_ID> Уникальный код договора, string<N_PARENTID>000000001</N_PARENTID> Уникальный код таблицы «Контрагенты», string <N_NAME>Договор</ N_NAME > Наименование договора, string <N_NUMBER>1</N_NUMBER> Номер договора, stringN_FORMID<N_FORMID>1</N_FORMID>Форма договора, 1 или 2, string<N_DAY_OF_DELAY>12</N_DAY_OF_DELAY> Дней отсрочки платежа, int<N_DAY_OF_CONTRACT>1362096000000</N_DAY_OF_CONTRACT> Дата заключения, long<N_DAY_OF_TERMINATION>1363910400000</N_DAY_OF_TERMINATION>Дата окончания, long<N_PRICEID>12131</N_PRICEID>Уникальный код типа цен, string<N_DEFAULT_ASSORTMENT>00001</N_DEFAULT_ASSORTMENT> Код ассортимента по умолчанию, string</T_CONTRACT>

« » (T_DEBTS)Таблица Кредитовые документы<T_DEBTS><N_PARENTID>AC0000004913</N_PARENTID>Уникальный код таблицы «Контрагенты», string<N_TYPE>Расходная накладная</N_TYPE>Тип документа, string<N_BASE_ID>3203aba-23b5-13e2-8411-005056c00008</N_BASE_ID>Уникальный код кредитового документа, string<N_NUMBER>AC0000141721</N_NUMBER>Номер кредитового документа, string<N_DATE>1356321600000</N_DATE>Дата документа, long<N_SUM>59.4</N_SUM>Сумма документа, float<N_SUM_OVERDUE>59.4</N_SUM_OVERDUE>Сумма просроченного долга по документу, float<N_FORMID>1</N_FORMID>Форма долга 1 или 2, string </T_DEBTS>

« » (Таблица Единицыизмерения T_UNITS)< T_UNITS><N_ID>3203aba-23b5-13e2-8411-005056c00008</N_ID>Уникальный код единицы, string < N_NAME>кг.</ N_NAME>Наименование единицы измерения, string</ T_UNITS>

« » (Таблица Единицыизмеренияпо номенклатуре T_NOMEN_UNITS)< T_NOMEN_UNITS>< N_NOMEN_ID>3203aba-23b5-13e2-8411-005056c00008</N_NOMEN_ID>Уникальный код номенклатуры, string < N_UNIT_ID>3203aba-23b5-13e2-2411-005056c00018.</N_UNIT_ID> Уникальный код единицы, string< N_FACTOR>1.5</ N_FACTOR> Коэффициент пересчета от базовой единицы, float</ T_NOMEN_UNITS>

Page 6: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

Таблица «Причины возвратов» (T_RETURN_REASON)< T_RETURN_REASON><N_ID>3203aba-23b5-13e2-8411-005056c00008</N_ID>Уникальный код причины возврата, string < N_NAME>Брак продукции</ N_NAME>Наименование причины возврата, string</ T_RETURN_REASON>

Таблица «Ограничения по ценам» (T_PRICE_LIMIT)< T_PRICE_LIMIT>< N_CLIENT_ID>3203aba-23b5-13e2-8411-005056c00008</ N_CLIENT_ID>Уникальный код клиента, string < N_PRICE_ID>3103aba-23b5-13e2-8410-205056c00007</ N_PRICE_ID> Уникальный код прайса, string </ T_PRICE_LIMIT>

Таблица «Разрешенные типы цен» (T_ALLOWED_PRICE)< T_ALLOWED_PRICE><N_NOMENID>3203aba-23b5-13e2-8411-005056c00008</N_NOMENID>Уникальный код номенклатуры, string <N_CLIENT_ID>3203aba-23b5-13e2-8411-005056c00008</ N_CLIENT_ID>Уникальный код клиента, string <N_PRICE_ID>3103aba-23b5-13e2-8410-205056c00007</ N_PRICE_ID> Уникальный код прайса, string </ T_ALLOWED_PRICE>

Таблица «Скидки клиентам» (T_DISCOUNT)<T_DISCOUNT><N_CLIENT_ID>3203aba-23b5-13e2-8411-005056c00008</ N_CLIENT_ID>Уникальный код клиента (если значение «ALL» – то по всем клиентам), string <N_PRICE_ID>3103aba-23b5-13e2-8410-205056c00007</ N_PRICE_ID> Уникальный код прайса, (если значение «ALL» – то по всем прайсам) string < N_NOMEN_ID>3103aba-23b5-13e2-8410-205056c00007</ N_NOMEN_ID> Уникальный код номенклатуры, (если значение «ALL» или не заполнено – то по всей номенклатуре) string <N_PERCENT>10.0</ N_PERCENT> Процент скидки контрагенту, float <N_MAX_PERCENT>20.0</ N_MAX_PERCENT> Максимальный процент скидки контрагенту, float</ T_DISCOUNT>

Таблица «Стандарты» (T_STANDART)< T_STANDART>< N_ID>3203aba-23b5-13e2-8411-005056c00008</ N_ID >Уникальный код стандарта, string < N_LOGISTICID >Розница</N_LOGISTICID > Тип логистики клиента, string < N_CLIENTTYPEID >Оптовый</ N_CLIENTTYPEID > Тип клиента, string </ T_STANDART>

Таблица «СКЮ» (T_SKU)< T_SKU >< N_ID>3203aba-23b5-13e2-8411-005056c00008</ N_ID >Уникальный код СКЮ, string < N_NAME >Фасованная рыба</N_NAME > Наименование СКЮ, string </ T_SKU >

(Таблица связейСКЮсоСтандартами T_STANDART_SKU)< T_STANDART_SKU >< N_STANDART_ID >3203aba-23b5-13e2-8411-005056c00008</ N_STANDART_ID >Уникальный код стандарта, string < N_SKU_ID >3203aba-23b5-13e2-8411-005056c00108</N_SKU_ID > Уникальный код СКЮ, string< N_SKU >Фасованная рыба</N_SKU >Количество СКЮ необходимое для выполнения стандарта, int</ T_STANDART_SKU >

Page 7: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

(Таблица связей номенклатурысСКЮ T_STANDART_NOMEN)< T_STANDART_NOMEN >< N_NOMEN_ID >3203aba-23b5-13e2-8411-005056c00008</ N_NOMEN_ID >Уникальный код номенклатуры, string < N_SKU_ID >3203aba-23b5-13e2-8411-005056c00108< N_SKU_ID > Уникальный код СКЮ, string</ T_STANDART_NOMEN >

Таблица «Принятые заказы» (T_APPROVED_ORDERS)<T_APPROVED_ORDERS><N_ID>3203aba-23b5-13e2-8411-005056c00008</N_ID>Уникальный код документа, string UUID<N_BB_NUMBER>AC0021332</ N_BB_NUMBER>Номер документа присвоенный базой, string</T_APPROVED_ORDERS>

Таблица «Принятые приходные накладные» (T_APPROVED_PURCHASES)<T_APPROVED_PURCHASES><N_ID>3203aba-23b5-13e2-8411-005056c00008</N_ID>Уникальный код документа, string UUID<N_BB_NUMBER>AC0021332</ N_BB_NUMBER>Номер документа присвоенный базой, string</T_APPROVED_PURCHAES>

Таблица «Принятые кассовые ордера» (T_APPROVED_CASH_ORDERS)<T_APPROVED_CASH_ORDERS><N_ID>32213aba-23b5-13e2-8411-005056c00008</N_ID>Уникальный код документа, string UUID<N_BB_NUMBER>AC0021332</ N_BB_NUMBER>Номер документа присвоенный базой, string</T_APPROVED_CASH_ORDERS>

Таблица «Принятые сторчеки» (T_APPROVED_STORECHECK)<T_APPROVED_STORECHECK><N_ID>2303aba-23b5-13e2-8411-005056c00008</N_ID>Уникальный код документа, string UUID<N_BB_NUMBER>AC0021332</ N_BB_NUMBER>Номер документа присвоенный базой, string</T_APPROVED_STORECHECK>

Таблица «Принятые фотографии» (T_APPROVED_PHOTOS)< T_APPROVED_PHOTOS><N_ID>2333aba-23b5-13e2-8411-005056c00008</N_ID>Уникальный код фотографии, string UUID</ T_APPROVED_PHOTOS>

Таблица «Принятые возвраты» (T_APPROVED_RETURNS)<T_APPROVED_RETURNS><N_ID>3203aba-21b5-13e2-8411-005056c00008</N_ID>Уникальный код документа, string UUID<N_BB_NUMBER>AC0021332</ N_BB_NUMBER>Номер документа присвоенный базой, string</T_APPROVED_RETURNS >

Таблица «Принятые клиенты» (T_APPROVED_CLIENTS)<T_APPROVED_CLIENTS><N_ID>3203aba-21b5-13e2-8411-005056c00008</N_ID>Уникальный код клиента, string UUID</T_APPROVED_CLIENTS>

Page 8: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

Таблица «Принятые выполненные задачи» (T_APPROVED_TASK_EXECUTION)<T_APPROVED_TASK_EXECUTION><N_ID>3203aba-21b5-13e2-8411-005056c00009</N_ID>Уникальный код задачи, string UUID</T_APPROVED_TASK_EXECUTION>

Таблица «Принятые ответы анкетирования» (T_APPROVED_ANSWERS)<T_APPROVED_ANSWERS><N_ID>3203aba-21b5-13e2-8411-005056c00009</N_ID>Уникальный код ответа, string UUID<N_BB_NUMBER>AC0011332</ N_BB_NUMBER>Номер документа присвоенный базой, string</T_APPROVED_ANSWERS >

Таблица «Внешние документы» (T_EXTERNAL)<T_ T_EXTERNAL><N_ID>1203aba-21b5-13e2-8411-005056c00008</N_ID>Уникальный код клиента, string UUID<N_NAME>Отчет зп период с 10 по 20</N_NAME>Наименование, string<N_DESCRIPTION>Взаиморасчеты с контрагентами</N_DESCRIPTION>Описание, string<N_BODY_BASE64>kldioKIALKl3JDsdj3dnod[ki9032Nnkndiwh23nd</N_BODY_BASE64>Тело документа HTML закодированное в строку Base64, string<N_BEGIN_DATE>10432432423432</ N_BEGIN_DATE>Дата начала действия документа, long (Unix date)<N_END_DATE>10432432423432</ N_END_DATE>Дата окончания действия документа, long (Unix date)<N_PARENT_ID>1103aba-21b5-13e2-8411-005056c00008</N_PARENT_ID>Уникальный код родителя, string UUID<N_IS_GROUP>0</N_IS_GROUP> Признак группы (0 или 1)

</ T_EXTERNAL>

Таблица «Места отгрузки, склады» (T_WAREHOUSE)<T_WAREHOUSE ><N_ID>3203aba-23b5-13e2-8411-005056c00008</ N_ID >Уникальный код склада, string <N_NAME >Склад основной<N_NAME > Наименование склада, string <N_PRICEID>1203aba-23b5-13e2-8411-005056c00008</N_PRICEID >Уникальный код цен номенклатуры, string <N_ASSORTMENTID>2203aba-23b5-13e2-8411-005056c00008</N_ASSORTMENTID >Уникальный код ассортимента, string </T_WAREHOUSE >

« » (Таблица Остаткипо складам T_REMAINS)<T_REMAINS ><N_NOMENID>00123</ N_NOMENID >Уникальный код номенклатуры, string <N_WAREHOUSEID>3203aba-23b5-13e2-8411-005056c00008<N_WAREHOUSEID> Уникальный код склада, string<N_NUMBER>10</ N_NUMBER >Остаток, float</T_ REMAINS>

Таблица «Шапка анкетирования клиентов» (T_QUESTION_TITLE)<T_QUESTION_TITLE><N_ID>00123</ N_ID>Уникальный код анкетирования, string <N_NAME>Маркетинговые исследования<N_NAME> Наименование опроса, string<N_BEGIN_DATE>10432432423432</ N_BEGIN_DATE>Дата начала опроса, long (Unix date)<N_END_DATE>10432432423432</ N_END_DATE>Дата окончания опроса, long (Unix date)<N_BG_COLOR>-8411393</<N_BG_COLOR>Цвет фона, integer</T_QUESTION_TITLE>

« » (Таблица Вопросы к анкетированиюклиентов T_QUESTION_TABLE)<T_QUESTION_TABLE>

Page 9: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

<N_NAME>Сколько Вам лет?<N_NAME> Наименование вопроса, string<N_ORDER>1</N_ORDER>Номер по порядку, integer<N_TITLE_ID>00123</N_TITLE_ID> Уникальный код анкетирования (T_QUESTION_TITLE), string<N_VALUE_TYPE>2</N_VALUE_TYPE>Тип ответа, integer, может принимать значения

если ответ «Да/Нет» тогда 1 если ответ «Число» тогда 2 если ответ «Текст» тогда 3 если ответ необходимо выбрать из списка тогда 4

<N_VALUES>Один;Два;Три;</N_VALUES>Список для выбора ответа, строки разделенные точкой с запятой, string, (используется в том случае если тип ответа установлен в «4»<N_DEFAULT >Один;Два;Три;</N_DEFAULT >Значение по умолчанию, string</T_QUESTION_TABLE>

Таблица «Задача менеджеру» (T_TASK)<T_TASK><N_ID>123213213<N_ID> Уникальный код задачи, string <N_NAME>Снять координаты<N_NAME> Наименование задачи, string <N_DESCRIPTION>установить координаты торговой точки<N_DESCRIPTION> Описание задачи задачи, string <N_CLIENTID>Снять координаты<N_CLIENTID> Уникальные коды клиентов одной строкой для которых создана задачи (если не указывать, то задача распространяется для всех клиентов), string <N_BEGIN_DATE>10432432423432</ N_BEGIN_DATE>Дата начала задачи, long (Unix date)<N_END_DATE>10432432423432</ N_END_DATE>Дата окончания задачи, long (Unix date)<N_ORDER>1</N_ORDER> Номер по порядку, integer<N_BLOCKING>1</N_BLOCKING> Блокирующая задача, 1 или 0. Если значение 1, тогда будет запрещено создавать документы пока задача не выполнена<N_ITERATION>5</N_ITERATION> Количество повторений задачи после которого она считается выполненной, integer,

если используется задача под конкретных клиентов количество повторений должно быть равно количеству клиентов

если значение количества повторений равно нулю – задача не завершается на всем промежутке времени если значение больше нуля и не заполнены коды клиентов – задача будет выполняться для любых

клиентов указанное количество<N_OBJECT_ID>00123<N_OBJECT_ID> Уникальный код объекта задачи, string (имеет смысл заполнять, например, при наличии разных опросов клиентов в одно время, т.е. если необходимо, чтобы данная задача была привязана только к одному анкетированию, то сюда необходимо записать его уникальный код, в других случаях не используется)<N_TO_DO>1</N_TO_DO> Действие которое привязано к выполнению задачи, integer, может принимать значения0 – задача свободная, не требует действий (например, напоминание)1 – для выполнения задачи необходимо оформить заказ2 – для выполнения задачи необходимо оформить возврат3 – для выполнения задачи необходимо оформить кассовый ордер4 – для выполнения задачи необходимо оформить сторчек 5 – для выполнения задачи необходимо произвести анкетирование6 - для выполнения задачи необходимо снять фотографию7 – для выполнения задачи необходимо установить координаты<N_ALERT_TIME>10432432423432</N_ALERT_TIME> Время напоминания о задачи средствами системы, long (Unix date)</T_TASK>

:Пример полного файла выгрузки

Имя архива: Иванов Иван.mbsi или 6a19533e-c4b7-11e0-b644-0015172808f3.mbslИмя файла в архиве: 6a19533e-c4b7-11e0-b644-0015172808f3.xml

Page 10: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

<?xml version="1.0" encoding="UTF-8"?><mobile_sales version_code="1" message_number="0" last_time_coords="1363620203036" count="13"><settings><user_name>Василий</user_name><user_guid>49a6ceda-643a-11e1-b890-1c4bd69d8841</user_guid><control_of_packaging>1</control_of_packaging><control_of_receivables>0</control_of_receivables><control_of_store_check>0</control_of_store_check><control_of_price>0</control_of_price><control_of_location>1</control_of_location><track_start_time>245404800000</track_start_time><track_end_time>245448000000</track_end_time><track_day_of_week>12345</track_day_of_week><control_of_settings>0</control_of_settings><text_currency>руб</text_currency><ftp_server_name>ftp.test.dp.ua</ftp_server_name><ftp_server_login>test</ftp_server_login><ftp_server_password>test</ftp_server_password><ftp_directory>Тест</ftp_directory></settings><T_NOMENCLATURE><N_ID>000000003</N_ID><N_NAME>Товары</N_NAME><N_ISGROUP>1</N_ISGROUP><N_PARENTID></N_PARENTID><N_PACKING></N_PACKING><N_BALANCE></N_BALANCE><N_SORTORDER>1</N_SORTORDER><N_ASSORTMENTID>000000001</N_ASSORTMENTID></T_NOMENCLATURE><T_NOMENCLATURE><N_ID>000000001</N_ID><N_NAME>Водка</N_NAME><N_ISGROUP>0</N_ISGROUP><N_PARENTID>000000003</N_PARENTID><N_PACKING></N_PACKING><N_BALANCE></N_BALANCE><N_SORTORDER>2</N_SORTORDER><N_ASSORTMENTID>000000001</N_ASSORTMENTID></T_NOMENCLATURE><T_NOMENCLATURE><N_ID>000000002</N_ID><N_NAME>Пиво</N_NAME><N_ISGROUP>0</N_ISGROUP><N_PARENTID>000000003</N_PARENTID><N_PACKING></N_PACKING><N_BALANCE></N_BALANCE><N_SORTORDER>3</N_SORTORDER><N_ASSORTMENTID>000000001</N_ASSORTMENTID></T_NOMENCLATURE><T_CLIENT><N_ID>000000001</N_ID><N_PARENTID>000000001</N_PARENTID><N_NAME>ЧП Иванова</N_NAME><N_OBJECT>ресторан</N_OBJECT><N_ADDRESS>ул. Кирова 101</N_ADDRESS><N_CONTACT>911</N_CONTACT><N_DEFAULT_PRICEID>000000001</N_DEFAULT_PRICEID>

Page 11: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

<N_LOGISTICID>Розница</N_LOGISTICID><N_SORTORDER></N_SORTORDER><N_CLIENTTYPEID>Магазин А</N_CLIENTTYPEID><N_DAYS_OF_WEEK>001000000000000000000</N_DAYS_OF_WEEK><N_TASK></N_TASK><N_LNG></N_LNG><N_LAT></N_LAT><N_PRIORITY></N_PRIORITY></T_CLIENT><T_ASSORTMENT><N_ID>000000001</N_ID><N_NAME>Общий</N_NAME></T_ASSORTMENT><T_PRICE_NAME><N_ID>000000001</N_ID><N_NAME>Розница</N_NAME></T_PRICE_NAME><T_PRICE_NAME><N_ID>000000002</N_ID><N_NAME>Отсрочка</N_NAME></T_PRICE_NAME><T_PRICE><N_PRICEID>000000001</N_PRICEID><N_NOMENID>000000001</N_NOMENID><N_PRICE>1</N_PRICE></T_PRICE><T_PRICE><N_PRICEID>000000002</N_PRICEID><N_NOMENID>000000001</N_NOMENID><N_PRICE>2</N_PRICE></T_PRICE><T_PRICE><N_PRICEID>000000001</N_PRICEID><N_NOMENID>000000002</N_NOMENID><N_PRICE>3</N_PRICE></T_PRICE><T_PRICE><N_PRICEID>000000002</N_PRICEID><N_NOMENID>000000002</N_NOMENID><N_PRICE>4</N_PRICE></T_PRICE><T_CONTRACT><N_ID>83903aba-8fb5-11e2-8411-005056c00008</N_ID><N_PARENTID>000000001</N_PARENTID><N_NUMBER>1</N_NUMBER><N_FORM>Ф1</N_FORM><N_DAY_OF_DELAY>12</N_DAY_OF_DELAY><N_DAY_OF_CONTRACT>1362096000000</N_DAY_OF_CONTRACT><N_DAY_OF_TERMINATION>1363910400000</N_DAY_OF_TERMINATION></T_CONTRACT><T_CONTRACT><N_ID>b4c8a6bc-8fb5-11e2-8411-005056c00008</N_ID><N_PARENTID>000000001</N_PARENTID><N_NUMBER>2</N_NUMBER><N_FORM>Ф2</N_FORM><N_DAY_OF_DELAY>0</N_DAY_OF_DELAY><N_DAY_OF_CONTRACT>1362096000000</N_DAY_OF_CONTRACT><N_DAY_OF_TERMINATION>1364515200000</N_DAY_OF_TERMINATION>

Page 12: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

</T_CONTRACT></mobile_sales>

Page 13: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

Данный файл записывает в кодировке UTF-8.Имя данного файла должно содержать уникальный код (UUID) пользователя устройства, расширение «xml»После создания файл пакуется архиватором ZIP и запакованному файлу устанавливается расширение и имя в зависимости от того начальная это загрузка или обновление.

Приемданных с устройстваПрием данных с устройства осуществляется двумя способами, по кабелю USB, с сервера FTP. Прием по

кабелю USB возможен только в том случае, если установлены драйвера на устройство и включен режим «Отладка USB»

Файл данных, которое передает устройство, имеет имя «UUID.mbsu» где UUID уникальный идентификатор устройства. Файл представляет собой архив ZIP, содержащий в свою очередь файл UUID.xml UTF-8, который имеет формат:

, :Форматфайла передаваемый устройством

Объявления XML:<?xml version="1.0" encoding="UTF-8"?>

Заголовок:<mobile_sales version_code="1" message_number="2" count="3">versoin_code – код версии протокола, int должен быть «1»message_number – номер сообщения, intcount – количество всех элементов передаваемых в сообщении, int

Таблицашапки заказа<T_ORDER_TITLE> <N_BB_NUMBER></N_BB_NUMBER>Номер заказ базы данных, string (не используется) <N_CLIENTID>AC00001236</N_CLIENTID>Уникальный код торговой точки (адреса доставки), string <N_COMMENT></N_COMMENT>Комментарий к заказу, string <N_PRICEID>ЦБ0001100000</N_PRICEID>Уникальный код типа цены, string <N_PARENTID>AC0000001056</N_PARENTID>Уникальный код контрагента, string <N_CONTRACTID>0000002053</N_CONTRACTID>Уникальный код договора, string <N_FORMID>2</N_FORMID>Код формы документа, 2-Ф2, 1-Ф1, int <N_ID>9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64</N_ID>Уникальный код документа, string UUID <N_UPLOAD>false</N_UPLOAD>флаг выгрузки, boolean (не используется) <N_LNG>0.0</N_LNG>Долгота местоположения снятия заказа, double <N_LAT>0.0</N_LAT>Широта местоположения снятия заказа, double <N_DATE>1363686675015</N_DATE>Дата заказа, long <N_SAVE_DATE>1363686675015</N_SAVE_DATE>Дата сохранения заказа, long <N_CREATE_DATE>1363636675015</N_CREATE_DATE>Дата создания заказа, long <N_DELAY>true</N_DELAY>Отсрочка или факт, boolean <N_SUM>20.0</N_SUM>Сумма заказа, float <N_SHIPMENT_DATE>1363686675015</N_SHIPMENT_DATE>Дата отгрузки, long <N_WAREHOUSE_ID >9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64</N_WAREHOUSE_ID>Код места хранения (склада), string UUID <N_HAVE_DISCOUNT>false</N_HAVE_DISCOUNT>Есть ли в заказе скидки, Boolean <N_GEOADDRESS>проспект Кирова 10</N_GEOADDRESS>Адрес, где оформлен документ, string <N_CHECK_NUMBER>20161011094532</N_CHECK_NUMBER>Номер чека при печати, string <N_PERIOD>1363686675015</N_ PERIOD> Время работы с документом, long<N_BG_COLOR>-8411393</<N_BG_COLOR>Цвет фона, integer

<N_SHIPPED>-1</<N_SHIPPED>Признак того что заказ отгружен, 1 или 0<N_CASH_SUM>-100.00</<N_CASH_SUM>Сумма оплаты, float<N_CASH_ID>-9c12c6f6-d12d-42a7-a9d8-ba3c6527ef64</<N_CASH_ID>Идентификатор ПКО, string UUID

Page 14: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

</T_ORDER_TITLE>

Таблица номенклатурызаказа<T_ORDER_TABLE> <N_ID>9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64ЦБ03084</N_ID>Уникальный код документа, string UUID <N_NOMENID>ЦБ03084</N_NOMENID>Уникальный код номенклатуры, string <N_TITLEID>9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64</N_TITLEID>Уникальный код шапки, string UUID <N_NUMBER>10.0</N_NUMBER>Количество номенклатуры, float <N_UNIT_ID>10.0</N_UNIT_ID>Код единицы измерения, string <N_FACTOR>1.5</N_FACTOR>Коэффициент пересчета от базовой единицы, float <N_MANUAL_PRICE>false</N_MANUAL_PRICE>Признак установки цен вручную, boolean <N_PRICE_ID>21321-321323-343-123</N_PRICE_ID>Уникальный идентификатор типа цен (если используется раздельный тип цен, иначе null) <N_PRICE_NAME>Розница факт</N_PRICE_NAME>Наименование типа цены, String (если используется раздельный тип цен, иначе null) <N_DISCOUNT_PERCENT>3.0</N_DISCOUNT_PERCENT>Процент скидки, float <N_COMMENT>ЦБ03084</N_COMMENT>Комментарий к данной строке номенклатуры, string

</T_ORDER_TABLE>

Таблицашапки приходной накладной<T_PURCHASE_TITLE> <N_BB_NUMBER></N_BB_NUMBER>Номер базы данных, string (не используется) <N_CLIENTID>AC00001236</N_CLIENTID>Уникальный код торговой точки (адреса доставки), string <N_COMMENT></N_COMMENT>Комментарий , string <N_PRICEID>ЦБ0001100000</N_PRICEID>Уникальный код типа цены, string <N_PARENTID>AC0000001056</N_PARENTID>Уникальный код контрагента, string <N_CONTRACTID>0000002053</N_CONTRACTID>Уникальный код договора, string <N_FORMID>2</N_FORMID>Код формы документа, 2-Ф2, 1-Ф1, int <N_ID>9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64</N_ID>Уникальный код документа, string UUID <N_UPLOAD>false</N_UPLOAD>флаг выгрузки, boolean (не используется) <N_LNG>0.0</N_LNG>Долгота местоположения снятия заказа, double <N_LAT>0.0</N_LAT>Широта местоположения снятия заказа, double <N_DATE>1363686675015</N_DATE>Дата заказа, long <N_SAVE_DATE>1363686675015</N_SAVE_DATE>Дата сохранения заказа, long <N_CREATE_DATE>1363636675015</N_CREATE_DATE>Дата создания заказа, long <N_DELAY>true</N_DELAY>Отсрочка или факт, boolean <N_SUM>20.0</N_SUM>Сумма, float <N_SHIPMENT_DATE>1363686675015</N_SHIPMENT_DATE>Дата отгрузки, long <N_WAREHOUSE_ID >9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64</N_WAREHOUSE_ID>Код места хранения (склада), string UUID <N_GEOADDRESS>проспект Кирова 10</N_GEOADDRESS>Адрес, где оформлен документ, string <N_PERIOD>1363686675015</N_ PERIOD> Время работы с документом, long<N_BG_COLOR>-8411393</<N_BG_COLOR>Цвет фона, integer</T_ORDER_TITLE>

Таблица номенклатурызаказа<T_PURCHASE_TABLE> <N_ID>9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64ЦБ03084</N_ID>Уникальный код документа, string UUID <N_NOMENID>ЦБ03084</N_NOMENID>Уникальный код номенклатуры, string <N_TITLEID>9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64</N_TITLEID>Уникальный код шапки, string UUID <N_NUMBER>10.0</N_NUMBER>Количество номенклатуры, float

Page 15: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

<N_UNIT_ID>10.0</N_UNIT_ID>Код единицы измерения, string <N_FACTOR>1.5</N_FACTOR>Коэффициент пересчета от базовой единицы, float <N_MANUAL_PRICE>false</N_MANUAL_PRICE>Признак установки цен вручную, boolean <N_PRICE_ID>21321-321323-343-123</N_PRICE_ID>Уникальный идентификатор типа цен (если используется раздельный тип цен, иначе null) <N_PRICE_NAME>Розница факт</N_PRICE_NAME>Наименование типа цены, String (если используется раздельный тип цен, иначе null) <N_COMMENT>ЦБ03084</N_COMMENT>Комментарий к данной строке номенклатуры, string</T_PURCHASE_TABLE>

Таблицашапки возврата<T_RETURN_TITLE> <N_BB_NUMBER></N_BB_NUMBER>Номер заказ базы данных, string (не используется) <N_CLIENTID>AC00001236</N_CLIENTID>Уникальный код торговой точки (адреса доставки), string <N_COMMENT></N_COMMENT>Комментарий к возврату, string <N_PARENTID>AC0000001056</N_PARENTID>Уникальный код контрагента, string <N_ID>9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64</N_ID>Уникальный код документа, string UUID <N_LNG>0.0</N_LNG>Долгота местоположения возврата, double <N_LAT>0.0</N_LAT>Широта местоположения возврата, double <N_DATE>1363686675015</N_DATE>Дата возврата, long <N_SAVE_DATE>1363686675015</N_SAVE_DATE>Дата сохранения, long <N_CREATE_DATE>1363636675015</N_CREATE_DATE>Дата создания возврата, long <N_SHIPMENT_DATE>1363686675015</N_SHIPMENT_DATE>Дата отгрузки, long <N_REASON_ID>NF001</N_REASON_ID>Код причины возврата, string <N_CONTRACTID>9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64</N_CONTRACTID>Уникальный идентификатор договора договора возврата, string <N_FORMID>1</N_FORMID>Код формы возврата, string <N_WAREHOUSE_ID >9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64</N_WAREHOUSE_ID>Код места отгрузки, string UUID<N_GEOADDRESS>проспект Кирова 10</N_GEOADDRESS>Адрес, где оформлен документ, string <N_BASE_ID>9c9dc6f6-d12d-42a5-a9d8-ba3c6527ef64</N_BASE_ID>Уникальный код основания, string<N_PERIOD>1363686675015</N_ PERIOD> Время работы с документом, long<N_BG_COLOR>-8411393</<N_BG_COLOR>Цвет фона, integer</T_RETURN_TITLE>

Таблица номенклатурывозврата<T_RETURN_TABLE> <N_ID>9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64ЦБ03084</N_ID>Уникальный код документа, string UUID <N_NOMENID>ЦБ03084</N_NOMENID>Уникальный код номенклатуры, string <N_TITLEID>9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64</N_TITLEID>Уникальный код табличной части, string UUID <N_NUMBER>10.0</N_NUMBER> Количество номенклатуры, float <N_UNIT_ID>10.0</N_UNIT_ID>Код единицы измерения, string <N_FACTOR>1.5</N_FACTOR> Коэффициент пересчета от базовой единицы, float <N_REASON_ID>NF001</N_REASON_ID>Код причины возврата, string <N_CHECK_NUMBER>20161011094532</N_CHECK_NUMBER>Номер чека при печати, string <N_SUM>20.0</N_SUM> Сумма по строке, заполняется только в том случае, если возврат оформлен на основании заказа или включена настройка прайс в возвратах, float<N_PRICE>20.0</N_PRICE> Цена, заполняется только в том случае, если возврат оформлен на основании заказа или включена настройка прайс в возвратах, float<N_COMMENT>ЦБ03084</N_COMMENT>Комментарий к данной строке номенклатуры, string

</T_RETURN_TABLE>

Таблицашапки снятия остатков<T_STORECHECK_TITLE> <N_CLIENTID>2393b915-687f-11e</N_CLIENTID> Уникальный код торговой точки (адреса доставки), string

Page 16: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

<N_COMMENT>Примечание</N_COMMENT> Комментарий к документу, string <N_DATE>1401825568500</N_DATE> Дата документа, long <N_SAVE_DATE>1363686675015</N_SAVE_DATE>Дата сохранения, long <N_CREATE_DATE>1363636675015</N_CREATE_DATE>Дата создания документа, long <N_ID>2056590a-353f-4de4-b26e-74cad1d5d26b</N_ID> <N_LAT>0.0</N_LAT> Широта местоположения снятия остатков, double <N_LNG>0.0</N_LNG> Долгота местоположения снятия остатков, double <N_GEOADDRESS>проспект Кирова 10</N_GEOADDRESS>Адрес, где оформлен документ, string <N_CHECK_NUMBER>20161011094532</N_CHECK_NUMBER>Номер чека при печати, string <N_PERIOD>1363686675015</N_ PERIOD> Время работы с документом, long <N_BG_COLOR>-8411393</<N_BG_COLOR>Цвет фона, integer</T_STORECHECK_TITLE>

Таблица номенклатурыснятия остатков<T_STORECHECK_TABLE> <N_BALANCE>10.0</N_BALANCE> Количество номенклатуры, float <N_SHOWCASE_PRICE>10.0</N_SHOWCASE_PRICE> Количество номенклатуры, float <N_FACTOR>1.0</N_FACTOR> Коэффициент пересчета от базовой единицы, float <N_NOMENID>ЦБ0000000712</N_NOMENID> Уникальный код номенклатуры, string <N_TITLEID>2056590a-353f-4de4- </N_TITLEID> Уникальный код табличной документа, string UUID <N_UNIT_ID>ALL</N_UNIT_ID> Код единицы измерения, string (ALL единица по умолчанию) <N_MADE>1401825568500</N_MADE> Дата изготовления продукции, long<N_COMMENT>ЦБ03084</N_COMMENT>Комментарий к данной строке номенклатуры, string</T_STORECHECK_TABLE>

Таблица приходных ордеров<T_CASH_ORDERS> <N_PARENTID>AC0000001268</N_PARENTID> Код контрагента <N_DEBT_NUMBER>AC0000139151</N_DEBT_NUMBER> Номер кредитового документа <N_DEBT_TYPE>Расходная накладная</N_DEBT_TYPE> Тип кредитового документа <N_ID>db50cb73-8154-4e6a-8121-34ab4d1fca2d</N_ID> Уникальный идентификатор, string UUID <N_BASE_ID>1b12cb73-8154-4e6a-8121-34ab4d1fca2d</ N_BASE_ID > Уникальный идентификатор основания, string <N_FORMID >2</N_FORMID > Уникальный идентификатор формы, string <N_CONTRACTID>1312cb73-8154-4e6a-8121-34ab4d1fca2d </N_CONTRACTID> Уникальный идентификатор договора, string <N_DATE>1369927234848</N_DATE> Дата документа, long <N_SAVE_DATE>1363686675015</N_SAVE_DATE>Дата сохранения, long <N_CREATE_DATE>1363636675015</N_CREATE_DATE>Дата создания, long <N_SUM>200.0</N_SUM> сумма, float <N_LAT>0.0</N_LAT> Широта, double <N_LNG>0.0</N_LNG> Долгота, double <N_GEOADDRESS>проспект Кирова 10</N_GEOADDRESS>Адрес, где оформлен документ, string <N_CHECK_NUMBER>20161011094532</N_CHECK_NUMBER>Номер чека при печати, string <N_PERIOD>1363686675015</N_ PERIOD> Время работы с документом, long <N_BG_COLOR>-8411393</<N_BG_COLOR>Цвет фона, integer</T_CASH_ORDERS>

Таблица расходных ордеров<T_CASH_WARRANTS> <N_PARENTID>AC0000001268</N_PARENTID> Код контрагента <N_DEBT_NUMBER>AC0000139151</N_DEBT_NUMBER> Номер кредитового документа <N_DEBT_TYPE>Расходная накладная</N_DEBT_TYPE> Тип кредитового документа <N_ID>db50cb73-8154-4e6a-8121-34ab4d1fca2d</N_ID> Уникальный идентификатор, string UUID <N_BASE_ID>1b12cb73-8154-4e6a-8121-34ab4d1fca2d</ N_BASE_ID > Уникальный идентификатор основания, string <N_FORMID >2</N_FORMID > Уникальный идентификатор формы, string

Page 17: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

<N_CONTRACTID>1312cb73-8154-4e6a-8121-34ab4d1fca2d </N_CONTRACTID> Уникальный идентификатор договора, string <N_DATE>1369927234848</N_DATE> Дата документа, long <N_SAVE_DATE>1363686675015</N_SAVE_DATE>Дата сохранения, long <N_CREATE_DATE>1363636675015</N_CREATE_DATE>Дата создания, long <N_SUM>200.0</N_SUM> сумма, float <N_LAT>0.0</N_LAT> Широта, double <N_LNG>0.0</N_LNG> Долгота, double <N_GEOADDRESS>проспект Кирова 10</N_GEOADDRESS>Адрес, где оформлен документ, string <N_CHECK_NUMBER>20161011094532</N_CHECK_NUMBER>Номер чека при печати, string <N_PERIOD>1363686675015</N_ PERIOD> Время работы с документом, long <N_BG_COLOR>-8411393</<N_BG_COLOR>Цвет фона, integer</T_CASH_WARRANTS>

Таблица обновленияклиентов<T_CLIENT > <N_ADDRESS></N_ADDRESS> Адрес, string <N_CLIENTID>AC00004245</N_CLIENTID> Код клиента, string <N_CONTACT></N_CONTACT> Контактная информация, string <N_OBJECT></N_OBJECT> Объект доставки, string <N_LNG>35.019264221191406</N_LNG> Широта, double <N_LAT>48.4467887878418</N_LAT> Долгота, double <N_DEFAULT_PRICEID>000000001</N_DEFAULT_PRICEID>Уникальный код таблицы «Тип цен» подставляемый по умолчанию для клиента, string <N_LOGISTICID>Розница</N_LOGISTICID>Тип торговой точки по логистике, string <N_CLIENTTYPEID>Магазин А</N_CLIENTTYPEID>Тип клиента, string <N_DAYS_OF_WEEK>001000000000000000000</N_DAYS_OF_WEEK>Дни недели и порядок для маршрута, string</T_CLIENT >

( )Таблицатрека координаты<T_COORDS> <N_LNG>35.0196479</N_LNG>Широта, double <N_DATE>1363686693847</N_DATE>Дата снятия координат, long <N_LAT>48.4467249</N_LAT> Долгота, double <N_ACC>41.0</N_ACC>Аккуратность, float <N_SPEED>41.0</N_SPEED>Скорость, float <N_MESSAGE_NUMBER>2</N_MESSAGE_NUMBER>Номер сообщения, int (не используется)</T_COORDS>

Таблица фотографий<T_PHOTO_FILE> <N_ATTACH_ID>1f8e30b5-35-</N_ATTACH_ID> Уникальный код объекта, к которому сделана фотография, string <N_ATTACH_TYPE>1</N_ATTACH_TYPE> Тип объекта к которому сделана фотография, intМожет принимать вид:Клиент = 1 (соответственно N_ATTACH_ID содержит ссылку на клиента)Заказ = 2 (соответственно N_ATTACH_ID содержит ссылку на заказ)Возврат 3 (соответственно N_ATTACH_ID содержит ссылку на возврат)Сторчек = 4 (соответственно N_ATTACH_ID содержит ссылку на сторчек)Опрос = 5 (соответственно N_ATTACH_ID содержит ссылку на опрос) <N_DATE>1401826237098</N_DATE> дата, long <N_ID>55291825-257a-467f-a81f-7dcb60db56bb</N_ID> Уникальный код фотографии, string <N_MESSAGE_NUMBER>7</N_MESSAGE_NUMBER> номер сообщения, int (не используется) <N_DATA>/9j/4AAQSkZJRgAB…</N_DATA> данные, string Base64 <N_TYPE>1</N_TYPE> Тип фотографии, int (не используется)</T_PHOTO_FILE>

Page 18: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

Таблица реквизитовинвентаризации< T_INVENTORY_TITLE> <N_BG_COLOR>-8411393</<N_BG_COLOR>Цвет фона, integer <N_COMMENT></N_COMMENT>Комментарий к документу, string <N_ID>9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64</N_ID>Уникальный код документа, string UUID <N_LNG>0.0</N_LNG>Долгота местоположения документа, double <N_LAT>0.0</N_LAT>Широта местоположения документа, double <N_DATE>1363686675015</N_DATE>Дата документа, long <N_SAVE_DATE>1363686675015</N_SAVE_DATE>Дата сохранения, long <N_CREATE_DATE>1363636675015</N_CREATE_DATE>Дата создания документа, long <N_WAREHOUSE_ID >9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64</N_WAREHOUSE_ID>Код склада, string UUID<N_GEOADDRESS>проспект Кирова 10</N_GEOADDRESS>Адрес, где оформлен документ, string<N_PERIOD>1363686675015</N_ PERIOD> Время работы с документом, long

</ T_INVENTORY_TITLE>

Таблица номенклатурыинвентаризации<T_INVENTORY_TABLE> <N_ID>9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64ЦБ03084</N_ID>Уникальный код документа, string UUID <N_NOMENID>ЦБ03084</N_NOMENID>Уникальный код номенклатуры, string <N_TITLEID>9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64</N_TITLEID>Уникальный код табличной части, string UUID <N_STOCK_NUMBER>10.0</N_NUMBER>Количество номенклатуры по учету, float <N_FACT_NUMBER>10.0</N_NUMBER>Количество номенклатуры по факту, float <N_UNIT_ID>10.0</N_UNIT_ID>Код единицы измерения, string <N_FACTOR>1.5</N_FACTOR>Коэффициент пересчета от базовой единицы, float <N_MADE>1401825568500</N_MADE> Дата изготовления продукции, long<N_COMMENT>ЦБ03084</N_COMMENT>Комментарий к данной строке номенклатуры, string</T_INVENTORY_TABLE>

( )Таблица анкетирование шапка<T_ANSWER_TITLE> <N_ID>12323-14340-35435345</N_ID> Уникальный код документа, string <N_QUESTION_TITLE_ID>13-6368-6693847</N_QUESTION_TITLE_ID> Уникальный код анкетирования, string <N_COMMENT>анкетирование на улице</N_COMMENT> Комментарий, string <N_CLIENTID>242880123</N_CLIENTID> Код клиента, string <N_DATE>1363686693847</N_DATE>Дата документа, long <N_SAVE_DATE>1363686675015</N_SAVE_DATE>Дата сохранения, long <N_PERIOD>1363686675015</N_ PERIOD> Время работы с документом, long <N_CREATE_DATE>1363636675015</N_CREATE_DATE>Дата создания документа, long <N_LAT>0.0</N_LAT> Широта, double <N_LNG>0.0</N_LNG> Долгота, double </T_ANSWER_TITLE>

( )Ответына анкетирование таблица<T_ANSWER_TABLE> <N_TITLE_ID>12323-14340-35435345</N_TITLE_ID> Уникальный код документа (шапка), string <N_QUESTION_NAME>Дважды два?</N_QUESTION_NAME> Вопрос, string <N_VALUE>4</N_VALUE> Ответ, string </T_ANSWER_TABLE>

Выполненные задачи <T_TASK_EXECUTION> <N_ID>12323-14340-35435345</N_ID> Уникальный код выполнения, string <N_TASK_ID>0012344</N_TASK_ID> Уникальный код задачи, string <N_TASK_NAME>Забрать оплату</N_TASK_NAME> Наименование задачи, string

Page 19: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

<N_CLIENT_ID>8821382-123-32</N_CLIENT_ID> Уникальный код клиента, string <N_DATE>1363686693847</N_DATE>Дата выполнения, long <N_OBJECT_TYPE>1</N_OBJECT_TYPE>Тип объекта результата выполнения, int0 – задача содержит заказ1 – задача содержит кассовый ордер2 – задача содержит возврат3 – задача содержит сторчек4 – задача содержит результат анкетирования7 – задача содержит клиента, для которого установлены координаты8 – задача содержит фотографию9 – задача ничего не содержит<N_OBJECT_ID>88212-382-123-32</N_OBJECT_ID> Уникальный код объекта, который содержит задача, string<N_LAT>0.0</N_LAT> Широта, double <N_LNG>0.0</N_LNG> Долгота, double</T_TASK_EXECUTION>

, Пример полного файла передаваемого устройством

Имя архива: 6a19533e-c4b7-11e0-b644-0015172808f3.mbsuИмя файла в архиве: 6a19533e-c4b7-11e0-b644-0015172808f3.xml

( , ):Текст пример с одним заказом и одной координатой<?xml version="1.0" encoding="UTF-8"?><mobile_sales version_code="1" message_number="2" count="3"><T_ORDER_TITLE> <N_BB_NUMBER></N_BB_NUMBER> <N_CLIENTID>AC00001236</N_CLIENTID> <N_COMMENT></N_COMMENT> <N_PRICEID>ЦБ0001100000</N_PRICEID> <N_PARENTID>AC0000001056</N_PARENTID> <N_FORMID>2</N_FORMID> <N_ID>9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64</N_ID> <N_UPLOAD>false</N_UPLOAD> <N_LNG>0.0</N_LNG> <N_LAT>0.0</N_LAT> <N_DATE>1363686675015</N_DATE> <N_DELAY>true</N_DELAY> <N_SUM>20.0</N_SUM> <N_MESSAGE_NUMBER>2</N_MESSAGE_NUMBER></T_ORDER_TITLE><T_ORDER_TABLE> <N_ID>9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64ЦБ03084</N_ID> <N_NOMENID>ЦБ03084</N_NOMENID> <N_TITLEID>9c9dc6f6-d12d-42a7-a9d8-ba3c6527ef64</N_TITLEID> <N_NUMBER>10.0</N_NUMBER></T_ORDER_TABLE><T_COORDS> <N_LNG>35.0196479</N_LNG> <N_DATE>1363686693847</N_DATE> <N_LAT>48.4467249</N_LAT> <N_ACC>41.0</N_ACC> <N_MESSAGE_NUMBER>2</N_MESSAGE_NUMBER></T_COORDS></mobile_sales>

Page 20: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

Обмен координатамиТак же, при использовании обмена FTP, и включенном режиме «Контроль местоположения» каждые 30

минут, устройство передает файл содержащий выгрузку координат, для более оперативного обмена местоположением и разгрузки базы данных на устройстве. Файл представляет собой архив ZIP с именем UUID.coordu, где UUID – уникальный идентификатор пользователя, архив в свою очередь содержит файл UUID.xml с данными по координатам

:Форматфайла передаваемого устройством<?xml version="1.0" encoding="UTF-8"?><mobile_sales_coords version_code="1" message_number="118" count="17"><T_COORDS> <N_LNG>35.29045728</N_LNG> <N_DATE>1363693121000</N_DATE> <N_LAT>48.73774842</N_LAT> <N_ACC>16.0</N_ACC> <N_MESSAGE_NUMBER>118</N_MESSAGE_NUMBER></T_COORDS><T_COORDS> <N_LNG>35.29049408</N_LNG> <N_DATE>1363693224000</N_DATE> <N_LAT>48.73759598</N_LAT> <N_ACC>16.0</N_ACC> <N_MESSAGE_NUMBER>118</N_MESSAGE_NUMBER></T_COORDS><T_COORDS> <N_LNG>35.29055279</N_LNG> <N_DATE>1363693792000</N_DATE> <N_LAT>48.73776917</N_LAT> <N_ACC>4.0</N_ACC> <N_MESSAGE_NUMBER>118</N_MESSAGE_NUMBER></T_COORDS></mobile_sales_coords>

После того как база данных примет данные из этого файла с координатами, в ту же директорию на FTP сервере необходимо записать файл с ответом о последнем времени принятых координат. Файл должен быть запакован ZIP архиватором и иметь имя UUID.coordl, где UUID уникальный идентификатор пользователя устройства. Архив должен содержать файл UUID.xml:

:Форматфайла дляпередачи на устройство

<?xml version="1.0" encoding="UTF-8"?><mobile_sales_coords version_code="1" message_number="753" last_time_coords="1363605695000" count="0"></mobile_sales_coords>last_time_coords – дата (UNIX) последней принятой координаты, long

:Вбольшинстве случаев алгоритмдействий такой1. создание начальной выгрузки вида ФИО.mbsi2. загрузка на устройство или FTP3. выгрузка с устройства файла обмена UUID.mbsu4. загрузка в базу данных5. выгрузка на устройство файла обновления UUID.mbsl

Вфоне прииспользовании FTP ( 30 ):и контроля трека раз в мин1. загрузка файла UUID.coordu2. выгрузка файла UUID.coordl

Page 21: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

:Формат цвета для передачи на устройствоПалитра RGB, но упаковка в целое число со сдвигом разрядов, т.е. формула :Цвет = (((Красный)*256 + Зеленый)*256 + Синий);В частности красный по этой формуле будет 255 * 256 * 256 = 16711680 или в HEX FF0000синий соответственно HEX 0000FF = 255Передавать необходимо целое число без неразрывных пробелов, т.е. для 1С необходимо использовать функцию Формат(Число, «ЧГ=»)

2.4.1:Новое в версииВ настройках добавились параметры:Автоматическая архивация данных - при включении копирует базу данных раз в суткиНовая таблица: T_PRICE_LIMIT – описывает разрешенные типы цен клиентуНовая таблица: T_DISCOUNT – описывает скидки клиента

Добавлена возможность просмотра (отправки по почте, печати через сторонние приложения) заказа клиента в PDFДобавлена возможность отдельно отправлять лог файл и отдельно отправлять архивные копии базы данных по почте или на FTP сервер

2.5.0:Новое в версииДобавлена таблица «Внешние документы»Добавлен поворот экранаДобавлена возможность изменять цены

2.5.1:Новое в версииДобавлена Реклама (ненавязчивая, возможно потом уберем)

В настройках добавлена возможности менять организацию, отображаемую при печати (меню настроек FTP)Скидки можно вводить интерактивно в процентном соотношении от суммы, по каждой номенклатуреВ настройках можно отключать интерактивное изменение цен и скидокПКО разделяется по формам оплат (Ф1, Ф2)Изменены таблицы T_DEBTS, T_CASH_ORDERНовый справочник “Места отгрузки” T_WAREHOUSEИзменены таблицы T_ORDER_TITLE, T_RETURN_TITLEДобавлена опция «Контроль остатков», определяющая будет или попадать номенклатура в список заказа если ее нет на складеДобавлена опция «Штрих код в наименовании», определяющая вывод штрих кода (если он есть) в наименовании номенклатурыИзменен состав таблицы SETTINGSДобавлена возможность исключать определенную номенклатуру при оформлении заказа клиента. Изменена таблица T_CLIENTДобавлена возможность напрямую в номенклатуре указывать на приоритет продажи, т.е. позиция будет отображаться в ассортименте «Приоритет» (поле N_TOP_LIST)Добавлена возможность изменять цвет и фон наименования номенклатуры в заказе, изменена таблица T_NOMENCLATUREДобавлена функция копирования документов из журналаДобавлена функция ограничения количества заявок без выгрузки «control_upload_documents» при превышении заданного количества заявки не будут оформляться Разделен статус документа на «Выгруженный» и «Принятый», отображается красным и синим предупреждением соответственноВосстановлена возможность изменять цвета темыАрхивирование базы данных перенесено на карту памяти (папку MobileSalesBackup)

Page 22: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

Добавлена интеграция с DropBox, DropBox можно использовать вместо FTP сервера

2.5.3:Новое в версииИсправлена ошибка, при которой по почте не отправлялись вложенияРазделены значки документов на выгрузку и непринятых документов Некоторые корректировки интерфейсаИзмененные элементы таблицы клиентов не затираются при загрузке

2.5.4:Новое в версииИсправлена ошибка установка флага «Контроль остатков»

Настройки, влияющие на производительность запросов вынесены отдельным пунктом

Добавлен цвет фона и цвет текста для групп номенклатуры (по аналогии с позициями номенклатуры)

Быстрая панель действий отображается при оформлении документов (может быть выключено в настройках)

Раздвижной маршрутный лист. При нажатии на клиента под ним отображаются его торговый точки

Новое меню быстрых действий. Прямо из маршрутного листа можно сделать фотографию, снять координаты, оформить любой документ.

Дни недели посещения можно устанавливать непосредственно на устройстве при редактировании клиента

Приходный ордер можно оформлять без основания или выбрать основание непосредственно при оформлении

Добавлена возможность печати в PDF всех документов, а также некоторых отчетов (прайс, остатки)

Добавлена настройка кодировки FTP сервера («ftp_encoding») можно передавать в настройка, по умолчанию стоит Cp1215

Добавлена возможность скрывать неиспользуемые иконки (долгий тап на иконку или в настройках), иконкам можно назначать цвет

Добавлена возможность разделить учет остатков по складам. Таблица T_REMAINS

Добавлена возможность задавать период действия внешних документов

Добавлено анкетирование(опросы) клиентов. Таблицы T_QUESTION_TITLE, T_QUESTION_TABLE (пример использования – проведения различных опросов клиентов с целью сбора информации о продукции, снятия цен конкурентов ввода любых данных). Так же возможен анализ результатов непосредственно на устройстве в виде графика или таблицы)

Добавлена возможность ставить задачи пользователям программы. Таблица T_TASK. К задаче могут быть привязаны действия, такие как оформить документ, сделать фотографию, снять координаты. Задачи блокируют доступ к созданию документов не из задачи. (пример использования, необходимо снять остатки на торговой точке, но менеджер игнорирует данное действие, создается задача по снятию остатков, и только после ее выполнения у менеджера появится возможность оформить заказ). Результат выполнения могут быть выгружены с передачей данных. Данная опция включается из меню «Настройки» - «Производительность» - «Выгружать выполнения задач» (по умолчанию – выключена)

2.5.5:Новое в версииДобавлено минимальное количество номенклатуры (изменяемое) меньше которого остатки отображаются красным светом

Page 23: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

Добавлена геолокация для документов. Кроме координат программа пытается определить адрес в текстовом выражении. (Возможно использовать для контроля посещения торговых точек)

Добавлен отчет по маршруту торгового представителя в PDF формате (Карты – PDF). Отчет отображает пробег в километрах, время и место оформления документов, начальную и конечную точку маршрута за день

Добавлена настройка, позволяющая запретить оформлять заказы, не находясь в торговой точке

Добавлена настройка, запрещающая изменять координаты торговой точки

В журналах документов цветом выделяются статусы выгружен/принят

2.5.8:Новое в версииВ таблицу контрагентов добавлены поля для внесения телефона, электронной почты и произвольной информации

Изменена форма информации по клиенту

Добавлена автоматическая архивация данных при обмене, в случае некорректного завершения работы при обмене, базу данных можно восстановить из архива

Добавлены настройки, запрещающие изменять информацию по клиентам

Добавлена настройка, позволяющая контролировать заказ по приоритетным позициям. Если в заказе есть приоритетны позиции номенклатуры, по ним должен быть обязательно сделан заказ (хотя бы по одной позиции)

Добавлена настройка, определяющая через сколько времени архивная копия является неактуальной и подлежит удалению (по умолчанию 5 дней)

Добавлена возможность выключить гарантированную доставку (т.е. программа не будет ждать подтверждения получения документов из базы данных). Внимание! В данном случае, есть риск что файл выгрузки будет перезаписан и не все документы попадут в базу данных.

2.5.9:Новое в версииДобавлена возможность сортировать и заполнять маршрутный лист на устройстве

2.6.0:Новое в версииДобавлена возможность рассчитывать заказ по методу полтора, расчет производится только в случае активной опции «Сторчек в заказе», а также необходимых данных (прошлый заказ, прошлый остаток, текущий остаток)

Добавлена возможно определять сколько времени создавался документ. Добавлены поля «N_CREATE_DATA» в таблицы шапки документов

Исправлен вывод остатков при иерархической сортировке

Существенно ускорено создание заказа при использовании нескольких складов

Добавлена возможно загружать картинки с SD карты

2.6.1:Новое в версииВозвраты заполняются по основанию (если накладная присутствует в базе).

Добавлена форма отправки сообщений поддержке. Адрес поддержки можно изменять через опцию «support_email»

Часть функций вынесено в нативный код

Page 24: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

2.6.2:Новое в версииИсправлены отборы в отчетах

Добавлена возможность использования трех знаков после запятой в количестве

Добавлена поддержка Android 6

2.6.3:Новое в версииДобавлен документ «Инвентаризация»

Добавлена настройка «Инвентаризация изменяет остатки» включающая возможность изменения остатков по складу при записи «Инвентаризации»

Добавлена поддержка вспышки при сканировании штрих код (если вспышка есть на устройстве и устройство поддерживает автофокус)

Исправлена ошибка при которой записанный заказ не отображал номенклатуру при контроле остатков и нулевом количестве

Скидки можно делать по разным разрезам – по контрагенту, по прайсу, по номенклатуре (и по группе номенклатуры) или по всем или нескольким сразу

Оптимизированы процедуры обмена данными

Исправлена проблема переключения клавиатуры на некоторых устройства при поиске

Интегрированы сервисы SFTP, Google Drive, Gmail

2.6.4:Новое в версииУвеличена скорость работы при использовании скидок

Добавлена возможность устанавливать цвет групп номенклатуры

Добавлена возможность просмотра пароля сервера FTP и SFTP при начальной установке (при получении данных сервера из обмена просмотр блокируется)

Добавлена функция «Срез цен». Используется при снятии сторчека, включается из меню настроек «Производительность». Добавлено поле N_SHOWCASE_PRICE в таблицу T_STORECHECK_TABLE, которое заполняется срезом цен.

Исправлена функция копирования документов для некоторых устройств

Яндекc карты обновлены до Android 6

Добавлена возможность ручного поиска по штрих коду (включается в настройках)

Исправлены ошибки

2.6.5:Новое в версииВосстановлена совместимость с процессорами x86

Исправлена ошибка пустых цен в заказе

2.6.6:Новое в версииВНИМАНИЕ! Изменены таблицы T_CLIENT, T_CASH_ORDER, T_RETURN_TITLE, Т_DISCOUNT

Более полная поддержка договоров. Договора не ограничены двумя видами по формам оплат.

Page 25: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

Добавлены скидки по формам оплат.

Добавлено поле «Номер строки» в табличные части документов, строки таблиц выгружаются по порядку.

Добавлена кнопка «Быстрый поиск» в формы документов

Увеличена производительность открытия документов и прайса при работе с большими базами данных

Увеличена скорость загрузки первоначальной информации

Ручной поиск по штрих коду установлен по умолчанию

Добавлена возможность раздельного обмена данными (отдельно выгрузка, отдельно загрузка)

Проверка обновлений может быть осуществлена из программы

Возвраты, приходные ордера можно вводить на основании из списка заказов.

В возвраты добавлено поле «Договор»

2.6.7:Новое в версииРасширена форма поддержки, возможно использовать отображение телефона и скайпа «support_tel» «support_skype», которые можно передавать в настройках

2.6.8:Новое в версииОпция проведения документов

Измене порядок в настройках

Изменение шрифта документов

2.7.0:Новое в версииПечать чеков на принтерах с поддержкой Bluetooth

Исправлена проблема отображения названия организации при печати

Прошлый комментарий видно в новых заказах

Добавлена настройка, запрещающая изменять документы после печати чека (control_check_print)

В отчет «Динамика» добавлена динамика по остаткам у клиента

Добавлено поле в документах N_CHECK_NUMBER куда записывается номер чека при печати

Сортировка по времени в журналах документов

2.7.1:Новое в версииДобавлена настройка GPS трекинга из программы и вывод информации в настройках

Оптимизирована работа с несколькими складами

Page 26: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

В случае возможности, координаты для документов устанавливаются вне зависимости от того включена ли геолокация

В выгрузку добавлен параметр содержащий время последней удачной загрузки данных на устройство. ("last_import", long, unix date)

В таблицу клиентов добавлено поле "N_EVEN_WEEK", string, max_length = min_lenght = 7, данное поле передается шифр посещений по четным/нечетным неделям в конкретный день.

Например: строка "0111220" будет интерпретирована какпонедельник - любая неделя,вторник - нечетная неделя,среда - нечетная неделя,четверг - нечетная неделя,пятница - четная неделя,суббота - четная неделя,воскресенье - любая неделя.Пустые значение данного поля, а также значения в которых количество символов не равно 7 - игнорируются.

2.7.2:Новое в версииПри нулевом сообщении таблицы не очищаются, если есть данные пользователяСканер штрих кода работает в портретной ориентацииВ PDF добавлен вывод штрих кода (если включена опция «Штрих код в наименовании»)В заголовки выгрузки добавлен параметр “serial” с серийный номером устройстваНомер сообщения отображается в строке состояния

2.7.3:Новое в версииВнешние документы можно группировать по иерархии (изменена таблица T_EXTERNAL)Добавлены периоды в журналах документовВ сторчеке и инвентаризации можно вводить дату изготовления продукции (изменены таблицы T_STORECHECK_TABLE, T_INVENTORY_TABLE), добавлена настройка «storecheck_bbd»

2.7.5:Новое в версииКонтроль остатков не позволяет добавлять количество больше того, что есть на остаткахДобавлены кодовые страницы для принтеров

2.7.7:Новое в версииДобавлена опция «Запретить возвраты без основания»Добавлена возможность удалять настройки или разрешать изменение некоторых настроек при блокировании опций из категории «Контроль»

2.7.8:Новое в версииРасширен список поддерживаемых принтеровДобавлена возможность привязывать тип цен к договору, поле N_PRICEID таблицы T_CONTRACT

2.7.9:Новое в версииДобавлена настройка «Не показывать нулевые остатки» в раздел «Документы» позволяющая скрывать номенклатуру, по которой нет положительного остатка в документах «Заказ», «Возврат», «Инвентаризация», отчете «Прайс», «Остатки»Добавлен вывод среднего от дней отсрочки платежа в отчет "Долги"В таблицу T_CLIENT добавлено поле N_DEFAULT_ASSORTMENT в которое можно заполнять код ассортимента, который будет использоваться по умолчанию для торговой точки при создании документов

Page 27: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

2.8.1:Новое в версииДобавлено поля N_PRICEID (тип цен по умолчанию), N_ASSORTMENTID (ассортимент по умолчанию) таблицы T_WAREHOUSE (склады), которые позволяют при изменении склада в документе подставлять автоматически тип цен и ассортимент документа. Добавлена возможность заказывать товар по нулевой стоимости.Добавлено поле N_CHARACTER_NAME для вывода дополнительной характеристики номенклатуры в таблицу T_NOMENCLATUREДобавлено поле N_REMOVE_MARKER во все таблицы, которое обозначает признак пометки на удаление (элемент не удаляется из базы данных, но и выводится не будет)Добавлено поле N_GROUP_NAME в таблицу T_CLIENT, где можно указать группу контрагентов, контрагенты будут разбиваться по группам в маршрутном листеДобавлена настройка «Привязка номенклатуры» (bind_nomenclature_warehouse) позволяющая привязать номенклатуру к складу через таблицу T_REMAINS, т.е. номенклатура которая отсутствует в остатках конкретного склада не будет отображаться при заказе или возврате товара (только в случае использования остатков по складам)Добавлена настройка Простая страница (simple_page), уменьшающая вывод информации в PDFВ прайсе можно выбирать несколько ассортиментов

Page 28: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

2.8.3:Новое в версии

Добавлен автономный режим работы. В автономном режиме работы нет необходимости использовать обмен данными, все вычисления производятся на устройстве непосредственно

Добавлена возможность редактировать номенклатуру и устанавливать цены

Добавлена возможность установить логотип при печати документа в PDF

2.8.4:Новое в версии

Инвентаризация может не обнулять остатки (включается в настройках)

По номенклатуре можно удалять прайс

2.8.4:Новое в версии

Инвентаризация может не обнулять остатки (включается в настройках)

По номенклатуре можно удалять прайс

2.9.1:Новое в версии

Новый поиск непосредственно в документе

Быстрое добавление товара свайпом влево и удаление свайпом вправо в заказе

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

Добавлено поле «Максимальный долг клиента» (N_MAX_DEBT) в таблице T_CLIENT, в случае превышение которого заказы не будут создаваться

Добавлена поддержка внешнего IR сканера через USB (OTG)

Исправлены некоторые ошибки совместимости с Android 8.1

Добавлен вывод скидки по документу в журнал документов и маршрут

2.9.3:Новое в версии

Раздельный тип цен для строк заказа (изменена таблица T_ORDER_TABLE)

В настройки добавлено поле different_types_of_prices_for_rows в группу «Контроль»

При длительном нажатии на кнопку «минус», при наборе номенклатуры количество (скидка) меняет знак на противоположный

Добавлена возможность изменять дату документа, понятия дата создания N_CREATE_DATE, дата документа N_DATE и дата сохранения N_SAVE_DATE разделяются по смыслу.

Добавлено поле N_SAVE_DATE – дата сохранения документа, изменены таблицы документов

Page 29: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

В настройки добавлено поле сhange_the_document_date разрешающее менять дату документа в группу «Контроль», по умолчанию – выключено

Исправлен расчет периода работы с документов (время которое тратиться на создание или редактирование документа)

Добавлено поле N_PERIOD – изменены таблицы документов

2.9.4:Новое в версии

Добавлена возможность регулировать просмотр прошлого комментария в новом заказе, в настройки добавлена опция «Предыдущее примечание», «previous_note» по умолчанию выключена

Добавлена возможность устанавливать цвет в журнале документов, изменены таблицы T_ORDER_TITLE, T_RETURN_TITLE, T_INVENTORY_TITLE, T_STORECHEK_TITLE, T_CASH_ORDERS добавлено поле N_BG_COLOR, integer

Строку поиска можно выключать

2.9.6:Новое в версии

Добавлена возможность добавить максимальный процент скидки (изменена таблица T_DISCOUNT)

При загрузке программа будет искать атрибут «serial_number» заголовке документа, если данный атрибут присутствует и не совпадает с серийным номером устройства загрузка прерывается.

Файлы передачи данных можно шифровать ZIP. При получении файла программа попытается его разархивировать с паролем, который является серийным номером устройства. Если расшифровка удалась успешно, дальнейший обмен данными будет производиться с использованием зашифрованных архивов (устройство будет шифровать исходящие данные). Если на устройство передать незашифрованные данные, процесс шифрования будет остановлен. Алгоритм шифрования показан в тестовой базе данных 1С (работает путем использования пароля на архив)

Добавлены настройки ask_at_closing «Вопрос при закрытии документа», при сохранении документа выводится вопрос о закрытии, по умолчанию включено, fast_input «Быстрый вввод», ввод количества в заказе смахиванием, по умолчанию включено

2.9.8:Новое в версии

Добавлена возможность устанавливать прайс в возвратных накладных, изменена таблица T_RETURN_TABLE

Добавлена настройка запрещающая менять цены в возвратных накладных «Контроль» - «Прайс возврата», передается как return_price, по умолчанию включена

Добавлена возможность комментировать каждую позицию номенклатуры в документах

Изменены таблицы T_ORDER_TABLE, T_RETURN_TABLE, T_INVENTORY_TABLE, T_STORECHECK_TABLE

Добавлен документ «Приходная накладная», добавлены таблицы T_PURCHASE_TITLE, T_PURCHASE_TABLE, T_APPROVED_PURCHASES

Добавлен документ «Расходный кассовый ордер», добавлены таблицы T_CASH_WARRANTS, T_APPROVED_CASH_WARRANTS

Page 30: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве

3.0.4:Новое в версии

Добавлена новая таблица T_ALLOWED_PRICE позволяющая разрешать определенный тип цен в разрезе клиента и номенклатуры

Вместе с последним заказом отображается последний возврат

3.1.0:Новое в версии

Возможность создавать ПКО непосредственно в заказе (в случае оплаты клиентом на месте)

Флаг заказа «Отгружен»

Изменена таблица «T_ORDER_TITLE»

Добавлены поля N_SHIPPED (флаг отгрузки заказа), N_CASH_SUM (сумма оплаты), N_CASH_ID (идентификатор ПКО)

Добавлена настройка «control_selling» (Оплата в накладной) в разделе «Контроль», которая дает возможность включать оформление ПКО в заказе.

В маршрутном листе и журнале заказов, корме суммы заказов, выводится сумма оплат по контрагенту

3.1.2:Новое в версии

Исправлено определение использования программ для фиктивных местоположений в новых версиях операционных систем

Расширена информация передаваемая в заголовке сообщения. Добавлено:

version_name – номер версии программы «3.1.2»

root – признак того что у пользователя устройство рутировано и следовательно может выдавать неправдоподобные данные

fake_location – признак того, что пользователь хоть один раз пользовался программами эмуляции трека во время записи координат мобильным агентом

3.1.5:Новое в версии

В выгрузку добавлено поле «use_auto_time» (boolean), которое информирует использует ли пользователь автоматическую настройку времени и часового пояса. Если пользователь хоть раз изменял время – значение будет “false”

Page 31: mobilesales.chegal.org.uamobilesales.chegal.org.ua/ProtocolMA_2x.docx · Web viewДля обмена через USB необходимо убедиться, что в устройстве