Metadata-Version: 2.4
Name: emitfy
Version: 0.5.0
Summary: Official Emitfy API SDK for Python (OpenAPI-typed)
Author: Emitfy
License: MIT
Project-URL: Homepage, https://api.emitfy.com/docs/sdks
Project-URL: Documentation, https://api.emitfy.com/docs
Project-URL: Repository, https://github.com/emitfy/emitfy-python
Keywords: emitfy,nfe,nfse,fiscal,brazil,sdk,openapi
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: urllib3>=2.0.0
Requires-Dist: python-dateutil>=2.8.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: typing-extensions>=4.0.0
Dynamic: license-file

# emitfy

Official Emitfy API SDK for Python (OpenAPI-typed).

## Install

```bash
pip install emitfy
```

## Facade

```python
from emitfy import Emitfy

emitfy = Emitfy(os.environ["EMITFY_API_KEY"], os.environ["EMITFY_API_SECRET"])
company = emitfy.company(os.environ["EMITFY_COMPANY_ID"])
company.nfse.create({
  "name": "Consultoria",
  "category": "consulting",
  "serviceDescription": "Consultoria em tecnologia",
  "cityServiceCode": "02800",
  "serviceItemCode": "01.05",
  "taxes": {"iss": {"rate": 2.9, "isWithheld": False}},
  "amount": 100,
  "borrower": {
    "name": "Cliente LTDA",
    "taxId": "12.345.678/0001-90",
    "email": "financeiro@cliente.com.br",
  },
})
```

## Typed OpenAPI layer

```python
from emitfy import WebhookCreate, WebhooksApi

api = emitfy.webhooks_api()
api.webhooks_create(WebhookCreate(url="https://seu-sistema.com/webhooks/emitfy", events={...}))
```

Docs: https://docs.emitfy.com/sdks  
OpenAPI: https://api.emitfy.com/openapi.yaml
