Obter produto
Devolve o cadastro completo, a variação única do produto (com estoque) e os números de negócios do produto.
Resposta
{
"data": {
"product": {
"id": "…", "name": "Camiseta Básica", "type": "physical", "status": "active",
"category_id": null, "subcategory_id": null, "category_name": null, "subcategory_name": null,
"brand": null, "description": null, "unit": "UN", "ncm": null, "billing": "one_time",
"base_price": 49.9, "track_stock": true, "external_id": null,
"created_at": "2026-10-06T12:00:00.000Z"
},
"variants": [
{
"id": "…", "sku": "CAM-1", "barcode": null, "price": null, "price_inherits": true, "effective_price": 49.9,
"stock_min": null, "weight_kg": null, "height_cm": null, "width_cm": null, "length_cm": null,
"active": true, "is_default": true,
"em_estoque": 10, "em_orcamentos": 2, "disponivel": 8
}
],
"price_range": { "min": 49.9, "max": 49.9 },
"metrics": {
"total_deals": 3, "open_deals": 1, "quote_deals": 1, "quote_value": 49.9,
"won_deals": 1, "won_value": 99.8, "lost_deals": 1, "lost_value": 49.9,
"quantity_sold": 2, "average_price": 49.9
},
"custom_fields": {}
}
}variants tem sempre um item: cada produto é um produto, sem grade. O id dele é o que vai em
variant_id na linha do negócio. em_orcamentos é a quantidade em negócios abertos da conta inteira
(sem recorte de responsável); disponivel é em_estoque menos em_orcamentos.
metrics conta só os negócios que a chave enxerga ("Só o dele" vale) — e só vem pra chave com
deals:read. quote_* são os negócios na etapa de negociação; average_price vem null sem venda.
⛔ Custo, imposto, lucro e margem só aparecem se quem responde pela chave é dono ou administrador da conta (ou da equipe Salos), conferido a cada chamada. Para os outros, as chaves
cost,tax_rate,tax_value,gross_profitemarginnão existem na resposta.