API
API
Meie liidesed on kättesaadavad ka otse HTTP API kaudu, kui soovid neid kasutada oma rakenduses.
Kui sinu platvorm ei ole WooCommerce ega Shopify, saad samu liideseid kasutada otse API kaudu. Võta ühendust ja saadame dokumentatsiooni ning testvõtmed.
Tellimuste API (Lovable ja eritellimusel e-poed)
Kui e-pood on tehtud Lovable'is, Boltis, v0-s või ise programmeeritud, saadab pood iga makstud tellimuse sellele aadressile ning e-liides teeb sellest arve sinu majandustarkvarasse (Merit Aktiva, SmartAccounts, SimplBooks, Standard Books või Erply). Litsentsi saab tellida Lovable platvormi moodulite alt.
Aadress
POST https://www.eliides.ee/api/lovable/orders
Autentimine
Authorization: Bearer <licence key>
Content-Type: application/json
Litsentsi võti päises "Authorization: Bearer <võti>". Päring tuleb teha serveri poolelt (nt Supabase Edge Function) — võti ei tohi brauserisse sattuda.
Väljad
| Väli | Kirjeldus |
|---|---|
| id kohustuslik | Poe enda unikaalne tellimuse ID (tekst). Sama tellimuse korduv saatmine on ohutu — arve tehakse üks kord. |
| number kohustuslik | Kliendile näidatav tellimuse number. Sellest saab arve number (koos seadetes määratud prefiksiga). |
| created_at kohustuslik | Tellimuse aeg, ISO 8601. |
| status kohustuslik | "paid", "pending", "cancelled" või "refunded". Arve tehakse ainult makstud tellimusest. |
| currency | Valuuta, vaikimisi "EUR". |
| prices_include_tax | true, kui hinnad sisaldavad käibemaksu (vaikimisi), false, kui hinnad on käibemaksuta. |
| total kohustuslik | Kliendi makstud summa. Peab võrduma ridade ja transpordi summaga (lubatud kõrvalekalle 0,05). |
| customer | first_name, last_name, email, phone; ettevõtte puhul ka company, reg_code ja vat_number. |
| billing_address | address1, address2, city, postal_code, country_code (kahetäheline ISO kood). |
| shipping_address | Sama kujuga kui billing_address. Võib puududa. |
| lines kohustuslik | Tellimuse read: sku, name, quantity, unit_price (ühe toote hind), tax_rate (käibemaksu %, nt 24), discount (kogu rea allahindlus). |
| shipping | Transport: name, sku, price, tax_rate, discount. Tasuta transpordi korral jäta ära. |
| payment | method — makseviisi lühikood, nt "montonio" (seadetes saab igale makseviisile oma konto määrata); amount — makstud summa. |
Näidistellimus
{
"id": "6f1c2a0e-1b2d-4c9e-9a51-0d7e3f2b8c11",
"number": "1042",
"created_at": "2026-11-13T12:00:00Z",
"status": "paid",
"currency": "EUR",
"prices_include_tax": true,
"total": 57.29,
"customer": {
"first_name": "Mari",
"last_name": "Maasikas",
"email": "mari@example.com",
"phone": "+3725550000",
"company": null,
"reg_code": null,
"vat_number": null
},
"billing_address": {
"address1": "Tartu mnt 1",
"address2": null,
"city": "Tallinn",
"postal_code": "10115",
"country_code": "EE"
},
"shipping_address": null,
"lines": [
{
"sku": "TSHIRT-M",
"name": "T-shirt, M",
"quantity": 2,
"unit_price": 19.9,
"tax_rate": 24,
"discount": 0
},
{
"sku": "MUG-01",
"name": "Mug",
"quantity": 1,
"unit_price": 15,
"tax_rate": 24,
"discount": 1.5
}
],
"shipping": {
"name": "Parcel locker",
"sku": "SHIPPING",
"price": 3.99,
"tax_rate": 24,
"discount": 0
},
"payment": {
"method": "montonio",
"amount": 57.29
}
}
Koodinäide
Abifunktsioon Supabase Edge Functioni või Next.js-i serveripoolse koodi jaoks. Kutsu seda makseteenuse webhookist, kui tellimus on makstud, tühistatud või tagastatud — mitte brauserist.
// Call from your server code once an order is paid, cancelled or refunded,
// e.g. in the payment provider's webhook handler. Never from the browser.
// `order` is the order in the format described above.
export async function sendToEliides(order: Record<string, unknown>) {
// Supabase Edge Function (Deno). In Node / Next.js: process.env.ELIIDES_API_KEY
const key = Deno.env.get("ELIIDES_API_KEY");
if (!key) throw new Error("ELIIDES_API_KEY is not set");
for (let attempt = 1; attempt <= 3; attempt++) {
try {
const res = await fetch("https://www.eliides.ee/api/lovable/orders", {
method: "POST",
headers: {
"Authorization": `Bearer ${key}`,
"Content-Type": "application/json",
},
body: JSON.stringify(order),
});
const body = await res.json().catch(() => ({}));
if (res.ok) return body; // { ok: true, state: "queued", ... }
if (res.status < 500) {
// 4xx: the key or the data is wrong. Retrying will not help;
// body.errors says what to fix.
console.error("e-liides refused the order", res.status, body);
return body;
}
} catch (error) {
console.error("e-liides could not be reached", error);
}
await new Promise((resolve) => setTimeout(resolve, 1000 * 2 ** attempt));
}
throw new Error("e-liides did not accept the order after 3 attempts");
}
Vastused
| 201 / 200 | Tellimus võeti vastu. Väli "state" ütleb, mis edasi saab: queued (arve tehakse mõne minuti jooksul), stored (ootab liidese aktiveerimist), ignored (maksmata, arvet ei tehta), invoiced (arve on juba tehtud), credit_queued (kreeditarve tehakse mõne minuti jooksul). |
| 422 | Andmed ei vasta nõuetele. Väli "errors" ütleb, mida parandada. |
| 401 / 402 / 403 | Võti puudub või on vale, litsents on aegunud või võti ei ole Lovable mooduli oma. |
Võrguvea või 5xx vastuse korral proovi uuesti (nt 3 korda kasvava vahega). 4xx vastuseid ei ole mõtet korrata.
Tühistamine ja tagastus
Kui juba arveldatud tellimus tühistatakse või tagastatakse täielikult, saada sama tellimus uuesti olekuga "cancelled" või "refunded". E-liides teeb kogu tellimuse kohta kreeditarve, mille number on algse arve number lõpuga "-K". Osalise tagastuse kreeditarve tuleb teha majandustarkvaras käsitsi. Erply puhul tuleb kreeditarve alati teha käsitsi.
Ühenduse test
Tühi POST päring samale aadressile lõpuga /ping koos sama päisega vastab {"ok": true, ...}, kui võti töötab.
POST https://www.eliides.ee/api/lovable/ping