Технічна документація Інтеграція 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

Коригування експрес-накладних (ЕН)
Створення та друк ТТН з документів 1С
Підтримка кількох відправників
Моніторинг статусів у списку замовлень
Автоматичний розрахунок ваги та обсягу
Зворотна доставка (гроші, документи)
Інтеграція з маркетплейсами
Підтримка API 2.0

Приклади коду 1С

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

Бізнес-переваги

• Оптимізація процесу оформлення відправлень
• Економія часу на обробку замовлень
• Підвищення рівня обслуговування клієнтів
• Масштабованість та професійна підтримка від SoftUp

Технічні характеристики та впровадження

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

Замовлення Покупців

Вкладка Служба доставки – Нова пошта (налаштування). Відкриваємо та створюємо нове налаштування. Вводимо назву. Галочка проставлена в Основне, означає, що назва при створенні нових документів буде проставлятися за замовчуванням. Створюємо ключ АPI. Для цього переходимо до особистого кабінету Нова пошта. Звертаємо увагу, щоб сервіс був не Мобільний додаток, оскільки він не підходить, а Бізнес-кабінет. Якщо її у вас немає, створюємо. І звертаємо увагу на термін дії. Переходимо до подальшого настроювання, вставляємо ключ АPI, зберігаємо.