Inside App

Documentație APIv1.9

APIv1.9

Bine ai venit la API-ul Inside App!

Platforma API Inside App îți permite să automatizezi integral procesele de facturare, gestionare a clienților și administrare financiară. Beneficiezi de integrare rapidă și acces complet la toate funcționalitățile esențiale pentru afacerea ta!

🚀 Module principale disponibile:

📋 Facturare și Documente
  • Facturi proforme - Creează, modifică și gestionează documentele preliminare
  • Facturi fiscale - Emite facturi cu valoare legală conform legislației
  • Chitanțe - Documentează plățile primite de la clienți
  • Configurare serii facturi - Personalizează aspectul și numerotarea documentelor
💰 Gestionare Financiară
  • Încasări - Monitorizează și gestionează plățile primite
  • Conturi bancare - Administrează conturile financiare ale companiei
  • Curs valutar - Accesează informații despre cursurile valutare
👥 Nomenclatoare
  • Clienți - Gestionează baza de date cu partenerii comerciali
  • Produse și servicii - Administrează catalogul ofertei comerciale
🏢 Funcții Avansate
  • SPV/eFactura - Integrare cu sistemul fiscal ANAF
  • Reseller - Gestionare avansată pentru parteneri de distribuție
  • Informații generale - Validări CIF și date administrative

🔎 Beneficii cheie:

  • Automatizare completă - Toate procesele de facturare și încasare
  • Conformitate fiscală - Respectă legislația română în vigoare
  • Integrare universală - Compatibil cu orice aplicație sau platformă
  • Gestionare centralizată - Toate datele în același loc
  • API REST modern - Răspunsuri în format JSON structurat
  • Documentație completă - Swagger UI pentru teste și implementare
  • Securitate avansată - Autentificare prin API keys
  • Suport CRUD complet - Operații create, read, update, delete

🎯 Cazuri de utilizare:

Pentru dezvoltatori: Integrează rapid sistemul de facturare în aplicațiile existente, automatizează procesele de business și sincronizează datele între sisteme.
Pentru companii: Automatizează emiterea facturilor, gestionează eficient clienții și produsele, monitorizează încasările și respectă conform legislația fiscală.

API-ul Inside App este soluția completă pentru digitalizarea proceselor de facturare și gestionare financiară! 🚀

URL principal: https://api.iapp.ro/
URL secundar: https://api-facturare.inap.ro/
Format răspunsuri: JSON
Autentificare: API Key (Vezi secțiunea "Conectare")

Conectare

Accesul la datele oferite prin intermediul acestui API se face folosind un cont (utilizator și parola) prin metoda Basic Auth.

Pentru a obține cont, utilizator și parolă, crează un cont pe iapp.ro și apoi accesează pagina Firmele mele, alege firma dorită, apasă butonul Acțiuni, apoi butonul Integrare API și apoi urmărește instrucțiunile pentru activarea sistemului API.

Pentru mai multe informații vă rugăm să folosiți metodele de contact furnizate mai jos.

Facturi Proforme

Descriere generală:
Modulul de facturi proforme permite gestionarea completă a documentelor preliminare înainte de emiterea facturilor fiscale. Această funcționalitate oferă control total asupra procesului de pregatire a facturilor, permitând crearea, modificarea și conversia proformelor în facturi fiscale. Sistemul facilitează gestionarea ciclului complet de facturare, de la documentul preliminar până la factura finală.

Beneficii principale:

  • Prepararea documentelor înainte de facturarea finală
  • Verificarea și validarea datelor clienților și produselor
  • Conversie automată din proformă în factură fiscală
  • Gestionarea modificărilor înainte de finalizare

Operațiuni disponibile

Endpoint Funcționalitate Când se utilizează
/emite/proforma Crearea unei noi facturi proformă cu datele specificate Pentru prepararea documentului preliminar, oferirea de cotatii clienților sau pregătirea facturării finale
/emite/proforma-v2 Versiune îmbunătățită pentru emiterea facturilor proformă cu funcționalități extinse Pentru utilizarea funcțiilor avansate de facturare, integrări complexe sau când sunt necesare opțiuni suplimentare
/vizualizare/proforma Accesarea detaliilor complete ale unei facturi proformă specifice Pentru verificarea datelor unei proforme, analiza conținutului sau pregătirea modificărilor
/modifica/proforma Actualizarea datelor și informațiilor unei facturi proformă existente Pentru corectarea erorilor, actualizarea prețurilor sau modificarea datelor clientului înainte de facturare
/anuleaza/proforma Anularea unei facturi proformă și marcarea acesteia ca fiind anulată Când proforma nu mai este necesară, clientul a anulat comanda sau există erori majore care impun anularea
/factureaza/proforma Conversia unei facturi proformă în factură fiscală oficială Când clientul confirmă comanda, proforma este aprobată și se dorește emiterea facturii fiscale finale
/vizualizare/proforme Obținerea listei complete a facturilor proformă cu opțiuni de filtrare și sortare Pentru gestionarea tuturor proformelor, căutarea documentelor specifice sau generarea de rapoarte
/sterge/proforma Ștergerea definitivă a unei facturi proformă din sistem Pentru eliminarea proformelor care nu sunt necesare, curățarea bazei de date sau corectarea erorilor majore
Notă: Facturile proforme sunt documente cu scop informativ și nu se transmit în SPV.

POST /emite/proforma

https://api.iapp.ro/emite/proforma

Descriere:
Acest endpoint permite crearea unei noi facturi proformă cu datele specificate. Răspunsul include detaliile complete ale documentului creat: numărul proformei, datele clientului, articolele facturate și informațiile necesare pentru urmărirea sau conversia în factură fiscală.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /emite/proforma-v2

https://api.iapp.ro/emite/proforma-v2

Descriere:
Acest endpoint reprezintă versiunea îmbunătățită pentru crearea facturilor proformă cu funcționalități extinse. Oferă opțiuni avansate de configurare, suport pentru tipuri complexe de produse și integrări suplimentare pentru procesarea documentelor preliminare.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /vizualizare/proforma

https://api.iapp.ro/vizualizare/proforma

Descriere:
Acest endpoint returnează detaliile complete ale unei facturi proformă specifice. Răspunsul include toate informațiile documentului: datele clientului, lista produselor/serviciilor, totalurile calculate, statusul actual și orice alte detalii necesare pentru gestionarea proformei.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /modifica/proforma

https://api.iapp.ro/modifica/proforma

Descriere:
Acest endpoint permite actualizarea datelor unei facturi proformă existente. Poate modifica informațiile clientului, articolele incluse, prețurile sau alte detalii ale documentului, cu condiția ca proforma să nu fi fost încă convertită în factură fiscală.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /anuleaza/proforma

https://api.iapp.ro/anuleaza/proforma

Descriere:
Acest endpoint permite anularea unei facturi proformă și marcarea acesteia ca fiind invalidă. Proforma anulată nu mai poate fi utilizată pentru conversie în factură fiscală și va fi marcată corespunzător în sistem pentru evidența completă a documentelor.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /factureaza/proforma

https://api.iapp.ro/factureaza/proforma

Descriere:
Acest endpoint convertește o factură proformă existentă într-o factură fiscală oficială. Procesul include transferul tuturor datelor din proformă în noul document fiscal și generarea numerelor oficiale conform legislației în vigoare.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

GET /vizualizare/proforme

https://api.iapp.ro/vizualizare/proforme

Descriere:
Acest endpoint returnează lista completă a facturilor proformă cu opțiuni de filtrare și sortare. Răspunsul include informații sumare despre fiecare proformă: numărul documentului, clientul, data emiterii, statusul și totalul, facilitând gestionarea și căutarea rapidă.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /sterge/proforma

https://api.iapp.ro/sterge/proforma

Descriere:
Acest endpoint permite ștergerea definitivă a unei facturi proformă din sistem. Operația este ireversibilă și va elimina complet documentul și toate datele asociate din baza de date, fiind recomandată doar pentru proformele create eronat.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

Facturi Fiscale

Descriere generală:
Modulul de facturi fiscale permite gestionarea completă a documentelor oficiale cu valoare fiscală. Această funcționalitate oferă control total asupra procesului de facturare fiscală, de la emiterea facturilor până la gestionarea încasărilor și anulărilor. Sistemul asigură conformitatea cu legislația fiscală în vigoare și facilitează integrarea cu sistemele contabile.

Beneficii principale:

  • Emiterea facturilor cu valoare fiscală oficială
  • Conformitate automată cu legislația fiscală română
  • Gestionarea ciclului complet de facturare și încasare

Operațiuni disponibile

Endpoint Funcționalitate Când se utilizează
/emite/factura Crearea unei noi facturi fiscale cu valoare legală și număr oficial Pentru facturarea finală a serviciilor sau produselor, emiterea documentelor cu valoare fiscală oficială
/emite/factura-v2 Versiune îmbunătățită pentru emiterea facturilor fiscale cu funcționalități extinse Pentru facturarea complexă cu opțiuni avansate, integrări speciale sau când sunt necesare funcții suplimentare
/vizualizare/factura Accesarea detaliilor complete ale unei facturi fiscale specifice Pentru verificarea datelor unei facturi, consultarea informațiilor fiscale sau pregătirea documentelor pentru client
/modifica/factura Actualizarea datelor unei facturi fiscale în conformitate cu legislația Pentru corectarea erorilor în limitele legale, actualizarea datelor de contact sau modificări permise de lege
/anuleaza/factura Anularea unei facturi fiscale cu respectarea procedurilor legale Când factura conține erori majore, clientul returnează produsele sau în situații prevăzute de lege
/incaseaza/factura Marcarea unei facturi ca fiind încasată și gestionarea plăților Când se primește plata de la client, pentru actualizarea statusului de încasare și evidența contabilă
/storneaza/factura Stornarea unei facturi fiscale existente Când este necesară stornarea totală a unei facturi emise anterior. Se va emite o factură nouă.
/vizualizare/facturi Obținerea listei complete a facturilor fiscale cu opțiuni de filtrare avansată Pentru raportări fiscale, analiza vânzărilor, gestionarea facturilor neîncasate sau generarea de statistici
/sterge/factura Ștergerea unei facturi fiscale în conformitate cu prevederile legale În situații excepționale prevăzute de lege, pentru corectarea erorilor majore sau la solicitarea autorităților
Atenție: Toate facturile emise trebuie transmise în sistemul SPV ANAF pentru a fi considerate valide din punct de vedere fiscal. Asigurați-vă că respectați toate cerințele legale privind facturarea și arhivarea documentelor fiscale.

POST /emite/factura

https://api.iapp.ro/emite/factura

Descriere:
Acest endpoint permite crearea unei noi facturi fiscale cu valoare legală și număr oficial. Răspunsul include detaliile complete ale documentului creat: numărul fiscal, datele clientului, articolele facturate și toate informațiile necesare pentru conformitatea fiscală și contabilă.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /emite/factura-v2

https://api.iapp.ro/emite/factura-v2

Descriere:
Acest endpoint reprezintă versiunea îmbunătățită pentru crearea facturilor fiscale cu funcționalități extinse. Oferă opțiuni avansate de configurare, suport pentru tipuri complexe de tranzacții și integrări suplimentare pentru conformitatea fiscală completă.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /vizualizare/factura

https://api.iapp.ro/vizualizare/factura

Descriere:
Acest endpoint returnează detaliile complete ale unei facturi fiscale specifice. Răspunsul include toate informațiile documentului: datele fiscale, lista produselor/serviciilor, calculele TVA, totalurile și statusul actual al facturii în sistem.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /modifica/factura

https://api.iapp.ro/modifica/factura

Descriere:
Acest endpoint permite actualizarea datelor unei facturi fiscale în conformitate cu legislația fiscală. Modificările sunt limitate la anumite câmpuri permise de lege și numai în condițiile prevăzute de Codul Fiscal pentru menținerea validității documentului.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /anuleaza/factura

https://api.iapp.ro/anuleaza/factura

Descriere:
Acest endpoint permite anularea unei facturi fiscale cu respectarea procedurilor legale. Anularea se face conform prevederilor Codului Fiscal și include notificarea autorităților competente și actualizarea evidențelor contabile corespunzătoare.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /incaseaza/factura

https://api.iapp.ro/incaseaza/factura

Descriere:
Acest endpoint permite marcarea unei facturi fiscale ca fiind încasată și gestionarea plăților asociate. Include înregistrarea detaliilor plății, actualizarea statusului de încasare și integrarea cu sistemul de evidență contabilă pentru urmărirea completă a tranzacțiilor.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /storneaza/factura

https://api.iapp.ro/storneaza/factura

Descriere:
Acest endpoint permite stornarea unei facturi fiscale, astfel se va emite o factură nouă.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

GET /vizualizare/facturi

https://api.iapp.ro/vizualizare/facturi

Descriere:
Acest endpoint returnează lista completă a facturilor fiscale cu opțiuni de filtrare avansată și sortare. Răspunsul include informații sumare despre fiecare factură: numărul fiscal, clientul, data emiterii, statusul de încasare și totalul, facilitând raportările și analiza financiară.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /sterge/factura

https://api.iapp.ro/sterge/factura

Descriere:
Acest endpoint permite ștergerea unei facturi fiscale în conformitate cu prevederile legale. Operația este strict reglementată și poate fi efectuată doar în situații excepționale prevăzute de Codul Fiscal, cu respectarea tuturor procedurilor de conformitate.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

Încasări

Descriere generală:
Modulul de încasări permite gestionarea completă a plăților primite de la clienți și monitorizarea fluxului de numerar. Această funcționalitate oferă control total asupra procesului de încasare, de la înregistrarea plăților până la reconcilierea conturilor și generarea rapoartelor financiare. Sistemul facilitează urmărirea facturilor plătite și neplatite, gestionarea restanțelor și optimizarea fluxului de numerar.

Beneficii principale:

  • Monitorizarea în timp real a încasărilor și plăților
  • Urmărirea facturilor neachitate și gestionarea restanțelor
  • Raportări detaliate pentru analiza fluxului de numerar

Operațiuni disponibile

Endpoint Funcționalitate Când se utilizează
/vizualizare/incasari Obținerea listei complete a încasărilor cu opțiuni de filtrare și sortare Pentru monitorizarea tuturor plăților primite, analiza încasărilor pe perioade sau generarea rapoartelor financiare
/modifica/incasare Actualizarea detaliilor unei încasări existente sau corectarea informațiilor Pentru corectarea erorilor în datele de plată, actualizarea informațiilor bancare sau modificarea sumelor încasate
/vizualizare/incasare Accesarea detaliilor complete ale unei încasări specifice Pentru verificarea informațiilor unei plăți, consultarea detaliilor tranzacției sau pregătirea documentelor de confirmare
/sterge/incasare Ștergerea unei înregistrări de încasare din sistem Pentru eliminarea încasărilor înregistrate eronat, corectarea duplicatelor sau anularea tranzacțiilor invalidate
Notă importantă: Modulul de încasări funcționează în strânsă legătură cu sistemul de facturare. Încasările pot fi asociate automat cu facturile corespunzătoare pentru o urmărire completă a ciclului de facturare și plată.

GET /vizualizare/incasari

https://api.iapp.ro/vizualizare/incasari

Descriere:
Acest endpoint returnează lista completă a încasărilor cu opțiuni de filtrare și sortare. Răspunsul include informații despre fiecare plată primită: suma încasată, data tranzacției, metoda de plată, factura asociată și statusul procesării pentru monitorizarea fluxului de numerar.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /modifica/incasare

https://api.iapp.ro/modifica/incasare

Descriere:
Acest endpoint permite actualizarea detaliilor unei încasări existente sau corectarea informațiilor înregistrate. Include modificarea sumelor, datelor de tranzacție, metodelor de plată sau asocierea cu alte facturi pentru menținerea acurateței evidențelor financiare.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /vizualizare/incasare

https://api.iapp.ro/vizualizare/incasare

Descriere:
Acest endpoint returnează detaliile complete ale unei încasări specifice. Răspunsul include toate informațiile tranzacției: suma, data, metoda de plată, clientul, factura asociată, detaliile bancare și statusul procesării pentru verificarea completă a plății.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /sterge/incasare

https://api.iapp.ro/sterge/incasare

Descriere:
Acest endpoint permite ștergerea unei înregistrări de încasare din sistem. Operația elimină definitiv datele despre plata respectivă și actualizează statusurile facturilor asociate pentru corectarea erorilor sau eliminarea duplicatelor din evidențele financiare.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

Chitanțe

Descriere generală:
Modulul de chitanțe permite gestionarea completă a documentelor de confirmare a plăților primite de la clienți. Această funcționalitate oferă control total asupra emiterii, modificării și gestionării chitanțelor, asigurând documentarea corespunzătoare a tranzacțiilor financiare. Sistemul facilitează urmărirea plăților în numerar și confirmarea încasărilor pentru diverse tipuri de servicii sau produse.

Beneficii principale:

  • Emiterea rapidă a chitanțelor pentru plăți primite
  • Documentarea oficială a tranzacțiilor în numerar
  • Gestionarea completă a ciclului de viață al chitanțelor
  • Conformitate cu cerințele legale de documentare
  • Integrare cu sistemul de contabilitate și raportări
  • Exportul chitanței în format PDF.

Operațiuni disponibile

Endpoint Funcționalitate Când se utilizează
/emite/chitanta Crearea unei noi chitanțe pentru confirmarea unei plăți primite Când se primește o plată în numerar, pentru transfer bancar sau alte forme de plată care necesită confirmare
/vizualizare/chitanta Accesarea detaliilor complete ale unei chitanțe specifice Pentru verificarea informațiilor unei chitanțe, consultarea detaliilor plății sau pregătirea documentelor pentru client
/anuleaza/chitanta Anularea unei chitanțe și marcarea acesteia ca fiind invalidă Când chitanța a fost emisă eronat, plata a fost anulată sau în situații care impun invalidarea documentului
/modifica/chitanta Actualizarea informațiilor unei chitanțe existente în limitele legale Pentru corectarea erorilor minore, actualizarea datelor de contact sau modificări permise înainte de finalizare
/vizualizare/chitante Obținerea listei complete a chitanțelor cu opțiuni de filtrare și sortare Pentru monitorizarea tuturor chitanțelor emise, generarea rapoartelor de încasări sau analiza tranzacțiilor
/sterge/chitanta Ștergerea definitivă a unei chitanțe din sistem Pentru eliminarea chitanțelor create eronat, curățarea bazei de date sau în situații excepționale
Important: Chitanțele sunt documente fiscale cu valoare legală. Asigurați-vă că toate informațiile sunt corecte înainte de emitere și respectați cerințele legale privind numerotarea și arhivarea.
Tip: Pentru o gestionare eficientă, recomandăm emiterea chitanțelor imediat după primirea plății și verificarea periodică a listei pentru a asigura completitudinea înregistrărilor.

POST /emite/chitanta

https://api.iapp.ro/emite/chitanta

Descriere:
Acest endpoint permite crearea unei noi chitanțe pentru confirmarea unei plăți primite. Răspunsul include detaliile complete ale documentului creat: numărul chitanței, suma încasată, data emiterii și informațiile necesare pentru documentarea oficială a tranzacției.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /vizualizare/chitanta

https://api.iapp.ro/vizualizare/chitanta

Descriere:
Acest endpoint returnează detaliile complete ale unei chitanțe specifice. Răspunsul include toate informațiile documentului: numărul chitanței, suma, data emiterii, clientul, motivul plății și statusul actual pentru verificarea și gestionarea documentelor de plată.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /anuleaza/chitanta

https://api.iapp.ro/anuleaza/chitanta

Descriere:
Acest endpoint permite anularea unei chitanțe și marcarea acesteia ca fiind invalidă. Chitanța anulată nu mai poate fi utilizată ca document de confirmare a plății și va fi marcată corespunzător în sistem pentru evidența completă a documentelor.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /modifica/chitanta

https://api.iapp.ro/modifica/chitanta

Descriere:
Acest endpoint permite actualizarea informațiilor unei chitanțe existente în limitele legale. Include corectarea datelor de plată, modificarea informațiilor clientului sau actualizarea detaliilor tranzacției înainte de finalizarea definitivă a documentului.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

GET /vizualizare/chitante

https://api.iapp.ro/vizualizare/chitante

Descriere:
Acest endpoint returnează lista completă a chitanțelor cu opțiuni de filtrare și sortare. Răspunsul include informații sumare despre fiecare chitanță: numărul documentului, suma, clientul, data emiterii și statusul pentru monitorizarea și gestionarea documentelor de plată.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /sterge/chitanta

https://api.iapp.ro/sterge/chitanta

Descriere:
Acest endpoint permite ștergerea definitivă a unei chitanțe din sistem. Operația elimină complet documentul și toate datele asociate din baza de date, fiind recomandată doar pentru chitanțele create eronat sau în situații excepționale.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

Nomenclator Clienți

Descriere generală:
Modulul de nomenclator clienți permite gestionarea completă a bazei de date cu informațiile clienților companiei. Această funcționalitate oferă control total asupra procesului de administrare a clienților, de la adăugarea de noi parteneri până la actualizarea datelor existente și gestionarea relațiilor comerciale. Sistemul facilitează organizarea eficientă a informațiilor de contact, date fiscale și istoricul colaborărilor.

Beneficii principale:

  • Centralizarea tuturor informațiilor despre clienți
  • Gestionarea eficientă a datelor de contact și fiscale
  • Organizarea și căutarea rapidă în baza de clienți
  • Actualizare în timp real a informațiilor

Operațiuni disponibile

Endpoint Funcționalitate Când se utilizează
/clienti/lista Obținerea listei complete a clienților cu opțiuni de filtrare și sortare Pentru afișarea tuturor clienților, căutarea rapidă a unui client specific sau generarea listelor pentru raportări
/clienti/vizualizare Accesarea detaliilor complete ale unui client specific Pentru verificarea informațiilor unui client, consultarea datelor fiscale sau pregătirea facturării
/clienti/adauga Adăugarea unui nou client în baza de date cu toate informațiile necesare Când se stabilește o colaborare cu un nou partener, client sau furnizor care necesită înregistrare
/clienti/modifica Actualizarea informațiilor unui client existent Pentru corectarea datelor de contact, actualizarea informațiilor fiscale sau modificarea detaliilor comerciale
/clienti/sterge Ștergerea unui client din baza de date Pentru eliminarea clienților inactivi, duplicatelor sau în situații care impun încetarea colaborării

POST /clienti/lista

https://api.iapp.ro/clienti/lista

Descriere:
Acest endpoint returnează lista completă a clienților cu opțiuni de filtrare și sortare. Răspunsul include informații sumare despre fiecare client: denumirea, codul fiscal, datele de contact și statusul activ pentru căutarea rapidă și gestionarea bazei de date clienți.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /clienti/vizualizare

https://api.iapp.ro/clienti/vizualizare

Descriere:
Acest endpoint returnează detaliile complete ale unui client specific. Răspunsul include toate informațiile înregistrate: datele de identificare, informațiile fiscale, datele de contact, adresele de facturare și livrare, precum și istoricul colaborărilor pentru gestionarea completă a relației comerciale.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /clienti/adauga

https://api.iapp.ro/clienti/adauga

Descriere:
Acest endpoint permite adăugarea unui nou client în baza de date cu toate informațiile necesare. Include înregistrarea datelor de identificare, informațiilor fiscale, datelor de contact și adreselor pentru stabilirea unei noi relații comerciale și integrarea în sistemul de facturare.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /clienti/modifica

https://api.iapp.ro/clienti/modifica

Descriere:
Acest endpoint permite actualizarea informațiilor unui client existent. Include modificarea datelor de contact, actualizarea informațiilor fiscale, schimbarea adreselor sau corectarea oricăror detalii pentru menținerea bazei de date la zi și asigurarea acurateței documentelor comerciale.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /clienti/sterge

https://api.iapp.ro/clienti/sterge

Descriere:
Acest endpoint permite ștergerea unui client din baza de date. Operația elimină toate informațiile clientului din sistem, inclusiv istoricul colaborărilor, și trebuie efectuată cu atenție deoarece poate afecta integritatea datelor istorice și raportărilor financiare.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

Nomenclator Produse și Servicii

Descriere generală:
Modulul de nomenclator produse și servicii permite gestionarea completă a cataloagelor de produse și servicii oferite de companie. Această funcționalitate oferă control total asupra procesului de administrare a ofertei comerciale, de la adăugarea de noi articole până la actualizarea prețurilor și gestionarea stocurilor. Sistemul facilitează organizarea eficientă a informațiilor despre produse, categorisirea și integrarea directă cu procesul de facturare.

Beneficii principale:

  • Centralizarea tuturor produselor și serviciilor oferite
  • Gestionarea eficientă a prețurilor și categoriilor
  • Organizarea și căutarea rapidă în catalog
  • Actualizare în timp real a informațiilor

Operațiuni disponibile

Endpoint Funcționalitate Când se utilizează
/produse/lista Obținerea listei complete a produselor și serviciilor cu opțiuni de filtrare Pentru afișarea întregului catalog, căutarea rapidă a unui articol specific sau generarea listelor de prețuri
/produse/vizualizare Accesarea detaliilor complete ale unui produs sau serviciu specific Pentru verificarea informațiilor unui articol, consultarea prețurilor sau pregătirea ofertelor comerciale
/produse/adauga Adăugarea unui nou produs sau serviciu în catalog Când se lansează produse noi, se extinde gama de servicii sau se diversifică oferta comercială
/produse/modifica Actualizarea informațiilor unui produs sau serviciu existent Pentru modificarea prețurilor, actualizarea descrierilor sau corectarea datelor tehnice
/produse/sterge Eliminarea produselor sau serviciilor din catalog Pentru retragerea articolelor discontinued, eliminarea duplicatelor sau curățarea catalogului

POST /produse/lista

https://api.iapp.ro/produse/lista

Descriere:
Acest endpoint returnează lista completă a produselor și serviciilor cu opțiuni de filtrare. Răspunsul include informații sumare despre fiecare articol: codul, denumirea, prețul, unitatea de măsură și statusul activ pentru căutarea rapidă și selectarea în procesul de facturare.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /produse/vizualizare

https://api.iapp.ro/produse/vizualizare

Descriere:
Acest endpoint returnează detaliile complete ale unui produs sau serviciu specific. Răspunsul include toate informațiile înregistrate: codul articolului, denumirea completă, descrierea, prețurile, cotele TVA, categoriile și alte specificații pentru gestionarea detaliată a catalogului.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /produse/adauga

https://api.iapp.ro/produse/adauga

Descriere:
Acest endpoint permite adăugarea unui nou produs sau serviciu în catalog. Include înregistrarea codului articolului, denumirii, descrierii, prețurilor, cotelor TVA și altor specificații necesare pentru extinderea ofertei comerciale și integrarea în sistemul de facturare.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /produse/modifica

https://api.iapp.ro/produse/modifica

Descriere:
Acest endpoint permite actualizarea informațiilor unui produs sau serviciu existent. Include modificarea prețurilor, actualizarea descrierilor, schimbarea cotelor TVA sau corectarea altor detalii pentru menținerea catalogului la zi și reflectarea condițiilor actuale de piață.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /produse/sterge

https://api.iapp.ro/produse/sterge

Descriere:
Acest endpoint permite eliminarea produselor sau serviciilor din catalog. Operația șterge articolele selectate din sistem și trebuie efectuată cu atenție deoarece poate afecta facturile existente și istoricul vânzărilor pentru articolele respective.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

Conturi Bancare Suplimentare

Descriere generală:
Modulul de conturi bancare permite gestionarea completă a conturilor bancare suplimentare ale companiei. Această funcționalitate oferă control total asupra procesului de administrare a conturilor financiare, de la adăugarea de noi conturi până la actualizarea datelor existente și gestionarea informațiilor bancare. Sistemul facilitează organizarea eficientă a datelor financiare și integrarea cu procesele de facturare și încasare.

Beneficii principale:

  • Centralizarea tuturor conturilor bancare ale companiei
  • Organizarea și căutarea rapidă în lista conturilor
  • Actualizare în timp real a informațiilor
  • Integrare directă cu sistemul de facturare

Operațiuni disponibile

Endpoint Funcționalitate Când se utilizează
/conturibancare/lista Obținerea listei complete a conturilor bancare cu opțiuni de filtrare Pentru afișarea tuturor conturilor disponibile, căutarea unui cont specific sau selectarea pentru facturare
/conturibancare/vizualizare Accesarea detaliilor complete ale unui cont bancar specific Pentru verificarea informațiilor unui cont, consultarea datelor bancare sau pregătirea documentelor
/conturibancare/adauga Adăugarea unui nou cont bancar în sistem Când se deschide un cont nou, se schimbă banca sau se diversifică opțiunile de plată
/conturibancare/modifica Actualizarea informațiilor unui cont bancar existent Pentru corectarea datelor bancare, actualizarea informațiilor sau modificarea detaliilor contului
/conturibancare/sterge Eliminarea unui cont bancar din sistem Pentru închiderea conturilor nefolosite, eliminarea duplicatelor sau curățarea listei

POST /conturibancare/lista

https://api.iapp.ro/conturibancare/lista

Descriere:
Acest endpoint returnează lista completă a conturilor bancare cu opțiuni de filtrare. Răspunsul include informații sumare despre fiecare cont: denumirea băncii, IBAN-ul, moneda, statusul activ și alte detalii pentru căutarea rapidă și selectarea în procesul de facturare și încasare.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /conturibancare/vizualizare

https://api.iapp.ro/conturibancare/vizualizare

Descriere:
Acest endpoint returnează detaliile complete ale unui cont bancar specific. Răspunsul include toate informațiile înregistrate: denumirea băncii, IBAN-ul, codul SWIFT/BIC, adresa băncii, moneda contului și setările de utilizare pentru gestionarea completă a informațiilor financiare.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /conturibancare/adauga

https://api.iapp.ro/conturibancare/adauga

Descriere:
Acest endpoint permite adăugarea unui nou cont bancar în sistem. Include înregistrarea tuturor detaliilor necesare: denumirea băncii, IBAN-ul, codul SWIFT/BIC, adresa și setările de utilizare pentru extinderea opțiunilor de plată și diversificarea instrumentelor financiare disponibile.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /conturibancare/modifica

https://api.iapp.ro/conturibancare/modifica

Descriere:
Acest endpoint permite actualizarea informațiilor unui cont bancar existent. Include modificarea datelor băncii, actualizarea IBAN-ului, schimbarea setărilor de utilizare sau corectarea oricăror detalii pentru menținerea informațiilor bancare la zi și asigurarea acurateței proceselor financiare.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /conturibancare/sterge

https://api.iapp.ro/conturibancare/sterge

Descriere:
Acest endpoint permite eliminarea unui cont bancar din sistem. Operația șterge toate informațiile contului din baza de date și trebuie efectuată cu atenție deoarece poate afecta facturile existente și procesele de încasare care folosesc contul respectiv.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

Configurare Serii Facturi - Gestionarea Șabloanelor de Facturare

Descriere generală:
Modulul de configurare serii facturi permite gestionarea completă a șabloanelor și setărilor pentru emiterea facturilor. Această funcționalitate oferă control total asupra aspectului, numerotării și elementelor vizuale ale facturilor emise. Sistemul permite crearea mai multor serii de facturi cu configurări diferite, adaptate pentru diverse tipuri de clienți sau servicii.

Beneficii principale:

  • Personalizarea aspectului facturilor conform brandului companiei
  • Gestionarea multiplelor serii de numerotare
  • Control asupra elementelor vizuale (logo si template-uri)
  • Configurare automată a datelor companiei pe facturi
  • Flexibilitate în adaptarea facturilor pentru diverse contexte

Operațiuni disponibile

Endpoint Funcționalitate Când se utilizează
/serie/lista Obținerea listei complete a seriilor de facturi configurate cu informații sumare Pentru afișarea tuturor șabloanelor disponibile, selectarea seriei pentru facturare sau gestionarea configurărilor existente
/serie/vizualizare Accesarea detaliilor complete ale unei serii specifice, inclusiv toate setările de configurare Pentru verificarea setărilor unei serii, pregătirea modificărilor sau analiza configurării actuale
/serie/design Obținerea opțiunilor disponibile de design și personalizare pentru aspectul facturilor Pentru selectarea unui nou design, personalizarea aspectului facturilor sau actualizarea temei vizuale
/serie/adauga Crearea unei noi serii de facturi cu configurările și setările specificate La configurarea unei noi linii de business, crearea șabloanelor pentru clienți speciali sau lansarea unor servicii noi
/serie/modifica Actualizarea setărilor și configurărilor unei serii existente de facturi Pentru modificarea aspectului facturilor, actualizarea datelor companiei sau adaptarea la cerințe noi
/serie/sterge Eliminarea completă a unei serii de facturi din sistem Când o serie nu mai este necesară, restructurarea șabloanelor sau curățarea configurărilor nefolosite
/serie/sterge-logo Eliminarea logo-ului asociat unei configurații specifice de serie Pentru actualizarea brandului, înlocuirea logo-ului vechi sau revenirea la configurația standard fără logo
⚠️ Notă importantă: Modificările la seriile de facturi se aplică doar facturilor noi. Facturile deja emise păstrează configurarea existentă la momentul emiterii.

POST /serie/lista

https://api.iapp.ro/serie/lista

Descriere:
Acest endpoint returnează lista completă a seriilor de facturi configurate pentru companie. Răspunsul include informații sumare despre fiecare serie: denumirea, tipul de numerotare, statusul activ/inactiv și alte detalii esențiale pentru identificarea și gestionarea șabloanelor de facturare.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /serie/vizualizare

https://api.iapp.ro/serie/vizualizare

Descriere:
Acest endpoint returnează toate detaliile unei serii specifice de facturi. Răspunsul include configurările complete: setările de design, informațiile de numerotare, logo-ul asociat, culorile personalizate și toate opțiunile de afișare configurate pentru seria respectivă.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /serie/design

https://api.iapp.ro/serie/design

Descriere:
Acest endpoint returnează toate opțiunile disponibile de design și personalizare pentru facturile companiei. Răspunsul include șabloanele de layout disponibile, paletele de culori, opțiunile de font, stilurile de afișare și alte elemente vizuale care pot fi aplicate seriilor de facturi.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /serie/adauga

https://api.iapp.ro/serie/adauga

Descriere:
Acest endpoint permite crearea unei noi serii de facturi cu configurările specificate. Request-ul trebuie să includă toate setările dorite: denumirea seriei, tipul de numerotare, opțiunile de design, logo-ul (dacă este cazul) și alte preferințe de personalizare pentru noua serie de facturi.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /serie/modifica

https://api.iapp.ro/serie/modifica

Descriere:
Acest endpoint permite actualizarea configurărilor unei serii existente de facturi. Request-ul trebuie să specifice ID-ul seriei și noile setări dorite: modificări de design, actualizări ale informațiilor de contact, schimbări în numerotare sau alte ajustări ale aspectului facturilor.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /serie/sterge

https://api.iapp.ro/serie/sterge

Descriere:
Acest endpoint permite eliminarea completă a unei serii de facturi din sistem. Request-ul trebuie să specifice ID-ul seriei care urmează să fie ștearsă. Atenție: această operațiune este ireversibilă și va elimina definitiv toate configurările asociate seriei respective.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /serie/sterge-logo

https://api.iapp.ro/serie/sterge-logo

Descriere:
Acest endpoint permite eliminarea logo-ului asociat unei configurații specifice de serie de facturi. Request-ul trebuie să specifice ID-ul seriei pentru care urmează să fie eliminat logo-ul. După această operațiune, facturile vor fi generate fără logo personalizat, revenind la configurația standard.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

Curs Valutar

Descriere generală:
Modulul Curs Valutar oferă acces la informațiile actuale despre ratele de schimb valutar. Această funcționalitate permite obținerea cursurilor valutare oficiale pentru diverse monede, fiind utilă pentru calculele financiare, facturarea în valută străină și raportările contabile. Datele sunt actualizate regulat pentru a asigura acuratețea informațiilor financiare.

Beneficii principale:

  • Acces rapid la cursurile valutare actuale
  • Informații actualizate regulat
  • Suport pentru multiple monede
  • Integrare simplă în aplicații financiare
  • Date precise pentru calculele de conversie

Operațiuni disponibile

Endpoint Funcționalitate Când se utilizează
/vizualizare/cursvalutar Obținerea informațiilor complete despre cursurile valutare actuale pentru diverse monede Pentru afișarea cursurilor în aplicații, calculele de conversie valutară, facturarea în monedă străină sau raportările financiare

GET /vizualizare/cursvalutar

https://api.iapp.ro/vizualizare/cursvalutar

Descriere:
Acest endpoint returnează informațiile complete despre cursurile valutare actuale pentru principalele monede internationale. Răspunsul include ratele de schimb oficiale, cursurile de cumpărare și vânzare, precum și data ultimei actualizări a informațiilor.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

Informații Generale - Date despre Firmă

Descriere generală:
Secțiunea de informații generale oferă acces rapid la datele esențiale despre companiile din România. Această funcționalitate permite verificarea și obținerea informațiilor oficiale despre orice firmă înregistrată în România, utilizând codul unic de identificare (CIF). Sistemul furnizează date actualizate provenind din registrele oficiale, fiind util pentru verificări, validări și completarea automată a informațiilor în aplicații.

Beneficii principale:

  • Verificare rapidă a datelor oficiale ale companiilor
  • Validare automată a informațiilor fiscale
  • Completare automată a formularelor cu date corecte
  • Acces la informații actualizate din registrele oficiale
  • Reducerea erorilor în procesarea documentelor

Operațiuni disponibile

Endpoint Funcționalitate Când se utilizează
/info/cif Obținerea informațiilor complete despre o companie pe baza codului CIF Pentru verificarea datelor unei companii, completarea automată a formularelor sau validarea informațiilor fiscale înainte de emiterea facturilor

Fluxuri de lucru tipice

🔍 Verificare companie
  1. Introducere CIF companie
  2. Apel request /info/cif
  3. Verificare date returnate
  4. Utilizare informații pentru procesare
📝 Completare automată
  1. Scanare/introducere CIF
  2. Obținere date via /info/cif
  3. Populare automată formular
  4. Confirmare și salvare date
✅ Validare înainte de facturare
  1. Verificare CIF client via /info/cif
  2. Validare denumire și adresă oficială
  3. Confirmare date pentru facturare corectă
  4. Procedare cu emiterea facturii

POST /info/cif

https://api.iapp.ro/info/cif

Descriere:
Această metodă permite verificarea și obținerea informațiilor complete despre o companie pe baza codului de identificare fiscală (CIF).

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

Prelucrare facturi din SPV (Arhiva Digitală)

Descriere generală:
Modulul SPV funcționează ca o arhivă digitală completă pentru toate facturile electronice ale companiei. Inside App stochează automat toate facturile - atât cele emise către clienți, cât și cele primite de la furnizori - creând o bază de date centralizată accesibilă prin intermediul API-ului. Această arhivă digitală permite vizualizarea, căutarea și descărcarea oricărei facturi din istoric, oferind o soluție completă de management documentar pentru e-facturare.

Beneficii principale:

  • Arhivare automată a tuturor facturilor din SPV ANAF
  • Stocare centralizată și securizată a documentelor
  • Acces rapid la toate facturile din istoric
  • Căutare și filtrare avansată în arhivă
  • Descărcare on-demand a facturilor în format PDF și XML
  • Backup automat pentru conformitatea fiscală
  • Facturile sunt stocate pe toată perioada de valabilitate a abonamentului Inside App.
  • În arhivă sunt stocate toate facturile emise, indiferent de de aplicația sau metoda folosită pentru emiterea și transmiterea acestora.
  • Pentru firmele adăugate ulterior, arhiva va conține doar facturile emise și primite după activarea serviciului, incluzând facturile din ultimele 60 de zile (disponibile în SPV / ANAF).

Operațiuni disponibile

Endpoint Funcționalitate Când se utilizează
/e-factura/emise Vizualizarea listei facturilor emise stocate în arhiva digitală cu opțiuni de căutare și filtrare Pentru consultarea istoricului facturilor trimise, generarea rapoartelor de vânzări sau căutarea unei facturi specifice din arhivă
/e-factura/view-emise Accesarea detaliilor complete ale unei facturi emise din arhiva digitală Pentru vizualizarea informațiilor detaliate ale unei facturi emise, verificarea datelor sau pregătirea pentru retransmitere
/e-factura/descarca-emise Descărcarea fișierelor PDF și XML ale facturilor emise din arhiva digitală Pentru obținerea copiilor facturilor pentru clienți, arhivare locală sau integrarea în alte sisteme
/e-factura/furnizori Vizualizarea listei facturilor primite de la furnizori stocate în arhivă cu căutare și filtrare Pentru consultarea facturilor de achiziții din istoric, verificarea plăților efectuate sau generarea rapoartelor de cumpărări
/e-factura/view-furnizori Accesarea detaliilor complete ale unei facturi primite din arhiva digitală Pentru vizualizarea informațiilor detaliate ale unei facturi de achiziție sau verificarea datelor pentru reconcilieri
/e-factura/descarca-furnizori Descărcarea fișierelor PDF și XML ale facturilor primite din arhiva digitală Pentru obținerea copiilor facturilor de la furnizori, arhivare în sistemul de contabilitate sau audit
/e-factura/upload-xml Încărcarea manuală a fișierelor XML și transmitere în SPV Pentru trimitea în SPV a facturilor generate prin alte aplicații în format XML.
/e-factura/upload-status Verificarea stării încărcării fișierelor XML în SPV Pentru a verifica dacă fișierele XML încărcate manual au fost procesate de ANAF
/e-factura/autorizare Obținerea link-ului de autorizare pentru configurarea accesului la arhiva digitală SPV Pentru configurarea inițială a accesului la arhivă sau reînnoirea autorizării. Link-ul permite sincronizarea cu ANAF pentru actualizarea arhivei

Fluxuri de lucru tipice

📤 Consultarea facturilor emise
  1. Căutare în arhiva facturilor emise (/e-factura/emise)
  2. Vizualizare detalii factură specifică (/e-factura/view/emise)
  3. Descărcare copie din arhivă (/e-factura/descarca/emise)
  4. Utilizare pentru rapoarte sau alte acțiuni interne
📥 Consultarea facturilor primite
  1. Căutare în arhiva furnizorilor (/e-factura/furnizori)
  2. Vizualizare detalii factură primită (/e-factura/view/furnizori)
  3. Descărcare din arhivă (/e-factura/descarca/furnizori)
  4. Utilizare pentru rapoarte sau alte acțiuni interne

⚠️ Informații importante despre arhivă:
  • Este nevoie de un abonament activ pentru acces la arhiva digitală
  • Inside App sincronizează automat toate facturile din SPV ANAF în arhiva digitală
  • Arhiva conține atât facturile emise cât și cele primite de companie
  • Accesul la arhivă necesită autorizare validă cu ANAF
  • Facturile sunt stocate permanent pe serverele Inside App și pot fi accesate oricând din istoric.
  • Nu există limitări pentru disponibilitatea / accesarea request-urilor arhivei
  • Aceste request-uri se accesează pentru fiecare companie în parte.
📋 Notă tehnică: Arhiva digitală este actualizată automat cu facturile noi din SPV. Toate request-urile returnează date din arhiva locală Inside App pentru performanță optimă și acces rapid.

POST /e-factura/emise

https://api.iapp.ro/e-factura/emise

Descriere:
Returnează lista facturilor emise de companie din sistemul SPV ANAF. Permite filtrarea pe perioade și diverse criterii pentru a obține exact informațiile necesare.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /e-factura/view-emise

https://api.iapp.ro/e-factura/view-emise

Descriere:
Returnează detaliile complete ale unei facturi emise specifice din sistemul SPV ANAF, inclusiv toate pozițiile și informațiile fiscale detaliate.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /e-factura/descarca-emise

https://api.iapp.ro/e-factura/descarca-emise

Descriere:
Permite descărcarea fișierului XML original al unei facturi emise din sistemul SPV ANAF. Returnează conținutul XML în format base64 sau un link de download.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /e-factura/furnizori

https://api.iapp.ro/e-factura/furnizori

Descriere:
Returnează lista facturilor primite de la furnizori din sistemul SPV ANAF. Permite filtrarea și căutarea facturilor pe diverse criterii pentru gestionarea eficientă a cheltuielilor.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /e-factura/view-furnizori

https://api.iapp.ro/e-factura/view-furnizori

Descriere:
Returnează detaliile complete ale unei facturi primite de la un furnizor din sistemul SPV ANAF, inclusiv toate pozițiile și informațiile fiscale detaliate.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /e-factura/descarca-furnizori

https://api.iapp.ro/e-factura/descarca-furnizori

Descriere:
Permite descărcarea fișierului XML original al unei facturi primite de la furnizor din sistemul SPV ANAF. Returnează conținutul XML în format base64 sau un link de download.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /e-factura/upload-xml

https://api.iapp.ro/e-factura/upload-xml

Descriere:
Permite încărcarea manuală a facturilor în format XML în SPV.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /e-factura/upload-status

https://api.iapp.ro/e-factura/upload-status

Descriere:
Permite verificarea stării încărcării fișierelor XML în SPV. Returnează informații despre procesarea fișierelor XML încărcate manual, dar și despre facturile emise prin API-ul nostru (/emite/factura și /emite/factura-v2).

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /e-factura/autorizare

https://api.iapp.ro/e-factura/autorizare

Descriere:
Configurează autorizarea pentru e-facturare pentru o companie din portofoliul de reseller. Permite setarea certificatelor și credențialelor necesare pentru integrarea cu sistemul SPV ANAF.
Request-ul generează un Link unic către care va trebui să faceți redict clientului.
Aici, acesta va trebui să se conecteze cu semnătura lui digitală.
Foarte important, semnătura trebuie să fie validă și să corespundă CIF-ului companiei.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

Reseller - Gestionarea portofoliului de clienți

Descriere generală:
Modulul Reseller permite partenerilor autorizați să gestioneze eficient un portofoliu de companii cliente. Această funcționalitate oferă control complet asupra conturilor de clienți, permițând administrarea, monitorizarea și configurarea serviciilor pentru fiecare companie în parte. Sistemul facilitează procesele de onboarding, suport tehnic și gestionarea accesului la serviciile API.

Beneficii principale:

  • Gestionare centralizată a portofoliului de clienți
  • Control granular asupra accesului și permisiunilor
  • Automatizarea proceselor de configurare
  • Monitorizarea utilizării serviciilor
  • Suport pentru operațiuni în masă

Operațiuni disponibile

Endpoint Funcționalitate Când se utilizează
/firma/lista Obținerea listei complete a companiilor gestionate cu informații sumare și posibilități de filtrare Pentru afișarea dashboard-ului principal, rapoarte generale, căutări și filtrări în portofoliul de clienți
/firma/vizualizare Accesarea tuturor detaliilor unei companii specifice, inclusiv istoric și configurări Pentru suport tehnic, auditare, verificarea stării contului sau pregătirea unui raport detaliat pentru client
/firma/adauga Crearea unui cont nou pentru o companie în portofoliul de reseller La onboarding-ul unui client nou, migrarea unei companii existente sau extinderea portofoliului
/firma/modifica Actualizarea informațiilor unei companii existente (date de contact, adrese, responsabili, etc) Când clientul își modifică datele de contact, schimbă sediul sau responsabilii de cont
/firma/api Obținerea cheii API active pentru o companie specificată, necesară pentru gestionarea activității companiei din platforma proprie Pentru integrarea companiei în platforma ta, permitând administrarea completă a serviciilor direct din sistemul tău de management
/firma/api-reset Regenerarea cheii API și invalidarea celei anterioare pentru a menține securitatea și continuitatea integrării În caz de compromitere a securității, probleme de conectivitate sau când integrarea în platforma proprie necesită o nouă cheie
/firma/activeaza Activarea unei companii dezactivate și restaurarea accesului complet la servicii După rezolvarea problemelor de plată, finalizarea unei suspendări temporare sau reactivarea la cererea clientului
/firma/dezactiveaza Suspendarea temporară a serviciilor pentru o companie Pentru neplăți, încălcarea termenilor de utilizare, cereri de suspendare temporară sau mentenanță
/e-factura/autorizare Obținerea link-ului de autorizare pentru configurarea semnăturii digitale necesară gestionării facturilor din SPV și transmiterii facturilor noi în SPV ANAF Pentru configurarea inițială a certificatului digital sau reînnoirea acestuia. Request-ul returnează un link către care trebuie făcut redirect în interfața clientului pentru autorizarea ANAF

Fluxuri de lucru tipice

🚀 Onboarding client nou
  1. Adăugare companie (/firma/adauga)
  2. Configurare certificat e-facturare (/e-factura/autorizare)
  3. Verificare configurare (/firma/vizualizare)
  4. Salvează credențiale client pentru gestiune internă
🔧 Suport tehnic
  1. Identificare companie (/firma/lista)
  2. Analiza detalii (/firma/vizualizare)
  3. Verificare API (/firma/api)
  4. Reset API dacă e necesar (/firma/api-reset)

📋 Notă importantă: Toate operațiunile de reseller necesită permisiuni speciale, astfel dacă doriți utilizarea acestui sistem, vă rugăm să ne contactați. Utilizarea acestor funcționalități trebuie făcută cu atenție și doar de către personalul autorizat.

POST /firma/lista

https://api.iapp.ro/firma/lista

Descriere:
Returnează lista companiilor gestionate în calitate de reseller. Permite filtrarea și căutarea companiilor pentru gestionarea eficientă a portofoliului de clienți.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /firma/vizualizare

https://api.iapp.ro/firma/vizualizare

Descriere:
Returnează informațiile complete ale unei companii gestionate în calitate de reseller. Include toate detaliile necesare pentru administrare și suport.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /firma/api

https://api.iapp.ro/firma/api

Descriere:
Returnează cheia API activă pentru o companie gestionată în calitate de reseller. Această metodă permite obținerea cheii API necesare pentru integrările companiei.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /firma/api-reset

https://api.iapp.ro/firma/api-reset

Descriere:
Generează o nouă cheie API pentru o companie gestionată în calitate de reseller, invalidând cheia anterioară. Această operațiune trebuie folosită cu precauție.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /firma/adauga

https://api.iapp.ro/firma/adauga

Descriere:
Adaugă o nouă companie în portofoliul de reseller. Această metodă creează un cont nou pentru companie și generează automat o cheie API.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /firma/modifica

https://api.iapp.ro/firma/modifica

Descriere:
Modifică informațiile unei companii existente din portofoliul de reseller. Permite actualizarea datelor de contact, adresei și altor informații importante.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /firma/dezactiveaza

https://api.iapp.ro/firma/dezactiveaza

Descriere:
Dezactivează o companie din portofoliul de reseller. Compania nu va mai putea accesa API-ul și toate funcționalitățile vor fi suspendate temporar.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /firma/activeaza

https://api.iapp.ro/firma/activeaza

Descriere:
Activează o companie dezactivată din portofoliul de reseller. Restaurează accesul la API și toate funcționalitățile companiei.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

POST /e-factura/autorizare

https://api.iapp.ro/e-factura/autorizare

Descriere:
Configurează autorizarea pentru e-facturare pentru o companie din portofoliul de reseller. Permite setarea certificatelor și credențialelor necesare pentru integrarea cu sistemul SPV ANAF.
Request-ul generează un Link unic către care va trebui să faceți redict clientului.
Aici, acesta va trebui să se conecteze cu semnătura lui digitală.
Foarte important, semnătura trebuie să fie validă și să corespundă CIF-ului companiei.

Pentru detalii de implementare, parametrii, structură și exemple de request-uri accesează documentația în format swagger.

Exemple de cod PHP

Descărcați exemple practice pentru a începe rapid integrarea cu API-ul Inside App.
Pachet complet de exemple PHP
Ce conține pachetul:
  • Exemple pentru toate endpoint-urile - cod PHP funcțional pentru fiecare API
  • Clasă PHP pentru autentificare - gestionarea automată a token-urilor
  • Exemple de facturare completă - flux complet de la proformă la factură
  • Gestionare nomenclatoare - clienți, produse și servicii
  • Integrare SPV/e-Factura - prelucrare facturi ANAF
  • Exemple pentru Reseller - gestionare multiple firme
Descarcă exemple PHP (ZIP) Versiunea 1.9 • Actualizat: August 2025
Structura fișierelor
iapp_api/
├── api.php
├── config.php
├── FacturiProforme/
│   ├── emite-proforma.php
│   ├── emite-proforma-v2.php
│   ├── view-proforma.php
│   ├── anuleaza-proforma.php
│   └── factureaza-proforma.php
├── FacturiFiscale/
│   ├── emite-fiscala.php
│   ├── emite-fiscala-v2.php
│   ├── view-fiscala.php
│   ├── incaseaza-fiscala.php
│   └── anuleaza-fiscala.php
├── Chitante/
│   ├── emite-chitanta.php
│   ├── view-chitanta.php
│   ├── anuleaza-chitanta.php
│   └── modifica-chitanta.php
├── Incasari/
│   ├── view-incasari.php
│   ├── view-incasare.php
│   ├── modifica-incasare.php
│   └── sterge-incasare.php
├── NomenclatorClienti/
│   ├── clienti_lista.php
│   ├── clienti_vizualizare.php
│   ├── clienti_adauga.php
│   ├── clienti_modifica.php
│   └── clienti_sterge.php
├── NomenclatorProduseServicii/
│   ├── produse_lista.php
│   ├── produse_vizualizare.php
│   ├── produse_adauga.php
│   ├── produse_modifica.php
│   └── produse_sterge.php
├── ConturiBancare/
│   ├── conturibancare_lista.php
│   ├── conturibancare_vizualizare.php
│   ├── conturibancare_adauga.php
│   ├── conturibancare_modifica.php
│   └── conturibancare_sterge.php
├── Configurare/
│   ├── serie_lista.php
│   ├── serie_vizualizare.php
│   ├── serie_design.php
│   ├── serie_adauga.php
│   ├── serie_modifica.php
│   ├── serie_sterge.php
│   └── serie_sterge_logo.php
├── CursValutar/
│   └── view-cursvalutar.php
├── Info/
│   └── info-cif.php
├── SPV/
│   ├── e-factura_emise.php
│   ├── e-factura_emise_view.php
│   ├── e-factura_emise_descarca.php
│   ├── e-factura_furnizori.php
│   ├── e-factura_furnizori_view.php
│   └── e-factura_furnizori_descarca.php
│   └── e-factura_upload-xml.php
│   └── e-factura_upload-status.php
└── Reseller/
    ├── firma_lista.php
    ├── firma_vizualizare.php
    ├── firma_api.php
    ├── firma_api_reset.php
    ├── firma_adauga.php
    ├── firma_modifica.php
    ├── firma_activeaza.php
    ├── firma_dezactiveaza.php
    └── e-factura_autorizare.php
Start rapid
Pași pentru integrare:
  1. Descărcați și extrageți arhiva ZIP
  2. Editați config/config.php cu credențialele dvs.
  3. Rulați exemplele din directorul dorit
  4. Adaptați codul pentru aplicația dvs.
Cerințe sistem:
  • • PHP 7.4+ sau 8.x
  • • cURL extension
  • • JSON extension
Exemple populare
  • Flux facturare completă
    Proformă → Factură → Încasare
  • Sincronizare nomenclatoare
    Import/export clienți și produse
  • Integrare SPV
    Descărcare automată facturi ANAF
  • Gestionare multi-firmă
    Pentru parteneri Reseller
Aveți nevoie de ajutor?

Pentru asistență tehnică sau întrebări specifice despre implementare:

Contact

Crează un ticket: developer.iapp.ro

Adresa de email: support@iapp.ro

Telefon: +40 773 334 875

WhatsApp: +40 770 846 823

WebSite: iapp.ro