Accueil › Documentation › Exports · origen_billing

Exports · origen_billing

Tous les exports sont enregistrés sous le nom de ressource origen_billing.

Exports serveur

CreateInvoice(target, amount, description, jobName, author, notes?, company?) → boolean, string|number

Crée une facture individuelle depuis une autre ressource.

local ok, result = exports['origen_billing']:CreateInvoice(
    'ABC12345',   -- target citizenid (or server source as number)
    500,          -- amount
    'Medical fee',
    'ambulance',
    'XYZ99999',   -- author citizenid
    'Notes here', -- optional
    nil           -- optional company label override
)
-- ok = true, result = invoiceId (number)
-- ok = false, result = reason (string)

CreateInvoiceWithItems(target, jobName, author, items, notes?, company?) → boolean, string|number

Crée une facture avec un panier de lignes individuelles. Le total est calculé automatiquement.

local ok, result = exports['origen_billing']:CreateInvoiceWithItems(
    'ABC12345',
    'mechanic',
    'XYZ99999',
    {
        { name = 'Oil change', price = 150, quantity = 1 },
        { name = 'Tire rotation', price = 80, quantity = 4, product_id = 12 },
    },
    nil, -- notes
    nil  -- company override
)

CreateBulkInvoice(targets, amount, description, jobName, author, notes?, company?) → table

Crée la même facture pour plusieurs destinataires à la fois.

local result = exports['origen_billing']:CreateBulkInvoice(
    { 'ABC12345', 'DEF67890' },
    200,
    'Event fee',
    'police',
    'XYZ99999'
)
-- result = { total, successful, failed, details = { { target, success, result }, ... } }

GetJobStatistics(jobName) → table

Renvoie les statistiques de facturation d’un métier.

local res = exports['origen_billing']:GetJobStatistics('police')
-- res = { success = true, data = { total, pending, paid, cancelled, totalRevenue, totalCommissions, averageAmount } }

GetPlayerTotalDebt(target) → number

Renvoie le montant total des factures en attente d’un joueur. Renvoie 0 si le joueur n’a aucune facture en attente ou s’il ne peut pas être résolu.

local debt = exports['origen_billing']:GetPlayerTotalDebt('ABC12345')
-- or by server source:
local debt = exports['origen_billing']:GetPlayerTotalDebt(source)

GetPlayerPendingInvoices(target) → table

Renvoie la liste des factures en attente d’un joueur.

local invoices = exports['origen_billing']:GetPlayerPendingInvoices('ABC12345')
-- Array of { id, job_name, company_label, amount, description, notes, context_data, status, created_at }

CanInvoice(source, jobName) → boolean

Renvoie true si le joueur indiqué exerce actuellement le métier spécifié et que ce métier est autorisé à émettre des factures.

local allowed = exports['origen_billing']:CanInvoice(source, 'ambulance')

Exports d’intégration avec la police

Ces exports sont destinés à origen_police (ou à toute ressource de police) et suivent le modèle de facturation policière.

CreatePoliceInvoice(targetIdentifier, amount, description, jobName, author, contextData) → boolean, string|number

Crée une facture de police. Le champ contextData est une chaîne encodée en JSON contenant des métadonnées propres à la police (reportid, months, concepts, title, etc.).

local ok, result = exports['origen_billing']:CreatePoliceInvoice(
    'ABC12345',
    1500,
    'Traffic violation | Speeding',
    'police',
    'Officer Smith',
    json.encode({
        title    = 'Traffic Fines',
        reportid = 42,
        months   = 0,
        concepts = {
            { name = 'Speeding', price = 1000 },
            { name = 'No license', price = 500 },
        },
    })
)

UpdatePoliceInvoice(invoiceId, data) → boolean

Met à jour le montant et les métadonnées d’une facture de police en attente.

exports['origen_billing']:UpdatePoliceInvoice(invoiceId, {
    price        = 2000,
    description  = 'Updated charges',
    context_data = json.encode({ ... }),
})

CancelPoliceInvoice(invoiceId) → boolean

Annule une facture de police en attente. La ressource appelante doit vérifier les permissions avant d’invoquer cet export.

exports['origen_billing']:CancelPoliceInvoice(invoiceId)

PayPoliceInvoice(source, invoiceId, paymentMethod) → boolean, string

Paie une facture de police. Délègue à InvoiceManager, qui gère le prélèvement de l’argent et le dépôt à la société.

local ok, reason = exports['origen_billing']:PayPoliceInvoice(source, invoiceId, 'bank')

GetPoliceBillsByIdentifier(identifier, jobCategory?) → boolean, table

Renvoie l’historique complet des factures d’un citoyen (tous les statuts). Utilisé dans les profils de citoyen de la tablette de police.

local ok, bills = exports['origen_billing']:GetPoliceBillsByIdentifier('ABC12345', 'police')

GetPolicePendingByIdentifier(identifier) → boolean, table

Renvoie uniquement les factures de police en attente d’un citoyen. Utilisé par les PNJ de paiement.

local ok, bills = exports['origen_billing']:GetPolicePendingByIdentifier('ABC12345')

GetPoliceInvoicesByReportId(reportid) → boolean, table

Renvoie toutes les factures de police liées à un ID de rapport précis.

local ok, bills = exports['origen_billing']:GetPoliceInvoicesByReportId(42)

GetPoliceDebtorsByCategory(jobCategory) → boolean, table

Renvoie une liste de débiteurs ayant des factures de police en attente, regroupés par citizenid avec leur dette totale.

local ok, debtors = exports['origen_billing']:GetPoliceDebtorsByCategory('police')
-- debtors = { { citizenid, totalprice }, ... }