Metadata-Version: 2.4
Name: kodebar
Version: 0.1.0
Summary: SDK oficial da API Kodebar — consulta de produtos por código de barras (GTIN/EAN)
Author-email: Kodebar <contato@korvensistemas.com.br>
License: MIT
Project-URL: Homepage, https://kodebar.korvensistemas.com.br
Project-URL: Documentation, https://kodebar.korvensistemas.com.br/docs
Project-URL: Repository, https://github.com/kodebar/kodebar-python
Keywords: kodebar,gtin,ean,barcode,produto,api,brasil
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.20

# kodebar

SDK oficial da [API Kodebar](https://kodebar.korvensistemas.com.br) — consulta de produtos brasileiros por código de barras (GTIN/EAN).

## Instalação

```bash
pip install kodebar
```

## Uso rápido

```python
from kodebar import Kodebar

kb = Kodebar("sua-api-key")

# Consultar um produto
produto = kb.lookup("7891234567890")
print(produto["nome"])       # "Produto Exemplo 500ml"
print(produto["thumbnail"])  # URL da imagem

# Buscar por nome
busca = kb.search("arroz integral")
for p in busca["results"]:
    print(p["gtin"], p["nome"])

# Autocomplete
sugestoes = kb.autocomplete("coca")

# Consulta em lote
lote = kb.bulk(["7891234567890", "7898765432100"])
print(f'{lote["found"]} encontrados, {lote["missed"]} não encontrados')
```

## Configuração

```python
kb = Kodebar("sua-api-key",
    timeout=15,       # timeout em segundos (default: 10)
    max_retries=3,    # retries em 429/5xx (default: 2)
)
```

## Métodos

| Método | Descrição | Tier mínimo |
|--------|-----------|-------------|
| `lookup(gtin)` | Consulta por GTIN/EAN | Teste (grátis) |
| `search(query, limit=, offset=)` | Busca por nome | Básico |
| `autocomplete(query, limit=)` | Autocomplete rápido | Básico |
| `bulk(gtins)` | Consulta em lote | Básico |
| `me()` | Info da conta | Teste |
| `usage(days=30)` | Histórico de uso | Teste |
| `logs(limit=50)` | Últimas consultas | Teste |
| `resolved_misses(days=, limit=)` | Misses resolvidos | Básico |
| `list_webhooks()` | Lista webhooks | Básico |
| `create_webhook(url, event=)` | Cria webhook | Básico |
| `delete_webhook(id)` | Remove webhook | Básico |

## Tratamento de erros

```python
from kodebar import Kodebar, KodebarNotFoundError, KodebarRateLimitError

kb = Kodebar("sua-api-key")

try:
    produto = kb.lookup("0000000000000")
except KodebarNotFoundError as e:
    print(f"Produto não encontrado: {e.gtin}")
except KodebarRateLimitError as e:
    print(f"Rate limit! Tente novamente em {e.retry_after} segundos")
except KodebarError as e:
    print(f"Erro: {e} (status: {e.status})")
```

## Crie sua conta grátis

[kodebar.korvensistemas.com.br/painel](https://kodebar.korvensistemas.com.br/painel)

## Licença

MIT
