Relatorio de Vendedores

GET /external/v1/reports/sellers

Retorna KPIs comerciais por vendedor — leads, negocios ganhos, receita, ticket medio e taxa de conversao — ordenados por receita. Construido sobre as mesmas definicoes do resto do CRM.

Definicoes

• leads de um vendedor = todas as oportunidades atribuidas a ele (respeitando os filtros).
• Ganha = ativa (lost_at IS NULL e discarded_at IS NULL) e em uma etapa is_win_stage.
• conversion_rate = won_count / leads.
• avg_ticket = won_value / won_count.
• Oportunidades sem responsavel sao excluidas.

Autenticacao

Requer permissao reports:read.

Parametros de Query

Parametro	Tipo	Padrao	Descricao
pipeline_id	string	-	Restringe a um pipeline
sector_id	string	-	Restringe a um setor/time
from	string (ISO 8601)	-	Apenas oportunidades criadas a partir desta data
to	string (ISO 8601)	-	Apenas oportunidades criadas ate esta data

Requisicao

cURL

curl --request GET \
  --url "https://app.getraze.com/external/v1/reports/sellers?from=2026-01-01" \
  --header "X-API-Key: YOUR_API_KEY"

Node.js

const axios = require('axios');

const response = await axios.get('https://app.getraze.com/external/v1/reports/sellers', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' },
  params: { from: '2026-01-01' }
});

console.log(response.data);

Python

import requests

response = requests.get(
    'https://app.getraze.com/external/v1/reports/sellers',
    headers={'X-API-Key': 'YOUR_API_KEY'},
    params={'from': '2026-01-01'}
)

print(response.json())

Resposta

{
  "success": true,
  "data": [
    {
      "owner_user_id": "usr_123",
      "owner_user_name": "Maria Silva",
      "owner_user_email": "maria@acme.com",
      "leads": 58,
      "won_count": 12,
      "won_value": 180000.00,
      "open_count": 30,
      "open_value": 420000.00,
      "lost_count": 16,
      "avg_ticket": 15000.00,
      "conversion_rate": 20.69
    }
  ]
}

Campos de Resposta

Campo	Tipo	Descricao
owner_user_id / owner_user_name / owner_user_email	string	O vendedor
leads	integer	Oportunidades atribuidas ao vendedor
won_count / won_value	number	Negocios ganhos e receita
open_count / open_value	number	Oportunidades ativas nao-ganhas e seu valor
lost_count	integer	Oportunidades perdidas/descartadas
avg_ticket	number	won_value / won_count
conversion_rate	number	won_count / leads (%)