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

General

All accounting related data in 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	Statuses of journal
PURCHASE_INVOICE	Purchase invoice	Ostolasku	Statuses of purchase invoice
SALES_INVOICE	Sales invoice	Myyntilasku	Statuses of sales invoice
PERIODIC_TAX_RETURN	Tax return for self-assessed taxes	Oma-aloitteisten verojen veroilmoitus	N/A
TRAVEL_INVOICE	Travel invoice	Matkalasku	Statuses of travel invoice
BILL_OF_CHARGES	Expense claim	Kululasku	Statuses of expense claim
SALARY	Salary	Palkka	Statuses of salary slip
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.