Обсудить задачу
Документы и маркировка

Skirbo +
Docsvision

Изучим передачу актов и сопроводительных документов Skirbo в используемые карточки Docsvision. Проверим платформу, модули и способ обмена, чтобы сохранить корпоративную логику документооборота.

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

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

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

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

Согласовать тип, секции карточки и набор вложений.

Этап обработкиDocsvision → SkirboОбсудим в составе подключения

Вернуть нужный результат маршрута в исходную операцию.

Связи документовВ обоих направленияхОбсудим в составе подключения

Сопоставить акт, поставку и исправленные версии.

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

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

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

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

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

Проверены документация внешнего взаимодействия и объектная модель Docsvision 5: API предоставляет работу с карточками, а шлюзы связывают бизнес-процессы с внешними системами. Сопровождающий разработчик выбирает разрешённый сервис или адаптер под установленную платформу. Эти материалы не подтверждают единый публичный REST endpoint для любого клиента; файловая версия и бизнес-карточка также не являются одним объектом.

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

  1. В Skirbo подготовить поставку, клиента, строки товара, фактические количества, причины и вложения; спорную часть оставить в состоянии, предусмотренном регламентом склада.
  2. Сопоставить вид акта с типом карточки установленной базы, строки и реквизиты — с разрешёнными секциями и справочниками. Зафиксировать связь идентификатора операции с карточкой, процессом и файлами.
  3. Сопровождающий адаптер через согласованный API создаёт либо находит карточку и передаёт файлы; до проверки адаптера ответственный может выполнить ту же передачу в интерфейсе по утверждённому регламенту.
  4. Прочитать карточку и проверить состав вложений. Отдельно подтвердить, что бинарное содержимое доступно и открывается, а не только существует запись о файле.
  5. Уполномоченный процесс запускает утверждённый маршрут; его итог, комментарий и относящаяся к акту версия возвращаются в Skirbo согласованным способом.
  6. При несовпадении типа, секции, клиента или версии остановить обработку конкретного акта. Кладовщик применяет полученное решение только после сверки с текущей поставкой и физическим товаром.

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

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

Акт приёмки в собственной карточке Docsvision

Задача: Доставить акт и доказательства в нужные секции карточки, сохранив логику процесса заказчика.

Когда начинается: Кладовщик завершил приёмку и выделил расхождения.

  1. В Skirbo подготовить поставку, клиента, строки товара, фактические количества, причины и вложения; спорную часть оставить в состоянии, предусмотренном регламентом склада.
  2. Сопоставить вид акта с типом карточки установленной базы, строки и реквизиты — с разрешёнными секциями и справочниками. Зафиксировать связь идентификатора операции с карточкой, процессом и файлами.
  3. Сопровождающий адаптер через согласованный API создаёт либо находит карточку и передаёт файлы; до проверки адаптера ответственный может выполнить ту же передачу в интерфейсе по утверждённому регламенту.
  4. Прочитать карточку и проверить состав вложений. Отдельно подтвердить, что бинарное содержимое доступно и открывается, а не только существует запись о файле.
  5. Уполномоченный процесс запускает утверждённый маршрут; его итог, комментарий и относящаяся к акту версия возвращаются в Skirbo согласованным способом.
  6. При несовпадении типа, секции, клиента или версии остановить обработку конкретного акта. Кладовщик применяет полученное решение только после сверки с текущей поставкой и физическим товаром.

Результат: Заказчик получает акт в своём процессе, а склад — связанное с ним решение без потери файлов и истории.

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

  • Наличие методов CardManager не означает обход бизнес-правил прикладного модуля.
  • GetCardState не используется как признак «согласован» без контракта процесса.

Согласование спорного возврата

Задача: Отделить физическую приёмку возврата от документного и финансового решения.

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

  1. Создать складскую запись возврата со ссылкой на исходную отгрузку, конкретные единицы, состояние и фото; товар направить на согласованную проверку качества.
  2. Найти исходный акт либо документ отгрузки в Docsvision и связать с карточкой возврата. Выбрать процесс именно для причины спора, не запускать общий маршрут повторным событием.
  3. Получить решение уполномоченного участника по конкретной версии и строкам; вернуть его в возврат вместе со ссылкой на карточку.
  4. Кладовщик после осмотра и решения выбирает дальнейшее физическое действие. Возврат денег и кассовый документ оформляются соответствующими владельцами отдельно.

Результат: Возврат, связанный документ и решение не смешиваются с финансовым завершением.

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

  • Автоматический метод запуска процесса и его входные параметры нужно подтвердить по вашей библиотеке.
  • Дубликат события возврата не должен создавать вторую задачу на согласование.

Исправление версии и восстановление недоступного файла

Задача: Передать исправление без потери прежней версии и не принять недоступное вложение за завершённую доставку.

Когда начинается: К акту добавлены новые доказательства, файл заблокирован редактором либо вынесен в офлайн-хранилище.

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

Результат: Исправление сохраняет историю, а склад получает подтверждение реально доступного файла.

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

  • Платформенная работа с файлами не гарантирует единую транзакцию с бизнес-карточкой и маршрутом.
  • Автоматический принудительный CheckIn, удаление исходного акта и повышение архивных прав не входят в предлагаемый процесс.

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

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

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

  • Каковы версии платформы, модулей и собственных библиотек карточек?
  • Какой тип карточки, секции и маршрут используются для акта приёмки либо возврата?
  • Где размещаются файлы, кто возвращает итог процесса и кто имеет право изменять спорный товар?
Перед оценкой

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

  • Указать версию Docsvision и установленные модули.
  • Предоставить описание нужных типов карточек и процессов.
  • Согласовать разрешённый API или шлюз с сопровождающим разработчиком.
  • Назначить организацию/клиента, карточку, процесс и файлы отдельными сущностями сопоставления.
  • Согласовать техническую учётную запись, пользовательскую сессию, необходимые права и доступный контур адаптера.
  • Определить, где хранится признак бизнес-согласования: платформенный статус карточки не используется вместо решения процесса.
  • Для вложений согласовать правила версий, блокировок, офлайн-хранения и проверку доступности содержимого.
Границы сценария

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

  • Возможности платформенного API не равны универсальному публичному REST-коннектору.
  • Пользовательские карточки требуют отдельного сопоставления.
  • Интеграция с оператором ЭДО и подписание не подразумеваются автоматически.
  • Guid типа, карточки и файла различаются; их нельзя заменять названием документа или одним номером поставки.
  • FileData и карточка файла с версиями имеют разную семантику; наличие карточки не гарантирует доступность файла.
  • Сценарии относятся к России; внешний юридически значимый обмен и правила других стран проверяются отдельно.
Стоимость и запуск

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

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

Какой тип карточки Docsvision используется для складских актов?

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

Подойдёт ли обмен для собственной карточки документа?

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

Можно запускать процесс по завершению приёмки?

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

Подойдёт ли любой REST-клиент?

Документация платформы подтверждает API и объектную модель, но не единый публичный HTTP-контракт вашей установки. Сначала выбирается опубликованный сервис либо адаптер и проверяются его права и версия.

Почему карточка видна, а файл не открывается?

У файла есть содержимое и сведения о нём; содержимое может находиться в другом или офлайн-хранилище. В предлагаемой приёмке нужно проверить открытие вложения, а восстановление недоступного файла передать уполномоченному сотруднику.

Статус карточки равен результату согласования?

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

Можно исправить файл, который сейчас редактирует другой сотрудник?

Исправление проводится по правилам версий и блокировки выбранного модуля. Адаптер сохраняет запрос на повтор, уведомляет ответственного и не снимает чужую блокировку автоматически.

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

Изучаем возможность связи со Skirbo. Описанные процессы предлагаются для оценки и настройки; работающий коннектор, срок подключения и запуск у клиента не подтверждены. Перед запуском подтвердим состав операций и проверим результат на согласованном сценарии.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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