# Sistemele tale lucrează cu VITT prin API.

> Magazinul, CRM-ul sau aplicația de depozit a firmei tale lucrează direct cu VITT printr-un API REST: creează parteneri și produse, emit facturi și le trimit în e-Factura, citesc facturile primite și află din webhooks ce s-a schimbat. Asistenții AI, ca Claude sau ChatGPT, se conectează separat, prin MCP.

Source: https://vitt.ro/integrari/api-mcp/

- **Documentație în română și engleză.** Ghiduri, erorile explicate și referința completă a API-ului, la docs.vitt.ro.
- **Contract OpenAPI 3.1.** API-ul v1 e descris în OpenAPI 3.1, din care îți poți genera clientul.
- **Date de referință.** Serii de documente, cote de TVA, unități de măsură și datele firmei, citite direct din VITT.

## Facturi emise din sistemul tău, trimise în e-Factura.

O factură creată prin API trece aceleași verificări ca în aplicație: se emite cu PDF și XML și pleacă la ANAF ca oricare alta.

- **Parteneri și produse.** Le listezi, citești, creezi, actualizezi și arhivezi. O firmă din România o adaugi după CUI, din datele ANAF; una din UE, prin VIES.
- **Facturi, de la ciornă la ANAF.** Ciorne, emitere, storno, trimitere în e-Factura, PDF și XML, cu starea plății și răspunsul ANAF.
- **Facturi primite.** Citești facturile furnizorilor, din SPV, încărcate sau bonuri, cu PDF-ul, XML-ul și atașamentele lor.
- **Reîncercări fără dubluri.** Cu o cheie de idempotență, o cerere repetată după o eroare de rețea are efect o singură dată.

## Fiecare cheie face doar ce i-ai permis.

Cheile API sunt ale firmei și se creează în Setări › Integrări › API. Un administrator alege pentru fiecare cheie ce poate citi și ce poate scrie.

- **Permisiuni pe cheie.** Cheia magazinului poate emite facturi, iar cheia unui raport doar citește.
- **Cheia e a firmei.** Integrarea nu depinde de contul unui coleg: cheia rămâne a firmei, cu permisiunile ei.

## Afli imediat ce s-a schimbat.

VITT anunță sistemul tău prin webhooks: factură emisă, acceptată sau respinsă de ANAF, plată, factură primită, partener sau produs nou ori modificat.

- **Semnate.** Fiecare livrare e semnată după schema Standard Webhooks, ca sistemul tău să verifice că vine de la VITT.
- **Nimic pierdut.** După o întrerupere, citești evenimentele pierdute din fluxul de evenimente, în ordine.

## Claude și ChatGPT se conectează prin MCP.

Pentru asistenții AI, VITT are un server MCP. Un asistent caută facturi, pregătește ciorne și citește solduri, rapoarte și stocuri, cu capabilitățile pe care un administrator le acordă fiecărei conexiuni.

- **API sau MCP.** API-ul e pentru sistemele firmei, care pot emite facturi și le pot trimite la ANAF. Un asistent AI nu poate aproba o factură și nu o poate trimite la ANAF.
- **Aprobare în VITT.** Facturile create sau modificate dintr-un asistent așteaptă implicit aprobarea în VITT.
- **Ce vede asistentul.** Firma alege cât din datele partenerilor vede un asistent, iar o conexiune nouă pornește fără niciun acces.

Ce citește un asistent ajunge la furnizorul lui (de exemplu Anthropic sau OpenAI), în condițiile firmei tale cu acel furnizor.

## Pentru dezvoltatori

Documentația API-ului, cu ghidurile de început, explicația fiecărei erori și referința completă, e la [docs.vitt.ro](https://docs.vitt.ro), în română și engleză. API-ul folosește aceleași reguli ca aplicația: o factură emisă prin API e validată pentru e-Factura ca oricare alta din [facturare](/functionalitati/facturare-e-factura/).

## Pentru asistenți AI

Dacă vrei să lucrezi cu VITT din Claude, ChatGPT sau alt asistent, nu ai nevoie de API: te conectezi prin MCP, cu autentificare și capabilități acordate de un administrator. Tot ce poate face un asistent e descris pe pagina [VITT în Claude și ChatGPT](/functionalitati/claude-chatgpt-mcp/).

## FAQ

### Pentru ce e API-ul VITT?

Pentru sistemele firmei tale: un magazin, un CRM, o aplicație de depozit. Prin API creează parteneri și produse, emit facturi și le trimit în e-Factura și citesc facturile primite.

### Unde găsesc documentația API-ului?

La docs.vitt.ro, în română și engleză: ghiduri, erorile explicate și referința completă, generată din contractul OpenAPI.

### Poate API-ul să trimită facturi la ANAF?

Da, dacă cheia are permisiunea. O cheie API e sistemul firmei tale, care lucrează în numele ei. Un asistent AI conectat prin MCP nu poate face asta.

### Cum aflu când ANAF acceptă sau respinge o factură?

Prin webhooks: VITT trimite un eveniment când factura e emisă, acceptată sau respinsă de ANAF și când i se schimbă starea plății.

### Care e diferența dintre API și MCP?

API-ul REST e pentru programe, cu chei ale firmei și permisiuni pe cheie. MCP e pentru asistenți AI ca Claude sau ChatGPT, cu capabilități acordate de un administrator pe fiecare conexiune și cu aprobare în VITT pentru facturi.
