Deposit and Fee Rule

A Deposit and Fee Rule defines how a refundable deposit or fee is applied to specific items. It specifies the amount to be added to a receipt when an item is sold.

For example, a bottle of water may have a deposit for the bottle, which is refunded when returned. Eco taxes or other fees can also be managed this way.

Hii Retail uses a dedicated Deposit and Fee Rule entity, rather than the GS1 price entity, for clarity and precision.

Deposit and Fee Rules are designed to be simple and few in nature. Rules should be assigned to a fiscal-jurisdiction type Business Unit Group, as deposit and fee amounts are typically uniform across all stores within a fiscal jurisdiction. Rules defined at a more specific Business Unit Group level act as overrides, but such overrides should not be required in most cases and should be avoided when possible.

Rules are referenced by their depositAndFeeRuleIds on the Item entity.

Example:
A $0.10 refundable deposit rule (type: REFUNDABLE_DEPOSIT, id: us-010) is referenced by all US items requiring this deposit.
A €0.50 rule is referenced for EU items.
An Eco Tax fee uses type: FEE and is referenced by all applicable items.

Types

Type	Description
REFUNDABLE_DEPOSIT	Used for refundable deposits (e.g., bottles, electronics, packaging).
FEE	Used for non-refundable fees (e.g., Eco Tax on tires).

Statuses

Status manages the lifecycle of a Deposit and Fee Rule.

Status	Description
ACTIVE	The rule is active and available for use.
DELETED	The rule is deleted and should not be used, except for reporting or possible reactivation.