Inicio › Documentación › Exports · origen_billing

Exports · origen_billing

Todos los exports se registran bajo el nombre de recurso origen_billing.

Exports del servidor

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

Crea una factura individual desde otro recurso.

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

Crea una factura con un carrito de líneas individuales. El total se calcula automáticamente.

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

Crea la misma factura para varios destinatarios a la vez.

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

GetJobStatistics(jobName) → table

Devuelve las estadísticas de facturación de un job.

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

GetPlayerTotalDebt(target) → number

Devuelve el importe total de facturas pendientes de un jugador. Devuelve 0 si el jugador no tiene facturas pendientes o no se puede resolver.

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

GetPlayerPendingInvoices(target) → table

Devuelve la lista de facturas pendientes de un jugador.

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

Devuelve true si el jugador indicado está trabajando actualmente en el job especificado y ese job está autorizado para emitir facturas.

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

Exports de integración con policía

Estos exports están pensados para origen_police (o cualquier recurso de policía) y siguen el modelo de facturación policial.

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

Crea una factura policial. El campo contextData es una cadena codificada en JSON con metadatos específicos de policía (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

Actualiza el importe y los metadatos de una factura policial pendiente.

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

CancelPoliceInvoice(invoiceId) → boolean

Cancela una factura policial pendiente. El recurso que lo llama debe comprobar los permisos antes de invocar este export.

exports['origen_billing']:CancelPoliceInvoice(invoiceId)

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

Paga una factura policial. Delega en InvoiceManager, que se encarga de descontar el dinero y del ingreso a la sociedad.

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

GetPoliceBillsByIdentifier(identifier, jobCategory?) → boolean, table

Devuelve el historial completo de facturas de un ciudadano (todos los estados). Se usa en los perfiles de ciudadano de la tablet de policía.

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

GetPolicePendingByIdentifier(identifier) → boolean, table

Devuelve solo las facturas policiales pendientes de un ciudadano. Lo usan los NPC de pago.

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

GetPoliceInvoicesByReportId(reportid) → boolean, table

Devuelve todas las facturas policiales vinculadas a un ID de informe concreto.

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

GetPoliceDebtorsByCategory(jobCategory) → boolean, table

Devuelve una lista de deudores con facturas policiales pendientes, agrupados por citizenid con su deuda total.

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