API Keez – Facturare prin integrare¶
Platforma Keez pune la dispoziție un API care permite sistemelor externe
să creeze și să gestioneze facturi în mod automat, fără interacțiune
manuală în interfața web.
Documentația completă a API-ului este disponibilă la
https://app.keez.ro/help/api/
Considerații generale¶
Keez expune un API de tip REST din perspectiva modelării resurselor
sistemului, fără însă să își propună să atingă ultimul nivel al modelului
de maturitate Richardson.
Resursele sunt identificate unic printr-un ID externalizabil, dacă nu se
specifică altfel.
Platforma creează ID-ul, care este apoi returnat apelantului.
Operațiile standard disponibile sunt modelate prin adresarea de verbe HTTP corespunzătoare resurselor:
GET — listarea resurselor sau accesul individual la o resursă
POST — crearea unei noi resurse
PUT — modificarea unei resurse existente
DELETE — ștergerea unei resurse
Notă
Operațiile de tip business logic sunt modelate prin expunerea unor
resurse separate, cărora clientul le va trimite cereri cu verbele
corespunzătoare.
De exemplu, validarea unei facturi se realizează printr-un
POST
către resursa invoices/valid.Toate exemplele din documentația API sunt realizate în Python.
Alternative fără cod — Import de facturi și comenzi¶
Dacă nu doriți o integrare programatică prin API, Keez oferă și
posibilitatea importului de fișiere structurate direct din interfața web.
Există două tipuri de import relevante pentru facturare, accesibile din
Contabilitate → Importuri → + Import nou.
Import facturi
Utilizat atunci când facturile au fost deja emise într-un sistem extern
și dețin serie și număr proprii.
Keez le preia, le înregistrează în contabilitate și le transmite în
RO e-Factură.
Mai multe detalii: Import Client Facturi – Încărcarea facturilor emise în sisteme externe
Import comenzi
Utilizat atunci când dețineți datele necesare facturării, dar facturile
nu au fost încă emise.
Keez generează facturile, le alocă serie și număr, le înregistrează în
contabilitate și le transmite în RO e-Factură.
Mai multe detalii: Import Client Comenzi – Generare facturi din date de comandă
Notă
Pentru asistență legată de integrarea prin API sau de importul de date,
ne puteți contacta prin Connect > Facturare.