Enlivy

API Enlivy

Conectează-ți sistemele și automatizează fluxurile de lucru cu API-ul Enlivy

Gratuit în orice plan

Conectezi Enlivy, prin API, la celelalte aplicații și platforme pe care le folosești și construiești integrări care țin pasul cu firma ta pe măsură ce crește.

Obține cheia API

Cont gratuit, fără card.

GÂNDIT API-FIRST

Făcut pentru programatori. Gata pentru afaceri.

Tot ce poți face în Enlivy poți face și prin API, în limitele rolului și ale planului tău.

Aplicația Enlivy folosește chiar acest API, așa că ce faci în interfață poți face și dintr-un script, în limitele rolului tău, ale organizațiilor la care are acces tokenul și ale planului. Automatizezi sarcinile repetitive, conectezi Enlivy la sistemele pe care le ai deja și construiești fluxuri potrivite cu felul în care lucrează firma ta.

Endpoint-uri curate și stabile, cu documentație clară și fără dependență de furnizor. Fie că ești startup, fie firmă mare, livrezi automatizări și integrări în câteva zile, nu în luni.

  • Gândit modular

    Conectezi doar ce îți trebuie (facturi, clienți, contracte și altele), fără să fii prins într-un sistem rigid.

  • Construiești mai repede, crești mai ușor

    Cu un API rapid și stabil, echipa ta face automatizări și integrări în câteva zile, nu în luni.

  • Se leagă de sistemele tale

    Conectezi Enlivy la sistemele de HR, financiar și CRM pe care le folosești deja.

  • Fără dependență de furnizor

    Endpoint-uri curate și documentate, pe care le controlezi tu, cu toată flexibilitatea.

Ce îți ține afacerea pe loc

Integrări care se strică ușor și muncă manuală repetitivă: exact lucrurile care împiedică o afacere să crească.

  • Sisteme care nu comunică

    Fără Enlivy: Legătura dintre HR, financiar și CRM înseamnă multă muncă manuală și integrări pe care nu te poți baza.

    Cu Enlivy: Orice date din Enlivy sunt disponibile printr-un singur API curat, așa că sistemele tale se leagă în sfârșit între ele și rămân sincronizate.

  • Muncă manuală care nu crește cu tine

    Fără Enlivy: Sarcinile manuale repetitive îți consumă timpul, aduc mai multe greșeli și te împiedică să crești cu încredere.

    Cu Enlivy: Pui într-un script munca repetitivă, de la facturare la sincronizarea datelor, iar automatizarea o preia, oricât ai crește.

Referință API

Facturi prin API

Te conectezi direct la Enlivy prin API-ul public și lucrezi din cod cu datele contului tău: facturi, chitanțe, tranzacții, produse, utilizatori, contracte și altele.

Exemplele de mai jos acoperă operațiile cele mai frecvente cu facturi: listarea, citirea unei singure facturi, crearea uneia noi și actualizarea datelor unei facturi existente.

Afișezi facturile recente în dashboard-ul tău. Listezi facturile organizației cu paginare, filtre și metadate. Poți include în răspuns și detalii ale facturii, precum liniile și taxele.

GET/organizations/<organization_id>/invoices
curl -G 'https://api.enlivy.com/organizations/<organization_id>/invoices' \
  --data-urlencode 'page=1' \
  --data-urlencode 'limit=20' \
  --data-urlencode 'include=invoice_prefix,tag_ids,line_items,taxes' \
  --data-urlencode 'include_meta=navigation' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json'

Referință API

Planuri de plată prin API

Automatizezi complet facturarea recurentă. Un plan de plată app-managed este rulat în întregime de Enlivy. Planul emite facturile la frecvența stabilită de tine, debitează metoda de plată salvată și trece prin propriul ciclu de viață: pending, active, paused, cancelling, completed. Stabilești o singură dată ce conține, iar Enlivy îl facturează după program.

Referința de mai jos acoperă doar planurile app-managed. Enlivy lucrează și cu planuri găzduite de Stripe, în care Stripe deține abonamentul și face facturarea. Acestea se administrează din Stripe, așa că nu descriem aici cum le creezi sau le modifici. Un plan app-managed îl compui în două feluri: din faze definite de tine (propriile linii recurente și frecvența lor) sau dintr-un pachet comercial de tip abonament (un șablon reutilizabil). Exemplele de mai jos le acoperă pe amândouă, plus listarea, editarea, reconfigurarea și anularea.

Listezi planurile cu paginare, filtre și căutare full-text. Filtrezi după status, direcție (outbound / inbound), expeditor, destinatar, contract, cont bancar sau după oricare dintre intervalele de date (starts_at, ends_at, created_at, updated_at). Poți include în răspuns fazele și plățile generate.

GET/organizations/<organization_id>/billing-schedules
# status: pending | active | payment_method_required | paused | cancelling | completed | cancelled
curl -G 'https://api.enlivy.com/organizations/<organization_id>/billing-schedules' \
  --data-urlencode 'page=1' \
  --data-urlencode 'limit=20' \
  --data-urlencode 'status=active' \
  --data-urlencode 'direction=outbound' \
  --data-urlencode 'include=receiver_user,phases,payments' \
  --data-urlencode 'include_meta=navigation' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json'

Referință API

Network Exchanges prin API

Prin API trimiți în e-Factura ANAF facturile către clienții din România și preiei facturile care îți sunt adresate. Un schimb (network exchange) este o singură transmitere a unei facturi către o instituție sau de la ea. Instituția acceptată este ANAF. Enlivy generează documentul UBL conform, îl trimite și urmărește răspunsul pe tot parcursul, ca să știi dacă documentul a fost acceptat, respins sau e încă în procesare.

Un schimb este de ieșire (trimiți o factură emisă de tine) sau de intrare (preiei documentele adresate ție). Referința începe cu pasul principal, trimiterea unei facturi, apoi trece la listarea și verificarea schimburilor, preluarea documentelor primite și descărcarea fișierelor semnate. Fiecare schimb are un status pe care îl poți verifica periodic.

Trimiți o factură emisă către o instituție din rețea. Cererea nu are body, pentru că se trimite chiar factura. Enlivy generează UBL-ul conform, îl transmite și returnează schimbul creat, cu statusul lui inițial. Instituțiile către care poate fi trimisă o factură le găsești chiar în datele ei.

GET/organizations/<organization_id>/invoices/<invoice_id>+1
# 1. Afli instituțiile eligibile pentru factură.
#    invoice.peppol_exchange_push_options listează instituțiile către care poți trimite;
#    invoice.peppol_exchanges_pushed le listează pe cele deja trimise.
curl 'https://api.enlivy.com/organizations/<organization_id>/invoices/<invoice_id>' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json'

# 2. Trimiți către o anumită instituție. Id-ul este un text, de exemplu "anaf" (România / ANAF).
# fără corp: documentul este factura
curl -X POST 'https://api.enlivy.com/organizations/<organization_id>/invoices/<invoice_id>/peppol/anaf' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json'

# Răspunsul este înregistrarea schimbului în rețea. Urmărești `status`:
# pending | processing | success | success_in_exchange_queue | success_pending_archive
# | change_required | rejected | rejected_at_exchange | failed | failed_credentials_expired
# Dacă instituția nu poate fi contactată, primești HTTP 503.

Referință API

Tranzacții bancare prin API

Aduni toate mișcările din conturile tale într-un singur registru, apoi afli ce reprezintă fiecare. Tranzacțiile bancare ajung în Enlivy prin sincronizarea cu banca, din payout-urile Stripe sau prin introducere manuală. Prin API le clasifici după tipul de cost și le reconciliezi cu documentele pe care le achită: facturi, chitanțe și fluturași de salariu. Fiecare tranzacție are propria stare, de la backlog până la connected, adică legată integral.

Lucrezi cu două resurse. Tipurile de cost sunt categoriile pe care le refolosești la clasificare, precum „Salarii”, „Încasare client” sau „Software”, și fiecare stabilește de ce poate fi legată o tranzacție. Tranzacțiile bancare sunt mișcările propriu-zise. Exemplele de mai jos le acoperă pe amândouă, plus listarea, filtrarea, reconcilierea și analizele.

Listezi tipurile de cost cu care clasifici tranzacțiile. Fiecare are o etichetă tradusă, arată dacă legătura cu o entitate e obligatorie și ce tipuri de entitate acceptă.

GET/organizations/<organization_id>/bank-transaction-cost-types
curl -G 'https://api.enlivy.com/organizations/<organization_id>/bank-transaction-cost-types' \
  --data-urlencode 'page=1' \
  --data-urlencode 'limit=50' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json'

Referință API

Taxe prin API

Enlivy organizează taxele după modelul folosit de Stripe pentru codurile fiscale ale produselor, nu cu câte o clasă pentru fiecare țară. O clasă de impozitare este o categorie de produs după natura lui (Bunuri și servicii standard, Cărți, Alimente, Servicii digitale, Scutit), iar fiecare produs îl marchezi cu categoria din care face parte, niciodată cu un procent introdus de mână. Fiecare clasă are un set de cote de impozitare, câte una pentru fiecare țară sau situație de vânzare. La facturare, Enlivy alege singura cotă aplicabilă după țara și statutul fiscal al cumpărătorului, luând potrivirea cu prioritatea cea mai mare.

Exemplele de mai jos acoperă ambele niveluri: clasa (categoria) și cotele (rândurile pe țări de sub fiecare clasă).

Listezi categoriile fiscale ale produselor tale. Incluzi tax_rates_overview ca să primești un rezumat al cotelor de sub fiecare clasă.

GET/organizations/<organization_id>/tax-classes
# filtre: name, description, ids
# include tax_rates_overview pentru un rezumat al cotelor fiecărei clase
curl -G 'https://api.enlivy.com/organizations/<organization_id>/tax-classes' \
  --data-urlencode 'page=1' \
  --data-urlencode 'limit=20' \
  --data-urlencode 'include=tax_rates_overview' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json'

Referință API

Pipeline-ul de vânzări prin API

Integrezi direct cu Enlivy captarea clienților potențiali, CRM-ul și automatizările de vânzări. Prin API lucrezi cu pipeline-urile de vânzări: adaugi un prospect din orice sursă, îl muți prin etapele configurate și notezi fiecare interacțiune.

Exemplele de mai jos arată cum listezi și filtrezi clienții potențiali, cum adaugi unul nou, cum îl muți prin etapele configurate și cum înregistrezi activități precum apeluri și întâlniri. API-ul oferă și panouri, revizuirea și unificarea duplicatelor și un rezumat pe care îl poți descărca.

Aduci pipeline-ul în orice dashboard sau job de sincronizare. Listezi clienții potențiali cu paginare, filtrezi după etapă, responsabil, sursă sau interval de date și cauți full-text după nume, firmă sau email. Poți include în răspuns date legate, precum etapa curentă și membrul echipei căruia i-a fost atribuit.

GET/organizations/<organization_id>/prospects
curl -G 'https://api.enlivy.com/organizations/<organization_id>/prospects' \
  --data-urlencode 'page=1' \
  --data-urlencode 'limit=20' \
  --data-urlencode 'source_type=inbound' \
  --data-urlencode 'include=organization_prospect_stage,assigned_organization_user' \
  --data-urlencode 'include_meta=navigation' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json'

Referință API

Contracte prin API

Redactezi, trimiți, semnezi și urmărești contracte de la un capăt la altul, fără ca utilizatorii tăi să iasă vreodată din aplicația ta. API-ul pentru contracte acoperă tot ciclul de viață: compui contractul din capitole și părți, îl treci prin statusurile definite de tine, deschizi pentru fiecare semnatar o sesiune de semnare cu valoare legală și descarci documentul semnat, împreună cu dovezile de audit, care nu pot fi modificate fără să se observe.

Lucrezi cu patru resurse: contractele (documentul, capitolele și părțile lui), statusurile de contract (etapele pe care le configurezi tu), sesiunile de semnare (câte una pentru fiecare parte, cu verificare prin email sau SMS) și istoricul de audit (jurnalele de trimitere și dovezile de semnare). Exemplele de mai jos parcurg tot fluxul.

Listezi contractele cu paginare, filtre detaliate și căutare full-text. Filtrezi după status, expeditor, destinatar, direcție (inbound / outbound), categorie (core, amendment, addenda, supplement), sursă (internal / uploaded), limbă, contract părinte sau oricare dintre intervalele de date (issued_at, ends_at, created_at, updated_at). Poți include în răspuns datele legate.

GET/organizations/<organization_id>/contracts
# filtrele sunt opționale și se pot combina
# trimiți q=... în loc de ids pentru căutare în tot textul
curl -G 'https://api.enlivy.com/organizations/<organization_id>/contracts' \
  --data-urlencode 'page=1' \
  --data-urlencode 'limit=20' \
  --data-urlencode 'direction=outbound' \
  --data-urlencode 'category=core' \
  --data-urlencode 'include=contract_status,sender_user,receiver_user,contract_parties' \
  --data-urlencode 'include_meta=navigation' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json'

Referință API

Produse prin API

Îți sincronizezi catalogul din propriile sisteme. Prin API administrezi produsele pe care le vinzi și le refolosești pe documente (servicii, produse digitale, produse fizice și bonusuri), fiecare cu prețuri în mai multe monede, denumiri pe limbi, clasă de impozitare și metadatele necesare pentru facturarea electronică conformă. Produsele create aici le folosești direct în facturi, propuneri și planuri de plată.

Exemplele de mai jos acoperă operațiile de bază: listarea și căutarea produselor, crearea, modificarea și ștergerea unui produs.

Listezi produsele din catalog cu paginare, filtre și căutare full-text. Filtrezi după nume sau descriere, ceri anumite id-uri și poți include în răspuns clasa de impozitare.

GET/organizations/<organization_id>/products
# filtre: name, description, ids (sau q=... pentru căutare în tot textul)
# includes: organization, tax_class, tag_ids, deleted_by_user
curl -G 'https://api.enlivy.com/organizations/<organization_id>/products' \
  --data-urlencode 'page=1' \
  --data-urlencode 'limit=20' \
  --data-urlencode 'name=Consulting' \
  --data-urlencode 'include=tax_class' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json'

Referință API

Sesiuni de autentificare prin API

Creezi și citești, direct din API-ul de administrare, sesiuni de autentificare în portalul clienților pentru utilizatorii tăi. O sesiune îi dă unui utilizator al organizației tale acces la aplicația pentru clienți (portalul), doar la ce alegi tu și pentru o perioadă limitată. Utilizatorul se autentifică prin email, telefon sau un link magic. Găsești utilizatorul, deschizi o sesiune (după id sau după email), apoi o citești.

Obții utilizatorii pentru care poți deschide o sesiune. Filtrezi după email, faci o căutare full-text sau parcurgi toată lista, pagină cu pagină, până găsești persoana potrivită.

GET/organizations/<organization_id>/users
# filtre: email, created_at_from/to, updated_at_from/to, ids, sau q=... pentru căutare în text
curl -G 'https://api.enlivy.com/organizations/<organization_id>/users' \
  --data-urlencode 'page=1' \
  --data-urlencode 'limit=20' \
  --data-urlencode 'email=jane@acme.example' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json'

Funcționează împreună cu

Oferte, contracte, facturi și plăți

Începe să folosești API-ul Enlivy, chiar de azi

Acces curat și consecvent la datele tale, pentru toate fluxurile de lucru. De la facturi la chitanțe și tranzacții, API-ul nostru te ajută să lucrezi repede și să păstrezi controlul.

Începi gratuit · Fără card · e-Factura ANAF pentru facturile către clienții din România