Produs nou · Beta · Saga API

DE LAVeziv IT Services, București

CĂTREFirma ta

Saga API: SAGA Web, legat de orice program

SAGA Web nu are un API public, așa că facturile din magazin, clienții din CRM și stocul din depozit se introduc de mână a doua oară. Saga API leagă SAGA Web de orice program: citește și scrie direct în contabilitate, cu regulile SAGA păstrate.

Cere un demo Scrie-ne

Demoîn curând

Pregătim un demo public, cu documentația interactivă legată de o firmă de test SAGA. Până atunci îți arătăm Saga API live, la o întâlnire.

Demo Saga API · în curând

Cum funcționează

Ce intră în modul, ce se întâmplă acolo și unde pleacă datele mai departe.

Ce intră

Comenzile și cliențiimagazinul online
Partenerii și oferteleCRM sau ERP
Facturile furnizoriloraprovizionare sau e-Factura
Comenzile de producțieatelier

Saga API: SAGA Web, legat de orice programVZV

Ce face modulul

01Primește cererea, cu cheia API a firmei
02Scrie în SAGA Web cu regulile de validare SAGA
03Validează documentul: stoc și note contabile
04Întoarce rezultatul calculat de SAGA

Ce iese și unde

Facturi, NIR-uri, transferuri validateSAGA Web
Stocul și prețurile la zimagazin și ERP
Creanțe, scadențe, rapoartepanouri și BI
Partenerii sincronizațiCRM

Programul de facturare, magazinul online și CRM-ul știu de comenzi, clienți și stoc. SAGA știe de contabilitate. Între ele stă un om care copiază: factura din magazin intră a doua oară în SAGA, clientul nou din CRM se scrie din nou, iar stocul din site e ieri.

Saga API pune un API în fața contabilității din SAGA Web. Programele tale cer și trimit date printr-o adresă web și o cheie, iar SAGA le primește ca pe documentele introduse de mână: le verifică, le validează, mișcă stocul și face notele contabile.

Ce primești

Peste 650 de operații pe aproape 200 de tabele din SAGA Web: clienți, furnizori, articole, gestiuni, plan de conturi, facturi emise și primite în lei și valută, transferuri, bonuri de consum, producție, inventariere, mijloace fixe, salariați.
Validare ca în SAGA. Validarea devine un apel API: stocul se mișcă, notele contabile se fac singure, iar devalidarea le anulează.
Totaluri calculate de SAGA. Trimiți cantitatea și prețul, iar valoarea, TVA-ul, totalul și contul analitic al partenerului le face SAGA.
Rapoarte la îndemână. Jurnale de TVA, D300, D394, SAF-T, bilanț, fișe de cont, situații de stoc și vânzări, scadențar.
Liste gata făcute. Circa 290 de liste SAGA (județe, localități, unități de măsură, gestiuni), ca datele trimise să fie corecte.
Documentație interactivă. Swagger cu exemple complete pentru fiecare endpoint și un mediu de test separat de producție.

Ce e încă în beta

Încasările și plățile, ordinele de plată, cecurile, notele contabile compuse, statele de salarii, comenzile și contractele se citesc prin API; scrierea lor vine în versiunile următoare.
Transmiterea e-Factura și e-Transport rămâne în SAGA; prin API citești starea și răspunsurile din SPV.

Fluxuri reale, cap-coadă

Cum arată o integrare adevărată, pas cu pas, cu apelurile exacte. Fiecare flux pornește din alt program și ajunge în SAGA Web.

Comanda din magazinul online devine factură în SAGA01

comanda plătită
x-api-key
stoc scăzut, note contabile

1Clientul există în SAGA? Îl cauți după CUI.GET /api/clienti?cauta=RO123&mod=exact
2Dacă nu există, îl adaugi. Contul analitic se face singur.POST /api/clienti
3Găsești fiecare produs după cod sau cod de bare.GET /api/articole?cauta=SKU
4Creezi factura: număr, client, dată, scadență.POST /api/iesiri
5Adaugi liniile: produs, gestiune, cantitate, preț, TVA.POST /api/iesiri/detalii?masterId={id}
6Verifici totalurile calculate de SAGA.GET /api/iesiri/{id}
7Validezi: stocul scade și se fac notele contabile.POST /api/iesiri/{id}/validare
8Trimiți stocul nou înapoi în magazin.GET /api/articole/{cod}

Catalogul și stocul din SAGA ajung în magazin sau în ERP02

articole, prețuri, stoc
x-api-key
catalog la zi

1Citești toate articolele: cod, denumire, preț, TVA, cod de bare, stoc.GET /api/articole?toate=true
2Iei gestiunile și grupele, ca să le potrivești cu categoriile tale.GET /api/gestiuni · GET /api/grupe/articole
3Repeți la câteva minute: se schimbă doar stocul și prețurile.GET /api/articole?coloane=Cod,Stoc,PretVanzare

Partenerii din CRM sau ERP, sincronizați cu SAGA03

client nou sau modificat
x-api-key
cu cont analitic

1Citești clienții și furnizorii existenți în SAGA.GET /api/clienti?toate=true
2Iei valorile corecte pentru județ și localitate.GET /api/liste/Judet · GET /api/liste/Localitate
3Adaugi clientul nou; codul vine singur dacă nu-l dai tu.POST /api/clienti
4Când se schimbă adresa sau contul bancar, trimiți doar câmpul modificat.PATCH /api/clienti/{cod}

Factura furnizorului devine NIR în SAGA04

din e-Factura sau din aprovizionare
x-api-key
stoc crescut, 371 = 401

1Cauți furnizorul după CUI; dacă lipsește, îl adaugi.GET /api/furnizori?cauta=RO456 · POST /api/furnizori
2Găsești sau adaugi articolele de pe factură.GET /api/articole · POST /api/articole
3Creezi factura de intrare.POST /api/intrari
4Adaugi liniile: marfă pe 371 sau servicii pe 628.POST /api/intrari/detalii?masterId={id}
5Validezi: stocul crește și se fac notele contabile.POST /api/intrari/{id}/validare

Producție: din materii prime în produs finit05

din atelier sau ERP
x-api-key
materiale consumate

1Muți materiile prime în gestiunea de producție.POST /api/transferuri · /detalii · /validare
2Citești rețeta produsului.GET /api/articole/retete?masterId={produs}
3Înregistrezi producția și materialele consumate după rețetă.POST /api/productie · POST /api/productie/detalii
4Validezi: materialele ies, produsul finit intră în stoc.POST /api/productie/{id}/validare

Cine îți datorează bani: creanțele, într-un panou06

facturi neachitate
x-api-key
scadențe și restanțe

1Citești facturile emise, cu suma neachitată și scadența.GET /api/iesiri?toate=true
2Vezi ce încasări s-au legat deja de fiecare factură.GET /api/iesiri/incasari
3Faci la fel pentru furnizori: ce ai tu de plătit.GET /api/intrari · GET /api/intrari/plati

Tot ce poți face prin Saga API

Peste 650 de operații, pe aproape 200 de tabele din SAGA Web. Le-am grupat pe ce faci în firmă, fiecare explicată pe înțelesul tuturor.

citire și scrierecitirecitire · scrierea vine

Clienți și furnizoriFișele partenerilor, cu cont analitic creat automat6

GET POST PATCH DELETE/api/clienticitire și scriere
Clienții: denumire, CUI, adresă, județ, cont bancar, telefon, e-mail, grupă. La adăugare se creează singur contul analitic 4111.
GET POST PATCH DELETE/api/furnizoricitire și scriere
Furnizorii, cu aceleași date. La adăugare se creează singur contul analitic 401.
GET/api/clienti/urmatorul-codcitire
Următorul cod liber, ca să nu ghicești codurile.
GET POST PATCH DELETE/api/agenticitire și scriere
Agenții de vânzări.
GET POST PATCH DELETE/api/grupe/clienti · /api/grupe/furnizoricitire și scriere
Grupele de parteneri.
GET/api/situatii-terti/…citire
Situațiile pe parteneri: sold la început și la sfârșit, facturi, scadențar cu zile de întârziere, avize nefacturate, avansuri.

Articole, gestiuni și plan de conturiNomenclatorul firmei, cu stocul curent7

GET POST PATCH DELETE/api/articolecitire și scriere
Articolele: denumire, unitate de măsură, TVA, tip, grupă, preț de vânzare cu și fără TVA, cod de bare, cod NC și CPV. La citire primești și stocul curent.
GET/api/articole/oferta · /api/articole/etichetecitire
Lista de prețuri pentru ofertă și etichetele cu cod de bare.
GET POST PATCH DELETE/api/articole/retetecitire și scriere
Rețetele de producție: ce componente intră și în ce cantitate.
GET POST PATCH DELETE/api/tipuri-articolecitire și scriere
Tipurile de articole și conturile lor de stoc, cheltuială și venit.
GET POST PATCH DELETE/api/gestiunicitire și scriere
Gestiunile: denumire, tip, gestionar, metoda de evaluare.
GET POST PATCH DELETE/api/grupe/articole · /activitati · /proiectecitire și scriere
Grupele de articole, activitățile (cu CAEN) și proiectele.
GET POST PATCH DELETE/api/plan-conturicitire și scriere
Planul de conturi: cont, denumire, tip, cont de închidere, blocat sau nu.

Facturi primite (intrări, NIR)În lei și în valută, cu validare5

GET POST PATCH DELETE/api/intraricitire și scriere
Antetul facturii de la furnizor: număr, furnizor, dată, scadență, TVA la încasare. Înapoi primești valoarea, TVA-ul, totalul și cât e neachitat.
GET POST PATCH DELETE/api/intrari/detaliicitire și scriere
Liniile facturii: articol sau serviciu, gestiune, cantitate, preț, TVA, cont, lot. Valorile se calculează singure.
POST/api/intrari/{id}/validare · /devalidarecitire și scriere
Validarea documentului în SAGA: crește stocul și se fac notele contabile. Devalidarea le anulează.
GET/api/intrari/platicitire
Plățile deja legate de factură.
GET POST PATCH DELETE/api/intrari-valuta (+ /detalii, /validare)citire și scriere
Facturile în valută: monedă, curs, taxe vamale, comisioane, accize.

Facturi emise (ieșiri)În lei și în valută, cu validare5

GET POST PATCH DELETE/api/iesiricitire și scriere
Antetul facturii către client: număr, client, dată, scadență, marcaj e-Factura. Înapoi primești valoarea, TVA-ul, totalul, ce e neachitat și adaosul.
GET POST PATCH DELETE/api/iesiri/detaliicitire și scriere
Liniile facturii: articol, gestiune, cantitate, preț, TVA, cont.
POST/api/iesiri/{id}/validare · /devalidarecitire și scriere
Validarea: scade stocul și se fac notele contabile.
GET/api/iesiri/incasaricitire
Încasările deja legate de factură.
GET POST PATCH DELETE/api/iesiri-valuta (+ /detalii, /validare)citire și scriere
Facturile în valută, cu monedă și curs.

e-FacturaCe s-a transmis și ce a venit din SPV3

GET/api/e-factura/e-fact-generare-si-transmiterecitire
Facturile cu starea lor în e-Factura.
GET/api/e-factura/e-fact-raspunsuricitire
Răspunsurile din SPV: recipisa și tipul mesajului.
GET/api/e-factura/e-fact-import…citire
Facturile emise și primite descărcate din SPV, cu liniile lor.

Stocuri și producțieDocumentele care mută marfa, cu validare7

GET POST PATCH DELETE/api/transferuri (+ /detalii, /validare)citire și scriere
Transferurile între gestiuni.
GET POST PATCH DELETE/api/bonuri (+ /detalii, /validare)citire și scriere
Bonurile de consum.
GET POST PATCH DELETE/api/productie (+ /detalii, /comenzi, /validare)citire și scriere
Producția: produsul finit, materialele consumate și comenzile de producție.
GET POST PATCH DELETE/api/inventarierecitire și scriere
Inventarierea: plusuri, minusuri și diferențe.
GET POST PATCH DELETE/api/bonuri-oi/…citire și scriere
Obiectele de inventar date în folosință și casate.
GET POST PATCH DELETE/api/operatii-speciale · /api/reglari-descarcarecitire și scriere
Operațiile speciale și reglările de descărcare.
GET/api/fise-articole · /api/situatii-stocuri · /api/situatii-vanzari · …citire
Fișa articolului, stocurile pe gestiuni, aprovizionările, vânzările cu adaos, consumurile, producția, ambalajele SGR, raportul de gestiune.

Casă, bancă și plățiSolduri, încasări, plăți, cecuri5

GET POST PATCH DELETE/api/registru-casa/solduricitire și scriere
Soldurile zilnice de casă și bancă.
GET/api/registru-casa/casacitire · scrierea vine
Înregistrările de casă, bancă și deconturi, cu sumă, monedă, curs, explicație.
GET/api/registru-casa/casa-detaliicitire
Ce facturi a stins fiecare încasare sau plată.
GET/api/jurnal-de-banca/opcitire · scrierea vine
Ordinele de plată: plătitor, beneficiar, IBAN, sumă.
GET/api/cecuri · /api/situatii-cecuri/…citire · scrierea vine
Cecurile și biletele la ordin, primite și emise.

Note contabile, registre și închidere de lunăTot ce iese din contabilitate6

GET/api/registrucitire · scrierea vine
Notele contabile: dată, cont debitor, cont creditor, sumă, explicație.
GET POST PATCH DELETE/api/inregistrare-cheltuieli-venituricitire și scriere
Cheltuielile și veniturile în avans.
GET/api/fise-conturi/… · /api/carte-mare/…citire
Fișele de cont și cartea mare.
GET/api/registru-jurnal · /api/registru-inventarcitire
Registrul jurnal și registrul inventar.
GET/api/inchidere-luna/…citire
Închiderea de lună: impozitul pe profit sau pe venit, D100, D101, diferențele de curs.
GET/api/situatii-managerialecitire
Costurile, veniturile și profitul pe fiecare activitate.

TVA, declarații și bilanțDatele din jurnale, SAF-T și situațiile financiare6

GET/api/jurnal-cumparari-vanzari/…citire
Jurnalele de cumpărări și vânzări, D300, D301, D394, D390 și OSS.
GET/api/saft/…citire
Secțiunile SAF-T (D406): plan de conturi, parteneri, produse, stocuri, active, jurnal, plăți.
GET/api/bilant/…citire
Bilanțul: contul de profit și pierdere, datele informative, notele explicative, activele imobilizate.
GET/api/declaratia-intrastat/…citire
Intrastat, la intrare și la expediere.
GET POST PATCH DELETE/api/declaratia205 (+ /detalii, /salariati)citire și scriere
Datele pentru D205.
GET POST PATCH DELETE/api/e-transport (+ /detalii)citire și scriere
Datele pentru e-Transport, cu codul UIT și starea.

Salariați și salariiFișele oamenilor și statele de plată4

GET POST PATCH DELETE/api/salariati (+ /intretinuti, /zilieri)citire și scriere
Salariații: nume, cod COR, funcție, data angajării, normă, persoanele în întreținere și zilierii.
GET/api/state-salarii/…citire · scrierea vine
Statele de plată: brut, net, contribuții, pe angajați permanenți și zilieri.
GET POST PATCH DELETE/api/configurare-salarii/…citire și scriere
Orele suplimentare, primele și sporurile.
GET POST PATCH DELETE/api/diurne · /api/actionaricitire și scriere
Diurnele și acționarii.

Comenzi și contracteCe s-a comandat și ce se facturează periodic3

GET/api/comenzi/… · /api/situatii-comenzicitire · scrierea vine
Comenzile, cu livrările, zilele de întârziere și factura.
GET/api/contracte/… · /api/contracte/ratecitire · scrierea vine
Contractele, cu ratele și facturile de generat.
GET POST PATCH DELETE/api/contracte/tipuri-contractecitire și scriere
Tipurile de contracte.

Mijloace fixe și mașiniImobilizări, amortizare, parc auto3

GET POST PATCH DELETE/api/imobilizari (+ /operatiuni-imobilizari)citire și scriere
Mijloacele fixe: număr de inventar, clasă, valoare, durată, metoda de amortizare, conturi și operațiile lor.
GET/api/imobilizari/plan-de-amortizare · /registrul-imobilizarilorcitire
Planul de amortizare și registrul imobilizărilor.
GET POST PATCH DELETE/api/masini (+ /foi-parcurs, /asigurari-revizii)citire și scriere
Mașinile, foile de parcurs, asigurările și reviziile.

UtilitareCe îți trebuie ca să lucrezi comod2

GET/api/liste/{lista}citire
Valorile din listele SAGA (circa 290): județe, localități, unități de măsură, gestiuni, articole.
POST/api/fluxuri/aprovizionare · /vanzare · /transfer · /productiecitire și scriere
Scenarii complete într-un singur apel, cu anulare completă (/api/fluxuri/anulare). Bune pentru teste și demonstrații.

Cum se leagă de SAGA

Nu instalezi nimic. Conectăm firma ta la Saga API o singură dată, iar aplicațiile tale primesc o cheie API.

01Conectăm firma
Legăm firma ta din SAGA Web de Saga API, cu acordul tău. O facem o singură dată, iar Saga API te anunță din timp dacă legătura trebuie reînnoită.
02Primești cheia API
Aplicațiile tale trimit cheia la fiecare cerere. Fără cheie, Saga API nu răspunde, iar site-urile care îl pot apela din browser sunt doar cele pe care le aprobi tu.
03Test și producție
Poți lega o firmă de test și firma reală în paralel și alegi pe fiecare cerere unde scrii. Producția cere o confirmare în plus.
04Documentația interactivă
Fiecare endpoint are exemple complete în Swagger (OpenAPI): îl încerci din browser înainte să scrii o linie de cod.
05Mai multe firme
Fiecare firmă are conexiunea ei, separată de celelalte. Un cabinet contabil sau un grup leagă câte firme are nevoie.

Regulile de validare SAGA rămân active: dacă SAGA refuză o operație, primești motivul în răspuns.
Totalurile, TVA-ul și conturile analitice le calculează SAGA, nu aplicația ta.
Documentele validate se pot devalida și șterge tot prin API, ca să corectezi o greșeală.

Se leagă cu

Întrebări frecvente

SAGA are API?

SAGA Web nu oferă un API public pentru programele tale. Saga API îți dă unul: endpoint-uri REST documentate, cu peste 650 de operații pe aproape 200 de tabele din SAGA Web.

Merge și cu SAGA instalat pe calculator?

Nu. Saga API lucrează cu SAGA Web, versiunea online. Dacă folosești SAGA pe calculator, întreabă-ne cum treci pe SAGA Web.

Ce trebuie să instalez în SAGA?

Nimic. Conectăm firma ta din SAGA Web la Saga API o singură dată, cu acordul tău, iar aplicațiile tale primesc o cheie API. Restul îl configurăm noi.

Se pot strica datele din contabilitate?

Regulile de validare SAGA rămân active: SAGA verifică fiecare document ca atunci când lucrezi pe ecran și refuză ce nu e corect. Poți lega în paralel o firmă de test, iar documentele validate se pot devalida și șterge prin API.

Ce nu poate face încă?

În beta, încasările și plățile, ordinele de plată, notele contabile compuse, statele de salarii, comenzile și contractele se citesc prin API, dar încă nu se scriu. Transmiterea e-Factura rămâne în SAGA.

Cât costă?

Depinde de câte firme legi și de integrarea de care ai nevoie (magazin, ERP, CRM, rapoarte). Cere o demonstrație și îți arătăm Saga API pe firma de test SAGA.