This page describes how accounting data can be retrieved from the Finago Procountor API into an external system for further processing and reporting.
Through the API interface, it is possible to either retrieve a selection of predefined accounting reports or alternatively fetch accounting data on a receipt-by-receipt basis.
Accounting reports available via the API
The following reports can be retrieved via the Finago Procountor API:
Income statement, cash flow, and balance sheet
POST /reports/accounting
Income Statement (INCOME_STATEMENT)
Cash Flow (CASH_FLOW)
Balance Sheet (BALANCE_SHEET)
General ledger
POST /reports/generalledger/{id}
Ledger accounts
POST /reports/ledgeraccounts
Example of requesting a balance sheet report
Example of requesting a balance sheet report that includes ledger receipts classified as business transactions.
POST /reports/accounting{
"startDate": "2025-11-01",
"endDate": "2025-11-30",
"receiptStatus": [
"PARTLY_PAID",
"PAYMENT_DENIED",
"PAID",
"MARKED_PAID",
"APPROVED",
"PAYMENT_QUEUED",
"PAYMENT_SENT_TO_BANK",
"NOT_SENT",
"SENT"
],
"type": "BALANCE_SHEET",
"options": {
"receiptType": [
"SALES_INVOICE",
"PURCHASE_INVOICE",
"TRAVEL_INVOICE",
"BILL_OF_CHARGES",
"JOURNAL",
"SALARY",
"VAT_FORM",
"EMPLOYER_CONTRIBUTION",
"PERIODIC_TAX_RETURN",
"VAT_SUMMARY",
"SALES_ORDER",
"PURCHASE_ORDER",
"REFERENCE_PAYMENT",
"BANK_STATEMENT_AS_RECEIPT",
"RECEIPT_FOR_OPENING_ACCOUNTS"
],
"reportLanguage": "fi"
}
}Retrieving accounting data by ledger receipts
Use case
A customer has an external reporting system where all accounting data will be exported to. All accounting data can be fetched as ledger receipts via Procountor API. Data is available receipt by receipt so it is required to collect and sum by the other system. Typically, the Business transactions are only included in the month’s official accounting and VAT summary.
Used endpoints
GET / ledgerreceipts endpoint fetches a list of ids of ledger receipts. The content of single ledger receipt is fetched by using on GET / ledgerreceipts{id} endpoint.
If dimensions and items are used, they need to be mapped with the dimensions of the other system, e.g. cost centers. Dimensions are handled as database ids. Use GET /dimensions/{dimensionId} endpoint to fetch dimensions.
The chart of accounts is available via Procountor API
GET /coa
Used VAT status codes are available via Procountor API
GET /vats/default
Statuses of the tracking periods and fiscal years. Modified time stamps show the time of last modification of the fiscal year status or period status.
GET /fiscalyears
Search filters
Accounting data vouchers (ledger receipts) can be filtered by statuses. The Business transactions are only included in the month’s official accounting and VAT summary. Unfinished or invalidated receipts are not official business transactions.
The id of saved ledger receipt is useful to be stored. By using the id of ledger receipt, you can search, update or invalidate it later via API if needed.
Other information
User rights should be sufficient to retrieve all types of ledger receipts, e.g. salary data requires at least viewing rights to Payroll (all salary functions).
