Folosim cookie-uri strict necesare pentru funcționarea site-ului. Cookie-uri de analiză și marketing folosim numai cu acordul tău. Vezi Politica de cookies și Politica de confidențialitate.
API REST

API REST pentru facturare și stocuri

Conectează-ți aplicația la JCont Cloud. Magazinul online, ERP-ul sau aplicația ta proprie emit facturi, citesc stocul și înregistrează încasări direct în JCont Cloud. Cu chei API generate din firmă și documentație completă în limba română.

Discută integrarea Cum începi

API-ul este inclus în planurile Professional și Ultimate.

# Factură pentru comanda 10045 din magazin
curl -X POST https://cloud.jcont.ro/api/v1/documents \
  -H "X-Api-Key: jck_…" \
  -H "Idempotency-Key: comanda-10045" \
  -H "Content-Type: application/json" \
  -d '{ "type": "FCT_CL",
        "partnerId": "…",
        "lines": [ { "productId": "…", "quantity": 2 } ] }'

# 201 Created
{ "id": "…", "message": "Factura … a fost emisă" }
Pentru cine

Când ai nevoie de API-ul JCont Cloud?

Pentru marketplace-uri, curieri și platformele de magazin cunoscute există deja integrări gata făcute. API-ul e pentru tot restul: aplicațiile tale și ale partenerilor tăi.

Magazin online propriu

Comanda plătită devine factură în JCont Cloud, cu PDF-ul trimis clientului și e-Factura transmisă în SPV.

ERP sau CRM propriu

Sincronizezi partenerii și produsele, iar documentele emise în JCont Cloud se văd și în sistemul tău.

Stoc afișat corect

Site-ul sau aplicația de vânzare citesc stocul pe gestiuni și nu mai vând ce nu există.

Încasări automate

Plățile cu cardul sau prin ordin de plată se înregistrează pe facturile clientului, iar soldul rămâne la zi.

Ce poate face

Ce operațiuni oferă API-ul?

API-ul are patru module. Fiecare cheie primește doar modulele de care are nevoie integrarea, cu acces doar de citire sau de citire și scriere.

ModulCitireScriere
ParteneriLista partenerilor și detaliile unui partenerAdăugarea unei firme după CUI, cu datele preluate de la ANAF
Produse și stocProduse, gestiuni și stocul pe fiecare gestiuneAdăugarea unui produs
DocumenteLista documentelor, detaliile cu starea e-Factura și PDF-ul facturii sau avizuluiEmiterea de facturi, avize, comenzi și oferte, stornarea unei facturi și trimiterea în e-Factura
Încasări-Încasări de la clienți prin chitanță, ordin de plată sau card, alocate pe facturi

Facturile emise prin API respectă aceleași reguli ca în aplicație: TVA (inclusiv UE, OSS și export), serii și numerotare, stoc și drepturile utilizatorului. Detalii despre facturare găsești pe pagina program de facturare online.

Securitate

Cum sunt protejate datele firmei?

Cheile API se generează din firmă, de un administrator conectat în aplicație, și se pot opri oricând.

Cheie afișată o singură dată

Cheia se vede doar la creare. JCont Cloud păstrează doar o amprentă criptografică a ei, nu cheia propriu-zisă.

Doar ce îi trebuie integrării

Alegi modulele, accesul doar de citire sau și de scriere, data de expirare și adresele IP de la care cheia este acceptată.

Drepturile unui utilizator

Cheia lucrează în numele celui care a creat-o, doar pentru firma lui. Dacă utilizatorul pierde accesul, cheia se oprește și ea.

Revocare imediată

Din ecranul Chei API vezi când a fost folosită fiecare cheie ultima dată și o poți revoca dintr-un clic.

Urmă în istoric

Documentele emise prin API apar în istoric cu mențiunea „prin API” și cu numele cheii, ca să știi de unde a venit fiecare operațiune.

Fără acces la setări sensibile

API-ul nu poate crea sau modifica firme, utilizatori, parole, roluri, conturi bancare, setări, abonamente sau chei API.

Primii pași

Cum începi o integrare cu API-ul JCont Cloud?

1

Creezi cheia

În JCont Cloud, un administrator deschide Administrare, apoi Chei API, și creează o cheie cu modulele și accesul de care are nevoie integrarea.

2

Citești documentația

Documentația interactivă de la cloud.jcont.ro/api/docs, în limba română, descrie fiecare operațiune, câmpurile și erorile. O poți încerca direct din browser, cu cheia ta.

3

Trimiți prima cerere

Pui cheia în antetul X-Api-Key și verifici legătura cu GET /api/v1/company. Apoi emiți primul document.

Pentru dezvoltatori

Ce trebuie să știe programatorul?

  • API REST cu JSON, prin HTTPS, cu specificație OpenAPI 3, din care se pot genera clienți pentru orice limbaj.
  • Antetul Idempotency-Key la scrieri: dacă o cerere se repetă după o eroare de rețea, factura nu se emite de două ori.
  • Liste paginate; documentele se filtrează după perioadă, tip, partener sau doar cele neîncasate.
  • O limită de cereri pe minut pentru fiecare cheie, cu răspuns 429 și antetul Retry-After la depășire.
  • Erori cu cod stabil și mesaj în română, de exemplu already_exists când partenerul există deja.
# 403 Forbidden
{
  "error": {
    "code": "scope_not_granted",
    "message": "Cheia API nu are acces la modulul „Documente de vânzare”.",
    "details": null
  }
}

Documentația interactivă este publică, la cloud.jcont.ro/api/docs, iar specificația OpenAPI la /api/v1/openapi.json.

Întrebări frecvente

Întrebări despre API-ul JCont Cloud

Poți citi și adăuga parteneri și produse, poți vedea stocul pe gestiuni, poți emite facturi, avize, comenzi și oferte, poți descărca PDF-ul unui document, poți storna o factură, o poți trimite în e-Factura și poți înregistra încasări de la clienți.

API-ul nu poate crea sau modifica firme, utilizatori, parole, roluri, conturi bancare, setări, abonamente sau chei API. Acestea se administrează doar din aplicația JCont Cloud, de un utilizator conectat.

Un administrator al firmei deschide în JCont Cloud Administrare, apoi Chei API, și creează o cheie nouă. Alege modulele, accesul (doar citire sau citire și scriere), valabilitatea și, opțional, adresele IP permise. Cheia se afișează o singură dată.

O revoci din același ecran și se oprește imediat. Poți limita din start cheia la anumite adrese IP, la modulele de care integrarea are nevoie și la acces doar de citire.

Da. Scrierile prin API trec prin aceleași reguli ca ecranele JCont Cloud: TVA, serii și numerotare, stoc și drepturile utilizatorului. În istoricul documentului apare că a fost emis prin API și cu ce cheie.

API-ul este inclus în planurile Professional și Ultimate. Detaliile le găsești pe pagina de prețuri, iar pentru o integrare anume ne poți scrie.

Ai o aplicație de conectat la JCont Cloud?

Spune-ne ce vrei să automatizezi și îți arătăm cum se face prin API, pe datele firmei tale.

Discută integrarea Vezi prețurile

API-ul este inclus în planurile Professional și Ultimate.