How to Enable and Use the API Interface in Eemel
APIs are available only in the Super version of Eemel. Follow the steps below to activate and configure API usage.
1. Activate API Access
Go to Settings (gear icon in the top menu).
Select Enabled Features.
Find API access enabled? and check the box.
2. Create an API Role
Go to My Info → Roles.
Click New Role (+).
Name the role (e.g., “API”).
Set the following:
Allow login? → No
Allow invoice editing? → No
Allow API usage? → Yes
Click Save.
3. Create an API User
Go to My Info → Users.
Create a new user and assign the newly created “API” role.
The system sends a password to the user’s email.
Use this username and password in API calls.
4. API Endpoints and Usage
You can import invoices in Finvoice or XML format using the REST interface.
Example Endpoint:
POST https://app.nettilasku.fi/hook.php
Required POST Fields:
plaintextCopyEditusername: your_api_user password: your_password asiakasid: your_customer_id komento: desired_command
Example: Importing Sales Invoices
plaintextCopyEditkomento: tuo_laskut xml: <Finvoice>...</Finvoice>
Example: Fetching Sales Invoices
plaintextCopyEditkomento: hae_laskut_finvoice from_date: 2015-12-01 to_date: 2015-12-31
Example: Fetching Payment Transactions
plaintextCopyEditkomento: hae_suoritukset from_date: 2015-12-01 to_date: 2015-12-31
Example: Importing Customers
plaintextCopyEditkomento: tuo_laskutusasiakkaat xml: <customers>...</customers>