finov.ioDocumentationHome

Enums

API Documentation / API Conventions

This page lists closed value sets that are part of the v1 contract and cannot be discovered from a lookup endpoint. Values are case-sensitive. Sending another value returns 422 Unprocessable Entity unless the field is documented as free text or extensible.

Common values

Sort order

Value Meaning
asc Sort the selected field in ascending order.
desc Sort the selected field in descending order.

OAuth values

Field Values
response_type code
code_challenge_method S256
grant_type authorization_code, refresh_token
token_type Bearer

Accounting values

New customer credit note form with invoice type contact dates and line fields
Choose Credit Note from the Invoices register to prepare a customer credit.

Contact type

Value Meaning
customer The contact may be used on sales documents.
supplier The contact may be used on purchase documents.
both The contact may be used on sales and purchase documents.

Tax treatment

Value Meaning
INPUT Tax paid or recoverable on purchases.
OUTPUT Tax collected or payable on sales.

Payment-term calculation

Value Meaning
days_after_invoice Add days to the invoice date.
day_of_following_month Use day_of_month in the month after the invoice date.

Bank values

Bank-account source type

Value Meaning
MANUAL Transactions are entered or uploaded in Finovio.
FEED Transactions are supplied by a connected feed provider.
API Transactions are submitted by an authorized application.

Bank transaction type is provider-supplied text and is not an enum. Batch source is lookup-backed internal data and is returned on each batch; public API submissions always return API.

Fixed-asset values

Depreciation method

Value Meaning
straight_line Allocate the depreciable amount evenly over the effective life.
diminishing_value Apply the configured rate to the opening written-down value.

Adjustment type

Value Meaning
cost Adjust the asset's cost basis.
accumulated_depreciation Adjust accumulated depreciation.

Asset event type

Value Meaning
REGISTER The draft asset was registered.
SUSPEND Depreciation was suspended.
RESUME Depreciation resumed.
ADJUST An auditable asset adjustment was posted.
DISPOSE The asset was disposed.
DEPRECIATION_RUN Depreciation was posted by a run.
ROLLBACK A depreciation-run event was reversed.

Report values

Accounting basis

Value Meaning
accrual Recognize activity using posted accrual accounting.
cash Project recognition from posted settlement activity.

Aging basis

Value Meaning
invoice_date Age open documents from their invoice date.
due_date Age open documents from their due date.

Comparison timeframe

Value Meaning
MONTH Calendar-month columns.
QUARTER Calendar-quarter columns.
FINANCIAL_QUARTER Quarters based on the subsidiary's financial year.
YEAR Calendar-year columns.
FINANCIAL_YEAR Columns based on the subsidiary's financial year.
RANGE Repeated columns matching the requested date range.

Statement selector

Value Meaning
profit_and_loss Profit-and-loss statement drill-down.
balance_sheet Balance-sheet statement drill-down.

Lookup-backed values

These values are not hard-coded enums. Retrieve them at runtime and store their stable code or identifier:

Lookup responses may gain values without a major API version. Clients must handle an unknown lookup code without failing the complete response.