Finance & Billing Ops

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 https://api.alguna.io/insights/ar-aging/by-customer \
  -H "Authorization: Bearer $ALGUNA_API_KEY" \
  -H "Alguna-Version: 2026-04-01"

import os

import requests

response = requests.get(
    "https://api.alguna.io/insights/ar-aging/by-customer",
    headers={
        "Authorization": f"Bearer {os.environ['ALGUNA_API_KEY']}",
        "Alguna-Version": "2026-04-01",
    },
    timeout=10,
)
response.raise_for_status()

for row in sorted(response.json()["data"], key=lambda r: float(r["buckets"]["days_90_plus"]), reverse=True):
    print(row["customer_name"], row["currency"], row["buckets"]["days_90_plus"], row.get("avg_days_overdue"))

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

Confirm usage is in

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

Approve invoices

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

Record offline payments

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

Pull the revenue schedule

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

Reconcile

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

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.

Sales & RevOps

Quoting and deal management.

Fintech & Payments

Transaction-based billing.

Developers

API integration.

← Back to Quick Starts

See all quick start guides

Quick Starts

By Industry

By Motion

By Role

Finance & Billing Ops

What finance cares about

1. Invoice management

2. Collections

A/R ageing

3. Revenue recognition

4. Accounting sync

Month-end checklist

Key features

Invoicing Configuration

Revenue Recognition

Collections

Data Exports

API reference

Invoices

Credit Notes

Revenue Schedules

Insights

Sales & RevOps

Fintech & Payments

Developers

← Back to Quick Starts

​What finance cares about

​1. Invoice management

​2. Collections

​A/R ageing

​3. Revenue recognition

​4. Accounting sync

​Month-end checklist

​Key features

Invoicing Configuration

Revenue Recognition

Collections

Data Exports

​API reference

Invoices

Credit Notes

Revenue Schedules

Insights

​Related quick starts

Sales & RevOps

Fintech & Payments

Developers

← Back to Quick Starts

What finance cares about

1. Invoice management

2. Collections

A/R ageing

3. Revenue recognition

4. Accounting sync

Month-end checklist

Key features

API reference

Related quick starts