Описание форматов файлов обмена данными для программы мобильной торговли Apecs Distribution версии 2.3 и выше.

25 Августа 2013

Для обеспечения работы мобильного приложения организован двухсторонний обмен данными. Файлы экспорта, такие как: информация о товарах и их остатков на складе, клиентов и их порядков взаиморасчетов,  подтвержденных кассовых ордеров, курсов валют - мобильное приложение получает по HTTP-GET запросу с сервера (например, IIS). Файлы импорта: журнал заявок на отгрузку и возврат товара, заявок на погашение задолженности, данных о координатах клиентов и дамп ошибок для отладки - мобильное приложение отправляет HTTP-POST запросом на сервер.

Ниже дан список файлов обмена, хранящихся на сервере и в мобильном устройстве. Общим для всех форматов файлов обмена является: разделитель данных - "#" (нельзя использовать в наименованиях товаров и пр.), разделитель целой части числа - ",".


Файлы экспорта из учетной системы:

  • GoodsDataFile_[НаименованиеСклада].txt (например: "GoodsDataFile_Склад.txt")
  • ClientsDataFile_[TorgNN].txt (например: "ClientsDataFile_Torg01.txt")
  • AcceptedPKODataFile.txt
  • Currency.txt

Файлы импорта в учетную систему:

  • [TorgNN]_orders_journal.txt
  • [TorgNN]_[КодКлиента]_[ДатаВремяСозданияЗаявки].txt
  • [TorgNN]_pko_journal.txt
  • [TorgNN]_clients_location.txt
  • [TorgNN]_unhandled_exception.txt


Далее представлено подробное описание назначения и формата вышеперечисленных файлов обмена.


Файл экспорта GoodsDataFile_[НаименованиеСклада].txt
Назначение: содержит информацию о характеристиках номенклатуры и ее остатков на складе.
Многострочный.
Отдельный файл для каждого мобильного устройства.
Пример имени файла: "GoodsDataFile_ОсновнойСклад.txt".

Порядок данных в строке:
1. Код товара (СТРОКА).
2. Артикул товара (СТРОКА).
3. Штрих-код товара (СТРОКА).
4. Наименование товара (СТРОКА).
5. Вид/группа товара (СТРОКА).
6. Цена за единицу товара (ЧИСЛО).
7. Доступный остаток товара в представлении упаковок (СТРОКА или ЧИСЛО). Возможные варианты: "> ящ", "1 блок" или "NN".
8. Количество единиц товара в одной упаковке (ЧИСЛО).

Формат строки:
[СТРОКА]#[СТРОКА]#[СТРОКА]#[СТРОКА]#[СТРОКА]#[ЧИСЛО]#[СТРОКА|ЧИСЛО]#[ЧИСЛО]

Пример:
C-02910#90004044##Арико Ручки на пл.к ЗВ св.-сер. 85мм (кв. 120mm)#Ручка на планке#21,50#44#200


Файл экспорта ClientsDataFile_[TorgNN].txt
Назначение: содержит информацию о клиентах, назначенных конкретному торговому представителю.
Многострочный.
Отдельный файл для каждого мобильного устройства.
Пример имени файла: "ClientsDataFile_Torg21.txt".

Порядок данных в строке:
1. Код клиента (СТРОКА).
2. Наименование клиента (СТРОКА).
3. Адрес клиента (СТРОКА).
4. Контактный телефон клиента (СТРОКА). Из мобильного приложения есть возможность совершить вызов на указанный номер. Рекомендуем хранить телефон в формате NNNNNNNNNNNN без дополнительных символов.
5. Код торгового представителя клиента (СТРОКА).
6. Список дат посещений клиента на месяц вперед (СТРОКА). Данный список представлен обычным текстом.
7. Канал сбыта клиента (СТРОКА).
8. Электронная почта клиента (СТРОКА).
9. Контактное лицо клиента (СТРОКА).
10. Глубина кредита клиента в днях (ЧИСЛО).
11. Сумма потолка отгрузки клиента (ЧИСЛО).
12. Долг клиента (ЧИСЛО).
13. Семь пар следующих погашений долга клиентом (с 13 по 26):
Дата погашения (ДАТА в формате ДД.ММ.ГГ) - оставить пустым, если долг отсутствует.
Сумма погашения (ЧИСЛО) - заменить на 0, если долг отсутствует.
27. Скидка от основной категории цен клиента (ЧИСЛО).

Формат строки:
[ЧИСЛО]#[СТРОКА]#[СТРОКА]#[СТРОКА]#[СТРОКА]#[СТРОКА]#[СТРОКА]#[СТРОКА]#[СТРОКА]#[ЧИСЛО]#[ЧИСЛО]#[ЧИСЛО]#[ДАТА]#[ЧИСЛО]#[ДАТА]#[ЧИСЛО]#[ДАТА]#[ЧИСЛО]#[ДАТА]#[ЧИСЛО]#[ДАТА]#[ЧИСЛО]#[ДАТА]#[ЧИСЛО]#[ДАТА]#[ЧИСЛО]#[ЧИСЛО]

Пример:
клиент без информации о порядке погашения долга:
21274#Голуб А.В.#Харьков, ул. Зеленая, 1#097134567#Torg01#17.07.13; 24.07.13; 31.07.13; 07.08.13; 14.08.13;#РХС_Д#mail@mail.ru#Алексей #15#2000#0##0##0##0##0##0##0##0#0

клиент с установленным порядком погашения долга:
2195#Голуб А.В.#Харьков, ул. Короля, 2#093234567; 0679874561#Torg21#17.07.13; 24.07.13; 31.07.13; 07.08.13; 14.08.13;#П_ВМЕЖ #mail@yandex.ru; mail@mail.ru#Борис #15#17157#6697,09#17.07.13 #393,67#24.07.13 #2459,43#26.07.13 #0,08#31.07.13 #3843,91##0##0##0#0


Файл экспорта AcceptedPKODataFile.txt
Назначение: список подтвержденных в учетной системе ПКО клиентов.
Многострочный.
Файл общий для всех мобильных устройств.

Порядок данных в строке:
1. Код клиента (ЧИСЛО).
2. Дата и время создания ПКО в мобильном устройстве (ГГГГ-ММ-ДД ЧЧ:ММ:СС).
3. Сумма ПКО (ЧИСЛО).

Формат строки:
[ЧИСЛО]#[ГГГГ-ММ-ДД ЧЧ:ММ:СС]#[ЧИСЛО]

Пример:
2114#2013-07-03 12:43:08#200
048#2013-07-03 12:50:34#0
21192#2013-07-03 10:02:16#112


Файл экспорта Currency.txt
Назначение: содержит текущий курс иностранной валюты.
Однострочный.
Файл общий для всех мобильных устройств.

Порядок данных в строке:
1. Текущий курс иностранной валюты.

Формат строки:
[ЧИСЛО]

Пример:
8,15


Файл импорта [TorgNN]_orders_journal.txt
Назначение: содержит "шапки" заявок на отгрузку и возвратов товаров, созданных в мобильном устройстве.
Многострочный.
Отдельный файл для каждого мобильного устройства.
Пример имени файла: "Torg01_orders_journal.txt".

Порядок данных в строке:
1. Дата и время создания заявки (ГГГГ-ММ-ДД ЧЧ:ММ:СС).
2. Код клиента (СТРОКА).
3. Наименование клиента (СТРОКА).
4. Сумма заявки (ЧИСЛО).
5. Вид оплаты: "по факту доставки" или "отсрочка платежа" (СТРОКА "Y"|"N").
6. Основание заявки (СТРОКА).
7. Статус готовности заявки (СТРОКА "Y"|"N").
8. Статус успешной отправки заявки на сервер (СТРОКА "Y"|"N").
9. Географическая широта места создания заявки (ЧИСЛО).
10. Географическая долгота места создания заявки (ЧИСЛО).
11. Сумма заявки, которая подтверждается остатками на складе (ЧИСЛО).
12. Вида документа: заявка на возврат или отгрузку товара (СТРОКА "Y"|"N").
13. Причина возврата товара (СТРОКА). Может быть кодом причины в учетной системе.
14. Причина пустой заявки товара (СТРОКА). Возможное применение: информация супервайзеру о причине, по которой торговый представитель не посетил клиента.

Формат строки:
[ГГГГ-ММ-ДД ЧЧ:ММ:СС]#[ЧИСЛО]#[СТРОКА]#[ЧИСЛО]#["Y"|"N"]#[СТРОКА]#["Y"|"N"]#["Y"|"N"]#[ЧИСЛО]#[ЧИСЛО]#["Y"|"N"]##

Пример:
2013-07-15 14:07:18#2156#ИВАНОВ М.М.#198,62#N#Доставка 16.07.2013#Y#Y###139,5#N##


Файл импорта [TorgNN]_[КодКлиента]_[ДатаВремяСозданияЗаявки].txt
Назначение: содержит "табличную (товарную) часть" конкретной заявки, созданной в мобильном устройстве.
Многострочный.
Отдельный файл для каждого мобильного устройства и для каждой заявки.
Пример имени файла: "Torg01_22334_2013-08-14 12-45-55.txt"

Порядок данных в строке:
1. Код товара (СТРОКА).
2. Наименование товара (СТРОКА).
3. Количество единиц товара (ЧИСЛО).
4. Цена за единицу товара (ЧИСЛО).
5. Наличие доступного остатка на момент создания заявки (СТРОКА "+"|"-").

Формат строки:
[СТРОКА]#[СТРОКА]#[ЧИСЛО]#[ЧИСЛО#["+"|"-"]

Пример:
C-02737#APECS EM-70-C-G (CIS)#2#44,12#-
C-00729#APECS SC(DF)-M70-Z-C-NI#2#46,41#+


Файл импорта [TorgNN]_pko_journal.txt
Назначение: содержит заявки на погашение долга клиентом (ПКО), созданных в мобильном устройстве.
Многострочный.
Отдельный файл для каждого мобильного устройства.
Пример имени файла: "Torg21_pko_journal.txt"

Порядок данных в строке:
1. Дата и время создания ПКО (ГГГГ-ММ-ДД ЧЧ:ММ:СС).
2. Код клиента (СТРОКА).
3. Наименование клиента (СТРОКА).
4. Сумма ПКО (ЧИСЛО).
5. Комментарий (СТРОКА).
6. Статус успешной отправки ПКО на сервер (СТРОКА "Y"|"N").
7. Планируемая дата погашения долга клиентом (ДД.ММ.ГГГГ).

Формат строки:
[ГГГГ-ММ-ДД ЧЧ:ММ:СС]#[СТРОКА]#[СТРОКА]#[ЧИСЛО]#[СТРОКА]#["Y"|"N"]#[ДД.ММ.ГГГГ]

Пример:
2013-07-04 14:27:35#21303#ИВАНОВ М.М.#3163##Y#05.07.2013
2013-07-05 14:47:12#2186#ПЕТРОВ А.А.#879##Y#06.07.2013


Файл импорта [TorgNN]_clients_location.txt
Назначение: содержит координаты местоположения точек доставки клиентов, отмеченных торговым представителем с помощью программы на мобильном устройстве.
Многострочный.
Отдельный файл для каждого мобильного устройства.

Порядок данных в строке:
1. Код клиента (СТРОКА).
2. Географическая широта местоположения точки доставки (ЧИСЛО).
3. Географическая долгота местоположения точки доставки (ЧИСЛО).

Формат строки:
[СТРОКА]#[ЧИСЛО]#[ЧИСЛО]

Пример:
221115#50,027860#36,183976
2026#49,998459#36,205695


Файл импорта [TorgNN]_unhandled_exception.txt
Назначение: содержит список ошибок программы мобильного устройства, зафиксированных при сбоях.
Многострочный.
Отдельный файл для каждого мобильного устройства.

Спасибо. Свои комментарии Вы можете оставить после регистрации на нашем сайте. Виталий Мудрак. 

Короткая ссылка на новость: http://www.task-idea-solution.org/~W1RU0