Обсудить задачу
Доставка

Skirbo +
ApiShip

Связать заказ, площадку отгрузки и внешнее отправление так, чтобы ошибку передачи перевозчику можно было исправить без второй выдачи товара и потерянного трек-номера.

Посмотреть сценарии

Какой обмен обсудим

Зафиксируем нужные операции, направление данных и условия приёмки.

ОперацияНаправлениеСостав и готовность
Заказ и местаSkirbo → ApiShipОбсудим в составе подключения

Проект: клиент + внутренний заказ + версия + склад → внешняя заявка; обязательные поля уточняются по перевозчику.

Результат передачиApiShip → SkirboОбсудим в составе подключения

Сохранять номер заявки, состояние передачи и ошибку; это отдельно от факта передачи курьеру.

Исправление заявкиSkirbo / оператор → ApiShipОбсудим в составе подключения

Выбирать изменение или пересоздание после проверки возможностей службы; сохранять старый и новый треки.

Факт отгрузкиСклад → SkirboОбсудим в составе подключения

Сканирование мест, сотрудник и время выдачи; API оформления не заменяет этот факт.

На узком экране таблицу можно прокрутить в сторону.

Это сценарии для обсуждения. Методы API сервиса сами по себе не подтверждают готовность подключения в Skirbo.

Для какой задачи подходит сервис

Для интернет-магазина или фулфилмента, который выбирает перевозчика для уже собранного заказа. Рассматривается ApiShip как контур оформления доставки: склад Skirbo отвечает за реальные коробки, а регистрация в транспортной системе подтверждается отдельно.

Как организовать обмен

Прочитаны получение токена, исправление ошибок и запрос статуса по clientNumber. Полный контракт создания и печати, права и условия конкретного перевозчика проверяются перед разработкой. Если автоматический метод недоступен, процесс согласуется через оператора.

Предлагаемый порядок работы

  1. Взять подтверждённый состав заказа, число мест, вес, адрес и выбранную услугу доставки.
  2. Сопоставить клиента, склад отправления и договор перевозчика; проверить, что в ApiShip выбран нужный склад, а не площадка другого продавца.
  3. По согласованному интерфейсу создать заявку либо передать её оператору кабинета; сохранить внешний номер в журнале обмена.
  4. Сотрудник склада сверяет коробки с заявкой и выдаёт их только в согласованное окно забора.
  5. Вернуть в заказ внешний номер и результат оформления; физическую передачу зафиксировать отдельным событием.
  6. Проверить принятие информации системой перевозчика: созданная запись ApiShip и принятый перевозчиком заказ не считаются одним фактом.
  7. Если передача завершилась ошибкой, остановить повторную выдачу и выбрать допустимое для этого перевозчика исправление.

Практические сценарии

Предлагаемая схема для согласования и пилота. Она не означает, что описанный обмен уже настроен в Skirbo.

От собранного заказа до принятого отправления

Задача: Удержать одну связь между физической посылкой и заявкой перевозчику.

Когда начинается: Склад закончил упаковку заказа продавца.

  1. Взять подтверждённый состав заказа, число мест, вес, адрес и выбранную услугу доставки.
  2. Сопоставить клиента, склад отправления и договор перевозчика; проверить, что в ApiShip выбран нужный склад, а не площадка другого продавца.
  3. По согласованному интерфейсу создать заявку либо передать её оператору кабинета; сохранить внешний номер в журнале обмена.
  4. Сотрудник склада сверяет коробки с заявкой и выдаёт их только в согласованное окно забора.
  5. Вернуть в заказ внешний номер и результат оформления; физическую передачу зафиксировать отдельным событием.
  6. Проверить принятие информации системой перевозчика: созданная запись ApiShip и принятый перевозчиком заказ не считаются одним фактом.
  7. Если передача завершилась ошибкой, остановить повторную выдачу и выбрать допустимое для этого перевозчика исправление.

Результат: У заказа есть проверяемая цепочка: коробки → заявка ApiShip → перевозчик → факт передачи.

Если возникло исключение

  • При неопределённом ответе сначала найти существующую заявку.
  • Новый трек после пересоздания сохранять рядом со старым с причиной замены.

Исправление ошибки передачи

Задача: Разобрать состояние uploadingError без слепого повторного создания.

Когда начинается: В ApiShip зафиксирована ошибка передачи заказа в систему перевозчика.

  1. Оператор сверяет ошибку с исходной версией адреса и грузовых мест.
  2. Выбирает описанное ApiShip обновление или контролируемое удаление и новое оформление после проверки отсутствия принятого дубля.
  3. После ответа перепроверяет внешнюю запись, сохраняет историю исправления и разрешает складскую передачу.

Результат: Ошибка закрывается подтверждённым результатом, а не исчезновением записи из очереди.

Если возникло исключение

  • Если перевозчик уже принял заказ, применять правила изменения действующей заявки.
  • Удаление записи не считать доказательством отмены физического забора.

Смена адреса до отгрузки

Задача: Сохранить связь при ограничениях конкретной службы доставки.

Когда начинается: Покупатель изменил адрес после оформления, но до передачи коробки.

  1. Заблокировать выдачу и установить, поддерживает ли выбранная служба обновление или отмену через ApiShip.
  2. Подтвердить результат изменения; при новом оформлении связать старый и новый трек.
  3. Перепечатать согласованные документы, снять старую этикетку и сверить коробку сканированием.

Результат: На коробке и в заказе остаётся одна действующая версия доставки.

Если возникло исключение

  • Если изменение не поддерживается, задачу решает оператор с перевозчиком; товар не выдаётся по двум заявкам.

Кто управляет данными

ДанныеОтветственный источникПравило обмена
Заказ и SKUПродавец / согласованная учётная системаПередавать версию заказа, владельца товара и таблицу соответствий артикулов, не сопоставлять только по названию.
ОстаткиСистема склада, где физически находится товарЗадание перевозчику и расчёт доставки не меняют количество доступного товара.
СтатусыСклад — комплектация и передача; перевозчик — перевозкаСохранять оба времени и исходное событие; трек-номер сам по себе не доказывает передачу.
ДокументыСторона, выпустившая документНомер, версия и связь с конкретными местами сохраняются; повторное чтение не создаёт вторую отгрузку.
ВозвратыПеревозчик — обратное движение; склад — фактическая приёмкаТовар становится доступным после осмотра и разрешения склада, а деньги возвращаются отдельным процессом.

Что обсудить перед пилотом

  • Какая служба первой принимает заказы и поддерживает ли она изменение до отгрузки?
  • Как склад узнаёт, что сведения приняты перевозчиком, и кто разбирает uploadingError?
  • Кто подтверждает замену трека и снимает старую этикетку?
Перед оценкой

Что нужно уточнить

  • Выбранный аккаунт ApiShip, договоры перевозчиков и отдельное сопоставление складов.
  • Обезличенные примеры успешной заявки и ошибки передачи, перечень доступных операций перевозчика.
  • Правило смены трека, этикетки и контроля незавершённых отмен.
Границы сценария

Что учесть заранее

  • Описанные процедуры различаются по перевозчикам; поддержка обновления и отмены не универсальна.
  • Токен API не доказывает наличие договора на выбранную службу и готового коннектора Skirbo.
  • Для Казахстана и Узбекистана нужен отдельный маршрут, договор и проверка услуг; российская настройка не переносится автоматически.
Стоимость и запуск

Оценим ваш набор операций

На объём работ влияют версии систем, доступы, число кабинетов, направление обмена и обработка ошибок. После разбора задачи согласуем реализацию, стоимость и сроки.

Выберите одну службу доставки и склад: нужны обезличенная заявка, пример uploadingError и правило выдачи коробок курьеру.

Вопросы о подключении

Почему наличие трека ещё не разрешает выдачу?

Трек связывает запись, но не подтверждает принятие перевозчиком и физический забор. Перед выдачей нужны оба контрольных условия выбранного процесса.

Можно ли удалить заказ и сразу создать новый?

Только после проверки судьбы первой заявки. Документация описывает пересоздание, но для склада это контролируемая замена со связью номеров и этикеток.

Как работать с двумя складами одного продавца?

Каждому назначают собственную внешнюю площадку и контакты. Заказ выбирает одну площадку; адрес нельзя брать из последней обработанной заявки.

Будут ли в ApiShip передаваться все остатки?

Для описанного оформления доставки это не требуется. Передаются данные конкретной отправки; запас остаётся в системе физического склада.

Интеграция уже готова?

Материал описывает предложение обмена. Работающий коннектор Skirbo, пилот и приёмка на заказах вашего клиента не подтверждены; способ реализации определяется после проверки доступов и операций. Перед запуском подтвердим состав операций и проверим результат на согласованном сценарии.

Официальные материалы сервиса

Используем для оценки возможностей внешней системы. Документация не является подтверждением готовности коннектора Skirbo.

Посмотрите другие сценарии

Весь каталог →
Ваш процесс → следующий шаг

Что хотите связать со Skirbo?

Выберите сервисы и расскажите, какие данные нужно передавать. Можно описать одну интеграцию или связку из нескольких систем.

  1. Разберём задачуУточним роли, склады и операции.
  2. Проверим возможностьОпределим доступы, ограничения и состав работ.
  3. Согласуем запускОбсудим стоимость, сроки и критерии готовности.

Оценка заявки не означает, что подключение уже готово или разработка согласована. Пароли, API-ключи и данные покупателей в форму не добавляйте.

1. Какие сервисы подключить?

До 5 сервисов в одной заявке.

Укажите роль — подскажем, какие особенности процесса описать.

2. Какие задачи решить?

Выберите от 1 до 8 задач.

Компания и объём заказов необязательно
3. Как с вами связаться?
Проверяем возможность отправки. Вы также можете подготовить запрос и передать его поддержке.
Открыть поддержку в Telegram

Копирование и переход в Telegram сами по себе не отправляют заявку.

Названия и логотипы используются для обозначения сервисов. Состав подключения и условия уточняем для вашей задачи.