При отправке партии из десятков заказов акт приема-передачи (АПП) – обязательный документ. Ручное формирование отнимает время, но API СДЭК позволяет создавать его автоматически. Разбираем, как это настроить.
Сравнение
| Критерий | По теме страницы | Создание АПП вручную через личный кабинет |
|---|---|---|
| Метод создания | Автоматический (API/правило) | Ручной (ЛК) |
| Время на 100 заказов | 1–2 минуты | 15–20 минут |
| Требования к настройке | Базовое знание API или настройки ЛК | Не требует навыков |
| Возможность кастомизации | Полная через API | Ограниченная (только правило) |
Как это работает
Получите список uuid через GET /v2/orders или из своей системы.
Отправьте POST /v2/acts с массивом uuid.
Используйте ссылку из ответа, сохраните в папку.
Откройте PDF, убедитесь, что все заказы включены.
Подробно
Формирование АПП через API СДЭК
Используйте POST /v2/acts. В теле передайте массив uuid заказов (до 50). Пример: {"orders": [{"uuid": "..."}]}. Для авторизации используйте токен OAuth 2.0. В ответе придёт ссылка на PDF. Акт можно сгенерировать только для заказов в статусе 'Создан' или 'Подтверждён'. При ошибке 429 – разбивайте на пакеты по 50.
Настройка авто-генерации в личном кабинете
В личном кабинете СДЭК перейдите в раздел «Настройки» → «Автоматизация». Создайте правило: «При появлении 10 новых заказов – создать акт». Также можно настроить отправку акта на email. Правило срабатывает раз в час. Удобно для тех, кто не хочет писать код.
Словарь терминов
Отзывы
Настроил авто-генерацию АПП через API. Теперь документы готовы сразу после формирования партии.
Раньше создавала акты вручную – теряла час в неделю. Автоматизация спасла.
Частые вопросы
Можно ли сгенерировать акт для заказов в разных статусах?
Только для статусов 'Создан' и 'Подтверждён'.
Какой максимальный размер одного акта?
До 50 заказов. Для большего количества создавайте несколько актов.
Как часто можно создавать акты?
Без ограничений, но не чаще 1 раза в 5 минут для одного клиента.
Настройте автоматическое создание актов приема-передачи и избавьтесь от рутины.
