Consultar produto ou serviço

Consulta um produto ou serviço, inclusive quando inativo. **Autenticação:** Bearer Token da API WBudget. O acesso aos dados respeita as permissões do usuário. Use o ID do cadastro de produtos e serviços. Não é o ID de uma linha da oportunidade. ### Parâmetros de caminho | Campo | Tipo | Obrigatório | Descrição | |---|---|---|---| | `id` | integer | Sim | ID do produto ou serviço. | ### Resposta HTTP **200**. Os exemplos usam dados fictícios e mostram os campos principais; outros campos podem acompanhar a resposta. Campos sem valor podem ser nulos. Campos principais de `data`: | Campo | Tipo | Descrição | |---|---|---| | `id` | integer | ID do produto ou serviço. | | `name` | string | Nome, entre 1 e 150 caracteres. | | `type` | string | product ou service. Padrão product. | | `category` | integer ou null | ID de categoria existente. Null remove a categoria; omitido na criação usa o padrão da conta. | | `value` | number | Preço unitário entre 0 e 99999999.9999. Padrão 0. | | `qty` | number | Quantidade entre 0 e 99999999.9999. Padrão 1; arredondada conforme a unidade. | | `unit` | string | Unidade cadastrada (até 8 caracteres). Na criação: un para produto e hour para serviço. | | `description` | string ou null | Descrição do produto ou serviço. | | `active` | boolean ou integer | true/false ou 1/0. Padrão true. Itens inativos deixam de aparecer em GET /items. | | `cost` | number | Custo não negativo, máximo 99999999.9999. Padrão 0; a consulta respeita as permissões do usuário. | | `tax` | number | Tributo não negativo, máximo 999999.999999. Padrão 0, conforme configuração comercial da conta. | | `sku` | string ou null | Código SKU único, até 45 caracteres. Null ou texto vazio remove o código. | | `pn` | string ou null | Código do fabricante único, até 45 caracteres. Null ou texto vazio remove o código. | | `tag` | string ou null | Etiquetas do item. | | `metadata` | object ou null | Campos personalizados. Chaves enviadas são mescladas; uma chave com null é removida. O objeto omitido ou null preserva os valores atuais. | | `category_name` | string ou null | Nome da categoria. | | `create_date` | string | Data de criação. | ```json { "data": { "id": 501, "name": "Consultoria", "type": "service", "category": null, "category_name": null, "value": 150, "qty": 1, "unit": "hour", "description": "Consultoria por hora", "active": true, "cost": 0, "tax": 0, "sku": "SERV-501", "pn": null, "tag": "consultoria", "metadata": { "referencia": "ERP-501" }, "create_date": "2026-09-06T10:00:00-03:00" } } ``` ### Erros específicos | HTTP | Código | Situação | |---|---|---| | 404 | `ITEM_NOT_FOUND` | Item not found. | Consulte a introdução da collection para o formato de erros e a configuração das variáveis.