> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developers.wbudget.app/w-budget/funis/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.wbudget.app/_mcp/server. # Overview Um **funil** é o caminho comercial de uma oportunidade, dividido em **etapas** ordenadas. O ID de uma etapa é o que vai no campo `status` da oportunidade; o do funil, em `pipe`. ## Rotas | Método | Rota | Para quê | | ------ | ------------- | --------------------------------------------------------------- | | `GET` | `/pipes` | [Listar funis](/w-budget/funis/listar-funis) com suas etapas. | | `GET` | `/pipes/{id}` | [Detalhar funil](/w-budget/funis/detalhar-funil) e suas etapas. | ## Campos principais | Campo | Conteúdo | | ------------- | -------------------------------------------- | | `id` / `name` | Identificação do funil. | | `order` | Ordem de exibição. | | `init_status` | ID da etapa inicial do funil. | | `statuses[]` | Etapas, com `id`, `name`, `color` e `order`. | ## Para que usar * Escolher a etapa inicial ao [criar uma oportunidade](/w-budget/oportunidades/criar-oportunidade) (`init_status` é um bom padrão). * Descobrir o ID da etapa de destino antes de [mover uma oportunidade](/w-budget/oportunidades/mover-oportunidade-de-etapa). * Filtrar [oportunidades](/w-budget/oportunidades/listar-oportunidades) e o [relatório de faturamento](/w-budget/relatorios/relatorio-de-faturamento) por etapa. Funis e etapas vêm ordenados pelo campo `order`. Para saber o que uma etapa exige antes de receber a oportunidade, consulte [Etapas](/w-budget/etapas). ## API Docs - [Listar funis](https://developers.wbudget.app/w-budget/funis/listar-funis.md): Funis - [Detalhar funil](https://developers.wbudget.app/w-budget/funis/detalhar-funil.md): Funis ## OpenAPI Specification - [OpenAPI JSON](https://developers.wbudget.app/openapi.json): raw OpenAPI 3.1 specification for this API, JSON format - [OpenAPI YAML](https://developers.wbudget.app/openapi.yaml): raw OpenAPI 3.1 specification for this API, YAML format