Bine ai venit!

Acest API îți oferă acces rapid și eficient la informații detaliate despre firmele din România, utilizând codul unic de identificare fiscală (CIF). Indiferent dacă ai nevoie de date pentru analiză, verificare sau integrare în propriul sistem, API-ul nostru este soluția ideală.

🚀 Funcționalitățile disponibile:

• Informații despre firme – Obține rapid detalii despre orice firmă din România pe baza CIF-ului.
• Nomenclator de județe – Accesează lista completă a județelor din România, actualizată și structurată.
• Nomenclator de localități – Explorează toate orașele, comunele și satele din România într-un format organizat și ușor de utilizat.

🔎 Beneficii:

• Acces rapid la date administrative organizate.
• Standardizare conform normelor oficiale.
• Ușor de integrat în orice sistem sau platformă.
• Toate răspunsurile sunt în formatul JSON.

API-ul este conceput pentru a fi rapid, fiabil și ușor de integrat în orice aplicație sau platformă.

Începe acum și descoperă puterea datelor bine organizate! 🚀

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 API Informații Firme și urmează pașii pentru generarea acestora.

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

Informații firmă

Obține informații despre o companie din românia pe baza CIF-ului.

POST /companie

Parametrii POST:

• "cif" - valoare tip integer sau string, ex: 14399840 sau RO14399840;

Exemplu de cod (PHP):

<?php

    $url = "https://api.inap.ro/companie";
    
    $curl = curl_init($url);
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_POST, true);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    
    $headers = array(
       "Authorization: Basic ".base64_encode("{USERNAME}:{PASSWORD}"),
       "Content-Type: application/json",
    );
    curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
    
    $data = '{"cif": "14399840"}';
    
    curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
    $resp = curl_exec($curl);
    curl_close($curl);
    var_dump($resp);
    

Exemplu de cod (python):

import requests
import base64
from requests.structures import CaseInsensitiveDict

auth_string = f"{USERNAME}:{PASSWORD}"
auth_encoded = base64.b64encode(auth_string.encode()).decode()

headers = CaseInsensitiveDict()
headers["Authorization"] = f"Basic {auth_encoded}"
headers["Content-Type"] = "application/json"

url = "https://api.inap.ro/companie"
data = '{"cif": "14399840"}'
resp = requests.post(url, headers=headers, data=data)

# Afișarea codului de răspuns
print(resp.status_code)
print(resp.text)
    

Exemplu de răspuns (JSON):

{
    "status": "SUCCESS",
    "error_code": "000",
    "message": "Informațiile au fost afisate cu succes.",
    "request": "companie",
    "data": {
        "input": {
            "cif": 14399840
        },
        "output": {
            "nume": "DANTE INTERNATIONAL SA",
            "cif": "14399840",
            "regcom": "J40/372/2002",
            "euid": "ROONRC.J40/372/2002",
            "tva": "Y",
            "caen": "",
            "data_inregistrare": "",
            "adresa": {
                "tara": "România",
                "judet_cod": "Bucureşti",
                "judet": "Bucureşti",
                "oras": "SECTOR6",
                "adresa": "Şos. VIRTUŢII, Nr. 148, spatiul E47, Cod poștal 60787"
            },
            "activa": "da",
            "actualizare": "2024-12-18 00:00",
            "stare": {
                "cod": "1048",
                "text": ""
            }
        }
    }
}

Nomenclatorul de Județe și Localități din România

API-ul nostru oferă acces la un nomenclator complet și actualizat al județelor și localităților din România. Aceste date sunt esențiale pentru orice aplicație care necesită organizare teritorială precisă, fie că este vorba despre gestionarea adreselor, validarea informațiilor sau analiza geografică.

📌 Ce informații sunt disponibile?

• Nomenclator de județe – Lista completă a județelor din România, fiecare identificat printr-un cod unic și un nume standardizat.
• Nomenclator de localități – Include orașe, comune și sate, fiecare asociată județului corespunzător.

Aceste informații sunt structurate pentru a fi ușor de utilizat, atât pentru căutări rapide, cât și pentru integrări avansate în aplicații software.

POST /nomenclator/judete

Acest request oferă lista județelor și codul asociat fiecăruia.

Nu sunt necesari parametri.

Exemplu de cod (PHP):

<?php

    $url = "https://api.inap.ro/nomenclator/judete";
    
    $curl = curl_init($url);
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_POST, true);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    
    $headers = array(
       "Authorization: Basic ".base64_encode("{USERNAME}:{PASSWORD}"),
       "Content-Type: application/json",
    );
    curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
    
    $resp = curl_exec($curl);
    curl_close($curl);
    var_dump($resp);
    

Exemplu de răspuns (JSON):

{
    "status": "SUCCESS",
    "error_code": "000",
    "message": "",
    "request": "nomenclator/judete",
    "data": {
        "output": [{
                "cod": "1",
                "auto": "AB",
                "name": "ALBA",
                "sort": "1"
            },
            {
                "cod": "2",
                "auto": "AR",
                "name": "ARAD",
                "sort": "2"
            },
            ...
        ]
    }
}

POST /nomenclator/localitati

Acest request oferă lista de orașe / comune / sate, asociată cu județul selectat de tine.

Parametrii POST:

• "cod" - valoare tip integer, reprezită codul asociat județului pentru care se solicită nomenclatorul;

{ "cod": {NUMAR} }

Exemplu de cod (PHP):

<?php

    $url = "https://api.inap.ro/nomenclator/localitati";
    
    $curl = curl_init($url);
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_POST, true);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    
    $headers = array(
       "Authorization: Basic ".base64_encode("{USERNAME}:{PASSWORD}"),
       "Content-Type: application/json",
    );
    curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
    
    $data = '{"cod": 1}';
    
    curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
    $resp = curl_exec($curl);
    curl_close($curl);
    var_dump($resp);
    

Exemplu de răspuns (JSON):

{
    "status": "SUCCESS",
    "error_code": "000",
    "message": "",
    "request": "nomenclator/localitati",
    "data": {
        "input": {
            "cod": 52
        },
        "output": [{
                "cod": "2",
                "cod_parinte": "0",
                "tip": "Com",
                "name": "Adunaţii-Copăceni",
                "postal": "87005"
            },
            {
                "cod": "1",
                "cod_parinte": "2",
                "tip": "Sat",
                "name": "Adunaţii-Copăceni",
                "postal": "87005"
            },
            ...
        ]
    }
}

Explicația Codurilor de Eroare din API

API-ul nostru returnează un cod de eroare și un mesaj descriptiv pentru fiecare răspuns, astfel încât utilizatorii să poată înțelege rapid rezultatul cererii efectuate.

Aceste coduri de eroare sunt esențiale pentru a diagnostica problemele întâmpinate în utilizarea API-ului și pentru a lua măsurile necesare în vederea corectării acestora. Mesajul asociat fiecărui cod oferă detalii clare despre natura erorii, facilitând integrarea și depanarea aplicațiilor care utilizează API-ul.

Lista Codurilor de Eroare

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