АЗС (Топливо. КСО)
Меню -> АЗС -> КСО
Данный раздел GUI представляет собой эмулятор для демонстрации функциональных возможностей кассы при работе автозаправочных станций при продаже нефтепродуктов, сжиженных углеводородных газов:
-
Заправка топлива в режиме КСО.
-
Взаимодействует только с интерфейсами интегрированными через АПИ согласно Руководства Программиста.
-
Оплата до начала заправки.
- Прерывание процесса заправки.
-
Правила округления GUI при работе с нефтепродуктами:
- Значение количества литров указываются до 2х знаков после запятой.
- При указании значения в режиме работы
Деньгизначение литров пересчитываются и округляются в меньшую сторону, пример:- Стоимость: 2.6, Сумма желаемой заправки: 10.00
- Пересчет: 10.00 / 2.6 = 3,84615385 - округление в меньшую сторону = 3.84
- Итого к оплате: 2.6 * 3.84 = 9.984 = округление стоимости по правилам математики 9.98
- Сдача: 0.02
-
Реализация применения скидок, надбавок, валют, УНП третьих лиц и осуществления безналичных оплат в автоматическом режиме - обеспечивается решением субъекта хозяйствования при организации работы с собственной базой товаров, согласно руководства Программиста.
-
Сумма по ставке НДС в документе продажи рассчитывается путем вычисления суммы НДС по каждой товарной позиции и сложением этих сумм.
-
Обеспечивает выполнение покупателем:
- Осуществление кассовой операции
Продажа(не поддерживает кассовые операции регистрации продажи за наличный расчет). - Осуществлять продажу только за безналичный расчет.
- Обеспечивать работу только с базой товаров.
- Осуществление кассовой операции
-
Обеспечивает выполнение работником продавца (исполнителя) осуществление кассовых операций, доступно после выхода из режима КСО.
-
Для программной кассы самообслуживания не указывается идентификатор кассира:
- В поле “Кассир” при формировании документа продажи Ф.И.О. кассира либо код - НЕ отображается.
-
Кнопка
Цены на топливо- просмотр и редактирование цен на топливо в эмуляторе:

- Выберите необходимую колонку:

- Укажите информацию о продукте:
- Выберите необходимый нефтепродукт.
- Выберите Режим заправки (Литры или Деньги).
- Укажите Значение (используйте шаблоны, либо введите произвольное значение).

- Заполните итоговую информацию о расчете (при необходимости):
- Укажите информацию о секция.
- Скидки и/или Надбавки на товар.
- Скидки и/или Надбавки на итог.
- УНП третьих лиц.
- Валюту (будет применено BYN - если не указать).

| Наименование поля | Поля в API | Обязательность | Описание |
|---|---|---|---|
| Название товара | name | + | Марка топлива и номер наливного устройства. |
| Тип кода | type | - | Тип кода, варианты значений: code - без GTIN/EAN, gtin - GTIN/EAN, service - Услуга, prepayment - Аванс |
| Код товара | code | - | Значение кода товара. Содержит исключительно цифры. В случае, если типКода указан как gtin, максимальная длина значенияКода равна 14 символам. Для остальных случаев ограничение в 13 символов |
| Количество | quantity | + | Кол-во литров. |
| Цена | price | + | Цена нефтепродуктов за 1 литр. |
| Код секции | code | - | Номер секции от 1 до 255 |
| Наименование секции | name | - | Название секции |
| Скидка | discount | + | Скидка товарной позиции. В случае, если скидка не должна быть применена, должно быть передано значение null |
| Надбавка | markup | + | Надбавка товарной позиции. В случае, если надбавка не должна быть применена, должно быть передано значение null |
| НДС | tax_rate | + | НДС. Важно помнить, что НДС 0 и отсутствие НДС - разные вещи |
| Скидка на итог | cheque_discount | + | Скидка по чеку |
| Надбавка на итог | cheque_markup | + | Надбавка по чеку |
| УНП третьих лиц | tp_tax_number | - | УНП 3-го лица |
| Валюта | currency | + | Валюта совершаемой операции, если не передано - byn |
- Подтвердите действие кнопкой
Оплатить и заправить- формируетitems- массив товарных позиций и информация об итогах.- Открывает модальное окно для формирования итоговой информации о расчете.
- Заполните данные об оплате:

-
Введите значение суммы в поле соответствующее выбранному типу оплаты
PaymentType.По карте- соответствует типуcashless.Др. способы- соответствует типуother.- Вы можете использовать название конкретного способа для указания в чеке и Z-отчете, для этого требуется указать:
- ID - ключ по которому способ оплаты будет группироваться в X/Z-отчетах.
- Имя - название способа, которое будет фигурировать в фискальных документах.
- Пример использования:
ID: 1Имя: Купон,ID2Имя: Талон
- Пример использования:
- Вы можете использовать название конкретного способа для указания в чеке и Z-отчете, для этого требуется указать:
-
Подтвердите действие кнопкой
Добавить оплату- формируетpayment- массив способов оплат -
Добавленная оплата отобразится в Списке оплат.
-
Чекбокс (флаг)
НЕ печатать чек- Обеспечивает возможность отказа от передачи на печать кассового документа.
- Устанавливает тип принтера
printer.dummyдля совершения операции.
-
Кнопка
Продажа- Название действия:create_sale- Данный метод предназначен для совершения операции продажи.
-
Кнопка
Электронный документ- Открывает электронный образ чека в браузере по умолчанию (при наличии интернет соединения и после успешной отправки документа на сервер)