Forge

Forge Agent API

Finance you can read but not corrupt: AR/AP, GST, stock and integrity checks by API, with exactly one deliberately draft-safe write.

Forge is the suite’s finance foundation: multi-company double-entry books, Singapore-first (GST) with US support. Journal entries form a per-company SHA-256 hash chain — immutability is enforced by database triggers and cryptographically verifiable.

Endpoint and auth

POST https://forge.qweaver.com/api/agent
Authorization: Bearer <your qwa_ key>   # needs the erp grant

A workspace holds many COMPANIES, each with its own chart of accounts, tax codes and base currency — resolve the company first with list_companies, never assume one. Amounts are exact-decimal strings ("1090.00").

Read actions

summary — AR/AP outstanding, bank balance, YTD P&L, top overdue, per company.
list_invoices / ar_aging / ap_aging / list_payments — documents, aging buckets, posted payments.
gst_summary — GST F5 boxes 1-8 computed from posted documents.
stock_levels — weighted-average balances with below-reorder flags.
verify_integrity — recomputes the journal hash chain; run it when anyone asks "can I trust these numbers?".

The one write, and why

prepare_invoice creates a QUOTATION — no journal entry, no GL effect — for a human to review and convert inside the ERP. Posting is final in this ledger, so agents can never post invoices, payments, or journals directly. To fix a posted mistake a human reverses it; there is no edit or delete, by design.

The live manual

curl

curl -s https://forge.qweaver.com/api/agent