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 does. We have ~1000 successful integrators. Every day we receive hundreds of 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.merit.ee/api/v1/” + endpoint + “?ApiId=” + APIID + “×tamp=” + TIMESTAMP + “&signature=” + APIKEY
STACKTRACE
You’re receiving ASP.NET stacktrace? It’s because you have compiled JSON payload that we weren’t even imagine possible. Probably you’re missing some key element of that payload. For example, trying to send salesinvoice without any item row.
Don’t worry about the trace. We have logged that, but probably never look into that. Or maybe some day we will add some additional checks and error messages.
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.