Finance & Billing Ops

Invoicing, collections, revenue recognition, accounting sync, and month-end close in Alguna

This quick start is for finance and billing operations teams: the people who approve invoices, chase cash, close the month, and answer the auditor. It maps each of those jobs to the part of Alguna that does it — dashboard and API — so you know where to look and what is automatic. Everything here runs on the objects described in How Alguna Works: the subscription that produced an invoice is the same one that produces its revenue schedule.

---

What finance cares about

Priority	Where it is handled
Accurate invoicing	Invoice approval, line-item review, credit notes
Fast collections	AutoPay, reminders, dunning, A/R ageing
Revenue recognition	Revenue schedules per subscription, customer, entity, organization
Accounting sync	QuickBooks, Xero, NetSuite integrations
Audit trail	Immutable issued invoices; statuses, credit notes, and refunds as separate records

---

1. Invoice management

Open Invoices. Statuses are defined in Invoicing Configuration.

Task	How
Review invoices before they go out	Turn off automatic approval; closed-period invoices stop at pending_approval. Approve singly or in bulk.
Edit a draft	Add, edit, or delete line items; see Recurring Invoices
Send an invoice	Issuance emails the customer and the hosted page; download the PDF from the invoice or GET /invoices/{id}/pdf
Record an offline payment	Mark as paid, or POST /invoices/{id}/mark-as-paid — see Invoicing Customers
Correct an issued invoice	Create a credit note; voiding is for withdrawing the whole invoice
Bill a parent for its subsidiaries	Roll-up billing

API: GET /invoices?status=pending_approval is your review queue.

---

2. Collections

State	What Alguna does	What you do
Due soon	The Invoices Due Reminders automation emails ahead of the due date	Nothing, once enabled
Payment failed	Emits payment_failed; the Failed Payment Notification automation asks for a new payment method	Add retry steps — see Dunning
Overdue	Moves the invoice to overdue and runs Overdue Invoice Reminder (day 3 and day 6)	Extend the cadence, or enable Agentic Collections
Disputed	A dispute on the payment is recorded on the invoice timeline	Resolve with the customer; credit note or refund if warranted

Cadences are automations configured on the Automations page, not through the API. See Collections.

A/R ageing

Invoices → A/R Aging, or GET /insights/ar-aging:

Bucket	Action
current	Monitor
days_1_to_30	Reminder cadence is running
days_31_to_60	Personal outreach
days_61_to_90	Escalate
days_90_plus	Consider write-off

cURL

curl https://api.alguna.io/insights/ar-aging/by-customer \
  -H "Authorization: Bearer $ALGUNA_API_KEY" \
  -H "Alguna-Version: 2026-04-01"

---

3. Revenue recognition

Revenue schedules are produced from subscriptions and invoices; nothing is re-keyed. The allocation method is per product — straight_line, usage_based, or contract_level_straight_line. See Revenue Recognition.

Need	Endpoint
Deferred and recognised revenue for the organization	GET /revenue-schedules?currency=USD&interval=monthly
Same for a legal entity, customer, or subscription	GET /revenue-schedules/legal-entity/{id}, /customer/{id}, /subscription/{id}
MRR, ARR, ACV for a subscription	GET /subscriptions/{id}/revenue
Net revenue and movement	GET /insights/revenue, GET /insights/revenue/breakdown-over-time

Each schedule entry reports new_ and total_ figures for deferred_revenue, recognized_revenue (fixed + metered), one_off_revenue, and contract_asset (delivered but unbilled).

---

4. Accounting sync

Connect QuickBooks, Xero, or NetSuite under Integrations. Invoices, payments, credit notes, and customers sync to the ledger, and journal entries implied by the revenue schedule are posted. See QuickBooks, Xero, and NetSuite.

For tax collected, see Tax; for reporting across currencies, Multi-Currency.

---

Month-end checklist

1. Confirm usage is in

   All usage events for the period should be ingested before periods close; late events land in the next period.

2. Approve invoices

   Clear GET /invoices?status=pending_approval. Anomalies are cheaper to fix as credit notes now than as disputes later.

3. Record offline payments

   Mark wires and cheques paid so A/R and revenue reflect them.

4. Pull the revenue schedule

   GET /revenue-schedules for the month; tie total_deferred_revenue to the deferred revenue account.

5. Reconcile

   Match GET /payments and GET /refunds for the period to the bank; export from Payments if you prefer a file. See Data Exports.

6. Confirm the sync

   Check the accounting integration’s sync status for anything that failed to post.

---

Key features

Invoicing Configuration

Statuses, approval, numbering, and defaults.

Revenue Recognition

Schedules, methods, and the API.

Collections

Overdue handling and A/R ageing.

Data Exports

Files and list endpoints for reconciliation.

API reference

Invoices

List, get, mark as paid, void, PDF.

Credit Notes

Create, credit an invoice, apply.

Revenue Schedules

Deferred and recognised revenue over time.

Insights

A/R ageing, revenue, billings, customers.

Related quick starts

Sales & RevOps

Quoting and deal management.

Fintech & Payments

Transaction-based billing.

Developers

API integration.

← Back to Quick Starts

See all quick start guides