FAQ

WHERE’S THE SANDBOX!?

We don’t have the sandbox. Just create a test company. Trial license allows you to create up to 100 documents.

HOW TO START

Just take Node.js example or PHP example. Put your API Id and Key in. Play with different payloads. You’ll get this.

API ID AND KEY?

Yes. Log into Merit Aktiva GUI. Go to Settings >> API Settings. Create Key. Use that key.

GET OR POST

Every endpoint accepts POST request. Some of them, because of historical reasons, accept GET as well.

IS THE SERVICE RUNNING?

Yes, it is. We have many successful integrators and every day we receive hundreds or thousands requests. It’s online and running. We can help to get your software connected as well.

ERROR 401

Two possible reasons, check the body of the content. If there is no content your API ID is invalid. If content exists, it possibly reads: the creator of the company has to have PRO or PREMIUM license for that company.

ERROR 404

Two possible reasons: the URL is invalid or you’re missing one of the required parameters. URL has to be like this: “https://aktiva.meritaktiva.fi/api/v1/” + endpoint + “?ApiId=” + APIID + “&timestamp=” + TIMESTAMP + “&signature=” + APIKEY

STACKTRACE

You’re receiving ASP.NET stacktrace? You should not receive stacktrace, but if that ever happens it’s logged and an alert is sent to our development team to see what’s wrong.

INCVOICE ROWS DOES NOT SUM UP

It’s because you didn’t round the values of the rows before summing. We need to make sure that the row price and VAT part is rounded 2 places after comma. Why? It’s because every row has it’s general ledger record and general ledger is Decimal(12.2). Why? Because those fractions would add nasty little additions that would take ages to find, understand and fix. That’s how bookkeepers do.

CAN’T CREATE PAYMENT SOMEHOW

9 cases of 10: you can only add payment with exact sum of the sales invoice. Other 10% of cases: customer name does not match.