Skip to main content

Ledger receipts: Available receipt types and their codes and statuses in Finago Procountor API

Updated over 2 weeks ago

General

All accounting related data in Finago Procountor is available via Procountor API as ledger receipts. Different receipts have their own type. Type is automatically set based on the saved receipt by Procountor.

Receipt types cannot be changed nor set by manual (nor through Procountor API).

When a receipt (eg. invoice or bank statement) is saved, then an accounting page (ledger receipts) is created and typed by Procountor. If the receipt (eg. invoice) is modified, then the accounting page is also updated (ie. created again with new id).

Usage of tracking periods is recommended if the accounting data search is done through API interface. It’s not allowed to do any changes in bookkeeping after the closing of tracking period.

Receipt types

Available receipt types are:

Type code in Procountor API

Type in UI in English

Tositelaji suomeksi

Available statuses

JOURNAL

Journal

Muistio

PURCHASE_INVOICE

Purchase invoice

Ostolasku

SALES_INVOICE

Sales invoice

Myyntilasku

PERIODIC_TAX_RETURN

Tax return for self-assessed taxes

Oma-aloitteisten verojen veroilmoitus

N/A

TRAVEL_INVOICE

Travel invoice

Matkalasku

BILL_OF_CHARGES

Expense claim

Kululasku

SALARY

Salary

Palkka

VAT_SUMMARY

VAT summary

Alv-laskelma

N/A

TRACKING_PERIOD_OPENING_RECEIPT

Receipt for opening tracking period

Seurantajakson avaustosite

N/A

BANK_STATEMENT_AS_RECEIPT

Bank statement as a receipt

Tiliote tositteena

N/A

RECEIPT_FOR_OPENING_ACCOUNTS

Receipt for opening the accounts

Tilinavaustosite

N/A

REFERENCE_PAYMENT

Reference payment

Viitemaksu

N/A

EMPLOYER_CONTRIBUTION

not in use since 2010

'Vanha TAS-ilmoituksen tosite'

VAT_FORM

not in use since 2010

Arvonlisäveroilmoitus

PURCHASE_ORDER *)

unofficial business transaction

Ostotilaus

SALES_ORDER *)

unofficial business transaction

Myyntitilaus

*) orders are NOT official business transactions, they should be excluded from official figures.

Statuses of the ledger receipts

Almost each receipt has its status. The status of receipt determines whether the receipt is an official business transaction or not. Statuses 'Unfinished', 'Received', 'Verified' and 'Invalidated' are NOT official business transactions.

Further information about the statuses of each receipt type – see table above.

Updated and/or deleted ledger receipts

Each ledger receipt has its unique receipt ID (in the database). Ledger receipts can be created again if some changes is done for the receipt itself. The current ledger receipt is deleted and a new one with new id is created. The new ledger receipt replaces the old one.

If the receipt (eg. invoice) is invalidated in user interface, then the accounting page (=ledger receipt) of the receipt is deleted from the database. Invalidated receipt cannot be activated anymore – it has been permanently removed.

Version stamp can used to identify, if any changes has been done since previous search. Please note, that some dimension changes (if done via Dimensions view or Group dimensioning) won’t be recognized. Dimension changes should be done on the Accounting page of the receipt.

Receipts for opening the accounts

Opening receipts are generated automatically when periods are closed. The business transactions of the previous period will be taken into account when generating opening receipts.

There are two types of opening receipts; RECEIPT_FOR_OPENING_ACCOUNTS for opening fiscal year and TRACKING_PERIOD_OPENING_RECEIPT for opening tracking period (a calendar month).

If periods are opened and closed again and again, then new opening receipts are generated again automatically. Opening receipts do not have status. The newest one is the valid one and replaces the previous one; the higher the id number, the newer the receipt.

The accounting pages of opening receipts can be accessed only through general journals or general ledgers created in detailed form in user interface. The accounting rows cannot be edited on these pages, but they can be dimensioned only.

Endpoints to be used and other requirements

GET ​/ledgerreceipts endpoint lists ledger receipts (vouchers) by used filtering. The receiptID in each result entry can be used to fetch complete receipt details with the GET /ledgerereceipts/{receiptId} endpoint.

GET ​/ledgerreceipts​/{id} endpoint returns complete details of the ledger receipt (voucher)

GET /coa endpoint returns the current chart of accounts of the Procountor environment

GET /dimensions endpoint returns available dimensions and their items for mapping

GET /fiscalyears endpoint returns 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.

Did this answer your question?