Liigu sisu juurde

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.

Vaata Lovable mooduleid →

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