> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developers.wbudget.app/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.wbudget.app/_mcp/server. # Consultar produto ou serviço GET https://wbudget.app/api/v1/api/v1/items/{id} 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. Reference: https://developers.wbudget.app/w-budget/produtos-e-servicos/consultar-produto-ou-serviço ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Request ### Path parameters - `id` (string, required) — ID do produto ou serviço. ## Response ### 200 OK - `data` (object, required) - `id` (integer, required) - `name` (string, required) - `type` (string, required) - `value` (integer, required) - `qty` (integer, required) - `unit` (string, required) - `description` (string, required) - `active` (boolean, required) - `cost` (integer, required) - `tax` (integer, required) - `sku` (string, required) - `tag` (string, required) - `metadata` (object, required) - `referencia` (string, required) - `create_date` (datetime, required) - `category` (any, optional) - `category_name` (any, optional) - `pn` (any, optional) ## Errors ### 404 Not Found Error Not Found - `error` (object, required) - `message` (string, required) - `code` (string, required) ## Examples **Response** ```json { "data": { "id": 501, "name": "Consultoria", "type": "service", "value": 150, "qty": 1, "unit": "hour", "description": "Consultoria por hora", "active": true, "cost": 0, "tax": 0, "sku": "SERV-501", "tag": "consultoria", "metadata": { "referencia": "ERP-501" }, "create_date": "2026-09-06T10:00:00-03:00" } } ``` **SDK Code** ```python Produtos e servicos_Consultar produto ou serviço_example import requests url = "https://wbudget.app/api/v1/api/v1/items/501" headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript Produtos e servicos_Consultar produto ou serviço_example const url = 'https://wbudget.app/api/v1/api/v1/items/501'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Produtos e servicos_Consultar produto ou serviço_example package main import ( "fmt" "net/http" "io" ) func main() { url := "https://wbudget.app/api/v1/api/v1/items/501" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Produtos e servicos_Consultar produto ou serviço_example require 'uri' require 'net/http' url = URI("https://wbudget.app/api/v1/api/v1/items/501") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java Produtos e servicos_Consultar produto ou serviço_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://wbudget.app/api/v1/api/v1/items/501") .header("Authorization", "Bearer ") .asString(); ``` ```php Produtos e servicos_Consultar produto ou serviço_example request('GET', 'https://wbudget.app/api/v1/api/v1/items/501', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp Produtos e servicos_Consultar produto ou serviço_example using RestSharp; var client = new RestClient("https://wbudget.app/api/v1/api/v1/items/501"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift Produtos e servicos_Consultar produto ou serviço_example import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://wbudget.app/api/v1/api/v1/items/501")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```