> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developers.wbudget.app/w-budget/produtos-e-servicos/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.wbudget.app/_mcp/server. # Overview O **catálogo** reúne os produtos e serviços que entram nas propostas, com preço, quantidade padrão, unidade e categoria. Um item do catálogo vira uma **linha** quando é adicionado a uma oportunidade. ## Rotas | Método | Rota | Para quê | | -------- | ------------- | -------------------------------------------------------------------------------------------------------------- | | `GET` | `/items` | [Listar produtos e serviços](/w-budget/produtos-e-servicos/listar-produtos-e-servicos) ativos. | | `GET` | `/items/{id}` | [Consultar produto ou serviço](/w-budget/produtos-e-servicos/consultar-produto-ou-servi-o), inclusive inativo. | | `POST` | `/items` | [Criar produto ou serviço](/w-budget/produtos-e-servicos/criar-produto-ou-servi-o). | | `PUT` | `/items/{id}` | [Atualizar produto ou serviço](/w-budget/produtos-e-servicos/atualizar-produto-ou-servi-o) parcialmente. | | `DELETE` | `/items/{id}` | [Excluir produto ou serviço](/w-budget/produtos-e-servicos/excluir-produto-ou-servi-o) sem vínculos. | ## Catálogo × linha da oportunidade | | Catálogo (`/items`) | Linha da oportunidade | | ------------- | -------------------------------------- | ----------------------------------------------------------------------------------------- | | Identificador | `id` do produto ou serviço | `itemId` da linha | | Onde se edita | `PUT /items/{id}` | [`PUT /budgets/{id}/items/{itemId}`](/w-budget/oportunidades/editar-item-da-oportunidade) | | Efeito | Muda o cadastro para propostas futuras | Muda só aquela proposta | Para colocar itens numa oportunidade, envie os `id` do catálogo em `items` ao [criar a oportunidade](/w-budget/oportunidades/criar-oportunidade) ou em [Adicionar itens do catálogo](/w-budget/oportunidades/adicionar-itens-do-catalogo). ## Cuidados * **Escrita exige permissão** de edição do cadastro de produtos. * **`type`** é `product` ou `service`. Na criação, a unidade padrão é `un` para produto e `hour` para serviço. * **`PUT` é parcial.** Campos omitidos são preservados; `0` e `false` são valores válidos. `null` limpa `category`, `description`, `tag`, `sku` e `pn`. * **Inativo some da listagem.** Item com `active: false` deixa de aparecer em `GET /items`, mas continua acessível por `GET /items/{id}`. * **Exclusão com vínculo dá 409.** Para tirar de uso sem perder o histórico, envie `{"active": false}` em `PUT /items/{id}`. ## API Docs - [Listar produtos e servicos](https://developers.wbudget.app/w-budget/produtos-e-servicos/listar-produtos-e-servicos.md): Produtos E Servicos - [Criar produto ou serviço](https://developers.wbudget.app/w-budget/produtos-e-servicos/criar-produto-ou-servi-o.md): Produtos E Servicos - [Consultar produto ou serviço](https://developers.wbudget.app/w-budget/produtos-e-servicos/consultar-produto-ou-servi-o.md): Produtos E Servicos - [Atualizar produto ou serviço](https://developers.wbudget.app/w-budget/produtos-e-servicos/atualizar-produto-ou-servi-o.md): Produtos E Servicos - [Excluir produto ou serviço](https://developers.wbudget.app/w-budget/produtos-e-servicos/excluir-produto-ou-servi-o.md): Produtos E Servicos ## 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