По запросу
Автоматизация
n8n
Оркестрация согласованного обмена между внешними системами и Skirbo.
АвтоматизацияSkirbo +
Skirbo +
DaData
Подготавливать коды города и страны до формирования заявки, сохраняя исходный адрес и отправляя неоднозначность на проверку оператору.
Какой обмен обсудим
Зафиксируем нужные операции, направление данных и условия приёмки.
| Операция | Направление | Состав и готовность |
|---|---|---|
| КЛАДР города | Skirbo / система продавца → DaData | Обсудим в составе подключения query для findById/delivery: входной код должен быть определён отдельно, метод не разбирает произвольный адрес. |
| Коды перевозчиков | DaData → контур доставки | Обсудим в составе подключения cdek_id, dpd_id и другие присутствующие поля читаются по выбранной службе; пустое значение требует разбора. |
| Страна | Система продавца ↔ DaData | Обсудим в составе подключения Исходное название/код → выбранные code, alfa2, alfa3; выбор подтверждается при неоднозначности. |
На узком экране таблицу можно прокрутить в сторону.
Это сценарии для обсуждения. Методы API сервиса сами по себе не подтверждают готовность подключения в Skirbo.
Для какой задачи подходит сервис
Для продавца с несколькими перевозчиками и для склада, получающего адреса из разных магазинов. Здесь рассматриваются конкретные справочники DaData: код города службы доставки по КЛАДР и коды стран. Проверка дома, квартиры, доступности тарифа и создание посылки в этот объём не входят.
Как организовать обмен
Прочитаны findById/delivery и методы suggest/country, findById/country. Документация показывает серверный запрос с API-ключом; перед реализацией проверяется актуальность кодов и поддержка выбранного перевозчика.
Предлагаемый порядок работы
- Получить исходный адрес и уже определённый КЛАДР-код города из системы продавца; сохранить их как входные данные.
- Проверить страну и отличить код города от кода улицы или текстового названия.
- Запросить findById/delivery и выбрать поле нужного перевозчика; связать результат с версией адреса.
- Оператор склада сверяет населённый пункт и назначение отправки перед упаковкой документов.
- Передать подтверждённый код в согласованный коннектор доставки, а в Skirbo вернуть решение и использованный справочник.
- Принять результат только после проверки ответа DaData и успешной валидации города у перевозчика.
- При пустом suggestions или отсутствующем коде остановить автоматическое оформление и уточнить адрес; запас и заказ не менять.
Практические сценарии
Предлагаемая схема для согласования и пилота. Она не означает, что описанный обмен уже настроен в Skirbo.
Город из заказа — код службы доставки
Задача: Снизить число отказов из-за названия города или неверного внешнего кода.
Когда начинается: Заказ готовится к передаче перевозчику.
- Получить исходный адрес и уже определённый КЛАДР-код города из системы продавца; сохранить их как входные данные.
- Проверить страну и отличить код города от кода улицы или текстового названия.
- Запросить findById/delivery и выбрать поле нужного перевозчика; связать результат с версией адреса.
- Оператор склада сверяет населённый пункт и назначение отправки перед упаковкой документов.
- Передать подтверждённый код в согласованный коннектор доставки, а в Skirbo вернуть решение и использованный справочник.
- Принять результат только после проверки ответа DaData и успешной валидации города у перевозчика.
- При пустом suggestions или отсутствующем коде остановить автоматическое оформление и уточнить адрес; запас и заказ не менять.
Результат: В заявке используется проверенный код нужной службы, а исходный адрес остаётся доступен.
Если возникло исключение
- Совпадение названия города без региона недостаточно.
- Историческое поле boxberry_id не подтверждает актуальную работу бренда или маршрута.
Страна получателя из разных магазинов
Задача: Не путать разные представления страны в международной заявке.
Когда начинается: Магазин передал название или код страны в своём формате.
- Сопоставить исходное значение с ISO-кодом через справочник country и сохранить выбранный результат.
- Оператор проверяет неоднозначную подсказку и допустимость страны у выбранного перевозчика.
- В транспортный контур передаётся требуемый формат кода, а оформление документов проверяется отдельно.
Результат: Страна указана последовательно без вывода о доступности доставки.
Если возникло исключение
- Наличие страны в справочнике не доказывает доступность маршрута или разрешение на перевозку.
Изменение адреса после подготовки
Задача: Не использовать закэшированный код для нового города.
Когда начинается: Продавец подтвердил другой адрес получателя.
- Создать новую версию адреса и сбросить связь с прежним результатом lookup.
- Запросить новый код и проверить действующую заявку перевозчика.
- Согласовать изменение заявки до выдачи; сохранить обе версии для разбора.
Результат: Кэш справочника не переопределяет подтверждённое изменение заказа.
Если возникло исключение
- Повторный ответ старого запроса не применяется к новой версии адреса.
Кто управляет данными
| Данные | Ответственный источник | Правило обмена |
|---|---|---|
| Заказ и SKU | Продавец / согласованная учётная система | Передавать версию заказа, владельца товара и таблицу соответствий артикулов, не сопоставлять только по названию. |
| Остатки | Система склада, где физически находится товар | Задание перевозчику и расчёт доставки не меняют количество доступного товара. |
| Статусы | Склад — комплектация и передача; перевозчик — перевозка | Сохранять оба времени и исходное событие; трек-номер сам по себе не доказывает передачу. |
| Документы | Сторона, выпустившая документ | Номер, версия и связь с конкретными местами сохраняются; повторное чтение не создаёт вторую отгрузку. |
| Возвраты | Перевозчик — обратное движение; склад — фактическая приёмка | Товар становится доступным после осмотра и разрешения склада, а деньги возвращаются отдельным процессом. |
| Адрес и справочный код | Продавец — адрес; DaData — результат справочного поиска | Сохранять исходное значение и выбранный вариант; исправление адреса требует подтверждения, справочник не является источником складского движения. |
Что обсудить перед пилотом
- Откуда приходит КЛАДР-код и какой уровень адреса он обозначает?
- Какие перевозчики фактически используются и какие поля им нужны?
- Кто подтверждает неоднозначный город и изменение адреса после оформления?
Перед оценкой
Что нужно уточнить
- API-ключ клиента и подтверждённый продукт справочников.
- Источник корректного кода города до вызова delivery.
- Образцы адресов, критерии ручной проверки и действующий справочник перевозчика.
Границы сценария
Что учесть заранее
- Метод delivery принимает КЛАДР-код города, а не готовый заказ и не произвольную адресную строку.
- Перечень кодов в сохранённом источнике исторический; по нему нельзя делать вывод о текущем статусе Boxberry или другого перевозчика.
- Справочник стран не переносит российские правила маркировки или документов на Казахстан и Узбекистан и не подтверждает международный тариф.
Стоимость и запуск
Оценим ваш набор операций
На объём работ влияют версии систем, доступы, число кабинетов, направление обмена и обработка ошибок. После разбора задачи согласуем реализацию, стоимость и сроки.
Подготовьте несколько обезличенных адресов с кодами городов и одну действующую схему заявки перевозчика — проверим точное сопоставление.
Вопросы о подключении
DaData проверит квартиру и возможность доставки?
В этой статье рассматривается поиск кода города. Проверка конкретного адреса, зоны обслуживания и ПВЗ требует другого подтверждённого источника.
Что означает пустой suggestions?
Для переданного кода не найден результат. Это повод проверить входной код и справочник, а не автоматически выбрать ближайший город.
Можно сопоставлять всё по тексту города?
Для вызова delivery нужен КЛАДР-код. Текстовый адрес сначала разбирается отдельным подтверждённым способом; одноимённые города требуют региона.
Как использовать кэш?
Хранить результат по коду, перевозчику и времени проверки. При изменении адреса или отказе перевозчика перепроверять; кэш не должен закреплять ошибку навсегда.
Как подготовить обратную доставку?
Для адреса склада возврата выполните собственное сопоставление города. Полученный код не оформляет возврат и не подтверждает приёмку: заявку создаёт перевозчик, а товар принимает склад.
Интеграция уже готова?
Материал описывает предложение обмена. Работающий коннектор Skirbo, пилот и приёмка на заказах вашего клиента не подтверждены; способ реализации определяется после проверки доступов и операций. Перед запуском подтвердим состав операций и проверим результат на согласованном сценарии.
Официальные материалы сервиса
Используем для оценки возможностей внешней системы. Документация не является подтверждением готовности коннектора Skirbo.
- API: идентификатор города в СДЭК, Boxberry и DPD — дата проверки: 2026-10-30
- API: страны — дата проверки: 2026-10-30
Посмотрите другие сценарии
Весь каталог →Ваш процесс → следующий шаг
Что хотите связать со Skirbo?
Выберите сервисы и расскажите, какие данные нужно передавать. Можно описать одну интеграцию или связку из нескольких систем.
- Разберём задачуУточним роли, склады и операции.
- Проверим возможностьОпределим доступы, ограничения и состав работ.
- Согласуем запускОбсудим стоимость, сроки и критерии готовности.
Оценка заявки не означает, что подключение уже готово или разработка согласована. Пароли, API-ключи и данные покупателей в форму не добавляйте.