Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

АЗС (Топливо)

Меню -> АЗС -> Топливо

Данный раздел 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
  • Кнопка Цены на топливо - просмотр и редактирование цен на топливо в эмуляторе:

image info

Продажа нефтепродуктов, сжиженных углеводородных газов

Этапы совершения операции:

Оплата до начала заправки.

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

image info

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

image info

Оплата после завершения заправки (Постоплата).

  • Выберите колонку Постоплата:

image info

  • Укажите информацию о продукте:
    • Выберите номер колонки.
    • Выберите необходимый нефтепродукт.
    • Укажите Значение (в литрах):

image info

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

image info

Наименование поляПоля в 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 - массив товарных позиций и информация об итогах.
    • Открывает модальное окно для формирования итоговой информации о расчете.
  • Заполните данные об оплате:

image info

  • Введите значение суммы в поле соответствующее выбранному типу оплаты PaymentType.

    • Наличные - соответствует типу cash.
    • По карте - соответствует типу cashless.
    • Др. способы - соответствует типу other.
      • Вы можете использовать название конкретного способа для указания в чеке и Z-отчете, для этого требуется указать:
        • ID - ключ по которому способ оплаты будет группироваться в X/Z-отчетах.
        • Имя - название способа, которое будет фигурировать в фискальных документах.
          • Пример использования: ID: 1 Имя: Купон, ID 2 Имя: Талон
  • Подтвердите действие кнопкой Добавить оплату - формирует payment - массив способов оплат

  • Добавленная оплата отобразится в Списке оплат.

  • Чекбокс (флаг) НЕ печатать чек

    • Обеспечивает возможность отказа от передачи на печать кассового документа.
    • Устанавливает тип принтера printer.dummy для совершения операции.
  • Кнопка Продажа - Название действия: create_sale

    • Данный метод предназначен для совершения операции продажи.
  • Кнопка Электронный документ

    • Открывает электронный образ чека в браузере по умолчанию (при наличии интернет соединения и после успешной отправки документа на сервер).

Возврат нефтепродуктов, сжиженных углеводородных газов

Этапы совершения операции:

  • Выберите колонку Возврат:

image info

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

image info

  • Подтвердите действие кнопкой Возврат - формирует items - массив товарных позиций и информация об итогах.
    • Открывает модальное окно для формирования итоговой информации о расчете.
  • Заполните данные об оплате:

image info

  • Введите значение суммы в поле соответствующее выбранному типу оплаты PaymentType.

    • Наличные - соответствует типу cash.
    • По карте - соответствует типу cashless.
    • Др. способы - соответствует типу other.
      • Вы можете использовать название конкретного способа для указания в чеке и Z-отчете, для этого требуется указать:
        • ID - ключ по которому способ оплаты будет группироваться в X/Z-отчетах.
        • Имя - название способа, которое будет фигурировать в фискальных документах.
          • Пример использования: ID: 1 Имя: Купон, ID 2 Имя: Талон
  • Подтвердите действие кнопкой Добавить оплату - формирует payment - массив способов оплат

  • Добавленная оплата отобразится в Списке оплат.

  • Чекбокс (флаг) НЕ печатать чек

    • Обеспечивает возможность отказа от передачи на печать кассового документа.
    • Устанавливает тип принтера printer.dummy для совершения операции.
  • Кнопка Возврат - Название действия: create_money_back

    • Данный метод предназначен для совершения операции продажи.
  • Кнопка Электронный документ

    • Открывает электронный образ чека в браузере по умолчанию (при наличии интернет соединения и после успешной отправки документа на сервер).