Facturación

Las facturas pasan por ai-core, nunca por los exports o eventos propios de un script de facturación. ai-core envía cada factura al script de facturación activo: el que elige el ajuste Billing script (script de facturación) del panel, o el primero que esté en marcha. Si no hay ninguno, la recogen las facturas propias de ai-core: el jugador ve en pantalla una lista de facturas abiertas y el dinero se mueve cuando paga. Una factura nunca se pierde.

Una factura viene de un trabajo (la cuenta bank del trabajo recibe el pago: multas de la policía, la tarifa de un mecánico) o de un jugador (ese jugador recibe el pago).

Las facturas propias de ai-core en resumen: las facturas abiertas se guardan por personaje (también de personajes desconectados), como mucho 20 facturas abiertas por personaje, y pagar retira el dinero de bank y luego de cash, en una sola transacción junto con la eliminación de la factura.

GetBillingSystemCopy Anchor Link

Adónde van las facturas.

Lado: Servidor · Espera: no · Lib: billing.provider()

GetBillingSystem(): string | null

local system = exports['ai-core']:GetBillingSystem() -- 'ai-core' o el nombre de un script

ParámetrosCopy Anchor Link

Ninguno.

DevuelveCopy Anchor Link

string | null: el nombre de recurso del script de facturación, o "ai-core" para las facturas propias de ai-core. Como las facturas propias de ai-core siempre están disponibles, en la práctica no es null.

EjemploCopy Anchor Link

import { resourceExport } from "@aicore-fivem/lib/server";

const core = resourceExport("ai-core");

/** Bills to offline characters only work with ai-core's own bills. */
export function canBillOffline(): boolean {
  return core.GetBillingSystem() === "ai-core";
}

SendBillCopy Anchor Link

Envía una factura a un jugador.

Lado: Servidor · Espera: no · Lib: billing.send

SendBill(bill: BillRequest): boolean

local sent = exports['ai-core']:SendBill({ to = target, amount = 250, label = 'Speeding', from = source, job = 'police' })

ParámetrosCopy Anchor Link

BillRequestCopy Anchor Link

Consulta BillRequest.

DevuelveCopy Anchor Link

boolean: true cuando se envió la factura. false cuando:

• la factura no es válida: ambos o ninguno de to / toCitizenid, sin label, amount no es un número entero de 1 a 10,000,000, ni job ni from, o from es igual al destinatario;
• se da from pero no tiene un personaje cargado, o job no existe;
• el destinatario está desconectado y las facturas van a un script de facturación (solo las facturas propias de ai-core llegan a personajes desconectados);
• el script de facturación la rechazó, o el destinatario ya tiene 20 facturas abiertas con las facturas propias de ai-core.

Una factura a un personaje desconectado con las facturas propias de ai-core responde true en cuanto es válida; la base de datos aún puede rechazarla (citizen id desconocido, 20 facturas abiertas), y eso queda en el log.

EjemploCopy Anchor Link

import { onClientCallback, coordsOf, isNear, resourceExport } from "@aicore-fivem/lib/server";
import { fail, readId, readInt } from "@aicore-fivem/lib/shared";
import { Locale } from "common";

const core = resourceExport("ai-core");

// Un agente multa al jugador que tiene delante; la cuenta de la policía recibe el dinero.
onClientCallback(
  "myscript:fine",
  {
    args: ([target, amount]) => {
      const t = readId(target);
      const a = readInt(amount, 1, 50_000);
      return t === null || a === null ? null : [t, a];
    },
  },
  (source, target, amount) => {
    if (core.GetDutyJob(source) !== "police") return fail("NOT_POLICE");
    if (!isNear(target, coordsOf(source), 3)) return fail("TOO_FAR");
    const sent = core.SendBill({ to: target, amount, label: Locale("BILL_FINE"), from: source, job: "police" });
    return sent ? { ok: true } : fail("BILL_FAILED");
  },
);

GetUnpaidBillsCopy Anchor Link

Las facturas abiertas (sin pagar) de un jugador.

Lado: Servidor · Espera: no (responde mediante done) · Lib: billing.unpaid(source) devuelve una Promise

GetUnpaidBills(source: number, done: (bills: UnpaidBill[] | null) => void): void

exports['ai-core']:GetUnpaidBills(source, function(bills) end) -- lista o nil

ParámetrosCopy Anchor Link

DevuelveCopy Anchor Link

Nada. done recibe una entrada por factura abierta con id (el id del script de facturación), label, amount (lo que aún se debe) y sender (etiqueta del trabajo o nombre del jugador) (UnpaidBill), o null cuando el jugador no tiene un personaje cargado o el script de facturación no puede listar facturas. Sin una función como done la llamada no hace nada.

EjemploCopy Anchor Link

import { onClientCallback, resourceExport } from "@aicore-fivem/lib/server";
import { fail } from "@aicore-fivem/lib/shared";
import type { UnpaidBill } from "@aicore-fivem/shared";

const core = resourceExport("ai-core");

// Un mostrador del ayuntamiento muestra lo que debe el jugador.
onClientCallback("myscript:myBills", async (source) => {
  const bills = await new Promise<UnpaidBill[] | null>((resolve) => core.GetUnpaidBills(source, resolve));
  if (!bills) return fail("BILLS_UNAVAILABLE");
  return { ok: true, bills, total: bills.reduce((sum, b) => sum + b.amount, 0) };
});

PayBillCopy Anchor Link

El jugador paga una de sus facturas abiertas.

Lado: Servidor · Espera: no · Lib: billing.pay

PayBill(source: number, id: string): boolean

local paid = exports['ai-core']:PayBill(source, billId)

ParámetrosCopy Anchor Link

DevuelveCopy Anchor Link

boolean: true cuando se pagó la factura. false cuando el jugador no tiene un personaje cargado, la factura no es suya o ya no existe, no puede pagarla, el script de facturación la rechazó o solo acepta pagos en su propia pantalla. Con las facturas propias de ai-core, una factura personal también necesita que el emisor esté conectado (el dinero va a su banco).

EjemploCopy Anchor Link

import { onClientCallback, resourceExport } from "@aicore-fivem/lib/server";
import { fail, readText } from "@aicore-fivem/lib/shared";

const core = resourceExport("ai-core");

onClientCallback(
  "myscript:payBill",
  { args: ([id]) => { const v = readText(id, 64); return v ? [v] : null; }, lock: true },
  (source, id) => (core.PayBill(source, id) ? { ok: true } : fail("BILL_NOT_PAID")),
);