sienge-ecbiesek-mcp 1.0.0__py3-none-any.whl → 1.1.1__py3-none-any.whl

sienge_ecbiesek_mcp-1.1.1.dist-info/METADATA

@@ -0,0 +1,383 @@
+Metadata-Version: 2.4
+Name: sienge-ecbiesek-mcp
+Version: 1.1.1
+Summary: Model Context Protocol (MCP) server for Sienge API integration - Brazilian construction management system
+Author-email: ECBIESEK <ti@ecbiesek.com>
+License: MIT
+Project-URL: Homepage, https://github.com/INOTECH-ecbiesek/Sienge-MCP
+Project-URL: Documentation, https://github.com/INOTECH-ecbiesek/Sienge-MCP#readme
+Project-URL: Repository, https://github.com/INOTECH-ecbiesek/Sienge-MCP.git
+Project-URL: Issues, https://github.com/INOTECH-ecbiesek/Sienge-MCP/issues
+Project-URL: Bug Reports, https://github.com/INOTECH-ecbiesek/Sienge-MCP/issues
+Project-URL: Source Code, https://github.com/INOTECH-ecbiesek/Sienge-MCP
+Project-URL: PyPI, https://pypi.org/project/sienge-ecbiesek-mcp/
+Keywords: sienge,mcp,model-context-protocol,claude,api,construction,erp,brazil,ecbiesek,fastmcp,ai-integration
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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 :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Scientific/Engineering :: Interface Engine/Protocol Translator
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Environment :: Console
+Classifier: Framework :: FastAPI
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastmcp>=0.1.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Dynamic: license-file
+
+# Sienge MCP Server
+
+Um servidor Model Context Protocol (MCP) para integração com a API do Sienge, sistema de gestão para empresas de construção civil.
+
+## 🚀 Funcionalidades
+
+### 📊 Contas a Receber
+- **get_sienge_accounts_receivable**: Lista contas a receber com filtros por período
+- Utiliza a Bulk-data API do Sienge para consultas eficientes
+- Suporte a filtros por data de vencimento e data de competência
+
+### 🏢 Projetos e Empresas
+- **get_sienge_projects**: Lista todos os projetos/empresas disponíveis
+- Informações detalhadas incluindo ID, nome, endereço e status
+
+### 📝 Notas Fiscais de Compra
+- **get_sienge_purchase_invoices**: Lista todas as notas fiscais de compra
+- **get_sienge_purchase_invoice_details**: Detalhes completos de uma nota fiscal específica
+- **get_sienge_purchase_invoice_items**: Lista itens de uma nota fiscal
+- **get_sienge_purchase_invoice_payments**: Lista pagamentos de uma nota fiscal
+- **search_sienge_purchase_invoices**: Busca avançada com múltiplos filtros
+
+### 🔍 Solicitações de Compra
+- **get_sienge_purchase_requests**: Lista solicitações de compra do sistema
+
+## 📦 Instalação
+
+### Via PyPI (Recomendado)
+```bash
+pip install sienge-ecbiesek-mcp
+```
+
+### Via Código Fonte
+```bash
+git clone https://github.com/INOTECH-ecbiesek/Sienge-MCP.git
+cd Sienge-MCP
+pip install -e .
+```
+
+## ⚙️ Configuração
+
+### 1. Variáveis de Ambiente
+Crie um arquivo `.env` no diretório do projeto com as seguintes variáveis:
+
+```env
+# Configurações da API do Sienge
+SIENGE_BASE_URL=https://api.sienge.com.br
+SIENGE_SUBDOMAIN=seu_subdominio
+SIENGE_USERNAME=seu_usuario
+SIENGE_PASSWORD=sua_senha
+SIENGE_TIMEOUT=30
+```
+
+### 2. Configuração no Claude Desktop
+
+#### Configuração Básica
+Adicione ao seu arquivo de configuração do Claude Desktop (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "sienge-mcp": {
+      "command": "python",
+      "args": ["-m", "sienge_mcp"],
+      "env": {
+        "SIENGE_BASE_URL": "https://api.sienge.com.br",
+        "SIENGE_SUBDOMAIN": "seu_subdominio",
+        "SIENGE_USERNAME": "seu_usuario",
+        "SIENGE_PASSWORD": "sua_senha",
+        "SIENGE_TIMEOUT": "30"
+      }
+    }
+  }
+}
+```
+
+#### Configuração com Virtual Environment
+Se você estiver usando um ambiente virtual:
+
+```json
+{
+  "mcpServers": {
+    "sienge-mcp": {
+      "command": "C:/caminho/para/seu/venv/Scripts/python.exe",
+      "args": ["-m", "sienge_mcp"],
+      "env": {
+        "SIENGE_BASE_URL": "https://api.sienge.com.br",
+        "SIENGE_SUBDOMAIN": "seu_subdominio",
+        "SIENGE_USERNAME": "seu_usuario",
+        "SIENGE_PASSWORD": "sua_senha",
+        "SIENGE_TIMEOUT": "30"
+      }
+    }
+  }
+}
+```
+
+## 🔐 Autenticação
+
+### Credenciais do Sienge
+A autenticação é feita através de **usuário e senha** do Sienge, não por token API:
+
+1. **SIENGE_BASE_URL**: URL base da API (`https://api.sienge.com.br`)
+2. **SIENGE_SUBDOMAIN**: Seu subdomínio no Sienge (ex: `suaempresa`)
+3. **SIENGE_USERNAME**: Seu nome de usuário no Sienge
+4. **SIENGE_PASSWORD**: Sua senha no Sienge
+5. **SIENGE_TIMEOUT**: Timeout das requisições em segundos (padrão: 30)
+
+### URLs da API
+- **API Base**: `https://api.sienge.com.br`
+- **Endpoints v1**: `/sienge/api/public/v1/`
+- **Bulk-data API**: `/bulk-data/`
+
+## 💻 Como Usar
+
+### 1. Iniciando o Servidor
+```bash
+# Via módulo Python
+python -m sienge_mcp
+
+# Ou diretamente
+sienge-mcp-server
+```
+
+### 2. No Claude Desktop
+Após configurar o servidor, reinicie o Claude Desktop. O servidor MCP será automaticamente carregado e as ferramentas ficarão disponíveis.
+
+### 3. Exemplos de Uso no Claude
+
+#### Consultar Contas a Receber
+```
+"Liste as contas a receber com vencimento entre 01/01/2024 e 31/01/2024"
+```
+
+#### Buscar Projetos
+```
+"Mostre todos os projetos disponíveis no Sienge"
+```
+
+#### Consultar Notas Fiscais
+```
+"Liste as notas fiscais de compra do mês atual"
+```
+
+#### Busca Avançada de Notas Fiscais
+```
+"Busque notas fiscais de compra com valor acima de R$ 10.000,00 emitidas em dezembro de 2023"
+```
+
+## 🛠️ Desenvolvimento
+
+### Estrutura do Projeto
+```
+src/
+├── sienge_mcp/
+│   ├── __init__.py
+│   ├── server.py          # Servidor MCP principal
+│   ├── services/          # Serviços de integração
+│   ├── tools/             # Ferramentas MCP
+│   └── utils/
+│       └── logger.py      # Sistema de logging
+```
+
+### Executando em Modo de Desenvolvimento
+```bash
+# Clone o repositório
+git clone https://github.com/INOTECH-ecbiesek/Sienge-MCP.git
+cd Sienge-MCP
+
+# Crie um ambiente virtual
+python -m venv .venv
+.venv\Scripts\activate  # Windows
+source .venv/bin/activate  # Linux/Mac
+
+# Instale as dependências
+pip install -e .
+
+# Configure as variáveis de ambiente
+cp .env.example .env
+# Edite o arquivo .env com suas configurações
+
+# Execute o servidor
+python -m sienge_mcp
+```
+
+### Testando Localmente
+```bash
+# Instale as dependências de teste
+pip install pytest pytest-asyncio
+
+# Execute os testes
+pytest tests/
+```
+
+## 📋 Requisitos
+
+### Dependências
+- Python >= 3.8
+- fastmcp >= 2.12.3
+- httpx >= 0.25.0
+- pydantic >= 2.0.0
+- python-dotenv >= 1.0.0
+
+### Compatibilidade
+- ✅ Windows
+- ✅ macOS  
+- ✅ Linux
+- ✅ Claude Desktop
+- ✅ Outros clientes MCP
+
+## 🔧 Configurações Avançadas
+
+### Logs e Debug
+O servidor inclui sistema de logging configurável:
+
+```python
+# Nível de log via variável de ambiente
+LOG_LEVEL=DEBUG  # DEBUG, INFO, WARNING, ERROR
+```
+
+### Timeout de Requisições
+Configure o timeout das requisições HTTP:
+
+```python
+# Timeout em segundos (padrão: 30s)
+SIENGE_TIMEOUT=60
+```
+
+### Cache de Respostas
+Para melhor performance em consultas frequentes:
+
+```python
+# Habilitar cache (padrão: False)
+SIENGE_CACHE_ENABLED=true
+SIENGE_CACHE_TTL=300  # TTL em segundos
+```
+
+## 🚨 Solução de Problemas
+
+### Erros Comuns
+
+#### Erro 401 - Unauthorized
+```
+Causa: Credenciais inválidas (usuário/senha incorretos)
+Solução: Verifique seu usuário e senha no Sienge
+```
+
+#### Erro 404 - Not Found
+```
+Causa: Endpoint incorreto ou recurso não encontrado
+Solução: Verifique as URLs base da API
+```
+
+#### Erro 429 - Rate Limited
+```
+Causa: Muitas requisições por minuto
+Solução: Implemente delay entre requisições
+```
+
+#### Servidor MCP não conecta
+```
+1. Verifique se o Python está no PATH
+2. Confirme se o módulo está instalado: pip show sienge-ecbiesek-mcp
+3. Teste a execução manual: python -m sienge_mcp
+4. Verifique os logs do Claude Desktop
+```
+
+### Debug
+Para debugar problemas de conexão:
+
+```bash
+# Execute com logs detalhados
+LOG_LEVEL=DEBUG python -m sienge_mcp
+
+# Teste a conectividade com a API
+# Use as credenciais do seu arquivo de configuração para testar
+```
+
+## 📚 Documentação da API
+
+### Endpoints Utilizados
+
+#### API Padrão (v1)
+- `GET /enterprises` - Lista empresas/projetos
+- `GET /purchase-requests` - Solicitações de compra  
+- `GET /purchase-invoices` - Notas fiscais de compra
+- `GET /purchase-invoices/{id}` - Detalhes da nota fiscal
+- `GET /purchase-invoices/{id}/items` - Itens da nota fiscal
+- `GET /purchase-invoices/{id}/payments` - Pagamentos da nota fiscal
+
+#### Bulk-data API
+- `POST /income` - Contas a receber (bulk)
+
+### Formatos de Data
+- **ISO 8601**: `2024-01-01T00:00:00Z`
+- **Brasileiro**: `01/01/2024`
+- **Filtros de período**: `start_date` e `end_date`
+
+### Códigos de Status
+- `200` - Sucesso
+- `400` - Requisição inválida
+- `401` - Não autorizado
+- `404` - Recurso não encontrado
+- `429` - Rate limit excedido
+- `500` - Erro interno do servidor
+
+## 📄 Licença
+
+Este projeto está licenciado sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes.
+
+## 🤝 Contribuindo
+
+1. Faça um fork do projeto
+2. Crie uma branch para sua feature (`git checkout -b feature/AmazingFeature`)
+3. Commit suas mudanças (`git commit -m 'Add some AmazingFeature'`)
+4. Push para a branch (`git push origin feature/AmazingFeature`)
+5. Abra um Pull Request
+
+## 📞 Suporte
+
+- **Issues**: [GitHub Issues](https://github.com/INOTECH-ecbiesek/Sienge-MCP/issues)
+- **Documentação**: [Wiki do Projeto](https://github.com/INOTECH-ecbiesek/Sienge-MCP/wiki)
+- **API Sienge**: [Documentação Oficial](https://api.sienge.com.br/docs)
+
+## 📈 Versões
+
+### v1.1.0 (Atual)
+- ✅ Adicionadas 5 ferramentas para Notas Fiscais de Compra
+- ✅ Suporte à Bulk-data API para contas a receber
+- ✅ Correção de endpoints para projetos/empresas
+- ✅ Melhorias na documentação e tratamento de erros
+
+### v1.0.0
+- ✅ Versão inicial com ferramentas básicas
+- ✅ Integração com API padrão do Sienge
+- ✅ Suporte a contas a receber, projetos e solicitações de compra
+
+---
+
+**Desenvolvido por INOTECH-ecbiesek** 🚀

sienge_ecbiesek_mcp-1.1.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+sienge_ecbiesek_mcp-1.1.1.dist-info/licenses/LICENSE,sha256=leWD46QLXsQ43M8fE_KgOo5Sf0YB9_X8EVqGdV0Dsc0,1101
+sienge_mcp/__init__.py,sha256=Pjl4hgBCWhVJ_BBZXaP7SuZfH7Z1JWZbSs8MV5sUle8,287
+sienge_mcp/server.py,sha256=-xMDp97XliIgJMii4X5Ws7gcHAT9Fwe3S2JViCd0tDs,43690
+sienge_mcp/utils/logger.py,sha256=bqU0GDsQXE9TaKOq5_6S2L8bh_Nas-EuYNDE3fzlPWg,5880
+sienge_ecbiesek_mcp-1.1.1.dist-info/METADATA,sha256=5jrtt8Q5SARdav4CAG7KPPcVLnTj4_fR6KwiTjDKzC8,11230
+sienge_ecbiesek_mcp-1.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+sienge_ecbiesek_mcp-1.1.1.dist-info/entry_points.txt,sha256=jxEu6gvTw3ci0mjDfqbi0rBLRpeuscwwRk9-H-UOnO8,63
+sienge_ecbiesek_mcp-1.1.1.dist-info/top_level.txt,sha256=FCvuhB9JQPKGY0Q8aKoVc7akqG5htoJyfj-eJvVUmWM,11
+sienge_ecbiesek_mcp-1.1.1.dist-info/RECORD,,

sienge_mcp/server.py

@@ -33,7 +33,7 @@ class SiengeAPIError(Exception):
 
 async def make_sienge_request(method: str, endpoint: str, params: Optional[Dict] = None, json_data: Optional[Dict] = None) -> Dict:
     """
-    Função auxiliar para fazer requisições à API do Sienge
+    Função auxiliar para fazer requisições à API do Sienge (v1)
     Suporta tanto Bearer Token quanto Basic Auth
     """
     try:
@@ -104,6 +104,79 @@ async def make_sienge_request(method: str, endpoint: str, params: Optional[Dict]
             "message": f"Erro na requisição: {str(e)}"
         }
 
+async def make_sienge_bulk_request(method: str, endpoint: str, params: Optional[Dict] = None, json_data: Optional[Dict] = None) -> Dict:
+    """
+    Função auxiliar para fazer requisições à API bulk-data do Sienge
+    Suporta tanto Bearer Token quanto Basic Auth
+    """
+    try:
+        async with httpx.AsyncClient(timeout=REQUEST_TIMEOUT) as client:
+            headers = {
+                "Content-Type": "application/json",
+                "Accept": "application/json"
+            }
+            
+            # Configurar autenticação e URL para bulk-data
+            auth = None
+            
+            if SIENGE_API_KEY and SIENGE_API_KEY != "sua_api_key_aqui":
+                # Bearer Token (Recomendado)
+                headers["Authorization"] = f"Bearer {SIENGE_API_KEY}"
+                url = f"{SIENGE_BASE_URL}/{SIENGE_SUBDOMAIN}/public/api/bulk-data/v1{endpoint}"
+            elif SIENGE_USERNAME and SIENGE_PASSWORD:
+                # Basic Auth usando httpx.BasicAuth
+                auth = httpx.BasicAuth(SIENGE_USERNAME, SIENGE_PASSWORD)
+                url = f"{SIENGE_BASE_URL}/{SIENGE_SUBDOMAIN}/public/api/bulk-data/v1{endpoint}"
+            else:
+                return {
+                    "success": False,
+                    "error": "No Authentication",
+                    "message": "Configure SIENGE_API_KEY ou SIENGE_USERNAME/PASSWORD no .env"
+                }
+            
+            response = await client.request(
+                method=method,
+                url=url,
+                headers=headers,
+                params=params,
+                json=json_data,
+                auth=auth
+            )
+            
+            if response.status_code in [200, 201]:
+                try:
+                    return {
+                        "success": True,
+                        "data": response.json(),
+                        "status_code": response.status_code
+                    }
+                except:
+                    return {
+                        "success": True,
+                        "data": {"message": "Success"},
+                        "status_code": response.status_code
+                    }
+            else:
+                return {
+                    "success": False,
+                    "error": f"HTTP {response.status_code}",
+                    "message": response.text,
+                    "status_code": response.status_code
+                }
+                
+    except httpx.TimeoutException:
+        return {
+            "success": False,
+            "error": "Timeout",
+            "message": f"A requisição excedeu o tempo limite de {REQUEST_TIMEOUT}s"
+        }
+    except Exception as e:
+        return {
+            "success": False,
+            "error": str(e),
+            "message": f"Erro na requisição bulk-data: {str(e)}"
+        }
+
 # ============ CONEXÃO E TESTE ============
 
 @mcp.tool
@@ -272,46 +345,115 @@ async def get_sienge_creditor_bank_info(creditor_id: str) -> Dict:
 # ============ FINANCEIRO ============
 
 @mcp.tool
-async def get_sienge_accounts_receivable(customer_id: Optional[str] = None, due_date_from: Optional[str] = None, 
-                                       due_date_to: Optional[str] = None, status: Optional[str] = None, limit: Optional[int] = 50) -> Dict:
+async def get_sienge_accounts_receivable(start_date: str, end_date: str, selection_type: str = "D", 
+                                       company_id: Optional[int] = None, cost_centers_id: Optional[List[int]] = None,
+                                       correction_indexer_id: Optional[int] = None, correction_date: Optional[str] = None,
+                                       change_start_date: Optional[str] = None, completed_bills: Optional[str] = None,
+                                       origins_ids: Optional[List[str]] = None, bearers_id_in: Optional[List[int]] = None,
+                                       bearers_id_not_in: Optional[List[int]] = None) -> Dict:
     """
-    Consulta títulos a receber
+    Consulta parcelas do contas a receber via API bulk-data
     
     Args:
-        customer_id: ID do cliente
-        due_date_from: Data inicial (YYYY-MM-DD)
-        due_date_to: Data final (YYYY-MM-DD)
-        status: Status (open, paid, overdue)
-        limit: Máximo de registros
+        start_date: Data de início do período (YYYY-MM-DD) - OBRIGATÓRIO
+        end_date: Data do fim do período (YYYY-MM-DD) - OBRIGATÓRIO  
+        selection_type: Seleção da data do período (I=emissão, D=vencimento, P=pagamento, B=competência) - padrão: D
+        company_id: Código da empresa
+        cost_centers_id: Lista de códigos de centro de custo
+        correction_indexer_id: Código do indexador de correção
+        correction_date: Data para correção do indexador (YYYY-MM-DD)
+        change_start_date: Data inicial de alteração do título/parcela (YYYY-MM-DD)
+        completed_bills: Filtrar por títulos completos (S)
+        origins_ids: Códigos dos módulos de origem (CR, CO, ME, CA, CI, AR, SC, LO, NE, NS, AC, NF)
+        bearers_id_in: Filtrar parcelas com códigos de portador específicos
+        bearers_id_not_in: Filtrar parcelas excluindo códigos de portador específicos
     """
-    params = {"limit": min(limit or 50, 200)}
+    params = {
+        "startDate": start_date,
+        "endDate": end_date,
+        "selectionType": selection_type
+    }
     
-    if customer_id:
-        params["customer_id"] = customer_id
-    if due_date_from:
-        params["due_date_from"] = due_date_from
-    if due_date_to:
-        params["due_date_to"] = due_date_to
-    if status:
-        params["status"] = status
+    if company_id:
+        params["companyId"] = company_id
+    if cost_centers_id:
+        params["costCentersId"] = cost_centers_id
+    if correction_indexer_id:
+        params["correctionIndexerId"] = correction_indexer_id
+    if correction_date:
+        params["correctionDate"] = correction_date
+    if change_start_date:
+        params["changeStartDate"] = change_start_date
+    if completed_bills:
+        params["completedBills"] = completed_bills
+    if origins_ids:
+        params["originsIds"] = origins_ids
+    if bearers_id_in:
+        params["bearersIdIn"] = bearers_id_in
+    if bearers_id_not_in:
+        params["bearersIdNotIn"] = bearers_id_not_in
+    
+    result = await make_sienge_bulk_request("GET", "/income", params=params)
     
-    result = await make_sienge_request("GET", "/accounts-receivable", params=params)
+    if result["success"]:
+        data = result["data"]
+        income_data = data.get("data", []) if isinstance(data, dict) else data
+        
+        return {
+            "success": True,
+            "message": f"✅ Encontradas {len(income_data)} parcelas a receber",
+            "income_data": income_data,
+            "count": len(income_data),
+            "period": f"{start_date} a {end_date}",
+            "selection_type": selection_type,
+            "filters": params
+        }
+    
+    return {
+        "success": False,
+        "message": "❌ Erro ao buscar parcelas a receber",
+        "error": result.get("error"),
+        "details": result.get("message")
+    }
+
+@mcp.tool
+async def get_sienge_accounts_receivable_by_bills(bills_ids: List[int], correction_indexer_id: Optional[int] = None,
+                                                correction_date: Optional[str] = None) -> Dict:
+    """
+    Consulta parcelas dos títulos informados via API bulk-data
+    
+    Args:
+        bills_ids: Lista de códigos dos títulos - OBRIGATÓRIO
+        correction_indexer_id: Código do indexador de correção
+        correction_date: Data para correção do indexador (YYYY-MM-DD)
+    """
+    params = {
+        "billsIds": bills_ids
+    }
+    
+    if correction_indexer_id:
+        params["correctionIndexerId"] = correction_indexer_id
+    if correction_date:
+        params["correctionDate"] = correction_date
+    
+    result = await make_sienge_bulk_request("GET", "/income/by-bills", params=params)
     
     if result["success"]:
         data = result["data"]
-        receivables = data.get("results", []) if isinstance(data, dict) else data
+        income_data = data.get("data", []) if isinstance(data, dict) else data
         
         return {
             "success": True,
-            "message": f"✅ Encontrados {len(receivables)} títulos a receber",
-            "receivables": receivables,
-            "count": len(receivables),
+            "message": f"✅ Encontradas {len(income_data)} parcelas dos títulos informados",
+            "income_data": income_data,
+            "count": len(income_data),
+            "bills_consulted": bills_ids,
             "filters": params
         }
     
     return {
         "success": False,
-        "message": "❌ Erro ao buscar títulos a receber",
+        "message": "❌ Erro ao buscar parcelas dos títulos informados",
         "error": result.get("error"),
         "details": result.get("message")
     }
@@ -531,6 +673,206 @@ async def create_sienge_purchase_request(description: str, project_id: str, item
         "details": result.get("message")
     }
 
+# ============ NOTAS FISCAIS DE COMPRA ============
+
+@mcp.tool
+async def get_sienge_purchase_invoice(sequential_number: int) -> Dict:
+    """
+    Consulta nota fiscal de compra por número sequencial
+    
+    Args:
+        sequential_number: Número sequencial da nota fiscal
+    """
+    result = await make_sienge_request("GET", f"/purchase-invoices/{sequential_number}")
+    
+    if result["success"]:
+        return {
+            "success": True,
+            "message": f"✅ Nota fiscal {sequential_number} encontrada",
+            "invoice": result["data"]
+        }
+    
+    return {
+        "success": False,
+        "message": f"❌ Erro ao buscar nota fiscal {sequential_number}",
+        "error": result.get("error"),
+        "details": result.get("message")
+    }
+
+@mcp.tool
+async def get_sienge_purchase_invoice_items(sequential_number: int) -> Dict:
+    """
+    Consulta itens de uma nota fiscal de compra
+    
+    Args:
+        sequential_number: Número sequencial da nota fiscal
+    """
+    result = await make_sienge_request("GET", f"/purchase-invoices/{sequential_number}/items")
+    
+    if result["success"]:
+        data = result["data"]
+        items = data.get("results", []) if isinstance(data, dict) else data
+        metadata = data.get("resultSetMetadata", {}) if isinstance(data, dict) else {}
+        
+        return {
+            "success": True,
+            "message": f"✅ Encontrados {len(items)} itens na nota fiscal {sequential_number}",
+            "items": items,
+            "count": len(items),
+            "metadata": metadata
+        }
+    
+    return {
+        "success": False,
+        "message": f"❌ Erro ao buscar itens da nota fiscal {sequential_number}",
+        "error": result.get("error"),
+        "details": result.get("message")
+    }
+
+@mcp.tool
+async def create_sienge_purchase_invoice(document_id: str, number: str, supplier_id: int, company_id: int,
+                                       movement_type_id: int, movement_date: str, issue_date: str,
+                                       series: Optional[str] = None, notes: Optional[str] = None) -> Dict:
+    """
+    Cadastra uma nova nota fiscal de compra
+    
+    Args:
+        document_id: ID do documento (ex: "NF")
+        number: Número da nota fiscal
+        supplier_id: ID do fornecedor
+        company_id: ID da empresa
+        movement_type_id: ID do tipo de movimento
+        movement_date: Data do movimento (YYYY-MM-DD)
+        issue_date: Data de emissão (YYYY-MM-DD)
+        series: Série da nota fiscal (opcional)
+        notes: Observações (opcional)
+    """
+    invoice_data = {
+        "documentId": document_id,
+        "number": number,
+        "supplierId": supplier_id,
+        "companyId": company_id,
+        "movementTypeId": movement_type_id,
+        "movementDate": movement_date,
+        "issueDate": issue_date
+    }
+    
+    if series:
+        invoice_data["series"] = series
+    if notes:
+        invoice_data["notes"] = notes
+    
+    result = await make_sienge_request("POST", "/purchase-invoices", json_data=invoice_data)
+    
+    if result["success"]:
+        return {
+            "success": True,
+            "message": f"✅ Nota fiscal {number} criada com sucesso",
+            "invoice": result["data"]
+        }
+    
+    return {
+        "success": False,
+        "message": f"❌ Erro ao criar nota fiscal {number}",
+        "error": result.get("error"),
+        "details": result.get("message")
+    }
+
+@mcp.tool
+async def add_items_to_purchase_invoice(sequential_number: int, deliveries_order: List[Dict[str, Any]],
+                                      copy_notes_purchase_orders: bool = True, copy_notes_resources: bool = False,
+                                      copy_attachments_purchase_orders: bool = True) -> Dict:
+    """
+    Insere itens em uma nota fiscal a partir de entregas de pedidos de compra
+    
+    Args:
+        sequential_number: Número sequencial da nota fiscal
+        deliveries_order: Lista de entregas com estrutura:
+            - purchaseOrderId: ID do pedido de compra
+            - itemNumber: Número do item no pedido
+            - deliveryScheduleNumber: Número da programação de entrega
+            - deliveredQuantity: Quantidade entregue
+            - keepBalance: Manter saldo (true/false)
+        copy_notes_purchase_orders: Copiar observações dos pedidos de compra
+        copy_notes_resources: Copiar observações dos recursos
+        copy_attachments_purchase_orders: Copiar anexos dos pedidos de compra
+    """
+    item_data = {
+        "deliveriesOrder": deliveries_order,
+        "copyNotesPurchaseOrders": copy_notes_purchase_orders,
+        "copyNotesResources": copy_notes_resources,
+        "copyAttachmentsPurchaseOrders": copy_attachments_purchase_orders
+    }
+    
+    result = await make_sienge_request("POST", f"/purchase-invoices/{sequential_number}/items/purchase-orders/delivery-schedules", json_data=item_data)
+    
+    if result["success"]:
+        return {
+            "success": True,
+            "message": f"✅ Itens adicionados à nota fiscal {sequential_number} com sucesso",
+            "item": result["data"]
+        }
+    
+    return {
+        "success": False,
+        "message": f"❌ Erro ao adicionar itens à nota fiscal {sequential_number}",
+        "error": result.get("error"),
+        "details": result.get("message")
+    }
+
+@mcp.tool
+async def get_sienge_purchase_invoices_deliveries_attended(bill_id: Optional[int] = None, sequential_number: Optional[int] = None,
+                                                         purchase_order_id: Optional[int] = None, invoice_item_number: Optional[int] = None,
+                                                         purchase_order_item_number: Optional[int] = None, 
+                                                         limit: Optional[int] = 100, offset: Optional[int] = 0) -> Dict:
+    """
+    Lista entregas atendidas entre pedidos de compra e notas fiscais
+    
+    Args:
+        bill_id: ID do título da nota fiscal
+        sequential_number: Número sequencial da nota fiscal
+        purchase_order_id: ID do pedido de compra
+        invoice_item_number: Número do item da nota fiscal
+        purchase_order_item_number: Número do item do pedido de compra
+        limit: Máximo de registros (padrão: 100, máximo: 200)
+        offset: Deslocamento (padrão: 0)
+    """
+    params = {"limit": min(limit or 100, 200), "offset": offset or 0}
+    
+    if bill_id:
+        params["billId"] = bill_id
+    if sequential_number:
+        params["sequentialNumber"] = sequential_number
+    if purchase_order_id:
+        params["purchaseOrderId"] = purchase_order_id
+    if invoice_item_number:
+        params["invoiceItemNumber"] = invoice_item_number
+    if purchase_order_item_number:
+        params["purchaseOrderItemNumber"] = purchase_order_item_number
+    
+    result = await make_sienge_request("GET", "/purchase-invoices/deliveries-attended", params=params)
+    
+    if result["success"]:
+        data = result["data"]
+        deliveries = data.get("results", []) if isinstance(data, dict) else data
+        metadata = data.get("resultSetMetadata", {}) if isinstance(data, dict) else {}
+        
+        return {
+            "success": True,
+            "message": f"✅ Encontradas {len(deliveries)} entregas atendidas",
+            "deliveries": deliveries,
+            "count": len(deliveries),
+            "metadata": metadata,
+            "filters": params
+        }
+    
+    return {
+        "success": False,
+        "message": "❌ Erro ao buscar entregas atendidas",
+        "error": result.get("error"),
+        "details": result.get("message")
+    }
+
 # ============ ESTOQUE ============
 
 @mcp.tool
@@ -601,39 +943,100 @@ async def get_sienge_stock_reservations(limit: Optional[int] = 50) -> Dict:
 # ============ PROJETOS/OBRAS ============
 
 @mcp.tool
-async def get_sienge_projects(limit: Optional[int] = 50, offset: Optional[int] = 0, status: Optional[str] = None, search: Optional[str] = None) -> Dict:
+async def get_sienge_projects(limit: Optional[int] = 100, offset: Optional[int] = 0, company_id: Optional[int] = None, 
+                            enterprise_type: Optional[int] = None, receivable_register: Optional[str] = None,
+                            only_buildings_enabled: Optional[bool] = False) -> Dict:
     """
-    Busca projetos/obras no Sienge
+    Busca empreendimentos/obras no Sienge
     
     Args:
-        limit: Máximo de registros (padrão: 50)
+        limit: Máximo de registros (padrão: 100, máximo: 200)
         offset: Pular registros (padrão: 0)
-        status: Filtrar por status
-        search: Buscar por nome
+        company_id: Código da empresa
+        enterprise_type: Tipo do empreendimento (1: Obra e Centro de custo, 2: Obra, 3: Centro de custo, 4: Centro de custo associado a obra)
+        receivable_register: Filtro de registro de recebíveis (B3, CERC)
+        only_buildings_enabled: Retornar apenas obras habilitadas para integração orçamentária
     """
-    params = {"limit": min(limit or 50, 200), "offset": offset or 0}
+    params = {"limit": min(limit or 100, 200), "offset": offset or 0}
     
-    if status:
-        params["status"] = status
-    if search:
-        params["search"] = search
+    if company_id:
+        params["companyId"] = company_id
+    if enterprise_type:
+        params["type"] = enterprise_type
+    if receivable_register:
+        params["receivableRegister"] = receivable_register
+    if only_buildings_enabled:
+        params["onlyBuildingsEnabledForIntegration"] = only_buildings_enabled
     
-    result = await make_sienge_request("GET", "/projects", params=params)
+    result = await make_sienge_request("GET", "/enterprises", params=params)
     
     if result["success"]:
         data = result["data"]
-        projects = data.get("results", []) if isinstance(data, dict) else data
+        enterprises = data.get("results", []) if isinstance(data, dict) else data
+        metadata = data.get("resultSetMetadata", {}) if isinstance(data, dict) else {}
         
         return {
             "success": True,
-            "message": f"✅ Encontrados {len(projects)} projetos",
-            "projects": projects,
-            "count": len(projects)
+            "message": f"✅ Encontrados {len(enterprises)} empreendimentos",
+            "enterprises": enterprises,
+            "count": len(enterprises),
+            "metadata": metadata,
+            "filters": params
+        }
+    
+    return {
+        "success": False,
+        "message": "❌ Erro ao buscar empreendimentos",
+        "error": result.get("error"),
+        "details": result.get("message")
+    }
+
+@mcp.tool
+async def get_sienge_enterprise_by_id(enterprise_id: int) -> Dict:
+    """
+    Busca um empreendimento específico por ID no Sienge
+    
+    Args:
+        enterprise_id: ID do empreendimento
+    """
+    result = await make_sienge_request("GET", f"/enterprises/{enterprise_id}")
+    
+    if result["success"]:
+        return {
+            "success": True,
+            "message": f"✅ Empreendimento {enterprise_id} encontrado",
+            "enterprise": result["data"]
+        }
+    
+    return {
+        "success": False,
+        "message": f"❌ Erro ao buscar empreendimento {enterprise_id}",
+        "error": result.get("error"),
+        "details": result.get("message")
+    }
+
+@mcp.tool
+async def get_sienge_enterprise_groupings(enterprise_id: int) -> Dict:
+    """
+    Busca agrupamentos de unidades de um empreendimento específico
+    
+    Args:
+        enterprise_id: ID do empreendimento
+    """
+    result = await make_sienge_request("GET", f"/enterprises/{enterprise_id}/groupings")
+    
+    if result["success"]:
+        groupings = result["data"]
+        return {
+            "success": True,
+            "message": f"✅ Agrupamentos do empreendimento {enterprise_id} encontrados",
+            "groupings": groupings,
+            "count": len(groupings) if isinstance(groupings, list) else 0
         }
     
     return {
         "success": False,
-        "message": "❌ Erro ao buscar projetos",
+        "message": f"❌ Erro ao buscar agrupamentos do empreendimento {enterprise_id}",
         "error": result.get("error"),
         "details": result.get("message")
     }

sienge_ecbiesek_mcp-1.0.0.dist-info/METADATA

@@ -1,205 +0,0 @@
-Metadata-Version: 2.4
-Name: sienge-ecbiesek-mcp
-Version: 1.0.0
-Summary: Sienge ECBIESEK MCP Server - Model Context Protocol integration for Sienge API (ECBIESEK Company)
-Author-email: ECBIESEK <ti@ecbiesek.com>
-License: MIT
-Project-URL: Homepage, https://github.com/Moizas951/Sienge-mcp
-Project-URL: Documentation, https://github.com/Moizas951/Sienge-mcp#readme
-Project-URL: Repository, https://github.com/Moizas951/Sienge-mcp.git
-Project-URL: Issues, https://github.com/Moizas951/Sienge-mcp/issues
-Keywords: sienge,mcp,claude,api,construction,ecbiesek
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-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 :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Office/Business :: Financial
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: fastmcp>=0.1.0
-Requires-Dist: httpx>=0.25.0
-Requires-Dist: pydantic>=2.0.0
-Requires-Dist: python-dotenv>=1.0.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: black>=23.0.0; extra == "dev"
-Requires-Dist: flake8>=6.0.0; extra == "dev"
-Dynamic: license-file
-
-# 🏗️ Sienge ECBIESEK MCP Server
-
-[![PyPI version](https://badge.fury.io/py/sienge-ecbiesek-mcp.svg)](https://badge.fury.io/py/sienge-ecbiesek-mcp)
-[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
-
-**Sienge ECBIESEK MCP Server** - Servidor MCP personalizado para a empresa ECBIESEK integrar com a API do Sienge através do Claude Desktop.
-
-## 🚀 Instalação Rápida (ECBIESEK)
-
-### Usando pipx (Recomendado)
-
-```bash
-# Executar diretamente sem instalação
-pipx run sienge-ecbiesek-mcp
-
-# Ou instalar permanentemente
-pipx install sienge-ecbiesek-mcp
-```
-
-### Usando pip
-
-```bash
-pip install sienge-ecbiesek-mcp
-```
-
-## ⚙️ Configuração no Claude Desktop (ECBIESEK)
-
-Adicione a seguinte configuração ao seu arquivo `claude_desktop_config.json`:
-
-### Para pipx (Recomendado):
-```json
-{
-  "mcpServers": {
-    "SiengeECBIESEK": {
-      "command": "pipx",
-      "args": [
-        "run",
-        "sienge-ecbiesek-mcp@latest"
-      ],
-      "env": {
-        "SIENGE_BASE_URL": "https://api.sienge.com.br",
-        "SIENGE_SUBDOMAIN": "ecbiesek",
-        "SIENGE_USERNAME": "seu-usuario-ecbiesek",
-        "SIENGE_PASSWORD": "sua-senha-ecbiesek"
-      }
-    }
-  }
-}
-```
-
-### Para pip (instalação global):
-```json
-{
-  "mcpServers": {
-    "SiengeECBIESEK": {
-      "command": "sienge-ecbiesek-mcp",
-      "env": {
-        "SIENGE_BASE_URL": "https://api.sienge.com.br",
-        "SIENGE_SUBDOMAIN": "ecbiesek",
-        "SIENGE_USERNAME": "seu-usuario-ecbiesek",
-        "SIENGE_PASSWORD": "sua-senha-ecbiesek"
-      }
-    }
-  }
-}
-```
-
-## 🔐 Variáveis de Ambiente (ECBIESEK)
-
-### Autenticação Basic Auth (Configuração ECBIESEK)
-```bash
-SIENGE_USERNAME=usuario_ecbiesek
-SIENGE_PASSWORD=senha_ecbiesek
-SIENGE_SUBDOMAIN=ecbiesek
-SIENGE_BASE_URL=https://api.sienge.com.br
-```
-
-### Autenticação Bearer Token (Alternativa)
-```bash
-SIENGE_API_KEY=token_api_ecbiesek
-SIENGE_BASE_URL=https://api.sienge.com.br
-```
-
-## 🛠️ Ferramentas Disponíveis
-
-O servidor ECBIESEK fornece mais de 30 ferramentas para interagir com a API do Sienge:
-
-### 📊 Relatórios e Listagens
-- `listar_projetos` - Lista todos os projetos ECBIESEK
-- `listar_contas` - Lista contas a pagar/receber
-- `listar_centros_custo` - Lista centros de custo
-- `listar_fornecedores` - Lista fornecedores
-- `listar_colaboradores` - Lista colaboradores ECBIESEK
-
-### 🏗️ Gestão de Projetos
-- `obter_projeto` - Obtém detalhes de um projeto específico
-- `listar_etapas_projeto` - Lista etapas de um projeto
-- `listar_medicoes_projeto` - Lista medições de um projeto
-
-### 💰 Financeiro
-- `criar_conta_pagar` - Cria conta a pagar
-- `atualizar_conta` - Atualiza conta existente
-- `obter_detalhes_conta` - Obtém detalhes de uma conta
-
-### 👥 Recursos Humanos ECBIESEK
-- `obter_colaborador` - Obtém detalhes de um colaborador
-- `listar_departamentos` - Lista departamentos
-- `listar_cargos` - Lista cargos
-
-### 📦 Estoque e Suprimentos
-- `listar_produtos` - Lista produtos
-- `obter_produto` - Obtém detalhes de um produto
-- `listar_grupos_produto` - Lista grupos de produtos
-
-### ⚙️ Configurações
-- `obter_configuracoes_sistema` - Obtém configurações do sistema
-- `listar_moedas` - Lista moedas disponíveis
-- `obter_info_autenticacao` - Verifica status da autenticação
-
-## 📝 Exemplos de Uso (ECBIESEK)
-
-### Listar Projetos
-```
-Claude: Liste todos os projetos ativos da ECBIESEK no Sienge.
-```
-
-### Criar Conta a Pagar
-```
-Claude: Crie uma conta a pagar para o fornecedor XYZ no valor de R$ 1.500,00 com vencimento em 30 dias.
-```
-
-### Obter Relatório Financeiro
-```
-Claude: Me mostre um resumo das contas a pagar em aberto dos projetos da ECBIESEK.
-```
-
-## 🏢 Sobre a ECBIESEK
-
-Este MCP Server foi desenvolvido especificamente para atender às necessidades da empresa ECBIESEK na integração com o sistema Sienge.
-
-## 📋 Requisitos
-
-- Python 3.9 ou superior
-- Acesso à API do Sienge com credenciais ECBIESEK
-- Claude Desktop instalado
-
-## 🐛 Resolução de Problemas
-
-### Erro de Autenticação
-- Verifique se as credenciais ECBIESEK estão corretas
-- Confirme se o subdomínio "ecbiesek" está correto
-- Teste as credenciais diretamente na API do Sienge
-
-### Timeout de Requisições
-- Aumente o valor de `REQUEST_TIMEOUT`
-- Verifique a conectividade com a API do Sienge
-
-## 📄 Licença
-
-MIT License - Desenvolvido para ECBIESEK
-
-## 📞 Suporte ECBIESEK
-
-- 📧 Email: ti@ecbiesek.com
-- 🏢 Empresa: ECBIESEK
-- 📖 Documentação interna
-
----
-
-**⭐ Sienge ECBIESEK MCP Server - Solução personalizada para integração Sienge + Claude Desktop**

sienge_ecbiesek_mcp-1.0.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-sienge_ecbiesek_mcp-1.0.0.dist-info/licenses/LICENSE,sha256=leWD46QLXsQ43M8fE_KgOo5Sf0YB9_X8EVqGdV0Dsc0,1101
-sienge_mcp/__init__.py,sha256=Pjl4hgBCWhVJ_BBZXaP7SuZfH7Z1JWZbSs8MV5sUle8,287
-sienge_mcp/server.py,sha256=-7JO_QGvI2Bsw2Fg3kcAmVoLLVoEsffZiHwjw3jLPzc,27107
-sienge_mcp/utils/logger.py,sha256=bqU0GDsQXE9TaKOq5_6S2L8bh_Nas-EuYNDE3fzlPWg,5880
-sienge_ecbiesek_mcp-1.0.0.dist-info/METADATA,sha256=kUMzLjwbt_ACAuUJI5M-n6PIuewJP6cwd4ZqX_WfFyI,6318
-sienge_ecbiesek_mcp-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-sienge_ecbiesek_mcp-1.0.0.dist-info/entry_points.txt,sha256=jxEu6gvTw3ci0mjDfqbi0rBLRpeuscwwRk9-H-UOnO8,63
-sienge_ecbiesek_mcp-1.0.0.dist-info/top_level.txt,sha256=FCvuhB9JQPKGY0Q8aKoVc7akqG5htoJyfj-eJvVUmWM,11
-sienge_ecbiesek_mcp-1.0.0.dist-info/RECORD,,