# SimpleCRM API

> SimpleCRM é uma plataforma CRM gratuita e aberta com API REST para gerenciar contatos, empresas, negócios (funil de vendas), tarefas, produtos, faturas, cotações, atividades, relatórios e webhooks.
> SimpleCRM is a free, open CRM platform with a REST API for managing contacts, companies, deals (sales pipeline), tasks, products, invoices, quotes, activities, reports, and webhooks.

- **URL Base / Base URL**: `https://crm.acessocomercial.com/api`
- **Autenticação / Authentication**: API Key via header `X-API-Key` (ou `Authorization: Bearer <key>`)
- **Rate limit**: 60 requisições/minuto por API key
- **Content-Type**: `application/json`
- **IDs**: Strings hexadecimais de 24 caracteres (MongoDB ObjectId)
- **Datas / Dates**: Formato ISO 8601 (`2026-05-07T10:00:00Z`)
- **Erros / Errors**: `{ "error": "descrição" }`
- **Paginação / Pagination**: `?page=1&limit=20` (máx 100)

## Referência da API / API Reference

- [Contatos](https://crm.acessocomercial.com/docs/api/contacts): CRUD completo para gerenciamento de contatos e leads.
- [Empresas](https://crm.acessocomercial.com/docs/api/companies): Gerenciamento de empresas e organizações vinculadas aos contatos.
- [Negócios](https://crm.acessocomercial.com/docs/api/deals): Funil de vendas: criação, atualização de estágio e acompanhamento de negócios.
- [Tarefas](https://crm.acessocomercial.com/docs/api/tasks): Gerenciamento de tarefas, follow-ups e calendário de atividades.
- [Produtos](https://crm.acessocomercial.com/docs/api/products): Catálogo de produtos e serviços com preços e categorias.
- [Faturas](https://crm.acessocomercial.com/docs/api/invoices): Criação, acompanhamento e gestão de faturas e pagamentos.
- [Cotações](https://crm.acessocomercial.com/docs/api/quotes): Propostas comerciais com conversão direta para faturas.
- [Atividades](https://crm.acessocomercial.com/docs/api/activities): Registro de atividades e timeline de interações com contatos e negócios.
- [Relatórios](https://crm.acessocomercial.com/docs/api/reports): Dashboards, métricas de vendas e análises de performance.
- [Webhooks](https://crm.acessocomercial.com/docs/api/webhooks): Consulte seus webhooks configurados. Criação, edição e exclusão são feitas pela interface web.

## Eventos de Webhook / Webhook Events

- [Webhooks](https://crm.acessocomercial.com/docs/api/webhooks): Notificações em tempo real para mudanças em entidades

## Especificações / Specs

- [Desenvolvimento Orientado a Especificações](https://crm.acessocomercial.com/docs/api/spec-driven): Construa sua própria interface usando nossas specs

## Arquivos de Especificação / Spec Files

- [OpenAPI 3.1 Spec](https://crm.acessocomercial.com/openapi.json): Contrato completo da API em formato OpenAPI 3.1
- [Referência Completa (LLM)](https://crm.acessocomercial.com/llms-full.txt): Documentação completa otimizada para LLMs
- [Referência da API (.md)](https://crm.acessocomercial.com/docs/specs/api-reference.md): Especificação completa dos endpoints em Markdown
- [Webhooks (.md)](https://crm.acessocomercial.com/docs/specs/webhooks.md): Eventos de webhook com payloads de exemplo
- [Modelos de Dados (.md)](https://crm.acessocomercial.com/docs/specs/data-models.md): Schemas das entidades e valores permitidos

## Servidor MCP / MCP Server

- [Servidor MCP](https://crm.acessocomercial.com/docs/api/mcp-server): Servidor MCP hospedado para integração com assistentes de IA
- **Endpoint**: `https://crm.acessocomercial.com/mcp` (configurar com sua API Key)

## Optional

- [Blog](https://crm.acessocomercial.com/blog): Atualizações e dicas sobre CRM
- [Privacidade](https://crm.acessocomercial.com/privacy): Política de privacidade
- [Termos](https://crm.acessocomercial.com/terms): Termos de uso