SAGA WEB se poate conecta acum direct la aplicațiile pe care le folosiți deja. Am lansat API-ul SAGA WEB, prin care magazinul online, ERP-ul, CRM-ul sau orice aplicație proprie pot trimite date în contabilitate și pot citi informații din ea, automat, fără exporturi și importuri manuale.
Facturile ajung în SAGA WEB imediat ce sunt emise, iar stocurile, soldurile și balanța pot fi consultate din aplicația dumneavoastră în timp real.
Ce puteți face cu API-ul
Prima versiune a API-ului acoperă un endpoint de import și cinci de interogare:
| Operație | Ce face | Parametri |
| Import date | Trimite în SAGA WEB fișiere XML cu facturi (intrări și ieșiri), articole, încasări, plăți și articole contabile | fișierul XML; parametru opțional importAutomat |
| Preluare stoc articol | Returnează stocul unui articol, pe o gestiune sau pe toate | codArticol; opțional gestiune și dată |
| Preluare situații stocuri | Returnează situația stocurilor pe o perioadă, ca fișier XML | dataStart, dataEnd |
| Preluare sold cont | Returnează soldul debitor sau creditor al unui cont la o dată | cont, tip (D/C), opțional dată |
| Preluare balanță | Returnează balanța sintetică sau analitică pe o perioadă | dataStart, dataEnd, tipBalanta |
| Preluare articol | Returnează datele unui articol din nomenclator | codArticol |
La import, opțiunea importAutomat finalizează importul fără intervenție manuală. Altfel, fișierul doar se încarcă în modulul Import date, de unde se poate importa și valida manual de către un operator.
Dacă unele documente au erori, se generează un raport text cu fiecare factură cu probleme și motivul pentru care s-a generat mesajul de eroare la importul ei (de exemplu, „factura a fost importată deja” sau „completați clientul”).
Cui îi folosește
- Firmelor cu magazin online sau aplicație de facturare proprie: facturile emise ajung direct în SAGA WEB, fără reintroducere manuală.
- Firmelor cu gestiune de stocuri: stocul real din SAGA WEB poate fi afișat pe site sau în aplicația de vânzări.
- Dezvoltatorilor și integratorilor: un API simplu, cu exemple gata făcute în C#, PHP, Python și Java.
Rezultatul: mai puțină muncă repetitivă, mai puține erori de tastare și date contabile actualizate permanent.
Cum începeți
- Un utilizator de tip Admin generează o cheie de acces din Utilizatori → Integrare API → Generează cheie de acces.
- Fiecare apel trimite cheia în header-ul Authorization: Bearer și codul fiscal al firmei în header-ul X-Saga-Cod-Fiscal.
- Când răspunsul conține header-ul X-Saga-Refresh-Token, salvați noua cheie și folosiți-o la apelul următor; altfel cheia se blochează și trebuie generată una nouă.
- Folosiți exemplele de cod din documentație (C#, PHP, Python, Java) ca punct de plecare.
Pentru formatul XML al facturilor există o scurtătură: tipăriți o factură din SAGA Desktop, ecranul „Ieșiri”, cu opțiunea „Formular PDF”. În folderul TEMP\Facturi veți găsi, pe lângă PDF, și XML-ul gata formatat.
API-ul este disponibil pentru toți utilizatorii SAGA WEB, fără costuri suplimentare. Documentația completă, cu structura fișierelor XML, codurile de răspuns și exemplele de cod, o găsiți aici: web.sagasoft.ro/DocumentatieAPI.
Detalii tehnice suplimentare resurselor existente în documentație puteți obține prin e-mail dacă vă sunt necesare. De asemenea puteți utiliza instanța de test disponibilă pe www.sagasoft.ro pentru a testa funcționalitatea API.