# API intern documentat și versionat între programele firmei | e-data

> Un API intern, documentat și versionat, prin care programele firmei schimbă date într-un singur fel. Mai puține legături de întreținut, fără surprize.

Adresa: https://www.e-data.ro/servicii/api-interne

# Legături curate între sisteme. Nu un ghem de scripturi.

Construim un API intern prin care programele firmei schimbă date într-un singur fel, documentat și versionat. Când schimbi un program, refaci o singură legătură, nu cinci.

[Cere o evaluare gratuită](https://www.e-data.ro/contact?serviciu=api-interne#formular) [Vezi harta spaghetelor](#harta)

- Documentat și versionat
- Jurnal pentru fiecare cerere
- Pe serverul firmei

1. **Programe separate** Fiecare cu limba lui.
2. **Legături peste tot** Scripturi, exporturi, copiat.
3. **Un punct comun** Toate trec prin API.
4. **Un contract clar** Documentat și versionat.
5. **Urmărit mereu** Știi ce merge și ce nu.

## Pe scurt

e-data construiește un API intern prin care programele firmei, de la ERP și CRM la magazin și depozit, schimbă date într-un singur fel, documentat și versionat. Primești documentație, chei pe program, evenimente, jurnal și monitorizare, pe serverul firmei. Legăturile vechi rămân pornite până când cele noi sunt verificate.

- **Pentru cine:** Firme cu patru sau mai multe programe care schimbă date între ele
- **Ce primești:** API documentat și versionat, chei și permisiuni, evenimente, jurnal, codul
- **Unde rulează:** Pe serverul firmei; datele nu trec pe la un serviciu extern
- **Integrări:** Programele existente, prin API-ul lor, bază de date sau fișiere
- **Preț:** Fix, în scris, după evaluarea gratuită

## Merge, până nu mai merge

Legăturile dintre programe cresc una câte una, după nevoie. Nimeni nu le-a desenat vreodată pe toate, până nu se rupe una.

**Fiecare legătură e un caz special**

Un script aici, un export acolo, un import pornit de mână vinerea. Fiecare scris altfel, de altcineva.

Se vede când pleacă omul care a scris scriptul.

**O schimbare strică trei lucruri**

Actualizezi programul de facturare și, a doua zi, raportarea și magazinul nu mai primesc date.

Se vede când schimbi un singur program.

**Nimeni nu vede ce s-a rupt**

Legăturile cad în tăcere. Afli după o săptămână, de la un client sau de la contabilitate.

Se vede când raportul de luni are cifre de vinerea trecută.

## Harta spaghetelor

Șase programe obișnuite într-o firmă de distribuție, cu magazin online. Comută între cum sunt legate azi și cum ar fi legate printr-un API intern, apoi alege un program pe care vrei să-l schimbi.

Azi

Cu API intern

**12** legături de întreținut

**6** feluri diferite de a lega

**4** legături de refăcut dacă schimbi Facturare

Schimbi un program:

ERP

CRM

Magazin

Facturare

Depozit

Raportare

Azi: 3 export Excel, 2 export CSV, 2 script de noapte, 2 copiat de mână, 2 plugin, 1 acces direct în bază.

Exemplu tipic. Harta voastră o desenăm împreună la evaluare.

## Un contract, nu o presupunere

Fiecare legătură are o pagină de documentație: ce primește, ce întoarce și ce erori pot apărea. Așa arată trei dintre ele.

Fișa clientului

Comandă nouă

Eveniment

v1, stabilă

GET`/v1/clienti/{cui}`

Fișa unui client, aceeași pentru toate programele. O citesc CRM-ul, facturarea și raportarea.

| cui | text, obligatoriuCUI-ul, cu sau fără RO |
| --- | --------------------------------------- |

- `404`clientul nu există
- `401`cheie lipsă sau greșită

Răspuns 200

```
{
  "cui": "RO18547236",
  "denumire": "Brădet Instal SRL",
  "telefon": "+40721456789",
  "termen_plata_zile": 30,
  "sold_restant": 12450.00,
  "actualizat": "2026-09-28T09:14:02+03:00"
}
```

POST`/v1/comenzi`

Creează o comandă și rezervă stocul. O folosesc magazinul online, vânzările și aplicația de teren.

| client\_cui | text, obligatoriucine comandă |
| ----------- | ---------------------------------- |
| produse | listă, obligatoriucod și cantitate |
| livrare | datăcând vrea clientul marfa |

- `409`stoc insuficient pentru un produs
- `422`cod de produs necunoscut

Cerere și răspuns

```
// cerere
{
  "client_cui": "RO18547236",
  "produse": [{ "cod": "PRF-4040", "cantitate": 120 }],
  "livrare": "2026-10-01"
}

// răspuns 201
{ "id": "CMD-5532", "status": "in_asteptare", "stoc_rezervat": true }
```

EVENIMENT`factura.emisa`

Trimis singur programelor abonate, imediat ce se emite o factură. Nimeni nu mai întreabă „s-a facturat?”.

| abonați | CRM, Raportarecine primește evenimentul |
| ------- | ------------------------------------------------------- |
| livrare | cu reîncercaredacă un program nu răspunde, mai încercăm |

Conținutul evenimentului

```
{
  "eveniment": "factura.emisa",
  "factura": "FCT-2026-4812",
  "client_cui": "RO18547236",
  "total": 4812.00,
  "moneda": "RON",
  "scadenta": "2026-10-28"
}
```

## Ce primești, pe lângă cod

Un API e bun doar dacă e ușor de folosit și greu de stricat. Asta înseamnă mai mult decât niște endpointuri.

**Documentație la zi**

Ce face fiecare endpoint, ce primește și ce întoarce, cu exemple. Scrisă o dată, citită de toți.

**Versiuni stabile**

O schimbare vine ca versiune nouă. Programele care folosesc versiunea veche merg mai departe.

**Chei și permisiuni**

Fiecare program are cheia lui și vede doar ce îi trebuie. Magazinul nu citește salariile.

**Evenimente**

Programele află singure când se întâmplă ceva, în loc să întrebe din oră în oră.

**Jurnal și monitorizare**

Fiecare cerere e notată. Dacă o legătură cade, afli pe loc, nu peste o săptămână.

**Pe serverul firmei**

API-ul rulează în rețeaua voastră. Datele nu trec pe la un serviciu extern.

**Și capabilități AI, ca orice alt endpoint**

Extrage datele dintr-o factură, clasifică un tichet, rezumă un contract. Programele le cer prin același API, iar modelul rulează local.

[Despre API-ul de inferență](https://www.e-data.ro/servicii/api-inferenta)

## Nu orice firmă are nevoie de el

Un API intern e o investiție. Vă spunem sincer la evaluare dacă merită la voi sau dacă e suficientă o legătură directă.

**Probabil nu merită dacă**
- Aveți două programe și legătura dintre ele merge bine.
- Programele pe care le folosiți au deja o integrare directă, întreținută de producător.
- Datele se schimbă rar și un export pe lună e suficient.

**Merită dacă**
- Aveți patru sau mai multe programe care schimbă date între ele.
- Aceleași date, de exemplu clienții sau stocul, sunt folosite peste tot.
- Vreți să schimbați un program fără să refaceți toate legăturile.
- Construiți aplicații noi care au nevoie de datele firmei.

## Fără să oprim nimic

Firma merge în timp ce mutăm legăturile. Fiecare legătură nouă rulează lângă cea veche până e verificată.

1. 1**Evaluare gratuită**
Desenăm harta de azi: ce program cu cine vorbește și cum.
2. 2**Contractul**
Scriem împreună ce date circulă și în ce formă, înainte de cod.
3. 3**Mutăm legăturile**
Una câte una, pe API, cu cea veche pornită până merge noua.
4. 4**Urmărire**
Jurnal, alerte și documentație ținute la zi.

## Întrebări frecvente

Ce este, concret, un API intern?

Un singur punct prin care programele firmei cer și primesc date, după reguli scrise. În loc ca fiecare program să fie legat de fiecare, toate vorbesc cu API-ul, în același fel.

Trebuie să înlocuim programele actuale?

Nu. API-ul se leagă de programele pe care le aveți, prin ce permite fiecare: API propriu, bază de date sau fișiere. Programele rămân, se schimbă doar felul în care vorbesc între ele.

Ce se întâmplă cu legăturile de azi cât lucrăm?

Rămân pornite. Mutăm câte o legătură, o verificăm lângă cea veche, și abia apoi o oprim pe cea veche.

Prin ce diferă de API-ul de inferență?

API-ul de inferență dă acces la un model AI. API-ul intern leagă programele și datele firmei. Se pot combina: de exemplu, un endpoint intern care extrage datele dintr-o factură folosind un model local.

Cine îl întreține după lansare?

Primiți documentația și codul. Îl puteți întreține voi, sau ne ocupăm noi, ca proiect sau prin abonament.

Cât costă?

Depinde de câte programe legăm și câte date circulă între ele. După evaluarea gratuită primiți un preț fix, în scris.

## Hai să desenăm harta voastră.

O oră de discuție și vedeți toate legăturile dintre programele firmei, pe o singură pagină. Evaluarea e gratuită, iar prețul îl primești fix, în scris.

[Cere o evaluare gratuită](https://www.e-data.ro/contact?serviciu=api-interne#formular) [Sună-ne: 0750 214 446](tel:+40750214446)

## Servicii înrudite

- [**Integrare ERP și CRM** Programele tale vorbesc între ele](https://www.e-data.ro/servicii/erp-crm)
- [**API-uri de inferență** Modelele tale, accesibile printr-un API intern](https://www.e-data.ro/servicii/api-inferenta)
- [**Monitorizare** Afli de o problemă înaintea utilizatorilor](https://www.e-data.ro/servicii/monitorizare)
- [**Automatizări** Munca repetitivă preluată de programe](https://www.e-data.ro/servicii/automatizari)

---

Sursa: e-data (E-DATA S.R.L.), https://www.e-data.ro/servicii/api-interne. Contact: contact@e-data.ro, 0750 214 446.