Obter produto

Devolve o cadastro completo, a variação única do produto (com estoque) e os números de negócios do produto.

GET https://app.salos.com.br/api/products/{id} products:read

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_profit e margin não existem na resposta.