Mikro ERP Integration
Connect your Mikro V17 ERP to Talos via the REST API for full material, order, invoice, and e-fatura synchronization.
Overview
Mikro ERP V17 exposes a REST API on port 8094. All endpoints use the POST method with JSON request/response bodies. Talos connects to this API to read and write materials, orders, invoices, delivery notes, and more.
The integration supports both on-premise and hosted Mikro installations. Talos handles authentication, MD5 password hashing, and session management automatically.
What You Need
- Mikro server IP address or hostname
- API port (default: 8094)
- FirmaKodu (company code)
- KullaniciKodu (user code, often "SRV")
- API password (different from login password)
- ApiKey and CalismaYili (working year, e.g. 2026)
Step 1 — Enable API Access
- Contact your Mikro administrator or dealer and ask them to enable the API module on your Mikro server.
- Open Mikro settings and navigate to the API configuration section. Note down the API key shown there.
- Ensure port 8094 (or your custom API port) is open and reachable from the machine running Talos.
Tip: The API module is a separately licensed feature in Mikro V17. If you don't see it in settings, contact your Mikro dealer.
Step 2 — Get Credentials
Collect the following credentials from your Mikro administrator:
| Field | Description | Example |
|---|---|---|
| FirmaKodu | Company code — identifies which company database to connect to. Usually a number (1, 2, etc.). | 1 |
| KullaniciKodu | API user code. Often "SRV" for service accounts. This is NOT the same as a regular Mikro login username. | SRV |
| Password | API-specific password. This is different from the normal Mikro login password. Talos hashes it automatically via MD5. | api-pass-2026 |
| ApiKey | API key from Mikro settings. A unique alphanumeric string assigned to your installation. | A1B2-C3D4-E5F6 |
| CalismaYili | Working year. Must match the active fiscal year in Mikro (e.g. 2026). | 2026 |
Step 3 — Configure in Talos
- Go to Settings > ERP in the Talos dashboard.
- Select "Mikro" as your ERP type.
- Enter the server address, port, FirmaKodu, KullaniciKodu, password, ApiKey, and CalismaYili.
- Click "Test Connection" to verify. If successful, click "Save".
What You Can Do
Once connected, Talos can perform the following operations through the Mikro API:
- Materials — Create, read, update materials (StokKaydet, StokListe, StokBul)
- Orders — Sales orders and purchase orders (SiparisFaturasi, SiparisListe)
- Invoices — Create and query invoices (FaturaKaydet, FaturaListe, FaturaBul)
- Delivery Notes — Create and list delivery notes (IrsaliyeKaydet, IrsaliyeListe)
- Payments — Record and query payment transactions (TahsilatKaydet, OdemeListe)
- BOM / Recipes — Read bill of materials and production recipes (UrunAgaci, ReceteListe)
- Production Orders — Create and track production orders (UretimEmri, UretimListe)
- Stock Movements — Track stock entries, exits, and transfers (StokHareket, DepoTransfer)
E-Invoice (E-Fatura)
Mikro V17 supports GIB (Revenue Administration) e-invoice operations through dedicated API methods:
- Send e-Invoice to GIB — Use FaturaToEFaturaV2 to convert a Mikro invoice into an official e-fatura and transmit it.
- Accept / Reject incoming e-invoices — Process incoming e-fatura with kabul (accept) or red (reject) operations.
- Download e-Invoice PDF — Retrieve the official PDF copy of any sent or received e-fatura.
- Check GIB status — Query the current status of an e-fatura submission (pending, accepted, rejected).
Security
- MD5 password hashing — Talos automatically hashes your API password using MD5 before sending it to Mikro. You enter the plain-text password; Talos handles the rest.
- Rate limits — Mikro enforces rate limits: 100 authentication requests per hour and 1,000 stock/data queries per day. Talos respects these limits automatically.
- Network security — The API runs on your local network. Ensure port 8094 is firewalled from the public internet and only accessible from trusted machines.
Troubleshooting
| Problem | Solution |
|---|---|
| Connection refused on port 8094 | Check that the Mikro API service is running on the server. Verify port 8094 is open in the firewall. Try telnet <server-ip> 8094 from the Talos machine. |
| Authentication fails / wrong password | Make sure you are using the API password, not the Mikro login password. They are different. Also verify FirmaKodu and KullaniciKodu are correct. |
| Method not found / V2 errors | Some older Mikro installations use V1 method names (e.g. FaturaToEFatura instead of FaturaToEFaturaV2). Check your Mikro version and update if needed. |
Useful Links
- Mikro Yazilim — Official Mikro Yazilim website — accounting and ERP solutions
- Mikro API Documentation — Mikro REST API documentation for developers
- Mikro API Community Docs — Community Mikro API documentation and examples