# @suderintalt/rivile-api-client

[![npm version](https://img.shields.io/npm/v/@suderintalt/rivile-api-client.svg)](https://www.npmjs.com/package/@suderintalt/rivile-api-client)
[![license](https://img.shields.io/npm/l/@suderintalt/rivile-api-client.svg)](https://github.com/jjonasjj/peakbask-lt/blob/main/LICENSE)
[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
[![Developed by Suderinta.lt](https://img.shields.io/badge/Developed%20by-Suderinta.lt-10b981.svg)](https://www.suderinta.lt)

Oficiali **TypeScript** biblioteka ir REST API klientas darbui su **Rivilė GAMA** ir **Rivilė ERP** apskaitos sistemomis. Sukurta ir palaikoma [Suderinta.lt](https://www.suderinta.lt) inžinerijos komandos, skirtas automatizuoti duomenų apsikeitimą tarp individualių CRM sistemų, B2B savitarnos portalų ir buhalterinės apskaitos.

Daugiau informacijos apie architektūrą ir integracijų praktiką rasite išsamiame gide:  
👉 **[CRM integracija su Rivilė ir i.MAS: techninis gidas ir architektūra](https://www.suderinta.lt/blog/crm-integracija-su-rivile-ir-imas)**.

---

## Funkcionalumas

* ⚡ **Pilnas TypeScript tipizavimas:** visi Rivilė REST API užklausų ir atsakymų objektai griežtai aprašyti tipais.
* 📦 **Klientų valdymas:** automatinė pirkėjų ir tiekėjų paieška pagal įmonės kodą arba PVM kodą, naujų klientų sukūrimas.
* 🧾 **PVM sąskaitų-faktūrų generavimas:** pardavimo operacijų kūrimas tiesiai į Rivilės apskaitą realiu laiku.
* 📊 **Likučių ir kainoraščių sinchronizacija:** sandėlio likučių gavimas su galimybe filtruoti pagal padalinius.
* 🛡️ **Atsparumas klaidoms ir Retry logika:** automatinis užklausų pakartojimas tinklo trikdžių ar laikino API perkrovimo atveju.

---

## Diegimas

```bash
npm install @suderintalt/rivile-api-client
# arba
yarn add @suderintalt/rivile-api-client
# arba
pnpm add @suderintalt/rivile-api-client
```

---

## Greitasis startas

```typescript
import { RivileClient } from "@suderintalt/rivile-api-client";

// Inicializuojame klientą su Rivilė REST API raktais
const client = new RivileClient({
  apiKey: process.env.RIVILE_API_KEY!,
  baseUrl: process.env.RIVILE_API_URL || "https://api.rivile.lt/v2",
  timeoutMs: 15000
});

async function main() {
  // 1. Patikriname kliento duomenis pagal įmonės kodą
  const clientData = await client.clients.findByCode("305123456");
  console.log("Rastas klientas:", clientData?.name);

  // 2. Gauname sandėlio likučius
  const stock = await client.inventory.getStock({
    warehouseId: "SANDELIS_1",
    itemCode: "PREKE-001"
  });
  console.log(`Likutis sandėlyje: ${stock.quantity} vnt.`);

  // 3. Sukuriame pardavimo sąskaitą-faktūrą
  const invoice = await client.invoices.create({
    clientCode: "305123456",
    docDate: new Date().toISOString().split("T")[0],
    items: [
      {
        itemCode: "PASLAUGA-01",
        name: "IT sistemų architektūros auditas",
        quantity: 1,
        priceWithoutVat: 1200,
        vatRate: 21
      }
    ]
  });

  console.log("Sąskaita sėkmingai sukurta Rivilėje:", invoice.docNumber);
}

main().catch(console.error);
```

---

## Architektūros kontekstas ir verslo sprendimai

Ši biblioteka yra atvirojo kodo dalis, sukurta remiantis patirtimi diegiant individualias verslo valdymo sistemas Lietuvos įmonėms:

* **[Individualios CRM sistemos](https://www.suderinta.lt/lp/crm-sistema)** – pritaikytos didmeninei prekybai, logistikai ir gamybai.
* **[Klientų savitarnos portalai](https://www.suderinta.lt/sprendimai/klientu-savitarnos-portalai)** – leidžiantys B2B klientams tiesiogiai teikti užsakymus ir matyti savo sąskaitų likučius realiu laiku iš Rivilės.
* **[Procesų automatizavimas](https://www.suderinta.lt/lp/procesu-automatizavimas)** – rankinio duomenų vedimo eliminavimas tarp pardavimų, sandėlio ir buhalterijos.

Norite įvertinti jūsų įmonės sistemų sujungimo galimybes? Rezervuokite nemokamą **[30 min. IT architektūros auditą](https://www.suderinta.lt/forma)**.

---

## Licencija

MIT License © 2026 [Suderinta.lt](https://www.suderinta.lt). Sukurta Lietuvos verslui.
