ru.crystals.pos.spi.currency

Interface ExtCurrencyHandler

All Superinterfaces:

Injectable

public interface ExtCurrencyHandler
extends Injectable

Реализации этого интерфейса знают как обращаться с деньгами: как их округлять при вычислении стоимости позиции или размера скидки.

Далее для простоты везде этот интерфейс и его реализации будем называть "округлятором".

NOTE: все денежные суммы представлены в BigDecimal с двумя знаками после запятой, т.е. scale=2

Method Summary

Modifier and Type	Method and Description
default java.lang.Long	calculateNdsSum(java.lang.Long sum, java.lang.Float nds) Вычисление суммы НДС
java.lang.Long	convertCurrency(java.math.BigDecimal value) Преобразует денежную величину "в рублях" в денежную величину, выраженную в минимальных денежных единицах.
java.math.BigDecimal	convertCurrency(java.lang.Long value) Преобразует денежную величину из копеек в рубли.
java.lang.Long	convertQuantity(java.math.BigDecimal quantity) Преобразует весовую величину из килограммов в граммы.
java.math.BigDecimal	convertQuantity(java.lang.Long quantity) Преобразует весовую велиичну из граммов в килограммы.
default java.lang.String	getCurrencyCode()
java.math.BigDecimal	getPositionSum(java.math.BigDecimal price, long qnty) Вычислить сумму позиции и округлить в соответствиями с текущими правилами округления (т.е.
java.math.BigDecimal	round(java.math.BigDecimal value) Вернет результат округления указанного аргумента до ближайшей валидной суммы денег.

Method Detail

getPositionSum

java.math.BigDecimal getPositionSum(java.math.BigDecimal price,
                                    long qnty)

Вычислить сумму позиции и округлить в соответствиями с текущими правилами округления (т.е. просто умножение, с последующим округлением)

Parameters:

price - цена

qnty - количенство в тысячных долях от единиц СИ (1000 = 1 шт.; 21458 = 21 кг 458 г)

Returns:

стоимость позиции

round

java.math.BigDecimal round(java.math.BigDecimal value)

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

1. республика Беларусь (местные деньги - до 2016-07-01): валидные значения денег: 0.00, 50.00, 100.00, 200.00 и т.д. - тогда:

   значение	округлится до
   0.1234	0
   12.3456	0
   25.00	0
   75.00	100.00
   123.4567	100.00

2. Россия: валидные значения денег: все целые: 0.00, 0.01, 0.02, ...

   значение	округлится до
   0.009	0.01
   0.018	0.02
   1.2345	1.23

Parameters:

value - количество денег, чей результат округления надо вернуть

Returns:

округленное значение аргумента

convertCurrency

java.lang.Long convertCurrency(java.math.BigDecimal value)

Преобразует денежную величину "в рублях" в денежную величину, выраженную в минимальных денежных единицах. В случае рубля это копейки, 1 рубль = 100 копеек.

Parameters:

value - денежная велечина в рублях.

Returns:

денежная величина в тысячных единицах или null, если переданное значение null.

Since:

0.0.37

See Also:

convertCurrency(Long)

convertCurrency

java.math.BigDecimal convertCurrency(java.lang.Long value)

Преобразует денежную величину из копеек в рубли.

Parameters:

value - денежная величина в копейках

Returns:

денежная величина в рублях или null, если переданный аргумент null.

Since:

0.0.37

See Also:

convertCurrency(BigDecimal)

convertQuantity

java.lang.Long convertQuantity(java.math.BigDecimal quantity)

Преобразует весовую величину из килограммов в граммы.

Parameters:

quantity - величина в килограммах

Returns:

величина в граммах или null, если переданный аргумент null

Since:

0.0.37

See Also:

convertQuantity(Long)

convertQuantity

java.math.BigDecimal convertQuantity(java.lang.Long quantity)

Преобразует весовую велиичну из граммов в килограммы.

Parameters:

quantity - величина в граммах

Returns:

величина в килограммах или null, если переданный аргумент null

Since:

0.0.37

See Also:

convertQuantity(BigDecimal)

calculateNdsSum

default java.lang.Long calculateNdsSum(java.lang.Long sum,
                                       java.lang.Float nds)

Вычисление суммы НДС

Parameters:

sum - сумма в копейках

nds - ставка НДС

Returns:

расчитанное значение НДС

Since:

0.0.73

getCurrencyCode

default java.lang.String getCurrencyCode()

Returns:

код валюты

Since:

0.0.95