Область применения
Обработка автоматически определяет службу доставки по номеру отправления и запрашивает информацию напрямую из API (без использования APIShip).
Установленные форматы номеров отслеживания:
| Почта России | 14 цифр |
| DPD | 2 буквы + 9 цифр, или 11 цифр |
| СДЭК | 8-10 цифр |
| PonyExpress | 2 цифры - 4 цифры - 4 цифры |
Отслеживание отправлений можно производить вручную (открыть обработку, внести номер отслеживания, нажать "Получить статус" - в служебных сообщениях появится информация о конечном статусе отправления), или автоматически - при интеграции с конфигурацией.
Технические требования
Тестировалось на платформе 8.3.18.1741, должно работать на любой платформе 8.3 (используются встроенные методы для работы с JSON).
Возможна доработка обработки под ваши задачи, добавление нужных Вам ТК/служб доставки.
Для работы обработки необходимо заполнить параметры авторизации в API по используемым службам доставки в функции "ИнициализацияПеременных()" в модуле обработки.
Код открыт.
Описание работы при интеграции с конфигурацией
Пользователи указывают номера отслеживания в документах. С некоторой периодичностью документы, в которых еще не получен конечный статус (например, "вручено"), обрабатываются регл.заданием и в них обновляются статусы.
Таким образом, при каждом выполнении регламентного задания обрабатываются только те документы, по которым не получен конечный статус.
При открытии формы документа пользователь видит текущий статус и может посмотреть историю статусов при нажатии на кнопку "История статусов".
Инструкция по интеграции с конфигурацией (для программистов):
1) В определенный документ конфигурации необходимо добавить реквизиты:
- НомерОтслеживания (Строка, 50);
- СтатусОтправления (Строка, 100);
- ПолученКонечныйСтатусОтправления (Булево).
Реквизиты "НомерОтслеживания" и "СтатусОтправления" необходимо вынести на форму документа.
Также на форму документа необходимо добавить кнопки:
- "Обновить статус" - при нажатии вызывать функцию "ПолучитьИнформациюПоНомерамОтслеживания(НомерОтслеживания)" из обработки и обновлять реквизиты "СтатусОтправления" и "ПолученКонечныйСтатусОтправления" в документе;
- "История статусов" - при нажатии вызывать функцию "ПолучитьИнформациюПоНомерамОтслеживания(НомерОтслеживания, Ложь)" из обработки и показывать пользователю полученную таблицу с историей статусов.
2) Для автоматического обновления статусов необходимо добавить регламентное задание, которое будет вызывать функцию "ОбновитьСтатусыОтправлений" из обработки. Функцию перед этим необходимо немного доработать - в запросе указать документ из 1 пункта (подробная инструкция по доработке внутри функции).
Для работы обработки необходимо заполнить параметры авторизации в API по используемым службам доставки в функции "ИнициализацияПеременных()" в модуле обработки.
