Обсудить задачу
Учётные системы

Skirbo +
LiteBox

Начать со сверяемого пополнения торговой точки: связать собранные складом позиции с документом «Приход» LiteBox, проверить загруженные строки и фактическую приёмку. Автоматический API-обмен и фискализацию оценить отдельными маршрутами.

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

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

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

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

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

Ассортимент и вариантыКаталог клиента / LiteBox ↔ сопоставление SkirboОбсудим в составе подключения

Отдельно связать код, штрихкод, вариант и единицу; строка названия не заменяет идентификатор товара.

Документы продаж и возвратовLiteBox → сверка SkirboОбсудим в составе подключения

API обмена документами описан как отдельный контур; конкретный набор операций, статусы и повторы проверяются по его контракту.

Фискальное подтверждение расчётаУполномоченный контур продавца ↔ кассовый контур LiteBoxОбсудим в составе подключения

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

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

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

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

Товароучёт LiteBox и связанная касса российского магазина клиента Skirbo. Карточка не описывает отдельную модель устройства и не переносит протоколы OrangeData или aQsi на LiteBox. В кассовом процессе отдельно учитываются продавец, магазин, устройство и событие расчёта.

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

Подтверждён операторский импорт XLS в документы «Приход» и «Инвентаризация». Для автоматизации LiteBox различает API обмена документами и API фискализации чеков; подробный контракт обмена документами открывается после входа на lbe.litebox.ru. Публичная инструкция указывает «Профи» — применимость тарифа нужно проверить в своей подписке. Складской документ и чек не объединяются в один запрос по предположению.

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

  1. В Skirbo зафиксировать клиента, отгрузку, точку назначения, SKU/варианты, количества и единицы; цены для документа подтверждает владелец учёта магазина.
  2. По таблице сопоставления подготовить XLS для «Прихода»: штрихкод или код товара, единица, количество и закупочная цена. Внешний код можно использовать как дополнительную связь по согласованным правилам, не подменяя обязательные колонки.
  3. Уполномоченный сотрудник открывает нужный документ LiteBox, выбирает файл, начальную строку и соответствие столбцов. Файл с заголовками проверяется отдельно, чтобы заголовок не стал товаром.
  4. После импорта сверить сообщение о количестве загруженных и незагруженных товаров с исходным составом. Неоднозначные товары, варианты и единицы разобрать до подтверждения документа.
  5. Магазин физически принимает и пересчитывает груз; сохранить связь отгрузки с документом и фактически принятой частью. Загрузка строк не считается сама по себе приёмкой всех товаров.
  6. При обрыве или частичном результате найти уже загруженные строки и сверить документ перед повтором. Исправлять недостающую часть по согласованному порядку, сохраняя исходный файл и причины расхождения.

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

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

Пополнение магазина через проверяемый XLS

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

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

  1. В Skirbo зафиксировать клиента, отгрузку, точку назначения, SKU/варианты, количества и единицы; цены для документа подтверждает владелец учёта магазина.
  2. По таблице сопоставления подготовить XLS для «Прихода»: штрихкод или код товара, единица, количество и закупочная цена. Внешний код можно использовать как дополнительную связь по согласованным правилам, не подменяя обязательные колонки.
  3. Уполномоченный сотрудник открывает нужный документ LiteBox, выбирает файл, начальную строку и соответствие столбцов. Файл с заголовками проверяется отдельно, чтобы заголовок не стал товаром.
  4. После импорта сверить сообщение о количестве загруженных и незагруженных товаров с исходным составом. Неоднозначные товары, варианты и единицы разобрать до подтверждения документа.
  5. Магазин физически принимает и пересчитывает груз; сохранить связь отгрузки с документом и фактически принятой частью. Загрузка строк не считается сама по себе приёмкой всех товаров.
  6. При обрыве или частичном результате найти уже загруженные строки и сверить документ перед повтором. Исправлять недостающую часть по согласованному порядку, сохраняя исходный файл и причины расхождения.

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

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

  • Нельзя повторять импорт всего файла, не проверив уже попавшие строки.
  • Импорт XLS не подтверждает API-метод создания или проведения накладной.

Инвентаризация по фактическому пересчёту

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

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

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

Результат: Фактический пересчёт и учётное исправление имеют разные, проверяемые основания.

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

  • Движения после пересчёта не следует исправлять как недостачу.
  • Правило точного имени относится к описанному импорту и не заменяет идентификаторы в будущем API.

Сверить возврат товара и торговый документ

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

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

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

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

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

  • Наличие категории возвратов в описании обмена не раскрывает конкретный API-метод и его идемпотентность.

Фискализация интернет-заказа как отдельный процесс

Задача: Не считать созданный приход или успешную оплату уже подтверждённым кассовым результатом.

Когда начинается: Продавец определил событие расчёта по интернет-заказу.

  1. Продавец подтверждает финансовое основание и реквизиты, склад — только фактический состав исполнения. Сопоставить заказ, платёж, торговый документ и будущий чек отдельными связями.
  2. Для выбранного магазина проверить протокол фискализации из кабинета, API-токен, идентификатор магазина и используемую кассу. Это отдельная настройка от API торговых документов.
  3. Уполномоченный кассовый контур передаёт задание и получает результат по подтверждённому протоколу. Пока его статусы не проверены, автоматическое закрытие выдачи по одному факту отправки не предусматривается.
  4. При неизвестном результате ответственный сначала сверяет существующий чек; возврат товара, возврат денег и возвратный фискальный документ разбираются как отдельные действия.

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

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

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

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

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

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

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

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

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

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

  • Инструкция об импорте подтверждает работу оператора с XLS, а не готовый двусторонний коннектор Skirbo.
  • Сохранённая инструкция инвентаризации требует заранее заведённых товаров и совпадения наименования вплоть до пробелов; применимость проверить на текущем интерфейсе.
  • Идентификатор магазина фискализации не выводится из GUID площадки ФГИС «Меркурий»: это разные контуры.
  • Схема статусов документов API, повторы и возвратный фискальный документ в доступной публичной статье не раскрыты.
  • Российские кассовые и маркировочные требования не распространяются этим материалом на Казахстан, Узбекистан и другие страны.
Стоимость и запуск

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

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

Какую торговую точку LiteBox нужно связать со складом, и сможете ли вы дать обезличенный пример «Прихода» с товарами и результатом импорта?

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

Обязательно начинать с API?

Для пополнения можно оценить управляемый импорт XLS в «Приход»: назначить ответственного, сопоставить поля и сверить загруженные строки. Это операторский процесс; автоматическое выполнение требует отдельного контракта.

Какие поля нужны для «Прихода»?

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

Подойдёт ли тот же файл для инвентаризации?

Проверка отдельная: инструкция инвентаризации требует также продажную цену, заранее заведённый ассортимент и совпадение наименований вплоть до пробелов. Нельзя автоматически переносить правила «Прихода» на другой документ.

GUID площадки — это ID магазина API?

В прочитанной инструкции GUID относится к площадке ФГИС «Меркурий». Для фискализации LiteBox отдельно указан идентификатор магазина; эти значения не подменяют друг друга.

Что делать, если импорт загрузил только часть товаров?

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

Один API покрывает товарный документ и чек?

Поставщик выделяет API обмена документами и API фискализации чеков. Доступ, идентификаторы и подтверждения этих процессов оцениваются отдельно.

Возвратный чек автоматически увеличит складской остаток?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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