Передача данных на устройство

Передача данных на устройство осуществляется несколькими видами обмена, обмен через сервер FTP/SFTP, обмен посредством Dropbox, HTTP сервиса или электронной почтой.

Файл загрузки на устройство является текстом 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 – количество всех элементов передаваемых в сообщении, int

version_name – версия программы, string

root – признак того что устройство рутировано, boolean

fake_location – признак того что пользователь использовал фиктивные местоположения, boolean

 

 

 

 

Настройки пользователя

<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>example@mail.com</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>sir.chegal@gmail.com</ support_email> электронный адрес поддержки приложения

<support_tel+123456789</support_tel> телефон поддержки приложения

<support_skype>chegal_serg </support_skypel> скайп поддержки приложения

<changes_remnants>1</ changes_remnants> разрешить акту инвентаризации менять остатки на складе , 0 или 1

<change_the_document_date>0</change_the_document_date> разрешить изменять дату документа , 0 или 1

<control_check_print>1</ control_check_print> запретить изменять или удалять документы  на которые распечатан чек, 0 или 1

<track_buzzler>1</ track_buzzler> подавать звуковой сигнал при отключении GPS, 0 или

<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> Возможность оформлять оплаты в заказе

<control_multiple_choice>1</control_multiple_choice>Возможность использовать множественный выбор в заказе, 0 или 1

<control_free_sales>1</control_free_sales>Возможность продавать товар бесплатно, 0 или 1<ftp_load_pictures>1</ftp_load_pictures>Загружать изображения номенклатуры во время обмена, 0 или 1 (по умолчанию – выключено)

<user_logo>https://img2.freepng.ru/20180329/jtq/kisspng-face-desktop-wallpaper-woman-clip-art-faces-5abce416074bc7.4470254215223285980299.jpg</user_logo> Ссылка на изображение пользователя

<user_background>https://img2.freepng.ru/20180329/jtq/kisspng-face-desktop-wallpaper-woman-clip-art-faces-5abce416074bc7.4470254215223285980299.jpg</user_background> Ссылка на изображение фона экрана

 

<company_logo>https://clipart-best.com/img/intel/intel-clip-art-10.png</company_logo> Ссылка на изображение логотипа компании (используется при печати накладных)

<print_page_font_size>12</print_page_font_size> Размер шрифта при печати

<print_page_height>297</print_page_height> Высота страницы печати в миллиметрах

<print_page_width>210</print_page_width> Ширина страницы печати в миллиметрах

<print_page_padding>5</print_page_padding> Отступы по краям страницы печати в миллиметрах

<last_order_number>1</last_order_number> Количество суммируемых последних документов для показа в поле «Последний документ» (1 по умолчанию)

<last_order_date>1</last_order_date > Показывать дату последнего заказа и возврата в поле «Последний документ» (0 или 1) по умолчанию - 1

<default_price_id>000-1212-1221</default_price_id> идентификатор прайса, который будет первым в списке выбора

</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>  

Действие может быть отложенным, если передать параметр delayed = “1”, отложенное действие будет выполнятся не при загрузке данных, а после выгрузки.

Например инструкция <clear_table delayed = “1”>T_CASH_ORDERS</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

<N_TOP_LIST>1</N_TOP_LIST>Показывать в разделе «Приоритет», 0 или 1

<N_TYPE>RETURNABLE</N_TYPE>Тип номенклатуры, не обязательное, может принимать значение RETURNABLE, если номенклатура относится к типу «Возвратная тара», string

<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>

 

Таблица «Типы цен номенклатуры» (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

<N_PROFIT>2</N_PRICE>Разница между приходной и ценой продажи, float (необязательно)

</T_PRICE>

 

Таблица «Установленные цены номенклатуры для клиента» (T_MANUAL_PRICE)

<T_MANUAL_PRICE>

<N_CLIENT_ID>000002122</N_CLIENT_ID>Уникальный код клиента, string

<N_NOMENID>000000002</N_NOMENID>Уникальный код номенклатуры, string

<N_PRICE>1</N_PRICE>Цена номенклатуры, float

<N_PROFIT>2</N_PRICE>Разница между приходной и ценой продажи, float (необязательно)

</T_MANUAL_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>

 

 

Таблица «Причины возвратов» (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 >

 

Таблица связей номенклатуры с СКЮ (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>

 

Таблица «Принятые выполненные задачи» (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_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)

<N_CLIENT_ID>1103aba-21b5-13e2-8411-005056c00008</N_CLIENT_ID>Уникальный код клиента, string UUID

 

 

</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_NOMEN_CLIENT)

<T_NOMEN_CLIENT>

<N_ID>231231231</N_ID >Уникальный идентификатор записи, обязательное, string

<N_NOMEN_ID>3203aba-23b5-13e2-8411-005056c00008<N_NOMEN_ID > Уникальный код номенклатуры, string

<N_CLIENT_ID>6203aba-23b5-13e2-8411-005056c01009<N_CLIENT_ID > Уникальный код клиента, string

<N_NUMBER>10</ N_NUMBER >Остаток, количество, float

<N_SUM>100.00</N_SUM>Остаток, сумма, float

<N_UNIT_NAME>100.00</N_UNIT_NAME>Наименование единицы измерения, string

</T_ NOMEN_CLIENT>

 

 

Таблица «Шапка анкетирования клиентов» (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>

<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>

 

Инструкция QUERY

<QUERY>DELETE FROM T_DISCOUNT WHERE N_CLIENT_ID = “123”</QUERY>

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

Данное действие может быть отложенное, если передать параметр delayed = “1”, отложенное действие будет выполнено не в момент загрузки, а после выгрузки данных на сервер из КПК

Например, <QUERY delayed = “1”>DELETE FROM T_DISCOUNT WHERE N_CLIENT_ID = “123”</QUERY>

 

 

 

 

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

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

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

 

<?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>

<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>

</T_CONTRACT>

</mobile_sales>

Данный файл записывает в кодировке 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 – номер сообщения, int

count – количество всех элементов передаваемых в сообщении, 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

 

 

</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

  <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

  <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

  <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 (не используется)

 <N_MOCK_TIME >0</N_MOCK_TIME> 1 или 0, 1 говорит о том, что пользователь использует системное время без автонастройки (есть подозрение на то что время координат неправильное)

 <N_MOCK_LOCATION>0</N_MOCK_LOCATION> 1 или 0, 1 говорит о том, что пользователь использует фиктивный сервис местоположений

</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 (не используется)

 <N_COMMENT>Комментарий</N_COMMENT> Комментарий к фотографии, string

</T_PHOTO_FILE>

                                                 

Таблица реквизитов инвентаризации

< 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

  <N_CLIENT_ID>8821382-123-32</N_CLIENT_ID> Уникальный код клиента, string

  <N_DATE>1363686693847</N_DATE>Дата выполнения, long

  <N_OBJECT_TYPE>1</N_OBJECT_TYPE>Тип объекта результата выполнения, int

0 – задача содержит заказ

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>

 

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

<T_DYNAMIC_FIELD>

  <N_GROUP>Акт сверки</N_GROUP> Наименование группы, string

  <N_ID>123</N_ID> Уникальный идентификатор реквизита, string

  <N_TITLE>Вид отгрузки</N_TITLE> Наименование реквизита, string

  <N_TYPE>3</N_TYPE> Тип реквизита, integer (0 – чекбокс, 1 – текстовое поле, 2 – дата, 3 – список выбора, 4 – ссылка на таблицу, 5 – вложение)

  <N_ORDER>1</N_ORDER> Порядок, integer

  <N_REQUIRED>1</N_REQUIRED> Признак того что реквизит должен быть обязательно заполнен, 1 или 0      (необязательно, не распространяется на реквизит с видом 0 (чекбокс))

  <N_DOCUMENT_TABLE>T_ORDER_TITLE</N_DOCUMENT_TABLE> Наименование таблицы документов, к которому будет добавлен реквизит, string (необязательно)

  <N_CLIENT_ID>21312312321</N_CLIENT_ID> Идентификатор клиента, если реквизит нужно добавить только для определенного клиента, string (необязательно)

<N_REFERENCE_TABLE>T_CLIENT</N_REFERENCE_TABLE> Таблица базы данных для типа динамического поля - 4 группы, string (обязательное, если тип поля4)

 

 

Если реквизит имеет тип 3 ( список выбора) необходимо передать элементы выбора. Также возможна (но необязательно) передавать список выборы для типа 2 (текстовое поле), в данном случае список выбора будет использован для автозавершения строк)

  <ITEMS >

     <ITEM>Вывоз из магазина</ITEM>

     <ITEM>Вывоз из склада</ITEM>

     <ITEM>Курьер</ITEM>

  </ITEMS>

</T_DYNAMIC_FIELD>

 

Таблица скидок к заказу от суммы документа

<T_DISCOUNT_ORDER>

            <N_DISCOUNT_PERCENT>30</N_DISCOUNT_PERCENT> Процент скидки, float

            <N_SUM_LIMIT>400</N_SUM_LIMIT> Сумма заказа при которой (или больше) начинает действовать скидка, float

            <N_CLIENT_ID>000000007</N_CLIENT_ID> Уникальный идентификатор клиента  (необязательно), если не заполнено – скидка будет применятся ко всем клиентам, string

<N_REQUIRED>1</N_REQUIRED> #Признак обязательно применения скидки (необязательно), если не заполнено или имеет значение «0», будет выведена кнопка для выбора скидки вручную. 1 или 0

</T_DISCOUNT_ORDER>

 

Таблица изображений номенклатуры

<T_NOMENCLATURE_PHOTO>

            <N_ID>30</N_ID> Код номенклатуры, string

            <N_IMAGE>DUDdunudwdbwdbew</N_IMAGE > Данные номенклатуры в формате Base64, string

</T_ NOMENCLATURE_PHOTO >

 

Таблица наборов номенклатуры

< T_NOMEN_SET>

            <N_ID>30</N_ID> Код набора номенклатуры, string

            <N_NAME>Набор 1</N_NAME > Наименование набора номенклатуры, string

            <N_ITEMS>

                        <N_NOMEN_ID>Код номенклатуры 1 входящей в набор</N_NOMEN_ID>

<N_NOMEN_ID>Код номенклатуры 2 входящей в набор</N_NOMEN_ID>

….

</N_ITEMS>

</ T_NOMEN_SET>

 

 

 

 

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

Имя архива: 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>

 

Обмен координатами

Так же, при использовании обмена 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

Обмен через HTTP сервер:

Обмен посредством http обеспечивает моментальную загрузку данных в базу, а так же прием данных исключая задержку при использовании FTP или других сервисов обмена данными. Для его работы необходим веб сервер, например IIS и http сервис 1С Предприятия опубликованный на этом веб сервере.

 

Поддерживается как анонимная так и обычная проверка подлинности (Basic Authorization)

 

 Формат запроса к сервису программа передает POST запросом, JSON формата

При подключении программа отправляет POST запрос с телом JSON:

{"action":"ping"}

Ожидаемый ответ: 200 ОК content-type: application/json

 

Для получения списка менеджеров на загрузку программа отправляет  POST запрос:

{"action":"list"}

Ожидаемый ответ JSON с массивом data:

{

    "data": [

        "Соболева Светлана.mbsi"

    ]

}

Имена менеджеров должны заканчиваться расширением “.mbsi” для обеспечения совместимости

 

Для получения данных по конкретному менеджеру программа отправляет POST запрос:

{"action":"upload", "filename":"Соболева Светлана.mbsi"}

Ожидаемый ответ JSON c данными в поле “data”:

{

    "data": "UEsDBBQACQgIAHmAO1MAAAAAAAAAAAAAAAAoA……

}

Данные в поле дата – файл mbsi в формате Base64

 

Для выгрузки данных на сервер программа отправляет POST запрос:

{"action":"load", "filename":"UUID.mbsu", “data”: "data": "UEsDBBQACQgIAHmAO1MAAAAAAAA….}

Данные в поле дата – файл mbsu в формате Base64

Ожидаемый ответ: 200 ОК

 

ВНИМАНИЕ! При использовании данного вида подключения порядок обмена меняется, сначала идет выгрузка данных, потом загрузка. Доставка считается гарантированной.

 

Пример сервиса можно посмотреть в конфигурации по ссылке

 

 

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

 

<?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.     создание начальной выгрузки вида ФИО.mbsi

2.     загрузка на устройство или FTP

3.     выгрузка с устройства файла обмена UUID.mbsu

4.     загрузка в базу данных

5.     выгрузка на устройство файла обновления UUID.mbsl

 

В фоне при использовании FTP и контроля трека (раз в 30 мин):

1.     загрузка файла UUID.coordu

2.     выгрузка файла UUID.coordl

 

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

Палитра 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)

 

 

Добавлена интеграция с 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:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

 

Новое в версии 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

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

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

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

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

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

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

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

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

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

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

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

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

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

 

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

Опция проведения документов

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

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

 

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

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

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

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

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

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

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

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

 

 

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

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

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

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

В выгрузку добавлен параметр содержащий время последней удачной загрузки данных на устройство. ("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 в которое можно заполнять код ассортимента, который будет использоваться по умолчанию для торговой точки при создании документов

 

Новое в версии 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

В прайсе можно выбирать несколько ассортиментов

 

Новое в версии 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 – дата сохранения документа, изменены таблицы документов

В настройки добавлено поле change_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

 

Новое в версии 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” 

 

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

Добавлен новый раздел «Выгрузка» где можно контролировать, что программа будет выгружать на сервер

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

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

Добавлена опция «control_free_sales» «Бесплатные продажи» которая позволяет продавать товар по нулевой стоимости. Изменена библиотека печати PDF

 

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

Добавлена опция «ftp_load_pictures» «Загружать картинки» которая будет загружать обновления изображений номенклатуры

 

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

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

 

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

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

Добавлено поле «Последние продажи» в список выбора ассортимента, при выборе данного поля заказ будет отфильтрован только по позициям у которых был оборот за период.

Добавлена возможность отложить действия команд clear_table и query до выгрузки данных, для этого в данных командах необходимо передавать параметр delayed = “1”. Это может быть полезно, если необходимо очистить таблицы после того, когда пользователь выгрузил данные на сервер.

 

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

Настройками печати можно управлять тегами настроек:

print_page_font_size – размер шрифта, integer

print_page_height – высота страницы, мм, integer

print_page_width – широта страницы, мм, integer

print_page_padding – ширина отступов, мм, integer

simple_page – выводить меньше информации на странице, «1» или «0»

Можно передавать ссылку на лого организации и лого пользователя

company_logo – ссылка на логотип организации, string

user_logo – ссылка на логотип пользователя, string

 

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

Добавлена возможность обмена через электронную почту @gmail.com, @yandex.ru, @mail.ru, @ukr.net

Для работы с почтой необходимо получить пароль приложения и открыть доступ сторонним приложениям к SMTP и IMAP, более подробно можно почитать по ссылкам:

Яндекс, Gmail, Mail.ru, Ukr.net

 

Добавлен новый тип обмена «Обмен через HTTP сервер». Этот тип обмена обеспечивает синхронизированную доставку данных сразу в базу данных. Для его работы необходимо использовать HTTP сервис 1С Предприятие или любой другой, который обеспечит необходимый протокол. Более подробно в разделе Обмен через HTTP сервер этого документа

 

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

При ручном изменении цены в заказе, программа запоминает эту цену для данного клиента и номенклатуры. В дальнейшем эту цену можно установить нажав на кнопку восстановления в прайсе

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

 

В настройки добавлен параметр «last_order_number» «Количество последних заказов», по умолчанию – 1, позволяет регулировать количество заказов, которые будут суммироваться в поле «Последний заказ» в документах.

 

Исправлена ошибка при которой мог неправильно показываться остаток на складе, если возврат оформляется на основании расходной накладной.

Если в диалоге набора количества номенклатуры изменяют прайс, а не вводят цену, цена не считается “мануальной” и красным не подсвечивается

Оптимизирован запрос формирования возвратной накладной

Редизайн некоторых графических элементов 

 

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

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

 

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

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

Пример дополнительного реквизита:

 

<T_DYNAMIC_FIELD>

            <N_ID>4</N_ID>

<N_REQUIRED>1</N_REQUIRED>

            <N_TITLE>Выберите город </N_TITLE>

<N_CLIENT_ID>000000007</N_CLIENT_ID>

<N_DOCUMENT_TABLE>T_ORDER_TITLE</N_DOCUMENT_TABLE>

            <N_TYPE>3</N_TYPE>

            <ITEMS>

                        <ITEM>Подольск</ITEM>

                        <ITEM>Берлин</ITEM>

                        <ITEM>Париж</ITEM>

            </ITEMS>

</T_DYNAMIC_FIELD>

 

Данное инструкция обяжет программу вывести дополнительное поле в виде списка выбора для документа «Расходная накладная» и клиента с кодом «000000007»

 

Выбранное значение будет добавлено в таблицу T_ORDER_TILE в виде поля (при выборе «Подольск»)

<N_DYNAMIC_4>Подольск</N_DYNAMIC_4>

Где «4» это идентификатор реквизита. Более подробно в описании таблицы данной инструкции.

 

 

Добавлена таблица T_DISCOUNT_ORDER которая позволяет назначать скидку от суммы заказа по всей номенклатуре

Пример заполненной таблицы:

 

<T_DISCOUNT_ORDER>

            <N_DISCOUNT_PERCENT>30</N_DISCOUNT_PERCENT> #Процент скидки

            <N_SUM_LIMIT>400</N_SUM_LIMIT> #Сумма заказа при которой (или больше) начинает действовать скидка

            <N_CLIENT_ID>000000007</N_CLIENT_ID> #Код клиента  (необязательно), если не заполнено – скидка будет применятся ко всем клиентам

<N_REQUIRED>1</N_REQUIRED> #Признак обязательного применения скидки (необязательно), если не заполнено или имеет значение «0», будет выведена кнопка для выбора скидки вручную.

</T_DISCOUNT_ORDER>

 

Если данная таблица заполнена и скидки применены – у таблицы T_ORDER_TITLE будет заполнено поле N_DISCOUNT_PERCENT значением этой скидки. При применении скидки по всему документу, ручное изменение скидки для одной номенклатуры становится невозможным.

 

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

 

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

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

Для этого нужно передать таблицу T_NOMENCLATURE_PHOTO в виде

 

 <T_NOMENCLATURE_PHOTO>

<N_ID>Код номенклатуры</N_ID>

<N_IMAGE>Данные изображения в формате Base64</N_IMAGE>

</T_NOMENCLATURE_PHOTO>

 

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

Теперь можно передавать ссылку на фоновое изображение экрана в настройках:

user_background – ссылка на фоновое изображение экрана, string

 

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

Расширена таблица T_DYNAMIC_FIELD

Добавлен тип данных 4 – ссылка, если используется данный тип, необходимо передавать тип ссылки в поле N_REFERENCE_TABLE, например <N_REFERENCE_TABLE>T_CLIENT</N_REFERENCE_TABLE> для выбора клиентов

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

 

Добавлена возможность отправить запрос на внешний документ, если в файле выгрузки на устройство передается T_DYNAMIC_FIELD с <N_DOCUMENT_TABLE>T_EXTERNAL</N_DOCUMENT_TABLE>, в окне выбора внешнего документа появляется кнопка, по нажатию на которую выводится диалог с заполнением занных динамических полей, после этого на сервер передается файл вида UUIDПользователя_ТекущееВремяВМиллисекундах.mbsr, данный файл представляет собой архив ZIP, в котором содержится файл вида UUIDПользователя.xml. Разметка данного файла имеет вид:

<T_DOCUMENT_REQUEST>

<N_GROUP>НаименованиеГруппы</N_GROUP>

            <N_DYNAMIC_КодДинамическогоПоля>ВыбранноеЗначение</N_DYNAMIC_КодДинамическогоПоля>

</T_DOCUMENT_REQUEST>

 

Пример для запроса Акта сверки:

<T_DYNAMIC_FIELD>

            <N_REQUIRED>1</N_REQUIRED>

            <N_DOCUMENT_TABLE>T_EXTERNAL</N_DOCUMENT_TABLE>

            <N_ID>9</N_ID>

            <N_TITLE>Контрагент</N_TITLE>

            <N_TYPE>4</N_TYPE>

            <N_REFERENCE_TABLE>T_CLIENT</N_REFERENCE_TABLE>

            <N_GROUP>Акт сверки</N_GROUP>

</T_DYNAMIC_FIELD>

 

<T_DYNAMIC_FIELD>

            <N_REQUIRED>1</N_REQUIRED>

            <N_ID>10</N_ID>

            <N_TITLE>Отправить в</N_TITLE>

            <N_DOCUMENT_TABLE>T_EXTERNAL</N_DOCUMENT_TABLE>

            <N_TYPE>3</N_TYPE>

            <ITEMS>

                        <ITEM>Телеграм</ITEM>

                        <ITEM >Вайбер</ITEM>

            </ITEMS>

            <N_GROUP>Акт сверки</N_GROUP>

</T_DYNAMIC_FIELD>

 

<T_DYNAMIC_FIELD>

            <N_ID>11</N_ID>

            <N_DOCUMENT_TABLE>T_EXTERNAL</N_DOCUMENT_TABLE>

            <N_REQUIRED>1</N_REQUIRED>

            <N_TITLE>Начало периода</N_TITLE>

            <N_TYPE>2</N_TYPE>

            <N_GROUP>Акт сверки</N_GROUP>

</T_DYNAMIC_FIELD>

 

<T_DYNAMIC_FIELD>

            <N_ID>12</N_ID>

            <N_DOCUMENT_TABLE>T_EXTERNAL</N_DOCUMENT_TABLE>

            <N_REQUIRED>1</N_REQUIRED>

            <N_TITLE>Конец периода</N_TITLE>

            <N_TYPE>2</N_TYPE>

            <N_GROUP>Акт сверки</N_GROUP>

</T_DYNAMIC_FIELD>

 

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

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

Пример:

<T_NOMEN_SET>

<N_ID>001</N_ID>

<N_NAME>Набор 1</N_NAME>

<ITEMS>

<N_NOMEN_ID>000000020</N_NOMEN_ID>

<N_NOMEN_ID>000000021</N_NOMEN_ID>

</ITEMS>

</T_NOMEN_SET>

 

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

Добавлена таблица T_NOMEN_CLIENT в которой можно передавать остатки номенклатуры типа «Возвратная тара» т.е. данная номенклатура не участвует во взаиморасчетах и будет числится за клиентом в натуральном виде. Расширена таблица T_NOMENCLATURE добавлено поле N_TYPE, которое может принимать значение “RETURNABLE”. Если данное поле содержит слово «RETURNABLE», эта номенклатура считается «Возвратной тарой». В информации по клиенту добавлена страница «Возвратная тара» с информацией по возвратной таре, которая числится за клиентом.

Пример передачи остатков по возвратной таре:

<T_NOMEN_CLIENT>

<N_ID>2131232</N_ID>

<N_NOMEN_ID>000000020</N_NOMEN_ID>

<N_CLIENT_ID>000000007</N_CLIENT_ID>

<N_NUMBER>3</N_NUMBER>

<N_SUM>22</N_SUM>

<N_UNIT_NAME>шт.</N_UNIT_NAME>

</T_NOMEN_CLIENT>

 

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

Добавлена настройка default_price_id в которой можно указать ID прайс листа, который будет первым в списке выбора в документах и отчетах, ее так же можно устанавливать вручную в меню Опции – Документы

 

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

Расширена таблица T_DYNAMIC_FIELD

Добавлен тип данных 5 – вложение, если используется данный тип, в данное поле пользователь может выбрать файл, который будет передан в Base64

Расширена таблица T_COORDS

Добавлены поля N_MOCK_TIME 1 или 0, передается 1 если пользователь использует системное время без автонастройки, N_MOCK_LOCATION  1 или 0, передается 1 если пользователь использует фиктивное местоположение

 

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

Добавлена история продаж (возвратов, сторчека и приходов) в диалог выбора количества номенклатуры. Ее можно отключить в настройках «Документы» - «История продаж» или параметром <history_view>0</history_view> в файле xml

 

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

Добавлена возможность загружать таблицу T_PHOTO_FILE на устройство. Добавлено поле  Т_COMMENT в таблицу T_PHOTO_FILE для комментариев к фотографиям