Маркировка¶
Маркировка добавляет к фискализации второй контур: ГИС МТ / Честный ЗНАК и ОИСМ. Для маркированного товара недостаточно передать обычную позицию чека; нужно корректно передать код маркировки, товарную группу, результат проверки и соблюсти ограничения канала продажи.
Главная логика¶
Перед payload нужно ответить на три вопроса:
- Разрешен ли товар к продаже в выбранном канале.
- Может ли сценарий использовать облачную ККТ.
- Кто выполняет проверку маркировки и передает результат в кассу.
Если товар нельзя продавать дистанционно или облачная касса не подходит для конкретной категории, технически успешный API-вызов не делает сценарий корректным.
Участники¶
| Участник | Роль |
|---|---|
| Мерчант | Передает товар, цену, код маркировки и сценарий продажи. |
| Банк/шлюз | Маршрутизирует фискальные данные в кассовый сервис. |
| Кассовый сервис | Передает данные ККТ и обрабатывает ответ по маркировке. |
| ККТ/ФН | Формирует фискальный документ и участвует в проверке кода. |
| ОИСМ / Честный ЗНАК | Проверяет код маркировки и разрешительный режим. |
| ОФД/ФНС | Получают фискальный документ и маркировочные реквизиты. |
Что должно быть в позиции¶
| Группа | Что проверить |
|---|---|
| Код маркировки | Формат Data Matrix / GS1 DM и способ передачи, который ожидает провайдер. |
| Товарная группа | Категория маркированного товара; от нее зависит разрешительный режим. |
| ФФД 1.2 | Поддержка маркировочных реквизитов в кассе и API. |
| Количество и мера | Для маркированного товара ошибка количества может ломать проверку. |
| НДС и цена | Должны соответствовать товару и общей сумме чека. |
| Результат проверки | Нужно понимать, проверен ли код в ФН/ОИСМ и какой статус вернулся. |
Пример смысловой структуры¶
{
"name": "Маркированный товар",
"payment_method": "full_payment",
"payment_object": "commodity",
"marking_code": "010460000000000021ABC..."
}
У конкретного провайдера поле может называться иначе, требовать вложенный объект, base64/hex-представление или дополнительные признаки проверки.
FBS, FBO и отсутствие делегирования¶
| Схема | Что важно для фискализации |
|---|---|
| FBS | Продавец обычно отвечает за товар и данные маркировки, площадка может быть агентом. |
| FBO | Площадка или оператор склада участвует в выдаче товара; нужно отдельно описывать роль поставщика и агента. |
| Без делегирования | Мерчант сам передает код и несет риск корректности payload. |
В агентских и маркетплейс-схемах маркировка связана с supplier-реквизитами: кто является поставщиком маркированного товара, тот должен быть корректно отражен в чеке.
Изменения внешнего контура¶
Интеграции с Честным ЗНАКом могут меняться независимо от кассового API. Если меняется транспорт, авторизация или порядок проверки кодов, старый payload может перестать проходить даже при неизменной кассовой части. Поэтому маркировочные сценарии нужно держать в отдельном наборе тестов и не смешивать с обычным sell-smoke.
Типовые риски¶
- провайдер принимает чек без полной проверки маркировки;
- касса не поддерживает нужную версию ФФД;
- код технически валиден, но товар нельзя продавать в выбранном канале;
- ОФД не показывает все маркировочные реквизиты на публичной витрине;
- после изменений Честного ЗНАКа старый payload перестает проходить;
- в агентской схеме код маркировки связан с неверным поставщиком.