Skip to content
Back to search

merit-aktiva-skills

MarketplaceWorks with Claude CodeGitHub

Merit Aktiva for AI agents — Claude Code skills for Estonian bookkeeping, invoicing, VAT (KMD), and the Merit Aktiva REST API.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/arturl95--merit-aktiva-skills/badge.svg)](/listings/arturl95--merit-aktiva-skills)

HTML

<a href="/listings/arturl95--merit-aktiva-skills"><img src="/api/listings/arturl95--merit-aktiva-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

In any Claude Code session:

# 1. Add this repo as a plugin marketplace
/plugin marketplace add arturl95/merit-aktiva-skills

# 2. Install the plugin
/plugin install merit-aktiva-skills@merit-aktiva-skills

Then set credentials (from Merit Aktiva → Settings → API Settings) in your shell:

export MERIT_API_ID="your-api-id-guid"
export MERIT_API_KEY="your-api-key-secret"

See [Installation](#installation) below for alternative install methods (local clone, marketplace.json, etc.).

Then ask Claude:

> "List Acme OÜ's unpaid invoices this month." > "Post a €1,000 + 24% VAT consulting invoice to Acme OÜ for May." > "Import last week's Swedbank statement and reconcile." > "Verify the April KMD reconciles before I file."

Claude loads the right skill(s), resolves customer/item/tax codes, builds the API payload, shows it to you for confirmation, and posts it on your "yes".

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 38 lines
  1. {
  2. "name": "merit-aktiva-skills",
  3. "description": "Merit Aktiva for AI agents — Claude Code skills for Estonian bookkeeping, invoicing, VAT (KMD), and the Merit Aktiva REST API.",
  4. "owner": {
  5. "name": "AlusLabs",
  6. "url": "https://aluslabs.com"
  7. },
  8. "plugins": [
  9. {
  10. "name": "merit-aktiva-skills",
  11. "source": "./",
  12. "description": "Merit Aktiva for AI agents — six skills covering authentication, masters (customers/vendors/items/taxes/accounts), sales, purchases & payments, ledger & reports, plus 2026 Estonian tax rules.",
  13. "version": "0.2.0",
  14. "author": {
  15. "name": "AlusLabs",
  16. "url": "https://aluslabs.com"
  17. },
  18. "homepage": "https://github.com/arturl95/merit-aktiva-skills",
  19. "repository": "https://github.com/arturl95/merit-aktiva-skills",
  20. "license": "MIT",
  21. "category": "accounting",
  22. "keywords": [
  23. "merit-aktiva",
  24. "merit-aktiva-api",
  25. "accounting",
  26. "raamatupidamine",
  27. "estonia",
  28. "eesti",
  29. "e-invoice",
  30. "e-arve",
  31. "vat",
  32. "kmd",
  33. "bookkeeping",
  34. "ai-agents"
  35. ]
  36. }
  37. ]
  38. }
README.md · README · 337 lines
  1. # Merit Aktiva for AI Agents
  2. > Plug **Merit Aktiva** — Estonia's most-used accounting software — into Claude, ChatGPT, Cursor and any AI agent. Bookkeeping, invoicing, VAT (KMD), and the full **Merit Aktiva API** in six Claude Code skills. Bilingual: **English · Eesti keeles**.
  3. [![Plugin](https://img.shields.io/badge/Claude_Code-plugin-blue)](https://code.claude.com/docs/en/plugins.md)
  4. [![Version](https://img.shields.io/badge/version-0.2.0-green)](https://github.com/arturl95/merit-aktiva-skills/releases)
  5. [![License](https://img.shields.io/badge/license-MIT-lightgrey)](LICENSE)
  6. [![Rates verified](https://img.shields.io/badge/rates_verified-2026--05--12-success)](skills/estonian-bookkeeping/SKILL.md)
  7. [![Made in Estonia](https://img.shields.io/badge/made_in-Estonia%20🇪🇪-blue)](#merit-aktiva-ai-agentidele--eestikeelne-juhend)
  8. **[Eesti keeles allpool ↓](#merit-aktiva-ai-agentidele--eestikeelne-juhend)**
  9. ---
  10. ## What is this?
  11. **Merit Aktiva for AI Agents** is an open-source [Claude Code](https://code.claude.com) skills plugin that lets AI agents — Claude, ChatGPT, Cursor, or anything that can read instructions — operate [Merit Aktiva](https://www.merit.ee/), Estonia's #1 accounting software (majandustarkvara). It wraps the official [Merit Aktiva API](https://api.merit.ee/) with HMAC-SHA256 authentication, the complete v2 endpoint surface, and — critically — the **2026 Estonian tax rules** (käibemaks 24%, distributed-profit CIT, payroll, KMD codes). Use it to automate sales invoicing, purchase invoices, e-arve import, bank reconciliation, GL adjustments, and month-end VAT (KMD) reporting from any LLM.
  12. This plugin does **not** ship code. It ships *instructions* — six skills your AI reads to learn the API, the gotchas, and the Estonian bookkeeping rules. Your agent talks to `api.merit.ee` directly over HTTPS.
  13. ## Quick start
  14. In any Claude Code session:
  15. ```bash
  16. # 1. Add this repo as a plugin marketplace
  17. /plugin marketplace add arturl95/merit-aktiva-skills
  18. # 2. Install the plugin
  19. /plugin install merit-aktiva-skills@merit-aktiva-skills
  20. ```
  21. Then set credentials (from Merit Aktiva → Settings → API Settings) in your shell:
  22. ```bash
  23. export MERIT_API_ID="your-api-id-guid"
  24. export MERIT_API_KEY="your-api-key-secret"
  25. ```
  26. See [Installation](#installation) below for alternative install methods (local clone, marketplace.json, etc.).
  27. Then ask Claude:
  28. > "List Acme OÜ's unpaid invoices this month."
  29. > "Post a €1,000 + 24% VAT consulting invoice to Acme OÜ for May."
  30. > "Import last week's Swedbank statement and reconcile."
  31. > "Verify the April KMD reconciles before I file."
  32. Claude loads the right skill(s), resolves customer/item/tax codes, builds the API payload, shows it to you for confirmation, and posts it on your "yes".
  33. ## Features
  34. - **Sales invoicing** — `sendinvoice` v2 with all the rounding and TaxId rules baked in. Credit invoices, e-arve dispatch via Omniva / Telema / bank, PDF retrieval, email delivery.
  35. - **Purchase invoicing** — supplier bills, expense claims, approval queue, reverse-charge VAT for intra-EU and non-EU transactions.
  36. - **Payments & bank reconciliation** — payments, prepayments, settlements, **camt.053** bank statement import with auto-matching via viitenumber.
  37. - **General ledger & reports** — `sendglbatch` for adjustments, P&L, balance sheet (`getfinpos`), AR aging, sales/purchase reports, VAT reconciliation.
  38. - **Estonian tax compliance** — 2026 rates (VAT 24% / 13% / 9%, CIT 22/78, social tax 33%, II pillar 2/4/6%), KMD line mapping, fringe-benefit math, deadlines, board-member-fee specifics. All citations to [emta.ee](https://www.emta.ee/en).
  39. - **HMAC-SHA256 request signing** — verified against the official spec and four open-source clients (Go, TS, two PHP). Worked example included.
  40. - **Confirmation guardrails on every write** — show the payload, wait for "yes". Optional batch-confirm mode for repetitive jobs.
  41. ## Authentication — HMAC-SHA256
  42. Every Merit Aktiva API call carries three query parameters: `ApiId`, `timestamp` (UTC, `yyyyMMddHHmmss`), and `signature`.
  43. ```
  44. timestamp = UTC now formatted yyyyMMddHHmmss
  45. dataToSign = utf8(apiId + timestamp + httpBody)
  46. signature = base64(hmac_sha256(apiKey, dataToSign)) # standard alphabet
  47. url = base + endpoint + "?ApiId=" + apiId
  48. + "&timestamp=" + timestamp
  49. + "&signature=" + urlencode(signature)
  50. ```
  51. Common gotchas (full list in [`skills/merit-aktiva-core/references/authentication.md`](skills/merit-aktiva-core/references/authentication.md)):
  52. - **URL-encode** the signature before appending — `+` becomes a space otherwise.
  53. - **UTC**, not Tallinn local. Sync to NTP.
  54. - **Sign the exact bytes** you POST. Re-serializing after signing breaks the signature.
  55. - **HMAC-SHA256**, not plain SHA-256. Standard base64 alphabet, not URL-safe.
  56. See [API seadistus on support.merit.ee](https://support.merit.ee/et/articles/368840-api-seadistus) for getting your API ID and API Key.
  57. ## The six skills
  58. | Skill | What it does |
  59. |---|---|
  60. | **`merit-aktiva-core`** | Authentication, conventions, error handling. Foundation skill. |
  61. | **`merit-aktiva-masters`** | Customers, vendors, items, tax codes, chart of accounts. Resolves names to GUIDs. |
  62. | **`merit-aktiva-sales`** | Sales invoices, credit notes, e-invoicing (Omniva/Telema/bank), PDFs. |
  63. | **`merit-aktiva-purchases-payments`** | Purchase invoices, expense claims, payments, camt.053 bank import. |
  64. | **`merit-aktiva-ledger-reports`** | GL journal entries, P&L, balance, customer-debt, sales/purchase, VAT reports. |
  65. | **`estonian-bookkeeping`** | 2026 Estonian tax rules — VAT, CIT, payroll, KMD codes, fringe benefits. Standalone (no Merit dependency). |
  66. Plus a bundled subagent **`merit-bookkeeper`** for batch jobs (a stack of receipts, monthly retainers, bank reconciliation).
  67. ## Installation
  68. Pick whichever method fits your setup.
  69. ### A — Add as a marketplace (recommended)
  70. In any Claude Code session:
  71. ```bash
  72. /plugin marketplace add arturl95/merit-aktiva-skills
  73. /plugin install merit-aktiva-skills@merit-aktiva-skills
  74. ```
  75. The first command registers this repo as a [plugin marketplace](https://code.claude.com/docs/en/plugin-marketplaces). The second installs the `merit-aktiva-skills` plugin from it. Updates land via `/plugin update`.
  76. ### B — Local clone (for development or air-gapped use)
  77. ```bash
  78. git clone https://github.com/arturl95/merit-aktiva-skills.git
  79. claude --plugin-dir ./merit-aktiva-skills
  80. ```
  81. `--plugin-dir` loads the plugin for the current session without installing it system-wide. You can stack multiple plugin directories.
  82. ### C — Persist as a known marketplace in `~/.claude/settings.json`
  83. ```json
  84. {
  85. "extraKnownMarketplaces": {
  86. "merit-aktiva-skills": {
  87. "source": { "source": "github", "repo": "arturl95/merit-aktiva-skills" }
  88. }
  89. }
  90. }
  91. ```
  92. Then `/plugin install merit-aktiva-skills@merit-aktiva-skills`. Useful if you want the marketplace available without re-adding it each time.
  93. ### Verifying installation
  94. ```bash
  95. /plugin list
  96. ```
  97. You should see `merit-aktiva-skills` enabled. Try `merit-aktiva-core` in your next prompt:
  98. > "Show me what merit-aktiva-core knows about authentication."
  99. Claude should load the skill and summarise the HMAC signing recipe.
  100. ## How it compares
  101. | Approach | Pros | Cons | Best for |
  102. |---|---|---|---|
  103. | **`merit-aktiva-skills`** (this) | Up-to-date 2026 tax rules baked in; AI-native; works in any LLM that reads instructions; bilingual | Requires Claude Code or compatible AI host | AI-driven bookkeeping, agent workflows |
  104. | **[`KasparKipp/merit-aktiva`](https://github.com/KasparKipp/merit-aktiva)** (Node/TS) | Strongly typed; modern stack | Manual coding; no tax knowledge | Node integrations |
  105. | **[`akosmarton/merit-aktiva-api-go`](https://github.com/akosmarton/merit-aktiva-api-go)** (Go) | Performant | Manual coding; uses URL-safe base64 (non-canonical) | Go backends |
  106. | **Raw HTTP** | Maximum control | You write every signature, every payload, every error path | Custom one-offs |
  107. ## Use cases
  108. - **AI bookkeeper for an Estonian OÜ** — process supplier invoices from email, decide accounts and VAT codes, post on confirmation.
  109. - **ChatGPT KMD assistant** — pull period invoices, build the KMD line totals, cross-check against GL, surface discrepancies before filing.
  110. - **e-arve sync** — read incoming e-invoices, route to approval queue, notify the responsible employee.
  111. - **Monthly recurring invoices** — list of customers × monthly retainer → 30 `sendinvoice` calls with one batch confirm.
  112. - **Bank reconciliation co-pilot** — daily camt.053 import + interactive matching of unmatched lines.
  113. ## FAQ
  114. ### What is the Merit Aktiva API?
  115. The official REST API for [Merit Aktiva](https://www.merit.ee/), Estonia's most-used accounting software. Documented at [api.merit.ee](https://api.merit.ee/). Supports sales invoices, purchase invoices, customers, vendors, items, payments, bank statements, GL transactions, and reports.
  116. ### How do I get a Merit Aktiva API ID and API key?
  117. Log into Merit Aktiva → **Settings → API Settings → Create Key**. You'll get an `ApiId` (GUID) and an `ApiKey` (HMAC secret). Step-by-step at [API seadistus](https://support.merit.ee/et/articles/368840-api-seadistus). Requires Pro or Premium license.
  118. ### Does Merit Aktiva have a sandbox?
  119. No. The [official FAQ](https://api.merit.ee/faq/) confirms it: *"We don't have the sandbox. Just create a test company. Trial license allows you to create up to 100 documents."* Use a trial company for testing.
  120. ### How does HMAC signing work?
  121. See the [Authentication](#authentication--hmac-sha256) section above and the full recipe in [`skills/merit-aktiva-core/references/authentication.md`](skills/merit-aktiva-core/references/authentication.md). It's HMAC-SHA256 over `apiId + timestamp + body`, base64-encoded and URL-encoded into the query string. UTC timestamp.
  122. ### Can I file KMD via API?
  123. No. EMTA's KMD submission happens at [emta.ee](https://www.emta.ee/) (e-MTA portal). Merit Aktiva exposes the figures (via report endpoints) but does not push to EMTA. Manual filing remains.
  124. ### Is this official?
  125. **No.** This is a community plugin, not affiliated with AS Merit Tarkvara. Cross-check rates and rules against [emta.ee](https://www.emta.ee/en) before filings.
  126. ### What if my LLM isn't Claude?
  127. The skills are Markdown files. Any LLM that can read text and follow instructions can use them — copy the relevant SKILL.md into your system prompt or context. The plugin format is Claude Code's, but the content is portable.
  128. ### Why "AI agents" and not "MCP server"?
  129. This plugin is a set of Claude Code *skills* (Markdown instructions), not an MCP server (a running process). The naming reflects what it actually is. The keywords `merit aktiva mcp` and `accounting mcp server` are addressed by the AI-agent framing because the use case overlaps.
  130. ## Need the integration built, not just the skills?
  131. This plugin is the open part of how [AlusLabs](https://aluslabs.com) builds Merit Aktiva API integrations for Estonian companies: web shop orders to sales invoices, bank statement matching, CRM to accounting. What that work looks like, and a real HMAC-signed request against the live API, is written up here:
  132. - [Merit Aktiva integratsioon ja API-liidestus](https://aluslabs.com/integratsioonid/merit-aktiva) (Estonian)
  133. - [Merit Aktiva API: a real HMAC-signed request](https://aluslabs.com/blog/merit-aktiva-api-juhend-ai-agent-2026) (Estonian)
  134. ## Security & disclaimer
  135. - **Credentials**: only set `MERIT_API_ID` / `MERIT_API_KEY` as environment variables. Never paste them into chat. Never commit them to git.
  136. - **Trial-first**: test against a Merit trial company before connecting to production. The skill prompts your AI to confirm before any first write in a session.
  137. - **Tax accuracy**: tax rates in this plugin are last verified on the date in each skill's `last-verified` frontmatter. Estonia legislates frequently; cross-check current rates at [emta.ee](https://www.emta.ee/en) before filings.
  138. - **Not an official Merit Tarkvara product.** Provided "as is" under [MIT License](LICENSE).
  139. ## Contributing
  140. Issues and PRs welcome at [github.com/arturl95/merit-aktiva-skills](https://github.com/arturl95/merit-aktiva-skills). When updating tax rates, change the `last-verified` date in the affected SKILL.md and update the cited emta.ee URLs.
  141. ---
  142. # Merit Aktiva AI agentidele — eestikeelne juhend
  143. > Ühenda **Merit Aktiva** — Eesti enimkasutatav majandustarkvara — Claude'i, ChatGPT, Cursori ja teiste AI agentidega. **Merit Aktiva API**, raamatupidamise automatiseerimine, müügiarved, ostuarved, e-arved, käibedeklaratsioon (KMD) — kõik see on pakendatud kuude Claude Code'i oskusesse (skill).
  144. ## Mis see on?
  145. **Merit Aktiva AI agentidele** on avatud lähtekoodiga Claude Code'i plugin, mis õpetab AI agentidele (Claude, ChatGPT, Cursor jt) selgeks **Merit Aktiva integratsiooni**: ametliku [Merit Aktiva API](https://api.merit.ee/) HMAC-SHA256 autentimise, kõik v2 endpoint'id ja — mis kõige tähtsam — **2026. aasta Eesti maksureeglid**: käibemaks 24%, jaotatud kasumi tulumaks 22/78, palgamaksud, KMD koodid ja erisoodustused.
  146. See plugin ei ole MCP server ega kooditeek — see koosneb kuuest **Markdown-failis kirjeldatud oskusest**, mida AI loeb ja omandab, et **Merit Aktiva liidesega** korrektselt suhelda. Sinu agent suhtleb `api.merit.ee`-ga otse üle HTTPS-i.
  147. **Kasutusjuhud**: AI raamatupidamine ja AI-toega raamatupidamine, e-arvete import, ostuarvete automaatne sisestamine, KMD koostamine ChatGPT abil, pangaväljavõtete automaatne kooskõlastamine ja igakuiste korduvate arvete genereerimine.
  148. ## Kiire alustamine
  149. Käivita Claude Code'is:
  150. ```bash
  151. # 1. Lisa see repo plugina-turuplatsina
  152. /plugin marketplace add arturl95/merit-aktiva-skills
  153. # 2. Paigalda plugin
  154. /plugin install merit-aktiva-skills@merit-aktiva-skills
  155. ```
  156. Seejärel sea API andmed terminalis (Merit Aktiva → Seaded → API seadistus):
  157. ```bash
  158. export MERIT_API_ID="sinu-api-id-guid"
  159. export MERIT_API_KEY="sinu-api-võti-salasõna"
  160. ```
  161. Alternatiivsete paigaldusviiside (kohalik kloon, `--plugin-dir`, `settings.json` kaudu) jaoks vaata [Installation](#installation) sektsiooni inglisekeelses osas.
  162. Seejärel küsi Claude'ilt:
  163. > "Näita Acme OÜ selle kuu tasumata arveid."
  164. > "Koosta Acme OÜ-le mai eest konsultatsiooniteenuse arve summas 1000 € + 24% käibemaks."
  165. > "Impordi eelmise nädala Swedbanki pangaväljavõte ja kooskõlasta laekumised."
  166. > "Kontrolli aprilli KMD-d enne esitamist."
  167. ## Funktsioonid
  168. - **Müügiarved** — `sendinvoice` v2; ümardamised, TaxId, kreeditarved, e-arvete väljastamine Omniva, Telema või pangakanalite kaudu, PDF-ide ja e-kirjade genereerimine.
  169. - **Ostuarved** — hankija arved, kuluaruanded, kinnitusringid, **pöördkäibemaks** EL-i ja kolmandate riikide tehingutel.
  170. - **Maksed ja pangaväljavõtted** — laekumised, tasumised, ettemaksud, kooskõlastamised, **camt.053** automaatne import ja sidumine viitenumbri alusel.
  171. - **Pearaamat ja aruanded** — `sendglbatch` käsitsi kannete tegemiseks, kasumiaruananne (`getprofitloss`), bilanss (`getfinpos`), ostjate tasumata arved, KMD kontroll.
  172. - **Eesti maksureeglid (2026)** — käibemaks 24% / 13% / 9%, sotsiaalmaks 33%, tulumaks 22%, maksuvaba tulu 700 €, II sammas 2/4/6%, KMD ridade kaardistamine, juhatuse liikme tasu eripärad.
  173. - **API allkirjastamine (HMAC-SHA256)** — testitud ja valideeritud ametliku spetsifikatsiooni ning nelja avatud lähtekoodiga kliendi (Go, TS, 2× PHP) põhjal.
  174. - **Kinnitusnõue andmete muutmisel** — enne API päringu teele panemist kuvatakse *payload* ja oodatakse kasutaja kinnitust ("jah"). Toetab ka partii-režiimi (*batch mode*).
  175. ## Autentimine (API ID, API võti, HMAC allkiri)
  176. Iga **Merit Aktiva API** päring sisaldab kolme URL-i parameetrit (*query parameter*): `ApiId`, `timestamp` (UTC, `yyyyMMddHHmmss`) ja `signature`.
  177. ```
  178. timestamp = praegune UTC kell formaadis yyyyMMddHHmmss
  179. dataToSign = utf8(apiId + timestamp + httpBody)
  180. signature = base64(hmac_sha256(apiKey, dataToSign))
  181. url = base + endpoint + "?ApiId=" + apiId
  182. + "&timestamp=" + timestamp
  183. + "&signature=" + urlencode(signature)
  184. ```
  185. API ID ja API võtme genereerimiseks ava: Merit Aktiva → Seaded → API seadistus. Vaata ka samm-sammulist juhendit: [API seadistus](https://support.merit.ee/et/articles/368840-api-seadistus). API kasutamine eeldab Pro või Premium paketi olemasolu.
  186. ## Kuus oskust (skills)
  187. | Oskus | Kirjeldus |
  188. |---|---|
  189. | **`merit-aktiva-core`** | Autentimine, API konventsioonid ja veakäsitlus. Baasoskus, millele toetuvad teised. |
  190. | **`merit-aktiva-masters`** | Kliendid, hankijad, artiklid, KM-koodid ja kontoplaan. Nimede vastendamine GUID-ideks. |
  191. | **`merit-aktiva-sales`** | Müügiarved, kreeditarved, e-arvete väljastamine ja PDF-ide genereerimine. |
  192. | **`merit-aktiva-purchases-payments`** | Ostuarved, kuluaruanded, maksed ja pangaväljavõtete import. |
  193. | **`merit-aktiva-ledger-reports`** | Pearaamatu kanded, finantsaruanded ja KMD andmete kontroll. |
  194. | **`estonian-bookkeeping`** | 2026. aasta Eesti maksureeglid — käibemaks, tulumaks, palgamaksud ja KMD koodid. |
  195. Lisaks on saadaval **`merit-bookkeeper`** alamagent (*subagent*) massandmete töötlemiseks (suurem hulk tšekke, igakuised korduvad arved, mahukad pangaväljavõtted).
  196. ## Kasutusnäited
  197. - **AI-raamatupidaja väikeettevõttele** — AI agent loeb e-kirjadest hankijate arveid, määrab õiged kulukontod ja KM-koodid ning sisestab need pärast inimese kinnitust raamatupidamisse.
  198. - **ChatGPT KMD-assistent** — perioodi arvete summeerimine KMD ridade lõikes, andmete võrdlemine pearaamatuga ja lahknevuste tuvastamine enne EMTA-le esitamist.
  199. - **E-arvete sünkroniseerimine** — sissetulevate e-arvete suunamine kinnitusringi ja vastutavate töötajate teavitamine.
  200. - **Igakuiste arvete masskoostamine** — kliendinimekiri × kuutasu → 30 `sendinvoice` päringut, mis saadetakse teele üheainsa koondkinnitusega.
  201. - **Pangaväljavõtete assistent** — igapäevane **camt.053** failide import ja interaktiivne abi tundmatute laekumiste sidumisel.
  202. ## KKK
  203. ### Mis on Merit Aktiva API?
  204. See on ametlik [Merit Aktiva](https://www.merit.ee/) REST API. Dokumentatsioon asub aadressil [api.merit.ee](https://api.merit.ee/). API toetab müügi- ja ostuarveid, klientide ning hankijate haldust, artikleid, makseid, pangaväljavõtteid, pearaamatu kandeid ja finantsaruandeid.
  205. ### Kuidas saada Merit Aktiva API võti?
  206. Ava Merit Aktiva ja liigu: **Seaded → API seadistus → Loo võti**. Sealt saad `ApiId` (GUID) ja `ApiKey` (HMAC salasõna). Loe lähemalt juhendist: [API seadistus](https://support.merit.ee/et/articles/368840-api-seadistus). API kasutamiseks on vajalik Pro või Premium pakett.
  207. ### Kas Merit Aktival on testkeskkond?
  208. Ei ole. Ametlik KKK ütleb: *"Meil ei ole sandboxi. Loo testfirma — prooviversioon lubab 100 dokumenti."* Testimine toimub tavalises prooviversiooni (*trial*) ettevõttes, kasutades sama API aadressi.
  209. ### Kuidas ühendada ChatGPT Merit Aktivaga?
  210. Selle plugina sisu töötab iga keelemudeliga (LLM), mis suudab juhiseid järgida. ChatGPT puhul kopeeri vajalike `SKILL.md` failide sisu süsteemiviipa (*system prompt*) — seejärel oskab agent otse `api.merit.ee`-ga suhelda. Claude Code'i kasutajad saavad plugina lihtsalt käsurealt paigaldada.
  211. ### Kuidas töötab HMAC-allkiri?
  212. Vaata [autentimise sektsiooni](#autentimine-api-id-api-võti-hmac-allkiri) ja täielikku tehnilist kirjeldust failist [`skills/merit-aktiva-core/references/authentication.md`](skills/merit-aktiva-core/references/authentication.md). Lühidalt: tehakse HMAC-SHA256 räsiallkiri stringist `apiId + timestamp + body`, mis kodeeritakse Base64 formaati ja lisatakse URL-kodeerituna päringu parameetritesse. Ajatempel peab olema UTC ajavööndis.
  213. ### Kas saab KMD-d API kaudu esitada?
  214. Ei saa. KMD esitamine toimub jätkuvalt [emta.ee](https://www.emta.ee/) e-MTA portaali kaudu. Merit Aktiva API kaudu saab kätte eeltäidetud andmed, kuid tarkvara ei saada neid automaatselt EMTA-sse.
  215. ### Kas see on ametlik AS Merit Tarkvara toode?
  216. **Ei.** Tegemist on kogukonna loodud pluginaga, mis ei ole AS-iga Merit Tarkvara seotud. Enne KMD/TSD esitamist kontrolli alati maksumäärad ja reeglid üle [emta.ee](https://www.emta.ee/) lehelt.
  217. ## Vajad Merit Aktiva API liidestust, mitte ainult oskusi?
  218. See plugin on avalik osa sellest, kuidas [AlusLabs](https://aluslabs.com) ehitab Eesti ettevõtetele Merit Aktiva API liidestusi: e-poe tellimused müügiarveteks, pangaväljavõtte sobitamine, CRM ja raamatupidamine. Kuidas selline liidestus käib ja milline näeb välja päris HMAC-allkirjastatud päring Merit Aktiva API vastu, on kirjas siin:
  219. - [Merit Aktiva integratsioon ja API-liidestus](https://aluslabs.com/integratsioonid/merit-aktiva)
  220. - [Merit Aktiva API: reaalne HMAC-allkirjastatud päring](https://aluslabs.com/blog/merit-aktiva-api-juhend-ai-agent-2026)
  221. ## Vastutus
  222. - Maksumäärad on viimati kontrollitud kuupäeval, mis on märgitud iga oskuse `last-verified` väljale. Kuna Eesti maksuseadusandlus võib muutuda, kontrolli andmeid enne deklaratsioonide esitamist alati [emta.ee](https://www.emta.ee/) lehelt.
  223. - Enne toodangukeskkonnas (*production*) kasutamist testi lahendust kindlasti prooviversiooni (*trial*) ettevõttes. Agent küsib sessiooni alguses alati kinnitust, enne kui teeb API kaudu esimese andmeid muutva päringu.
  224. - API ID ja API võti on konfidentsiaalsed andmed — ära kunagi lisa neid versioonihaldusesse (nt Git) ega jaga avalikes vestlustes.
  225. ## Litsents
  226. [MIT](LICENSE) · Autor: Artur · Kogukonna projekt, **tegemist ei ole ametliku AS Merit Tarkvara tootega**.
  227. ---
  228. *Made for Estonian businesses. Built with [Claude Code](https://code.claude.com), the [Model Context Protocol](https://modelcontextprotocol.io) ecosystem, and the patience required to read every page of [api.merit.ee/connecting-robots/reference-manual/](https://api.merit.ee/connecting-robots/reference-manual/).*

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.