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/
Cum obțin cheia API (API key) și documentația API?
Cheia API (API key) se obține prin solicitare în chat, la categoria Admin sau Facturare și stocuri.
Cheia este furnizată de echipa Keez.
Mediul de staging este disponibil începând cu ziua următoare după configurare.
Documentația completă a API-ului Keez 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.