rivile-api-client

Rivilė GAMA REST API Client (@suderinta/rivile-api-client)

TypeScript License: MIT Maintained by Suderinta.lt

Oficiali, pilnai tipizuota TypeScript/Node.js kliento biblioteka darbui su Rivilė GAMA ERP REST API.

Sukurta ir prižiūrima Suderinta.lt inžinierių komandos, diegiančios individualias CRM sistemas, klientų savitarnos portalus ir buhalterinių sistemų integracijas Lietuvos verslui.


⚡ Galimybės (Features)


📦 Diegimas (Installation)

npm install @suderinta/rivile-api-client

arba:

pnpm add @suderinta/rivile-api-client

🚀 Greitas startas (Quickstart)

import { RivileApiClient } from "@suderinta/rivile-api-client";

// Inicializavimas su Rivilės API raktu
const rivile = new RivileApiClient({
  apiKey: process.env.RIVILE_API_KEY!,
  baseUrl: "https://api.rivile.lt/v2", // arba jūsų tarpinio serverio adresas
});

async function run() {
  // 1. Klientų paieška pagal pavadinimą arba kodą
  const clients = await rivile.getClients({ search: "Maxima" });
  console.log("Rasti klientai:", clients);

  // 2. Naujo kliento sukūrimas iš CRM
  await rivile.upsertClient({
    code: "KLI-00129",
    name: "UAB Naujas Klientas",
    companyCode: "301844044",
    vatCode: "LT100004242415",
    address: "Gedimino pr. 1, Vilnius",
    email: "info@klientas.lt",
    isBuyer: true,
  });

  // 3. Pardavimo sąskaitos faktūros įregistravimas
  const invoice = await rivile.createSalesInvoice({
    series: "SUD",
    docNumber: "2026-0042",
    docDate: "2026-10-09",
    clientCode: "KLI-00129",
    items: [
      {
        itemCode: "PRG-01",
        quantity: 1,
        price: 1500.0,
        vatRate: 21,
      },
    ],
  });
  console.log("Sąskaita sukurta:", invoice);
}

run().catch(console.error);

📚 Išsamūs integracijų gidai ir architektūra

Detalią architektūrą, kaip teisingai sujungti CRM su Rivilė GAMA ir automatizuoti duomenų teikimą į VMI i.MAS (i.SAF / i.VAZ), rasite mūsų techniniame gide:


🏢 Reikia pagalbos integruojant Rivilę?

Jeigu jūsų įmonei reikalinga nestandartinė integracija tarp CRM, el. komercijos platformos (Shopify, WooCommerce, Magento) ar gamybos valdymo sistemos ir Rivilės:


📄 Licencija

MIT © Suderinta.lt