emitare 1.0.0__py3-none-any.whl

emitare/__init__.py

@@ -0,0 +1,6 @@
+"""Emitare — SDK Python para API NFS-e."""
+
+from .client import Emitare, EmitareError
+
+__version__ = "1.0.0"
+__all__ = ["Emitare", "EmitareError"]

emitare/client.py

@@ -0,0 +1,133 @@
+"""Cliente principal do SDK Emitare para Python."""
+
+import json
+import urllib.request
+import urllib.error
+from typing import Any, Dict, Optional
+
+
+class EmitareError(Exception):
+    def __init__(self, message: str, status_code: int = 0, body: Any = None):
+        super().__init__(message)
+        self.status_code = status_code
+        self.body = body
+
+
+class _Resource:
+    def __init__(self, client: "Emitare"):
+        self._c = client
+
+
+class NfseResource(_Resource):
+    def emitir(self, dados: Dict) -> Dict:
+        return self._c._request("POST", "/api/v1/nfse/emitir", dados)
+
+    def consultar(self, nfse_id: str) -> Dict:
+        return self._c._request("GET", f"/api/v1/nfse/{nfse_id}")
+
+    def cancelar(self, nfse_id: str, motivo: str) -> Dict:
+        return self._c._request("POST", f"/api/v1/nfse/{nfse_id}/cancelar", {"motivo": motivo})
+
+    def listar(self, empresa_id: str, **params) -> Dict:
+        qs = "&".join(f"{k}={v}" for k, v in params.items())
+        path = f"/api/v1/nfse?empresaId={empresa_id}" + (f"&{qs}" if qs else "")
+        return self._c._request("GET", path)
+
+    def xml(self, nfse_id: str) -> Dict:
+        return self._c._request("GET", f"/api/v1/nfse/{nfse_id}/xml")
+
+    def pdf(self, nfse_id: str) -> Dict:
+        return self._c._request("GET", f"/api/v1/nfse/{nfse_id}/pdf")
+
+
+class CompaniesResource(_Resource):
+    def listar(self) -> Dict:
+        return self._c._request("GET", "/api/v1/companies")
+
+    def criar(self, dados: Dict) -> Dict:
+        return self._c._request("POST", "/api/v1/companies", dados)
+
+    def buscar(self, empresa_id: str) -> Dict:
+        return self._c._request("GET", f"/api/v1/companies/{empresa_id}")
+
+    def atualizar(self, empresa_id: str, dados: Dict) -> Dict:
+        return self._c._request("PATCH", f"/api/v1/companies/{empresa_id}", dados)
+
+    def remover(self, empresa_id: str) -> Dict:
+        return self._c._request("DELETE", f"/api/v1/companies/{empresa_id}")
+
+    def upload_certificado(self, empresa_id: str, pfx_base64: str, senha: str) -> Dict:
+        return self._c._request("POST", f"/api/v1/companies/{empresa_id}/certificate", {
+            "pfxBase64": pfx_base64,
+            "senha": senha
+        })
+
+
+class MunicipiosResource(_Resource):
+    def buscar_por_ibge(self, ibge: int) -> Dict:
+        return self._c._request("GET", f"/api/v1/municipios/{ibge}")
+
+    def buscar_por_nome(self, nome: str) -> Dict:
+        import urllib.parse
+        return self._c._request("GET", f"/api/v1/municipios?nome={urllib.parse.quote(nome)}")
+
+
+class Emitare:
+    """
+    Cliente da API NFS-e Emitare.
+
+    Uso:
+        from emitare import Emitare
+
+        client = Emitare("sua-api-key")
+        nota = client.nfse.emitir({ ... })
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = "https://emitare.com.br",
+        timeout: int = 30,
+    ):
+        if not api_key:
+            raise ValueError("api_key é obrigatório")
+        self.api_key  = api_key
+        self.base_url = base_url.rstrip("/")
+        self.timeout  = timeout
+
+        self.nfse       = NfseResource(self)
+        self.companies  = CompaniesResource(self)
+        self.municipios = MunicipiosResource(self)
+
+    def _request(self, method: str, path: str, body: Optional[Dict] = None) -> Any:
+        full_url = self.base_url + path
+        payload  = json.dumps(body).encode() if body is not None else None
+
+        req = urllib.request.Request(
+            full_url,
+            data=payload,
+            method=method,
+            headers={
+                "x-api-key":    self.api_key,
+                "Content-Type": "application/json",
+                "Accept":       "application/json",
+                "User-Agent":   "emitare-python/1.0.0",
+            }
+        )
+
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout) as resp:
+                return json.loads(resp.read().decode())
+        except urllib.error.HTTPError as e:
+            body = {}
+            try:
+                body = json.loads(e.read().decode())
+            except Exception:
+                pass
+            raise EmitareError(
+                body.get("message", f"HTTP {e.code}"),
+                e.code,
+                body
+            ) from e
+        except urllib.error.URLError as e:
+            raise EmitareError(str(e.reason), 0, None) from e

emitare-1.0.0.dist-info/METADATA

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: emitare
+Version: 1.0.0
+Summary: SDK Python para a API NFS-e Emitare — emita notas fiscais de serviço em todos os municípios do Brasil
+Home-page: https://emitare.com.br/docs
+Author: Emitare
+Author-email: dev@emitare.com.br
+Project-URL: Documentação, https://emitare.com.br/docs
+Project-URL: Repositório, https://github.com/krgitti/emitare-nfs-api
+Project-URL: Rastreador de bugs, https://github.com/krgitti/emitare-nfs-api/issues
+Keywords: nfse nota-fiscal-servico api-nfse brasil prefeitura erp fiscal
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: project-url
+Dynamic: requires-python
+Dynamic: summary
+
+# Emitare SDK para Python
+
+SDK oficial Python para a [API NFS-e Emitare](https://emitare.com.br) — emita Notas Fiscais de Serviço Eletrônicas em todos os 5.570 municípios do Brasil.
+
+## Instalação
+
+```bash
+pip install emitare
+```
+
+## Uso rápido
+
+```python
+from emitare import Emitare
+
+client = Emitare("sua-api-key")
+
+# Emitir NFS-e
+nfse = client.nfse.emitir(
+    empresa_id="uuid-da-empresa",
+    tomador={
+        "cpfCnpj": "12345678000195",
+        "razaoSocial": "Empresa Tomadora Ltda",
+        "email": "financeiro@tomadora.com.br"
+    },
+    servico={
+        "codigoMunicipio": 3550308,  # São Paulo
+        "descricao": "Desenvolvimento de software",
+        "valorTotal": 1500.00,
+        "aliquotaIss": 2.0
+    }
+)
+
+print(f"NFS-e emitida: {nfse['numero']}")
+```
+
+## Funcionalidades
+
+- ✅ Emissão de NFS-e em 5.570 municípios brasileiros
+- ✅ Suporte a 10 provedores (GINFES, ISSNet, SIGISS, Betha, IPM, SimplISS, DSF, eGoverne, PRODAM, Padrão Nacional 2026)
+- ✅ Padrão Nacional 2026 (LC 214/2025 — IBS/CBS)
+- ✅ Consulta e cancelamento de NFS-e
+- ✅ Emissão em lote
+- ✅ Webhooks em tempo real
+
+## Documentação
+
+Documentação completa em [emitare.com.br/docs](https://emitare.com.br/docs)
+
+## Licença
+
+MIT

emitare-1.0.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+emitare/__init__.py,sha256=5GQlc0sYqDxXyRDT_a0STOu94Zpwk_W3ghfY9XLwEVU,149
+emitare/client.py,sha256=TbS6qpVBSDqNw6VwtvcLNKk-cXY08ktFo4XBla6V0NI,4374
+emitare-1.0.0.dist-info/METADATA,sha256=zOlI2GhebPE_0m9vxVD7LOFTKTxb81MLlaAEsgFzpAU,2634
+emitare-1.0.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+emitare-1.0.0.dist-info/top_level.txt,sha256=QjHxXv4Pp8Emuu1Cla8MV10PI6eleaDApWQtmBHIL7o,8
+emitare-1.0.0.dist-info/RECORD,,

emitare-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

emitare-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+emitare