https://crystals.atlassian.net/browse/SRTB-9728

https://crystals.atlassian.net/browse/CR-13898

1 Описание
2 Ценность
3 Особенности работы
4 Примеры работы
- 4.1 Клавиатурная касса
- 4.2 SetTouch
5 Ограничения
6 Настройка
- 6.1 Проверка существующих настроек
- 6.2 Добавление или обновление настроек
7 Интеграция
8 Статьи по теме

Описание

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

Из-за этого сотрудникам приходится вручную сверять данные в ERP-системе, что увеличивает трудозатраты и риск ошибок.

В версии 10.4.18.0 добавлена возможность указывать номер документа-основания при регистрации нефискального документа.

Ценность

Снижение трудозатрат за счёт автоматизации сверки заказов.
Уменьшение количества ошибок, вызванных ручным вводом данных.
Повышение скорости обработки заказов.

Особенности работы

Запрос номера заказа активируется только при наличии соответствующей настройки, привязанной к типу нефискального документа. Если настройка не включена, система не требует ввода номера.
Процесс ввода номера:
- Номер можно ввести вручную с клавиатуры или отсканировать штрихкод.
- Допустимы только цифровые символы (максимум — 10 знаков).
- Поле не может быть пустым: если кассир отменяет ввод, система прерывает формирование нефискального документа.
После указания номера он передаётся в ERP в составе данных нефискального документа для дальнейшей обработки.

Примеры работы

Клавиатурная касса

Кассир выбирает пункт меню Нефискальный документ.

Кассир выбирает тип нефискального документа - Заказ юридического лица → нажимает ВВОД.

Касса запрашивает ввод номера документа-основания. Кассир вводит номер → нажимает ВВОД.

Кассир добавляет товары в документ → нажимает ПОДИТОГ.

В случае, если кассир просканировал некорректный номер - на кассе отображается сообщение: “Считанный номер документа не соответствует ожидаемому формату - (строка, до 10 цифр)“. При вводе вручную сообщение не отображается.

SetTouch

Кассир нажимает кнопку Нефискальный документ.

Кассир выбирает тип нефискального документа - Заказ юридического лица → нажимает Выбрать.

Кассир сканирует номер или вводит значение вручную.

Кассир нажимает ПОДТВЕРДИТЬ.

Кассир добавляет товары в документ → нажимает .

В случае, если кассир сканирует некорректный номер, касса отображает сообщение:

Ограничения

Вводимый номер не проверяется во внешних системах.

Настройка

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

Проверка существующих настроек

Для просмотра текущих конфигураций выполните SQL-запрос:

SELECT * FROM sales_management_properties WHERE module_name IN ('CASH_NON_FISCAL_DOC');

В результате вы увидите, какие типы документов уже имеют настройки. Например:

Документ "Вскрытие тары" содержит параметр property_key=OPEN_UP_TARE.settings
Документы "Списание товара" и "Заказ юридического лица" настройки не имеют.

Добавление или обновление настроек

В зависимости от наличия .settings выполняется соответствующий скрипт:

Если настройка существует - выполните скрипт для обновления:

• Пример скрипта для нефискального документа “Вскрытие тары”:

UPDATE sales_management_properties SET property_value = '{"enterDocNumber": true}' WHERE property_key = 'OPEN_UP_TARE.settings';

Если настройка отсутствует - выполните скрипт для добавления настройки:

• Пример скрипта для нефискального документа “Заказ юридического лица”:

SELECT add_property('CASH_NON_FISCAL_DOC', null, 'LEGAL_ENTITY_ORDER.settings', '{"enterDocNumber": true}', 'Настройки', 10, 2, 0);

• Пример скрипта для пользовательского нефискального документа “Списание товара”:

SELECT add_property('CASH_NON_FISCAL_DOC', null, 'CUSTOM_DOC1.settings', '{"enterDocNumber": true}', 'Настройки', 10, 2, 0);

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

Интеграция

Экспорт нефискальных документов производится согласно интеграционной документации:

Экспорт чеков из SetRetail10 в ERP (веб-сервис на стороне SetRetail10)

Пример экспорта

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
  <purchase tabNumber="99999" userName="Иванов Иван Иванович" operationType="true" cashOperation="INCOME" operDay="2025-08-07+03:00" shop="779" cash="2" shift="93" number="4" saletime="2025-08-08T13:10:50.877+03:00" begintime="2025-08-08T13:10:27.037+03:00" amount="1777.77" discountAmount="0.00" inn="7802781104">
        <plugin-property key="NON_FISCAL_DOCUMENT_TYPE" value="LEGAL_ENTITY_ORDER"/>
        <plugin-property key="FISCAL_DOC_ID" value="0"/>
        <plugin-property key="NON_FISCAL_DOCUMENT_NUMBER" value="22354"/>
        <plugin-property key="KPP" value="780101001"/>
        <positions>
            <position order="1" departNumber="583" goodsCode="0000305" barCode="4216420000305" count="1.000" cost="1777.77" nds="20.0" ndsSum="0.00" discountValue="0.00" costWithDiscount="1777.77" amount="1777.77" dateCommit="2025-08-08T13:10:36.820+03:00" insertType="2">
                <plugin-property key="countryName" value="Россия"/>
                <plugin-property key="salesTax"/>
                <plugin-property key="ffdTag2108"/>
                <plugin-property key="minimalPrice" value="-1"/>
            </position>
        </positions>
        <payments/>
    </purchase>
</purchases>

SetRetail10 ◾️ Ввод номера нефискального документа