Sari la conținut

Integrări · API și MCP

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.

Vreau VITT pentru afacerea mea

API REST v1

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ă.

Chei API

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.

Webhooks

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.

MCP · Asistenți AI

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.

Cum funcționează conexiunea
  • 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.

Dintr-o privire

Și restul detaliilor care contează.

  • 01

    Documentație în română și engleză

    Ghiduri, erorile explicate și referința completă a API-ului, la docs.vitt.ro.

  • 02

    Contract OpenAPI 3.1

    API-ul v1 e descris în OpenAPI 3.1, din care îți poți genera clientul.

  • 03

    Date de referință

    Serii de documente, cote de TVA, unități de măsură și datele firmei, citite direct din VITT.

Pentru dezvoltatori

Documentația API-ului, cu ghidurile de început, explicația fiecărei erori și referința completă, e la 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.

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.

Întrebări frecvente

API și MCP

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.

Intră printre primele firme pe VITT.

Locuri limitate pentru firmele din România.

În prima etapă primim un număr limitat de firme.