Техническая документация Интеграция BAS/1C в API «Новая почта»

Настоящий документ описывает технические требования, архитектуру, сценарии и примеры реализации интеграции 1С:УТ11 с API «Новая почта».

Архитектура решения

Схема обмена данными: 1С:УТ11 ↔ REST/JSON API «Нова пошта». Используется
HTTPS, авторизация по ключу API.

Пример упрощенной схемы:

1С:УТ 11 → (HTTP POST JSON) → API «Нова пошта» → (JSON відповідь) → 1С:УТ 11
├─ Создание ТТН из документа «Заказ клиента»
├─ Получение номера ТТН и запись в документ
├─ Регламентная задача для статусов
└─ Синхронизация справочников (города, отделения)

Авторизация

{
«apiKey»: «<ВАШ_API_KEY>»,
«modelName»: «InternetDocument»,
«calledMethod»: «save»,
«methodProperties»: { … }
}

Функциональные возможности модуля SoftUp

Корректировка экспресс-накладных (ЭН)
Поддержка API 2.0
Создание и печать ТТН из документов 1С
Поддержка нескольких отправителей
Мониторинг статусов в списке заказов
Автоматический расчет веса и объема
Обратная доставка (деньги, документы)
Интеграция с маркетплейсами

Примеры кода 1С

Процедура ЗапросJSON(АдресСервера, ТелоJSON)
Соединение = Новый HTTPСоединение(АдресСервера, 443, Истина);
Запрос = Новый HTTPЗапрос(«/v2.0/json/»);
Запрос.УстановитьТелоИзСтроки(ТелоJSON, «UTF-8», «application/json»);
Ответ = Соединение.Отправить(Запрос);
Сообщить(Ответ.ПолучитьТелоКакСтроку());
КонецПроцедуры

Бизнес-преимущества

Оптимизация процесса оформления отправлений
Масштабируемость и профессиональная поддержка от SoftUp
Экономия времени на обработку заказов
Повышение уровня обслуживания клиентов

Технические характеристики и внедрение

Основные аспекты интеграции

Заказы Покупателей

Вкладка Служба доставки – Новая почта (настройки). Открываем и создаем новую настройку. Вводим название. Галочка проставлена в Основное, означает что название при создании новых документов будет проставляться по умолчанию. Создаем ключ АPI. Для этого переходим в личный кабинет Новая почта. Обращаем внимание, чтобы сервис был не Мобильное приложение, поскольку он не подходит, а Бизнес кабинет. Если его у вас нет, создаем. И обращаем внимание на срок действия. Переходим к дальнейшей настройке, вставляем ключ АPI, сохраняем.