get_coverage_trend
Histórico trimestral de cobertura por município · domínio Vendas · escopo mcp:trade
O que faz
Cobertura de um fornecedor por município, trimestre a trimestre — para achar onde a cobertura caiu vs o trimestre anterior. Cobertura = % dos clientes que compraram algo naquele município, no trimestre, que também compraram deste fornecedor. Use para 'onde a cobertura da Nissin caiu no último trimestre?'.
Exemplo de pergunta
“onde a cobertura da Nissin caiu no último trimestre?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Padrão | Significado |
|---|---|---|---|---|
supplier_code | integer | sim | — | Fornecedor (obrigatório) |
municipality_code | integer | não | — | Filtra um município (opcional) |
top | integer (1–500) | não | 100 |
O que você recebe
supplier_code— Fornecedor (cód.)supplier_name— Fornecedormunicipality_code— Município (cód.)municipality_name— Municípioquarter_labelregistered_countcovered_countcoverage_pct
Cuidados ao ler o resultado
Leia antes de interpretar
- Um trimestre só aparece depois de fechado por completo — o trimestre em andamento nunca é mostrado (comparação parcial não é válida).
- Cobertura é calculada sobre quem comprou algo no município naquele trimestre (não sobre o cadastro atual de clientes) — imune a clientes cadastrados/excluídos depois.
- Atualizado no máximo 4x ao ano (a cada fechamento de trimestre), não diariamente.
Por trás da ferramenta
Esta ferramenta consulta o endpoint /v1/coverage-history da API REST — as mesmas permissões e o mesmo recorte da sua credencial valem nos dois caminhos.
Esta página ajudou? Conte para a gente — lemos tudo.