onStockWithdrawnFromShop

Purpose

Triggered when items are withdrawn from shop stock to player inventory. Use this hook to track stock removals and monitor potential theft.

When It Triggers

• Employee or owner withdraws items from shop stock to their inventory

• Stock levels are reduced

Parameters

Parameter	Type	Description
data.source	number	Server ID
data.shopId	string	Unique shop identifier
data.shopName	string	Display name of the shop
data.itemName	string	Item spawn name
data.itemLabel	string	Item display name
data.quantity	number	Quantity withdrawn
data.previousStock	number	Stock before withdrawal
data.newStock	number	Stock after withdrawal
data.withdrawnBy	string	Name of person who withdrew
data.withdrawnByIdentifier	string	Identifier of person who withdrew
data.timestamp	number	Server timestamp

Example

exports['sd-shops']:registerServerHook('onStockWithdrawnFromShop', function(data)
    -- Log withdrawal
    print(('[STOCK] %s withdrew %dx %s from %s (Stock: %d -> %d)'):format(
        data.withdrawnBy, data.quantity, data.itemLabel,
        data.shopName, data.previousStock, data.newStock
    ))

    -- Log potential theft/misuse for auditing
    exports['your-logging']:Log('stock-withdrawal', {
        shop = data.shopName,
        item = data.itemLabel,
        quantity = data.quantity,
        previousStock = data.previousStock,
        newStock = data.newStock,
        withdrawnBy = data.withdrawnBy,
        withdrawnById = data.withdrawnByIdentifier
    })

    -- Alert for large withdrawals
    if data.quantity >= 50 then
        exports['your-logging']:Log('large-withdrawal-alert', {
            shop = data.shopName,
            item = data.itemLabel,
            quantity = data.quantity,
            by = data.withdrawnBy
        })
    end
end)