| name | merit-company-lookup |
| version | 1.0.0 |
| description | Look up Estonian companies in the Business Register (äriregister) using the two FREE live services via `elnora-merit ariregister`: invoicing requisites (legal name, VAT number, status, address) by registry code, and e-invoice capability. Use to fill or verify customer/invoice details from the authoritative source, or to check whether a company can receive e-invoices before sending one. Use when: looking up a company's registry data, getting a VAT number or address by registry code, verifying customer details before invoicing, or checking e-invoice capability. TRIGGERS: "äriregister lookup", "business register", "registrikood", "look up company", "company requisites", "VAT number for", "registry data", "verify customer", "e-invoice check", "can they receive e-invoices", "e-arve check", "kmkr number".
|
Merit Company Lookup — äriregister free services
Two FREE (tasuta), read-only services from the Estonian Business Register, exposed via
elnora-merit ariregister. Nothing here writes to the books or costs money.
When to use
- Before creating a customer/invoice — pull the authoritative legal name, VAT number,
and address instead of typing them by hand or trusting a stale value.
- Before sending an e-invoice — confirm the recipient actually has an active e-invoice
channel, so you don't send into a void.
Commands
Requisites (needs credentials)
elnora-merit ariregister requisites <regCode> [--include-deleted] [--lang eng]
Returns JSON: regCode, name, vatNo, status, statusText, address {street, ehakCode, ehakText, postalIndex}, registryLink. status R = registered/active; K = deleted.
Example:
$ elnora-merit ariregister requisites 16818352
{"regCode":"16818352","name":"Elnora AI OÜ","vatNo":"EE102672514","status":"R", ...}
E-invoice capability (no credentials)
elnora-merit ariregister e-invoice-check <regCode> [<regCode> ...]
One row per code: status OK = active e-invoice relationship (canReceiveEInvoice: true),
MR = none/invalid; plus name and provider (operator).
Mapping requisites to a Merit customer
| äriregister field | Merit customer field |
|---|
name | Name |
vatNo | VatRegNo |
regCode | RegNo |
address.street | Address |
address.ehakText | City / County |
address.postalIndex | PostalCode |
Setup & limits
- Requisites needs
ARIREG_XML_USER / ARIREG_XML_PASSWORD in the environment or
~/.config/elnora-merit/.env. Create an XML-authorised user in the e-äriregister portal
(Haldus → Kasutajate haldamine) and use that account's credentials. A "credential rejected"
error means they are missing or wrong.
- E-invoice-check needs no credentials at all.
- Only these two free services are wired. Detailed company data, beneficial owners, and
representation rights are billable in the register and are intentionally not exposed.
- Endpoint defaults to production; set
ARIREG_XML_ENV=test to hit the demo endpoint.
See also: merit-sales-invoices (issuing the invoice once requisites are confirmed) and the
merit-company-lookup agent for a guided flow.
