Nuovo prodotto · Beta · Saga API

DAVeziv IT Services, Bucarest

ALa tua azienda

Saga API: SAGA Web, collegato a qualsiasi programma

SAGA Web non ha un'API pubblica, quindi le fatture del negozio, i clienti del CRM e le giacenze del magazzino si inseriscono a mano una seconda volta. Saga API collega SAGA Web a qualsiasi programma: legge e scrive direttamente nella contabilità, mantenendo le regole di SAGA.

Richiedi una demo Scrivici

Demoin arrivo

Stiamo preparando una demo pubblica, con la documentazione interattiva collegata a un'azienda di test SAGA. Nel frattempo te la mostriamo dal vivo.

Demo Saga API · in arrivo

Come funziona

Cosa entra nel modulo, cosa succede lì e dove vanno poi i dati.

Cosa entra

Ordini e clientiil negozio online
Partner e offerteCRM o ERP
Fatture dei fornitoriacquisti o e-Factura
Ordini di produzioneil laboratorio

Saga API: SAGA Web, collegato a qualsiasi programmaVZV

Cosa fa il modulo

01Riceve la richiesta, con la chiave API dell'azienda
02Scrive in SAGA Web con le regole di validazione di SAGA
03Convalida il documento: magazzino e scritture contabili
04Restituisce il risultato calcolato da SAGA

Cosa esce, e dove

Fatture, NIR, trasferimenti convalidatiSAGA Web
Giacenze e prezzi aggiornatinegozio ed ERP
Crediti, scadenze, reportdashboard e BI
Partner sincronizzatiCRM

Il programma di fatturazione, il negozio online e il CRM conoscono ordini, clienti e giacenze. SAGA conosce la contabilità. In mezzo c'è una persona che copia: la fattura del negozio entra una seconda volta in SAGA, il nuovo cliente del CRM si riscrive da capo, e le giacenze sul sito sono quelle di ieri.

Saga API dà un'API alla contabilità di SAGA Web. I tuoi programmi chiedono e inviano dati tramite un indirizzo web e una chiave, e SAGA li riceve come i documenti inseriti a mano: li controlla, li convalida, muove il magazzino e fa le scritture contabili.

Cosa ottieni

Oltre 650 operazioni su quasi 200 tabelle di SAGA Web: clienti, fornitori, articoli, magazzini, piano dei conti, fatture emesse e ricevute in lei e in valuta, trasferimenti, buoni di consumo, produzione, inventario, cespiti, dipendenti.
Convalida come in SAGA. La convalida diventa una chiamata API: il magazzino si muove, le scritture contabili si fanno da sole, e l'annullamento della convalida le cancella.
Totali calcolati da SAGA. Invii quantità e prezzo, e valore, IVA, totale e conto analitico del partner li calcola SAGA.
Report a portata di mano. Registri IVA, D300 (la dichiarazione IVA), D394 (la dichiarazione di acquisti e vendite nazionali), SAF-T, bilancio, schede contabili, situazioni di magazzino e vendite, scadenzario.
Liste pronte. Circa 290 liste SAGA (distretti, località, unità di misura, magazzini), perché i dati inviati siano corretti.
Documentazione interattiva. Swagger con esempi completi per ogni endpoint e un ambiente di test separato dalla produzione.

Cosa è ancora in beta

Incassi e pagamenti, ordini di pagamento, assegni, scritture contabili composte, prospetti paga, ordini e contratti si leggono tramite API; la scrittura arriva nelle prossime versioni.
L'invio a e-Factura ed e-Transport resta in SAGA; tramite API leggi lo stato e le risposte dello SPV (il portale online dell'ANAF).

Flussi reali, dall'inizio alla fine

Come funziona un'integrazione vera, passo per passo, con le chiamate esatte. Ogni flusso parte da un altro programma e arriva in SAGA Web.

L'ordine del negozio online diventa fattura in SAGA01

ordine pagato
x-api-key
giacenza ridotta, scritture contabili

1Il cliente esiste già in SAGA? Lo cerchi per codice fiscale (CUI).GET /api/clienti?cauta=RO123&mod=exact
2Se non esiste, lo aggiungi. Il conto analitico si crea da solo.POST /api/clienti
3Trovi ogni prodotto per codice o codice a barre.GET /api/articole?cauta=SKU
4Crei la fattura: numero, cliente, data, scadenza.POST /api/iesiri
5Aggiungi le righe: prodotto, magazzino, quantità, prezzo, IVA.POST /api/iesiri/detalii?masterId={id}
6Controlli i totali calcolati da SAGA.GET /api/iesiri/{id}
7Convalidi: la giacenza scende e si fanno le scritture contabili.POST /api/iesiri/{id}/validare
8Rimandi la nuova giacenza al negozio.GET /api/articole/{cod}

Il catalogo e le giacenze di SAGA arrivano nel negozio o nell'ERP02

articoli, prezzi, giacenze
x-api-key
catalogo aggiornato

1Leggi tutti gli articoli: codice, denominazione, prezzo, IVA, codice a barre, giacenza.GET /api/articole?toate=true
2Prendi i magazzini e i gruppi, per abbinarli alle tue categorie.GET /api/gestiuni · GET /api/grupe/articole
3Ripeti ogni pochi minuti: cambiano solo giacenze e prezzi.GET /api/articole?coloane=Cod,Stoc,PretVanzare

I partner del CRM o dell'ERP, sincronizzati con SAGA03

cliente nuovo o modificato
x-api-key
con conto analitico

1Leggi i clienti e i fornitori già presenti in SAGA.GET /api/clienti?toate=true
2Prendi i valori corretti per distretto e località.GET /api/liste/Judet · GET /api/liste/Localitate
3Aggiungi il nuovo cliente; il codice si assegna da solo se non lo indichi tu.POST /api/clienti
4Quando cambiano l'indirizzo o il conto bancario, invii solo il campo modificato.PATCH /api/clienti/{cod}

La fattura del fornitore diventa NIR in SAGA04

da e-Factura o dagli acquisti
x-api-key
giacenza aumentata, 371 = 401

1Cerchi il fornitore per codice fiscale; se manca, lo aggiungi.GET /api/furnizori?cauta=RO456 · POST /api/furnizori
2Trovi o aggiungi gli articoli della fattura.GET /api/articole · POST /api/articole
3Crei la fattura di entrata.POST /api/intrari
4Aggiungi le righe: merce sul conto 371 o servizi sul 628.POST /api/intrari/detalii?masterId={id}
5Convalidi: la giacenza aumenta e si fanno le scritture contabili.POST /api/intrari/{id}/validare

Produzione: dalle materie prime al prodotto finito05

dal laboratorio o dall'ERP
x-api-key
materiali consumati

1Sposti le materie prime nel magazzino di produzione.POST /api/transferuri · /detalii · /validare
2Leggi la distinta del prodotto.GET /api/articole/retete?masterId={produs}
3Registri la produzione e i materiali consumati secondo la distinta.POST /api/productie · POST /api/productie/detalii
4Convalidi: i materiali escono, il prodotto finito entra a magazzino.POST /api/productie/{id}/validare

Chi ti deve soldi: i crediti, in un pannello06

fatture non pagate
x-api-key
scadenze e arretrati

1Leggi le fatture emesse, con l'importo non pagato e la scadenza.GET /api/iesiri?toate=true
2Vedi quali incassi sono già collegati a ogni fattura.GET /api/iesiri/incasari
3Fai lo stesso per i fornitori: quello che devi pagare tu.GET /api/intrari · GET /api/intrari/plati

Tutto quello che puoi fare con Saga API

Oltre 650 operazioni, su quasi 200 tabelle di SAGA Web. Le abbiamo raggruppate in base a quello che fai in azienda, ognuna spiegata in modo semplice.

lettura e scritturaletturalettura · la scrittura arriva

Clienti e fornitoriLe schede dei partner, con il conto analitico creato in automatico6

GET POST PATCH DELETE/api/clientilettura e scrittura
I clienti: denominazione, codice fiscale (CUI), indirizzo, distretto, conto bancario, telefono, e-mail, gruppo. Quando ne aggiungi uno, il conto analitico 4111 si crea da solo.
GET POST PATCH DELETE/api/furnizorilettura e scrittura
I fornitori, con gli stessi dati. Quando ne aggiungi uno, il conto analitico 401 si crea da solo.
GET/api/clienti/urmatorul-codlettura
Il prossimo codice libero, così non devi indovinare i codici.
GET POST PATCH DELETE/api/agentilettura e scrittura
Gli agenti di vendita.
GET POST PATCH DELETE/api/grupe/clienti · /api/grupe/furnizorilettura e scrittura
I gruppi di partner.
GET/api/situatii-terti/…lettura
Le situazioni per partner: saldo iniziale e finale, fatture, scadenzario con giorni di ritardo, documenti di trasporto non fatturati, anticipi.

Articoli, magazzini e piano dei contiL'anagrafica articoli dell'azienda, con la giacenza attuale7

GET POST PATCH DELETE/api/articolelettura e scrittura
Gli articoli: denominazione, unità di misura, IVA, tipo, gruppo, prezzo di vendita con e senza IVA, codice a barre, codice NC (doganale) e CPV. In lettura ricevi anche la giacenza attuale.
GET/api/articole/oferta · /api/articole/etichetelettura
Il listino prezzi per le offerte e le etichette con codice a barre.
GET POST PATCH DELETE/api/articole/retetelettura e scrittura
Le distinte di produzione: quali componenti entrano e in che quantità.
GET POST PATCH DELETE/api/tipuri-articolelettura e scrittura
I tipi di articolo e i loro conti di magazzino, di costo e di ricavo.
GET POST PATCH DELETE/api/gestiunilettura e scrittura
I magazzini: denominazione, tipo, magazziniere, metodo di valutazione.
GET POST PATCH DELETE/api/grupe/articole · /activitati · /proiectelettura e scrittura
I gruppi di articoli, le attività (con il codice di attività CAEN) e i progetti.
GET POST PATCH DELETE/api/plan-conturilettura e scrittura
Il piano dei conti: conto, denominazione, tipo, conto di chiusura, bloccato o no.

Fatture ricevute (entrate, NIR)In lei e in valuta, con convalida5

GET POST PATCH DELETE/api/intrarilettura e scrittura
L'intestazione della fattura del fornitore: numero, fornitore, data, scadenza, IVA per cassa. In risposta ricevi valore, IVA, totale e quanto resta da pagare.
GET POST PATCH DELETE/api/intrari/detaliilettura e scrittura
Le righe della fattura: articolo o servizio, magazzino, quantità, prezzo, IVA, conto, lotto. I valori si calcolano da soli.
POST/api/intrari/{id}/validare · /devalidarelettura e scrittura
La convalida del documento in SAGA: la giacenza aumenta e si fanno le scritture contabili. L'annullamento della convalida le cancella.
GET/api/intrari/platilettura
I pagamenti già collegati alla fattura.
GET POST PATCH DELETE/api/intrari-valuta (+ /detalii, /validare)lettura e scrittura
Le fatture in valuta: valuta, cambio, dazi doganali, commissioni, accise.

Fatture emesse (uscite)In lei e in valuta, con convalida5

GET POST PATCH DELETE/api/iesirilettura e scrittura
L'intestazione della fattura al cliente: numero, cliente, data, scadenza, indicatore e-Factura. In risposta ricevi valore, IVA, totale, quanto resta da incassare e il ricarico.
GET POST PATCH DELETE/api/iesiri/detaliilettura e scrittura
Le righe della fattura: articolo, magazzino, quantità, prezzo, IVA, conto.
POST/api/iesiri/{id}/validare · /devalidarelettura e scrittura
La convalida: la giacenza scende e si fanno le scritture contabili.
GET/api/iesiri/incasarilettura
Gli incassi già collegati alla fattura.
GET POST PATCH DELETE/api/iesiri-valuta (+ /detalii, /validare)lettura e scrittura
Le fatture in valuta, con valuta e cambio.

e-FacturaCosa è stato trasmesso e cosa è arrivato dallo SPV3

GET/api/e-factura/e-fact-generare-si-transmiterelettura
Le fatture con il loro stato in e-Factura.
GET/api/e-factura/e-fact-raspunsurilettura
Le risposte dallo SPV: la ricevuta e il tipo di messaggio.
GET/api/e-factura/e-fact-import…lettura
Le fatture emesse e ricevute scaricate dallo SPV, con le loro righe.

Magazzino e produzioneI documenti che muovono la merce, con convalida7

GET POST PATCH DELETE/api/transferuri (+ /detalii, /validare)lettura e scrittura
I trasferimenti tra magazzini.
GET POST PATCH DELETE/api/bonuri (+ /detalii, /validare)lettura e scrittura
I buoni di consumo.
GET POST PATCH DELETE/api/productie (+ /detalii, /comenzi, /validare)lettura e scrittura
La produzione: il prodotto finito, i materiali consumati e gli ordini di produzione.
GET POST PATCH DELETE/api/inventarierelettura e scrittura
L'inventario: eccedenze, ammanchi e differenze.
GET POST PATCH DELETE/api/bonuri-oi/…lettura e scrittura
I beni di consumo durevole dati in uso e dismessi.
GET POST PATCH DELETE/api/operatii-speciale · /api/reglari-descarcarelettura e scrittura
Le operazioni speciali e le rettifiche di scarico.
GET/api/fise-articole · /api/situatii-stocuri · /api/situatii-vanzari · …lettura
La scheda articolo, le giacenze per magazzino, gli approvvigionamenti, le vendite con ricarico, i consumi, la produzione, gli imballaggi SGR (sistema di deposito cauzionale), il rapporto di magazzino.

Cassa, banca e pagamentiSaldi, incassi, pagamenti, assegni5

GET POST PATCH DELETE/api/registru-casa/soldurilettura e scrittura
I saldi giornalieri di cassa e banca.
GET/api/registru-casa/casalettura · la scrittura arriva
Le registrazioni di cassa, banca e note spese, con importo, valuta, cambio, causale.
GET/api/registru-casa/casa-detaliilettura
Quali fatture ha saldato ogni incasso o pagamento.
GET/api/jurnal-de-banca/oplettura · la scrittura arriva
Gli ordini di pagamento: ordinante, beneficiario, IBAN, importo.
GET/api/cecuri · /api/situatii-cecuri/…lettura · la scrittura arriva
Gli assegni e le cambiali, ricevuti ed emessi.

Scritture contabili, registri e chiusura del meseTutto quello che esce dalla contabilità6

GET/api/registrulettura · la scrittura arriva
Le scritture contabili: data, conto dare, conto avere, importo, causale.
GET POST PATCH DELETE/api/inregistrare-cheltuieli-veniturilettura e scrittura
I risconti attivi e passivi: costi e ricavi anticipati.
GET/api/fise-conturi/… · /api/carte-mare/…lettura
Le schede contabili e il libro mastro.
GET/api/registru-jurnal · /api/registru-inventarlettura
Il libro giornale e il libro degli inventari.
GET/api/inchidere-luna/…lettura
La chiusura del mese: imposta sul reddito d'impresa o sui ricavi, D100, D101, differenze di cambio.
GET/api/situatii-managerialelettura
Costi, ricavi e profitto per ogni attività.

IVA, dichiarazioni e bilancioI dati dai registri, il SAF-T e il bilancio d'esercizio6

GET/api/jurnal-cumparari-vanzari/…lettura
I registri acquisti e vendite, D300, D301, D394, D390 e OSS.
GET/api/saft/…lettura
Le sezioni del SAF-T (D406): piano dei conti, partner, prodotti, magazzino, cespiti, giornale, pagamenti.
GET/api/bilant/…lettura
Il bilancio: conto economico, dati informativi, note esplicative, immobilizzazioni.
GET/api/declaratia-intrastat/…lettura
Intrastat, per arrivi e spedizioni.
GET POST PATCH DELETE/api/declaratia205 (+ /detalii, /salariati)lettura e scrittura
I dati per la D205.
GET POST PATCH DELETE/api/e-transport (+ /detalii)lettura e scrittura
I dati per e-Transport, con il codice UIT e lo stato.

Dipendenti e pagheLe schede delle persone e i prospetti paga4

GET POST PATCH DELETE/api/salariati (+ /intretinuti, /zilieri)lettura e scrittura
I dipendenti: nome, codice professione COR, mansione, data di assunzione, orario, familiari a carico e lavoratori giornalieri.
GET/api/state-salarii/…lettura · la scrittura arriva
I prospetti paga: lordo, netto, contributi, per dipendenti fissi e lavoratori giornalieri.
GET POST PATCH DELETE/api/configurare-salarii/…lettura e scrittura
Gli straordinari, i premi e le maggiorazioni.
GET POST PATCH DELETE/api/diurne · /api/actionarilettura e scrittura
Le diarie e i soci.

Ordini e contrattiCosa è stato ordinato e cosa si fattura periodicamente3

GET/api/comenzi/… · /api/situatii-comenzilettura · la scrittura arriva
Gli ordini, con le consegne, i giorni di ritardo e la fattura.
GET/api/contracte/… · /api/contracte/ratelettura · la scrittura arriva
I contratti, con le rate e le fatture da generare.
GET POST PATCH DELETE/api/contracte/tipuri-contractelettura e scrittura
I tipi di contratto.

Cespiti e automezziImmobilizzazioni, ammortamento, parco auto3

GET POST PATCH DELETE/api/imobilizari (+ /operatiuni-imobilizari)lettura e scrittura
I cespiti: numero di inventario, classe, valore, durata, metodo di ammortamento, conti e relative operazioni.
GET/api/imobilizari/plan-de-amortizare · /registrul-imobilizarilorlettura
Il piano di ammortamento e il registro dei cespiti.
GET POST PATCH DELETE/api/masini (+ /foi-parcurs, /asigurari-revizii)lettura e scrittura
Gli automezzi, i fogli di viaggio, le assicurazioni e le revisioni.

Strumenti utiliQuello che ti serve per lavorare comodo2

GET/api/liste/{lista}lettura
I valori delle liste SAGA (circa 290): distretti, località, unità di misura, magazzini, articoli.
POST/api/fluxuri/aprovizionare · /vanzare · /transfer · /productielettura e scrittura
Scenari completi in una sola chiamata, con annullamento completo (/api/fluxuri/anulare). Utili per test e dimostrazioni.

Come si collega a SAGA

Non installi nulla. Colleghiamo la tua azienda a Saga API una volta sola, e le tue applicazioni ricevono una chiave API.

01Colleghiamo l'azienda
Colleghiamo la tua azienda in SAGA Web a Saga API, con il tuo consenso. Lo facciamo una volta sola, e Saga API ti avvisa per tempo se il collegamento va rinnovato.
02Ricevi la chiave API
Le tue applicazioni inviano la chiave a ogni richiesta. Senza chiave, Saga API non risponde, e i siti che possono chiamarlo dal browser sono solo quelli che approvi tu.
03Test e produzione
Puoi collegare in parallelo un'azienda di prova e quella reale e scegliere a ogni richiesta dove scrivere. La produzione chiede una conferma in più.
04La documentazione interattiva
Ogni endpoint ha esempi completi in Swagger (OpenAPI): lo provi dal browser prima di scrivere una riga di codice.
05Più aziende
Ogni azienda ha il suo collegamento, separato dalle altre. Uno studio contabile o un gruppo collega tutte le aziende che gli servono.

Le regole di validazione di SAGA restano attive: se SAGA rifiuta un'operazione, la risposta ti dice il motivo.
Totali, IVA e conti analitici li calcola SAGA, non la tua applicazione.
Anche i documenti convalidati si possono riaprire ed eliminare tramite API, per correggere un errore.

Collegato a

Domande frequenti

SAGA ha un'API?

SAGA Web non offre un'API pubblica per i tuoi programmi. Saga API te ne dà una: endpoint REST documentati, con oltre 650 operazioni su quasi 200 tabelle di SAGA Web.

Funziona anche con SAGA installato sul computer?

No. Saga API lavora con SAGA Web, la versione online. Se usi SAGA sul computer, chiedici come passare a SAGA Web.

Cosa devo installare in SAGA?

Niente. Colleghiamo la tua azienda in SAGA Web a Saga API una volta sola, con il tuo consenso, e le tue applicazioni ricevono una chiave API. Al resto pensiamo noi.

Si possono rovinare i dati contabili?

Le regole di validazione di SAGA restano attive: SAGA controlla ogni documento come quando lavori a schermo e rifiuta ciò che non è corretto. Puoi collegare in parallelo un'azienda di prova, e i documenti convalidati si possono riaprire ed eliminare tramite API.

Cosa non può ancora fare?

In beta, incassi e pagamenti, ordini di pagamento, scritture contabili composte, prospetti paga, ordini e contratti si leggono tramite API, ma non si scrivono ancora. L'invio a e-Factura resta in SAGA.

Quanto costa?

Dipende da quante aziende colleghi e dall'integrazione che ti serve (negozio, ERP, CRM, report). Chiedi una demo e ti mostriamo Saga API sull'azienda di prova di SAGA.