General Information

The basics of using Procountor API

About Procountor API

Procountor API (application programming interface) is an open interface to Finago Procountor, the friendly accounting software. With its diverse support for financial management features, the API can be used for building value creating integrations with both commercial software and internal systems. The API was published in early 2017 and is being enhanced and extended continually. The API mainly adheres to the REST architectural style and uses JSON as data representation format.

This website is intended as a technical reference for software developers building integrations with Finago Procountor API. For information about the software itself, please have a look at Finago.com.

API versioning and release cycle

Procountor API follows a monthly release cycle. Each month a latest version of the API is published. The latest version always contains the newest set of features and endpoints.

Every three months we release a new supported version which contains all the changes from the latest versions from the past three months.

Each supported version is also available as a numbered version. These are numbered following YY.MM convention. Each numbered version will be available for a six month period using the assigned version number (vYYMM). Numbered versions will receive security and bug fixes but do not get any new endpoints or schema changes.

Integration partners may keep themselves up to date on changes by following the release notes or subscribing to Procountor Developers mailing list.

Using the API

To access the Procountor API one first needs to request API client credentials. In addition to credentials you also need to have a valid Procountor environment with API access enabled, and a user account to that environment. You can request client credentials and testing environment here.

Request testing environment

With the client credentials and a user account you can continue to implement API authentication following the instructions outlined here. Authentication follows the OAuth 2.0 standard. After successful authentication process you will receive an access token, which can be used to authorize the API endpoints. Note that some API endpoints require using additional two-factor authentication. You can read more about this here.

See instructions for API authentication
Read about two-factor authentication

After authenticating and receiving an access token you can start making requests to the API endpoints. You can see the complete API reference for descriptions of these endpoints. Before making API requests it is good to read the conventions and practices used throughout our API. We have also prepared a set of examples you can use to familiarize yourself with our API

Read how to make API requests
Check out the example flows
Browse the complete API reference

API servers

The development process for integrations with Procountor API starts on a dedicated server for testing purposes. The testing server contains the same software platform as the production server without the possibility to enact real financial transactions. This makes it possible to move your integration from testing to production by simply changing the server address and access credentials within your application.

All three currently available API versions, latest and two supported versions, can be found from both testing and production servers. The /api and /latest/api paths always point to the latest version while the most recent supported version can be accessed using /supported/api path. Both available supported versions can also be accessed using their version specific /vYYMM/api paths.

To keep track of changes with API endpoints and supported versions please refer to the release notes page. This page also includes information about upcoming features and changes.

Production server

Resource URL
Latest API version (monthly updates) https://api.procountor.com/api
https://api.procountor.com/latest/api
Newest supported API version (quarterly updates) https://api.procountor.com/supported/api
Specific supported API version (available 6 months after release) https://api.procountor.com/vYYMM/api

Testing server

Resource URL
Latest API version (monthly updates) https://api-test.procountor.com/api
https://api-test.procountor.com/latest/api
Newest supported API version (quarterly updates) https://api-test.procountor.com/supported/api
Specific supported API version (availble for 6 months after release) https://api-test.procountor.com/vYYMM/api
Procountor UI https://api-test.procountor.com/procountor/

Testing server UI

All API testing environments can be accessed through the user interface as well. The UI uses the same user credentials than the API.

Please note that the production user accounts are not available on the testing server or vice versa. Feel free to create new user accounts and environments to the testing server. For more infomation about creating new user accounts, have a look at Procountor user manual.

Note that two-factor authentication is not enabled on the testing server. When logging in to the testing server UI the first time, select One-time password list as your login verification method. The one-time password will be automatically filled during subsequent logins.

Differences between testing and production

Although both the testing and production servers contain the same software platform some features are only available in production.
The following features do not work in testing:

  • Changing or resetting passwords without logging in to the Procountor UI
    • Passwords can still be managed using the UI.
  • Bank connections
    • The testing environment does not execute actual financial transactions nor does it receive statements from banks.
  • Two-factor authentication
    • Two-factor authentication is not enabled on the testing server. Any actions requiring two-factor authentication are automatically accepted.
  • Sending mail
    • The testing server does not send out any mail, electronic or otherwise

Other useful information

Procountor user manual

Procountor user manual answers several questions regarding everyday usage of Procountor. The manual is available in English, Finnish, Swedish, Norwegian and Danish on Procountor support site. If the API reference does not provide a satisfying amount of information to your needs, the user manual is worth checking.

See user manual

Differences between countries

The API is equal in each country: Denmark, Finland, Norway and Sweden. However, due to legislation and product feature differences, validations for some of the API fields are country-dependent. These differences are documented in the complete API reference.

When developing an integration intended to be used in multiple countries, please request testing environments for respective countries.

Pricing

Actions made through the API respect the standard limits and pricing of the Procountor environment in question. For instance, creating invoices or ledger receipts through the API counts against the possible quotas associated with the environment, and are priced as if they were made on the UI. Additionally, usage of Procountor API may involve monthly or similar fees.

The current monthly fee for using the API, including an unlimited amount of integrations, is as follows:

  • Finnish environments: EUR 9.95 (excl. VAT)
  • Swedish, Norwegian and Danish environments: EUR 0.00 (incl. VAT)

The price will be charged from the end-user company as an add-on service. Always confirm the latest rates for API usage on Procountor.com for Finland, Sweden, Norway and Denmark. Pricing is subject to change.

All actions made in testing environments on the api-test server, as well as accessing the testing environments through the API or UI, are always free of charge.