Execute_AddCurrencyToHouseholdBiz

Description

Adds currency to the HouseholdBiz owner when the BaseObject entity makes a purchase at a business site. The transferred amount is multiplied by the business level's IncomeMultiplier and the active price policy. If no HouseholdBiz is found at the entity's location, only the original amount is deducted from the customer. Negative F1 values deduct currency from the customer without transferring income to the business owner.

Note

Final amount transferred = OriginalAmount * LevelMultiplier * PricePolicyMultiplier. Price policy multipliers: VeryLow (0.5x), Low (0.75x), Normal (1.0x), High (1.5x), VeryHigh (2.0x). The currency widget effect is shown on the BaseObject entity.

Parameters

Parameter	Description
BaseObject	The customer or employee entity making the purchase (Self or Target).
S1	Currency ID to transfer (e.g., Mew).
S2	Ledger category for settlement (e.g., ProductSale, ServiceSale, EntranceFee).
F1	Original transaction amount. Positive = income to biz; Negative = deduction from customer only.

Examples

Description	BaseObject	Command
Customer pays for a product at a HouseholdBiz	Self	AddCurrencyToHouseholdBiz
Customer pays for a service at a HouseholdBiz	Target	AddCurrencyToHouseholdBiz
Deduct cost from customer without income to biz owner	Self	AddCurrencyToHouseholdBiz