Developers

-- after your own code has decided the player may use the shop
if not exports.lation_shops:openShop(source, '24_7_store') then
    print(('%s could not open the 24/7 Store'):format(GetPlayerName(source)))
end

{
    id = '24_7_store',
    title = '24/7 Store',                  -- the name players see
    subtitle = 'Your neighborhood convenience store',
    currency = '$',
    currencySuffix = false,                -- true shows 100$ instead of $100
    shopMode = 'buy',                      -- 'buy', 'sell' or 'both'
    balance = 18450,
    ownerIdentifier = 'ABC12345',          -- nil while the server runs it
    ownerName = 'John Doe',
    forSale = false,
    salePrice = 125000,
    purchaseAmount = 125000,               -- what this owner paid; 0 when it was given
    catalogIds = { 'general' },            -- in merge order
    catalogStocking = false,               -- Stock from catalogs
    locations = {},                        -- { type = 'coords' | 'ped' | 'model', coords, model?, scenario?, models?, label?, showBlip?, delivery? }
    blip = nil,                            -- { label, sprite, color, scale }, or nil
    categories = {},                       -- { id, label, icon?, iconColor? }
    paymentMethods = {},                   -- { id, label, icon?, type = 'player' | 'society' | 'custom', minGrade? }
    revenueShares = {},                    -- { id, job, jobLabel, percentage }
    jobRestriction = nil,                  -- { jobs = { { job, minGrade } } }, or nil
    operatingHours = nil,                  -- { enabled, openTime, closeTime }, or nil
    itemRequirement = nil,                 -- { item, removeOnOpen } for one item, { items = { { item, removeOnOpen } }, requireAll } for several, or nil
    randomPrices = nil,                    -- { enabled, percentage, interval }, or nil
    sellPricePercentage = nil,             -- the shop's Default Sell Price (%)
    sellPaymentSource = nil,               -- { type = 'server' | 'society' | 'shop_balance', account?, delivery = 'cash' | 'bank' | 'custom', deliveryItem? }
    activeSale = nil,                      -- the running sale (below), or nil
    allowStockDeposit = true,
    allowStockWithdraw = false,
    managementLocation = nil,              -- { x, y, z }, or nil
    deliveryLocation = nil,                -- { x, y, z, w }, or nil
    inventory = {},                        -- the listings (below)
}

{
    listingId = 42,
    item = 'water_bottle',
    label = 'Water Bottle',
    description = nil,
    category = 'drinks',
    icon = 'nui://ox_inventory/web/images/water_bottle.png',
    price = 11,                -- what it sells for now, after random prices, before a sale
    basePrice = 10,            -- the price set by the admin or the owner
    stock = 30,                -- nil is unlimited
    maxStock = 50,             -- nil for unlimited and player-driven stock
    playerStocked = false,     -- player-driven stock
    license = nil,
    jobRestriction = nil,
    metadata = nil,
    buyEnabled = true,         -- false: Sell only, never on a Buy tab
    sellEnabled = true,        -- false: Buy only, never on a Sell tab
    sellPrice = nil,           -- nil uses the shop's percentage
    sellHidden = false,
    autoRestockThreshold = nil,
    autoRestockQuantity = nil,
    catalogId = nil,           -- set on listings made by Stock from catalogs
}

{
    label = 'Grand Opening',
    discountPct = 30,
    listingIds = { 42, 43 },   -- nil for the whole shop
    jobs = nil,                -- { 'police', ... } when limited to jobs
    startsAt = 1730000000,     -- unix seconds
    endsAt = 1730172800,
    createdBy = 'ABC12345',
}

local shop = exports.lation_shops:GetShop('24_7_store')
if shop and shop.ownerIdentifier then
    print(('%s is owned by %s and holds %d'):format(shop.title, shop.ownerName, shop.balance))
end

local owner = exports.lation_shops:GetShopOwner('24_7_store')
if owner and owner.identifier then
    print(('24/7 is owned by %s'):format(owner.name))
elseif owner and owner.forSale then
    print(('24/7 is for sale at %d'):format(owner.salePrice))
end

{
    identifier = 'XYZ98765',
    name = 'Maria Lopez',
    role = 'Manager',
    permissions = { manage_inventory = true, place_orders = true, --[[ every permission key ]] },
    commission = { default = 5, rules = { { type = 'item', key = 'burger', pct = 10 } }, mode = 'online' }, -- nil when none
    earnings = 412,            -- unclaimed
    hiredBy = 'ABC12345',
}

{
    today = 1240,              -- revenue since midnight
    week = 8630,               -- revenue over the last 7 days
    weekSellPayouts = 410,     -- paid to customers for sell-backs
    topSellers = {},           -- up to 6: { item_name, totalQuantity, totalAmount }
    dailyRevenue = {},         -- 7 days, oldest first: { day = '2026-11-01', total }
    dailySellPayouts = {},     -- the same, for sell-backs
    dailyBalance = {},         -- the balance at the end of each day: { day, total }
}

local employees = exports.lation_shops:GetConfig('employees')
print(employees['ownership.maxEmployees']) -- 10

function OnDeliveryRequested(shopId, orderId, order, dropoff, pickup)
    -- start your own delivery job with the order, its drop-off and pickup
    exports.my_delivery:CreateJob({ id = orderId, shop = shopId, dropoff = dropoff, pickup = pickup })
end

function OnDeliveryCancelled(shopId, orderId)
    -- the order was cancelled in the shop: drop your job
    exports.my_delivery:RemoveJob(orderId)
end

-- when the driver arrives
exports.lation_shops:CompleteStockOrder(orderId)

-- if your system gives up on the job
exports.lation_shops:CancelStockOrder(orderId)

RegisterCommand('phoneshop', function()
    exports.lation_shops:openShop('phone_store') -- a shop with no locations
end)

AddEventHandler('lation_shops:purchase', function(data)
    print(('%s spent %d at %s'):format(data.name, data.total, data.shopId))
end)

AddEventHandler('lation_shops:sale', function(data)
    if data.shopId == 'pawn_shop' and data.total > 5000 then
        TriggerEvent('police:alert', ('Large sale at the pawn shop by %s'):format(data.name))
    end
end)

AddEventHandler('lation_shops:ownerChanged', function(data)
    if data.reason == 'purchase' then
        print(('%s bought %s'):format(data.ownerName, data.shopId))
    end
end)

AddEventHandler('lation_shops:employeeChanged', function(data)
    if data.action == 'hired' then
        print(('%s now works at %s'):format(data.name, data.shopId))
    end
end)

AddEventHandler('lation_shops:balanceChanged', function(data)
    if data.delta and data.delta < -10000 then
        print(('%s lost %d (%s)'):format(data.shopId, -data.delta, data.reason or '?'))
    end
end)

AddEventHandler('lation_shops:orderPlaced', function(data)
    print(('order #%d for %s: %d'):format(data.orderId, data.shopId, data.totalCost))
end)

AddEventHandler('lation_shops:orderPosted', function(data)
    print(('order #%d is on the %s board'):format(data.orderId, data.system))
end)

AddEventHandler('lation_shops:orderClaimed', function(data)
    print(('order #%d for %s is in transit'):format(data.orderId, data.shopId))
end)

AddEventHandler('lation_shops:orderCancelled', function(data)
    print(('order #%d cancelled, %d refunded'):format(data.orderId, data.refund))
end)

AddEventHandler('lation_shops:orderDelivered', function(data)
    print(('order #%d arrived at %s'):format(data.orderId, data.shopId))
end)

AddEventHandler('lation_shops:shopUpdated', function(data)
    if data.created then
        print(('new shop %s'):format(data.shopId))
    end
end)

AddEventHandler('lation_shops:shopDeleted', function(data)
    print(('shop %s deleted'):format(data.shopId))
end)

AddEventHandler('lation_shops:configUpdated', function(section)
    if section == nil or section == 'employees' then
        local employees = exports.lation_shops:GetConfig('employees')
        print(('staff cap is now %d'):format(employees['ownership.maxEmployees']))
    end
end)

-- A gang-only shop (Qbox)
function OnBeforeShopOpen(source, shopId, shop)
    if shopId == 'ballas_stash' then
        local player = exports.qbx_core:GetPlayer(source)
        local gang = player and player.PlayerData.gang
        if not gang or gang.name ~= 'ballas' then
            return false, 'Members only'
        end
    end
    return true
end

function OnBeforeItemPurchase(source, shopId, item, quantity, price, metadata, listingId, category)
    if item == 'advanced_rifle' and exports.xp_system:GetLevel(source) < 10 then
        return false, 'You need level 10'
    end
    return true
end

-- An ID card carries the buyer's details (Qbox)
function OnPurchaseItemMetadata(source, shopId, item, quantity, price, metadata, listingId)
    if item == 'id_card' then
        return exports.qbx_idcard:GetMetaLicense(source, 'id_card')
    end
    return nil
end

function OnBeforeItemSell(source, shopId, item, quantity, sellPrice, listingId)
    if exports.my_evidence:IsStolen(source, item) then
        return false, 'This shop won\'t take that'
    end
    return true
end

{
    id = 501,                          -- the order id
    source = 'lation_shops',
    pickup = { x, y, z, w },           -- nil: the trucking resource's depot
    dropoff = { x, y, z, w },
    reward = 1000,
    company = '24/7 Store',
    cargo = 'Shop stock',
    metadata = { shopId = '24_7_store', items = { { name = 'burger', amount = 50 } } },
    trailerModel = nil,                -- optional
}

function OnDeliveryJob(shopId, orderId, job)
    job.trailerModel = 'trailers2'
    job.reward = job.reward + 250
    return job
end