insideapp-python-sdk 1.30.2__py3-none-any.whl

insideapp/client.py

@@ -0,0 +1,1040 @@
+"""
+Client principal InsideApp Python SDK.
+
+Această clasă implementează toate metodele API ale InsideApp pentru:
+- Gestiune facturi (proformă, fiscale, chitanțe)  
+- Integrare SPV/eFactura cu ANAF
+- Management clienți, produse, servicii, conturi bancare
+- API Reseller pentru mai multe firme
+- Utilitare (validare CIF, cursuri valutar, etc.)
+"""
+
+import json
+import base64
+from typing import Dict, Any, List, Optional, Union
+from urllib.parse import urljoin
+
+import requests
+from requests.auth import HTTPBasicAuth
+from requests.exceptions import RequestException, Timeout, ConnectionError
+
+from .exceptions import (
+    InsideAppError,
+    InsideAppAPIError, 
+    InsideAppAuthError,
+    InsideAppValidationError,
+    InsideAppTimeoutError,
+    InsideAppConnectionError,
+)
+
+
+class InsideAppClient:
+    """
+    Client principal pentru interacțiunea cu API-ul InsideApp.
+    
+    SDK oficial Python pentru InsideApp - gestiune facturi și integrare completă cu SPV.
+    Tot ce ai nevoie pentru facturarea în România: emite facturi, integrează automat cu 
+    ANAF eFactura și gestionează tot procesul pentru mai multe firme.
+    
+    Attributes:
+        base_url (str): URL-ul de bază al API-ului InsideApp
+        timeout (int): Timeout pentru requesturi în secunde
+        
+    Example:
+        >>> from insideapp import InsideAppClient
+        >>> client = InsideAppClient("username", "password")
+        >>> judete = client.info_judete()
+        >>> print(len(judete))  # 42 județe
+    """
+    
+    def __init__(self, username: str, password: str, timeout: int = 300):
+        """
+        Inițializează clientul InsideApp.
+        
+        Args:
+            username (str): Numele de utilizator (email/username API)
+            password (str): Parola API
+            timeout (int, optional): Timeout pentru requesturi în secunde. Default: 300
+            
+        Raises:
+            InsideAppValidationError: Dacă credențialele sunt goale
+        """
+        if not username:
+            raise InsideAppValidationError("Username-ul nu poate fi gol")
+        if not password:
+            raise InsideAppValidationError("Parola nu poate fi golă")
+            
+        self.username = username
+        self.password = password
+        self.base_url = "https://api.my.iapp.ro/"
+        self.timeout = timeout
+        
+        # Setup sesiune HTTP cu autentificare
+        self.session = requests.Session()
+        self.session.auth = HTTPBasicAuth(username, password)
+        self.session.timeout = timeout
+        
+        # Headers default
+        self.session.headers.update({
+            'User-Agent': 'InsideApp-Python-SDK/1.30.2',
+            'Accept': 'application/json',
+            'Content-Type': 'application/json',
+        })
+    
+    def get_version(self) -> str:
+        """
+        Returnează versiunea SDK-ului.
+        
+        Returns:
+            str: Versiunea curentă a SDK-ului
+        """
+        return "1.30.2"
+    
+    def set_timeout(self, timeout: int) -> 'InsideAppClient':
+        """
+        Setează timeout-ul pentru requesturi.
+        
+        Args:
+            timeout (int): Timeout în secunde
+            
+        Returns:
+            InsideAppClient: Instanța clientului pentru method chaining
+        """
+        self.timeout = timeout
+        self.session.timeout = timeout
+        return self
+    
+    def _make_request(
+        self, 
+        method: str, 
+        endpoint: str, 
+        data: Optional[Dict[str, Any]] = None,
+        params: Optional[Dict[str, Any]] = None,
+        download: bool = False
+    ) -> Union[Dict[str, Any], List[Any], bytes]:
+        """
+        Execută un request HTTP către API-ul InsideApp.
+        
+        Args:
+            method (str): Metoda HTTP (GET, POST, etc.)
+            endpoint (str): Endpoint-ul API (ex: "emite/factura")
+            data (dict, optional): Datele de trimis în request body
+            params (dict, optional): Parametrii URL pentru GET requests
+            download (bool): Dacă să returneze conținutul pentru download
+            
+        Returns:
+            Union[Dict, List, bytes]: Răspunsul decodat JSON sau bytes pentru download
+            
+        Raises:
+            InsideAppAuthError: Pentru erori de autentificare
+            InsideAppAPIError: Pentru erori returnate de API
+            InsideAppTimeoutError: Pentru timeout-uri
+            InsideAppConnectionError: Pentru erori de conexiune
+        """
+        url = urljoin(self.base_url, endpoint.lstrip('/'))
+        
+        try:
+            if method.upper() == 'GET':
+                response = self.session.get(url, params=params)
+            else:
+                response = self.session.post(url, json=data)
+                
+            # Verifică status code
+            if response.status_code == 401:
+                raise InsideAppAuthError("Credențiale invalide sau expirate")
+            elif response.status_code == 403:
+                raise InsideAppAuthError("Acces interzis - verifică permisiunile")
+            elif response.status_code >= 500:
+                raise InsideAppAPIError(
+                    f"Eroare server: {response.status_code}",
+                    status_code=response.status_code
+                )
+            elif response.status_code >= 400:
+                try:
+                    error_data = response.json()
+                    error_msg = error_data.get('message', f'Eroare API: {response.status_code}')
+                except ValueError:
+                    error_msg = f'Eroare API: {response.status_code}'
+                    
+                raise InsideAppAPIError(
+                    error_msg,
+                    status_code=response.status_code,
+                    response_data=error_data if 'error_data' in locals() else {}
+                )
+            
+            # Pentru download
+            if download:
+                return response.content
+                
+            # Încearcă să decodeze JSON
+            try:
+                return response.json()
+            except ValueError as e:
+                raise InsideAppAPIError(f"Răspuns invalid JSON: {e}")
+                
+        except Timeout as e:
+            raise InsideAppTimeoutError(f"Request timeout după {self.timeout} secunde: {e}")
+        except ConnectionError as e:
+            raise InsideAppConnectionError(f"Eroare de conexiune: {e}")
+        except RequestException as e:
+            raise InsideAppError(f"Eroare request: {e}")
+
+    # =========================================================================
+    # FACTURI PROFORMA
+    # =========================================================================
+    
+    def emite_proforma(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Emite o factură proforma.
+        
+        Args:
+            data (dict): Datele pentru factura proforma
+            
+        Returns:
+            dict: Răspunsul API cu detaliile proformei emise
+        """
+        return self._make_request("POST", "emite/proforma", data)
+    
+    def emite_proforma_v2(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Emite o factură proforma (versiunea 2 a API-ului).
+        
+        Args:
+            data (dict): Datele pentru factura proforma
+            
+        Returns:
+            dict: Răspunsul API cu detaliile proformei emise
+        """
+        return self._make_request("POST", "emite/proforma_v2", data)
+    
+    def view_proforma(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Vizualizează detaliile unei facturi proforma.
+        
+        Args:
+            data (dict): Datele cu ID-ul proformei
+            
+        Returns:
+            dict: Datele complete ale proformei
+        """
+        return self._make_request("POST", "view/proforma", data)
+        
+    def view_proforme(self, data: Optional[Dict[str, Any]] = None) -> List[Dict[str, Any]]:
+        """
+        Listează toate facturile proforma.
+        
+        Args:
+            data (dict, optional): Filtere pentru listă
+            
+        Returns:
+            list: Lista facturilor proforma
+        """
+        return self._make_request("POST", "view/proforme", data or {})
+    
+    def cancel_proforma(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Anulează o factură proforma.
+        
+        Args:
+            data (dict): Datele cu ID-ul proformei de anulat
+            
+        Returns:
+            dict: Confirmarea anulării
+        """
+        return self._make_request("POST", "cancel/proforma", data)
+    
+    def factureaza_proforma(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Transformă o proforma în factură fiscală.
+        
+        Args:
+            data (dict): Datele proformei de transformat
+            
+        Returns:
+            dict: Datele facturii fiscale create
+        """
+        return self._make_request("POST", "factureaza/proforma", data)
+
+    # =========================================================================
+    # FACTURI FISCALE
+    # =========================================================================
+    
+    def emite_factura(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Emite o factură fiscală.
+        
+        Args:
+            data (dict): Datele pentru factura fiscală
+            
+        Returns:
+            dict: Răspunsul API cu detaliile facturii emise
+        """
+        return self._make_request("POST", "emite/factura", data)
+    
+    def emite_factura_v2(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Emite o factură fiscală (versiunea 2 a API-ului).
+        
+        Args:
+            data (dict): Datele pentru factura fiscală
+            
+        Returns:
+            dict: Răspunsul API cu detaliile facturii emise
+        """
+        return self._make_request("POST", "emite/factura_v2", data)
+    
+    def view_factura(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Vizualizează detaliile unei facturi fiscale.
+        
+        Args:
+            data (dict): Datele cu ID-ul facturii
+            
+        Returns:
+            dict: Datele complete ale facturii
+        """
+        return self._make_request("POST", "view/factura", data)
+    
+    def view_facturi(self, data: Optional[Dict[str, Any]] = None) -> List[Dict[str, Any]]:
+        """
+        Listează toate facturile fiscale.
+        
+        Args:
+            data (dict, optional): Filtere pentru listă
+            
+        Returns:
+            list: Lista facturilor fiscale
+        """
+        return self._make_request("POST", "view/facturi", data or {})
+    
+    def cancel_factura(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Anulează o factură fiscală.
+        
+        Args:
+            data (dict): Datele cu ID-ul facturii de anulat
+            
+        Returns:
+            dict: Confirmarea anulării
+        """
+        return self._make_request("POST", "cancel/factura", data)
+    
+    def incaseaza_factura(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Marchează o factură ca fiind încasată.
+        
+        Args:
+            data (dict): Datele cu ID-ul facturii și detaliile încasării
+            
+        Returns:
+            dict: Confirmarea încasării
+        """
+        return self._make_request("POST", "incaseaza/factura", data)
+    
+    def storneaza_factura(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Stornează o factură fiscală.
+        
+        Args:
+            data (dict): Datele pentru stornare
+            
+        Returns:
+            dict: Datele facturii de stornare
+        """
+        return self._make_request("POST", "storneaza/factura", data)
+
+    # =========================================================================
+    # CHITANȚE
+    # =========================================================================
+    
+    def emite_chitanta(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Emite o chitanță.
+        
+        Args:
+            data (dict): Datele pentru chitanță
+            
+        Returns:
+            dict: Răspunsul API cu detaliile chitanței emise
+        """
+        return self._make_request("POST", "emite/chitanta", data)
+    
+    def view_chitanta(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Vizualizează detaliile unei chitanțe.
+        
+        Args:
+            data (dict): Datele cu ID-ul chitanței
+            
+        Returns:
+            dict: Datele complete ale chitanței
+        """
+        return self._make_request("POST", "view/chitanta", data)
+    
+    def view_chitante(self, data: Optional[Dict[str, Any]] = None) -> List[Dict[str, Any]]:
+        """
+        Listează toate chitanțele.
+        
+        Args:
+            data (dict, optional): Filtere pentru listă
+            
+        Returns:
+            list: Lista chitanțelor
+        """
+        return self._make_request("POST", "view/chitante", data or {})
+    
+    def anuleaza_chitanta(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Anulează o chitanță.
+        
+        Args:
+            data (dict): Datele cu ID-ul chitanței de anulat
+            
+        Returns:
+            dict: Confirmarea anulării
+        """
+        return self._make_request("POST", "anuleaza/chitanta", data)
+    
+    def sterge_chitanta(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Șterge o chitanță.
+        
+        Args:
+            data (dict): Datele cu ID-ul chitanței de șters
+            
+        Returns:
+            dict: Confirmarea ștergerii
+        """
+        return self._make_request("POST", "sterge/chitanta", data)
+
+    # =========================================================================
+    # ÎNCASĂRI
+    # =========================================================================
+    
+    def view_incasari(self, data: Optional[Dict[str, Any]] = None) -> List[Dict[str, Any]]:
+        """
+        Listează toate încasările.
+        
+        Args:
+            data (dict, optional): Filtere pentru listă
+            
+        Returns:
+            list: Lista încasărilor
+        """
+        return self._make_request("POST", "view/incasari", data or {})
+    
+    def view_incasare(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Vizualizează detaliile unei încasări.
+        
+        Args:
+            data (dict): Datele cu ID-ul încasării
+            
+        Returns:
+            dict: Datele complete ale încasării
+        """
+        return self._make_request("POST", "view/incasare", data)
+    
+    def sterge_incasare(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Șterge o încasare.
+        
+        Args:
+            data (dict): Datele cu ID-ul încasării de șters
+            
+        Returns:
+            dict: Confirmarea ștergerii
+        """
+        return self._make_request("POST", "sterge/incasare", data)
+
+    # =========================================================================
+    # NOMENCLATOR CLIENȚI
+    # =========================================================================
+    
+    def clienti_lista(self, data: Optional[Dict[str, Any]] = None) -> List[Dict[str, Any]]:
+        """
+        Listează toți clienții.
+        
+        Args:
+            data (dict, optional): Filtere pentru listă
+            
+        Returns:
+            list: Lista clienților
+        """
+        return self._make_request("POST", "clienti/lista", data or {})
+    
+    def clienti_vizualizare(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Vizualizează detaliile unui client.
+        
+        Args:
+            data (dict): Datele cu ID-ul clientului
+            
+        Returns:
+            dict: Datele complete ale clientului
+        """
+        return self._make_request("POST", "clienti/vizualizare", data)
+    
+    def clienti_adauga(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Adaugă un client nou.
+        
+        Args:
+            data (dict): Datele clientului nou
+            
+        Returns:
+            dict: Datele clientului creat
+        """
+        return self._make_request("POST", "clienti/adauga", data)
+    
+    def clienti_modifica(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Modifică datele unui client.
+        
+        Args:
+            data (dict): Datele actualizate ale clientului
+            
+        Returns:
+            dict: Datele clientului modificat
+        """
+        return self._make_request("POST", "clienti/modifica", data)
+    
+    def clienti_sterge(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Șterge un client.
+        
+        Args:
+            data (dict): Datele cu ID-ul clientului de șters
+            
+        Returns:
+            dict: Confirmarea ștergerii
+        """
+        return self._make_request("POST", "clienti/sterge", data)
+
+    # =========================================================================
+    # NOMENCLATOR PRODUSE/SERVICII
+    # =========================================================================
+    
+    def produse_lista(self, data: Optional[Dict[str, Any]] = None) -> List[Dict[str, Any]]:
+        """
+        Listează toate produsele și serviciile.
+        
+        Args:
+            data (dict, optional): Filtere pentru listă
+            
+        Returns:
+            list: Lista produselor/serviciilor
+        """
+        return self._make_request("POST", "produse/lista", data or {})
+    
+    def produse_vizualizare(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Vizualizează detaliile unui produs/serviciu.
+        
+        Args:
+            data (dict): Datele cu ID-ul produsului
+            
+        Returns:
+            dict: Datele complete ale produsului
+        """
+        return self._make_request("POST", "produse/vizualizare", data)
+    
+    def produse_adauga(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Adaugă un produs/serviciu nou.
+        
+        Args:
+            data (dict): Datele produsului nou
+            
+        Returns:
+            dict: Datele produsului creat
+        """
+        return self._make_request("POST", "produse/adauga", data)
+    
+    def produse_modifica(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Modifică datele unui produs/serviciu.
+        
+        Args:
+            data (dict): Datele actualizate ale produsului
+            
+        Returns:
+            dict: Datele produsului modificat
+        """
+        return self._make_request("POST", "produse/modifica", data)
+    
+    def produse_sterge(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Șterge un produs/serviciu.
+        
+        Args:
+            data (dict): Datele cu ID-ul produsului de șters
+            
+        Returns:
+            dict: Confirmarea ștergerii
+        """
+        return self._make_request("POST", "produse/sterge", data)
+
+    # =========================================================================
+    # CONFIGURARE SERII
+    # =========================================================================
+    
+    def serie_lista(self, data: Optional[Dict[str, Any]] = None) -> List[Dict[str, Any]]:
+        """
+        Listează toate seriile de facturi.
+        
+        Args:
+            data (dict, optional): Filtere pentru listă
+            
+        Returns:
+            list: Lista seriilor
+        """
+        return self._make_request("POST", "serie/lista", data or {})
+    
+    def serie_vizualizare(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Vizualizează detaliile unei serii.
+        
+        Args:
+            data (dict): Datele cu ID-ul seriei
+            
+        Returns:
+            dict: Datele complete ale seriei
+        """
+        return self._make_request("POST", "serie/vizualizare", data)
+    
+    def serie_design(self, data: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+        """
+        Obține setările de design ale facturilor.
+        
+        Args:
+            data (dict, optional): Parametrii pentru design
+            
+        Returns:
+            dict: Setările de design
+        """
+        return self._make_request("POST", "serie/design", data or {})
+    
+    def serie_adauga(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Adaugă o serie nouă.
+        
+        Args:
+            data (dict): Datele seriei noi
+            
+        Returns:
+            dict: Datele seriei create
+        """
+        return self._make_request("POST", "serie/adauga", data)
+    
+    def serie_modifica(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Modifică o serie existentă.
+        
+        Args:
+            data (dict): Datele actualizate ale seriei
+            
+        Returns:
+            dict: Datele seriei modificate
+        """
+        return self._make_request("POST", "serie/modifica", data)
+    
+    def serie_sterge(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Șterge o serie.
+        
+        Args:
+            data (dict): Datele cu ID-ul seriei de șters
+            
+        Returns:
+            dict: Confirmarea ștergerii
+        """
+        return self._make_request("POST", "serie/sterge", data)
+    
+    def serie_sterge_logo(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Șterge logo-ul unei serii.
+        
+        Args:
+            data (dict): Datele cu ID-ul seriei
+            
+        Returns:
+            dict: Confirmarea ștergerii logo-ului
+        """
+        return self._make_request("POST", "serie/sterge_logo", data)
+
+    # =========================================================================
+    # CONTURI BANCARE
+    # =========================================================================
+    
+    def conturi_bancare_lista(self, data: Optional[Dict[str, Any]] = None) -> List[Dict[str, Any]]:
+        """
+        Listează toate conturile bancare.
+        
+        Args:
+            data (dict, optional): Filtere pentru listă
+            
+        Returns:
+            list: Lista conturilor bancare
+        """
+        return self._make_request("POST", "conturi_bancare/lista", data or {})
+    
+    def conturi_bancare_vizualizare(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Vizualizează detaliile unui cont bancar.
+        
+        Args:
+            data (dict): Datele cu ID-ul contului
+            
+        Returns:
+            dict: Datele complete ale contului bancar
+        """
+        return self._make_request("POST", "conturi_bancare/vizualizare", data)
+    
+    def conturi_bancare_adauga(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Adaugă un cont bancar nou.
+        
+        Args:
+            data (dict): Datele contului bancar nou
+            
+        Returns:
+            dict: Datele contului creat
+        """
+        return self._make_request("POST", "conturi_bancare/adauga", data)
+    
+    def conturi_bancare_modifica(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Modifică datele unui cont bancar.
+        
+        Args:
+            data (dict): Datele actualizate ale contului
+            
+        Returns:
+            dict: Datele contului modificat
+        """
+        return self._make_request("POST", "conturi_bancare/modifica", data)
+    
+    def conturi_bancare_sterge(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Șterge un cont bancar.
+        
+        Args:
+            data (dict): Datele cu ID-ul contului de șters
+            
+        Returns:
+            dict: Confirmarea ștergerii
+        """
+        return self._make_request("POST", "conturi_bancare/sterge", data)
+
+    # =========================================================================
+    # UTILITARE
+    # =========================================================================
+    
+    def curs_valutar(self, data: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+        """
+        Obține cursul valutar curent.
+        
+        Args:
+            data (dict, optional): Parametrii pentru curs valutar
+            
+        Returns:
+            dict: Cursurile valutare actuale
+        """
+        return self._make_request("POST", "curs_valutar", data or {})
+    
+    def info_cif(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Validează și obține informații despre un CIF.
+        
+        Args:
+            data (dict): Datele cu CIF-ul de verificat
+            
+        Returns:
+            dict: Informațiile despre CIF
+        """
+        return self._make_request("POST", "info/cif", data)
+    
+    def info_judete(self, data: Optional[Dict[str, Any]] = None) -> List[Dict[str, Any]]:
+        """
+        Obține lista județelor din România.
+        
+        Args:
+            data (dict, optional): Parametrii suplimentari
+            
+        Returns:
+            list: Lista celor 42 de județe din România
+        """
+        return self._make_request("POST", "info/judete", data or {})
+    
+    def info_localitati(self, data: Optional[Dict[str, Any]] = None) -> List[Dict[str, Any]]:
+        """
+        Obține localitățile dintr-un județ specificat.
+        
+        Args:
+            data (dict, optional): Datele cu codul județului
+            
+        Returns:
+            list: Lista localităților din județ
+        """
+        return self._make_request("POST", "info/localitati", data or {})
+
+    # =========================================================================
+    # SPV / eFactura
+    # =========================================================================
+    
+    def e_factura_emise(self, data: Optional[Dict[str, Any]] = None) -> List[Dict[str, Any]]:
+        """
+        Listează facturile emise în SPV.
+        
+        Args:
+            data (dict, optional): Filtere pentru listă
+            
+        Returns:
+            list: Lista facturilor emise în SPV
+        """
+        return self._make_request("POST", "eFactura/emise", data or {})
+    
+    def e_factura_view_emise(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Vizualizează o factură emisă în SPV.
+        
+        Args:
+            data (dict): Datele cu ID-ul facturii
+            
+        Returns:
+            dict: Detaliile facturii emise
+        """
+        return self._make_request("POST", "eFactura/view_emise", data)
+    
+    def e_factura_descarca_emise(self, data: Dict[str, Any]) -> bytes:
+        """
+        Descarcă PDF-ul unei facturi emise.
+        
+        Args:
+            data (dict): Datele cu ID-ul facturii
+            
+        Returns:
+            bytes: Conținutul PDF al facturii
+        """
+        return self._make_request("POST", "eFactura/descarca_emise", data, download=True)
+    
+    def e_factura_furnizori(self, data: Optional[Dict[str, Any]] = None) -> List[Dict[str, Any]]:
+        """
+        Listează facturile primite de la furnizori în SPV.
+        
+        Args:
+            data (dict, optional): Filtere pentru listă
+            
+        Returns:
+            list: Lista facturilor de la furnizori
+        """
+        return self._make_request("POST", "eFactura/furnizori", data or {})
+    
+    def e_factura_view_furnizori(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Vizualizează o factură de la furnizor din SPV.
+        
+        Args:
+            data (dict): Datele cu ID-ul facturii
+            
+        Returns:
+            dict: Detaliile facturii de la furnizor
+        """
+        return self._make_request("POST", "eFactura/view_furnizori", data)
+    
+    def e_factura_descarca_furnizori(self, data: Dict[str, Any]) -> bytes:
+        """
+        Descarcă PDF-ul unei facturi de la furnizor.
+        
+        Args:
+            data (dict): Datele cu ID-ul facturii
+            
+        Returns:
+            bytes: Conținutul PDF al facturii
+        """
+        return self._make_request("POST", "eFactura/descarca_furnizori", data, download=True)
+    
+    def e_factura_upload_xml(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Încarcă o factură XML în SPV.
+        
+        Args:
+            data (dict): Datele cu conținutul XML
+            
+        Returns:
+            dict: Confirmarea încărcării
+        """
+        return self._make_request("POST", "eFactura/upload_xml", data)
+    
+    def e_factura_upload_status(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Verifică status-ul trimiterii unei facturi în SPV.
+        
+        Args:
+            data (dict): Datele cu ID-ul facturii
+            
+        Returns:
+            dict: Status-ul trimiterii la ANAF
+        """
+        return self._make_request("POST", "eFactura/upload_status", data)
+
+    # =========================================================================
+    # API RESELLER
+    # =========================================================================
+    
+    def firma_lista(self, data: Optional[Dict[str, Any]] = None) -> List[Dict[str, Any]]:
+        """
+        Listează toate firmele din cont (API Reseller).
+        
+        Args:
+            data (dict, optional): Filtere pentru listă
+            
+        Returns:
+            list: Lista firmelor
+        """
+        return self._make_request("POST", "firma/lista", data or {})
+    
+    def firma_vizualizare(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Vizualizează detaliile unei firme.
+        
+        Args:
+            data (dict): Datele cu ID-ul firmei
+            
+        Returns:
+            dict: Datele complete ale firmei
+        """
+        return self._make_request("POST", "firma/vizualizare", data)
+    
+    def firma_api(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Obține credențialele API ale unei firme.
+        
+        Args:
+            data (dict): Datele cu ID-ul firmei
+            
+        Returns:
+            dict: Credențialele API ale firmei
+        """
+        return self._make_request("POST", "firma/api", data)
+    
+    def firma_api_reset(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Resetează credențialele API ale unei firme.
+        
+        Args:
+            data (dict): Datele cu ID-ul firmei
+            
+        Returns:
+            dict: Noile credențiale API
+        """
+        return self._make_request("POST", "firma/api_reset", data)
+    
+    def firma_adauga(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Adaugă o firmă nouă în cont.
+        
+        Args:
+            data (dict): Datele firmei noi
+            
+        Returns:
+            dict: Datele firmei create
+        """
+        return self._make_request("POST", "firma/adauga", data)
+    
+    def firma_modifica(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Modifică datele unei firme.
+        
+        Args:
+            data (dict): Datele actualizate ale firmei
+            
+        Returns:
+            dict: Datele firmei modificate
+        """
+        return self._make_request("POST", "firma/modifica", data)
+    
+    def firma_activeaza(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Activează o firmă.
+        
+        Args:
+            data (dict): Datele cu ID-ul firmei
+            
+        Returns:
+            dict: Confirmarea activării
+        """
+        return self._make_request("POST", "firma/activeaza", data)
+    
+    def firma_dezactiveaza(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Dezactivează o firmă.
+        
+        Args:
+            data (dict): Datele cu ID-ul firmei
+            
+        Returns:
+            dict: Confirmarea dezactivării
+        """
+        return self._make_request("POST", "firma/dezactiveaza", data)
+    
+    def e_factura_autorizare(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Creează o autorizare nouă pentru eFactura.
+        
+        Args:
+            data (dict): Datele pentru autorizare
+            
+        Returns:
+            dict: Detaliile autorizării
+        """
+        return self._make_request("POST", "eFactura/autorizare", data)
+    
+    def trimite_factura_spv_manual(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Trimite manual o factură în SPV.
+        
+        Args:
+            data (dict): Datele facturii de trimis
+            
+        Returns:
+            dict: Confirmarea trimiterii
+        """
+        return self._make_request("POST", "trimite/factura_spv_manual", data)
+    
+    def e_factura_autorizari_lista(self, data: Dict[str, Any]) -> List[Dict[str, Any]]:
+        """
+        Listează autorizările pentru eFactura.
+        
+        Args:
+            data (dict): Parametrii pentru listă
+            
+        Returns:
+            list: Lista autorizărilor
+        """
+        return self._make_request("POST", "eFactura/autorizari_lista", data)
+    
+    def e_factura_vizualizare_setari(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Vizualizează setările eFactura pentru o firmă.
+        
+        Args:
+            data (dict): Datele cu ID-ul firmei
+            
+        Returns:
+            dict: Setările eFactura
+        """
+        return self._make_request("POST", "eFactura/vizualizare_setari", data)
+    
+    def e_factura_modifica_setarile(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Modifică setările eFactura pentru o firmă.
+        
+        Args:
+            data (dict): Noile setări eFactura
+            
+        Returns:
+            dict: Confirmarea modificării setărilor
+        """
+        return self._make_request("POST", "eFactura/modifica_setarile", data)