ru.crystals.pos.spi.plugin.goods

Interface AddForSaleCallback

public interface AddForSaleCallback

Интерфейс для оповещения кассы о результатах выполнения запроса на добавление товара в чек продажи. Через этот слушатель плагин типа товаров оповещает о завершении создания позиции.

Method Summary

Modifier and Type	Method and Description
void	completed(AddForSaleResult result) Добавление товара в чек.
default void	completed(NewLineItem newLineItem) Deprecated. Метод устарел и не рекомендуется к использованию. Используйте completed(AddForSaleResult)
default void	completed(NewLineItem newLineItem, java.util.Collection<Action> actionsToTake) Добавление товара в чек
default void	notCompleted() Результат: товар не может быть добавлен в чек продажи.
void	notCompleted(AddForSaleResult result) Результат: товар не может быть добавлен в чек продажи.

Method Detail

completed

@Deprecated
default void completed(NewLineItem newLineItem)
                            throws InvalidLineItemException

Deprecated. Метод устарел и не рекомендуется к использованию. Используйте completed(AddForSaleResult)

Результат: товар может быть добавлен в чек продажи.

Parameters:

newLineItem - данные, которые необходимо сохранить в БД

Throws:

InvalidLineItemException - исключение возникает, если аргумент newLineItem содержит некорректные данные.
Данные не будут сохранены в БД кассы.
Локализованное сообщение можно получить методом Throwable.getLocalizedMessage()

Причинами возникновения исключения могут быть:
  - некорректно заполненные или пустые требуемые поля;
  - другими настройками кассы, блокирующими добавление (например превышение суммы чека).
 

В данной ситуации рекомендуется отобразить сообщение об ошибке и,
если возможно, отменить добавление товара.

InvalidLineItemException - если товар не может быть добавлен по причине ошибки.

completed

default void completed(NewLineItem newLineItem,
                       java.util.Collection<Action> actionsToTake)
                throws InvalidLineItemException

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

Parameters:

newLineItem - данные, которые необходимо сохранить в БД

actionsToTake - действия, которые нужно произвести, если добавление пройдет успешно

Throws:

InvalidLineItemException - если данная позиция не может быть добавлена.

API Note:

Важно знать:
1. Каждый Action атомарен и не влияет на выполнение других
2. Выполнение не гарантируется и не влияет на добавление товара в чек

completed

void completed(AddForSaleResult result)
        throws InvalidLineItemException

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

Parameters:

result - результат обработки плагином события добавления товара в чек

Throws:

InvalidLineItemException - если данная позиция не может быть добавлена

Since:

0.0.71

notCompleted

default void notCompleted()
                   throws CancelDeniedException

Результат: товар не может быть добавлен в чек продажи.

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

Throws:

CancelDeniedException - возникает, когда у кассира нет привилегии для отмены позиции.
Управление остается у плагина.
Решается административно, например авторизацией пользователем имеющим данную привилегию.

notCompleted

void notCompleted(AddForSaleResult result)
           throws CancelDeniedException

Результат: товар не может быть добавлен в чек продажи.

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

Parameters:

result - результат обработки плагином события добавления товара в чек

Throws:

CancelDeniedException - возникает, когда у кассира нет привилегии для отмены позиции.
Управление остается у плагина.
Решается административно, например авторизацией пользователем имеющим данную привилегию.

Since:

0.0.71