API Dokumentācija
Integrējiet erekini.eu jūsu sistēmās. Automatizējiet rēķinu izrakstīšanu un klientu pārvaldību ar mūsu REST API.
🚀Ātrais sākums
1. Iegūstiet API atslēgu
Dodieties uz Organizācijas iestatījumi → API un ģenerējiet jaunu API atslēgu.
2. Autentifikācija
Visiem pieprasījumiem jāsatur Authorization header ar Bearer token:
curl
curl -X GET "https://www.erekini.eu/api/v1/invoices" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"Read Operations
60 pieprasījumi/min
Write Operations
30 pieprasījumi/min
● Health Check
Kļūdu kodi
400
Bad Request
Nepareizi pieprasījuma parametri
401
Unauthorized
Nederīga vai trūkstoša API atslēga
403
Forbidden
Nav atļaujas veikt šo darbību
404
Not Found
Resurss neeksistē
429
Too Many Requests
Pārsniegts pieprasījumu limits
500
Internal Server Error
Servera kļūda, mēģiniet vēlreiz
Koda piemēri
⚡ JavaScript / Node.js
fetch-invoices.js
const API_KEY = 'your-api-key';
const BASE_URL = 'https://www.erekini.eu/api/v1';
async function getInvoices() {
const response = await fetch(`${BASE_URL}/invoices?status=issued`, {
headers: {
'Authorization': `Bearer ${API_KEY}`,
'Content-Type': 'application/json'
}
});
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
return response.json();
}
async function createInvoice(clientId, items) {
const response = await fetch(`${BASE_URL}/invoices`, {
method: 'POST',
headers: {
'Authorization': `Bearer ${API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
client_id: clientId,
due_date: '2026-02-10',
items: items
})
});
return response.json();
}🐍 Python
invoices.py
import requests
API_KEY = 'your-api-key'
BASE_URL = 'https://www.erekini.eu/api/v1'
headers = {
'Authorization': f'Bearer {API_KEY}',
'Content-Type': 'application/json'
}
# Get all invoices
def get_invoices(status=None):
params = {'status': status} if status else {}
response = requests.get(f'{BASE_URL}/invoices', headers=headers, params=params)
response.raise_for_status()
return response.json()
# Create invoice
def create_invoice(client_id, items, due_date):
data = {
'client_id': client_id,
'due_date': due_date,
'items': items
}
response = requests.post(f'{BASE_URL}/invoices', headers=headers, json=data)
response.raise_for_status()
return response.json()MCP serveris
Bezmaksas MCP serveris, ko var pievienot jebkuram AI asistentam, kas atbalsta attālinātus MCP serverus. Tas nolasa strukturētu e-rēķinu (UBL 2.1, Peppol BIS Billing 3.0, EN 16931) un atdod to salasāmā veidā vai kā PDF. Nav vajadzīga atslēga un nav vajadzīgs konts.
Servera adrese
https://www.erekini.eu/api/public/mcpKā pievienot
- 1.Nokopē adresi augstāk.
- 2.Ielīmē to sava asistenta MCP serveru konfigurācijā.
- 3.Palūdz asistentam nolasīt e-rēķina XML failu.
Pieejamie rīki
read_einvoice- Nolasa XML un atdod piegādātāju, saņēmēju, pozīcijas, PVN un summas. Ja dokumenta norādītā kopsumma nesakrīt ar to, ko dod paša dokumenta rindas, tas tiek pateikts atsevišķi.
einvoice_to_pdf- Pārvērš to pašu XML par PDF, ko var izdrukāt vai pārsūtīt cilvēkam, kurš XML nelasa.
latvian_vat- Aprēķina PVN abos virzienos pēc Latvijas likmēm (21%, 12%, 5%, 0%) un pēc izvēles pārbauda 50 000 eiro reģistrācijas slieksni. Likme ārpus šī saraksta tiek atteikta, nevis aprēķināta: to pašu kopu erekini.eu piemēro reāliem rēķiniem.
latvian_late_payment_interest- Aprēķina līgumsodu pēc dienas likmes un likumiskos procentus 6% gadā blakus, ar brīdinājumu, ja summa pārsniedz 10% no pamatparāda. Asistents saņem aprēķinu, nevis aptuvenu skaitli.
Drošība
Serveris tikai lasa. Tas neko neraksta, nesaglabā dokumentu un neseko nevienai saitei dokumentā. Faili ar DOCTYPE vai ENTITY tiek atteikti, un lielākais pieļaujamais izmērs ir 5 MB.