---
title: "Consulta por Perfil do cliente"
method: GET
path: "/v1/vendas/recomendacoes/perfil-cliente"
tags: ["Sugestões de Vendas"]
---

# Consulta por Perfil do cliente

`GET /v1/vendas/recomendacoes/perfil-cliente`

Recebe o código do parceiro via query param e retorna recomendações de produtos baseadas no perfil de compra do agrupador ao qual o parceiro pertence. Quando não há agrupador vigente ou não há ranking calculado, retorna `temRecomendacao` false com o motivo da ausência.

Versão mínima do SankhyaOm: **4.36**

## Query parameters

- `codigoParceiro` integer, required

## Response `200`

Operação bem sucedida

- RetornoPerfilCliente
  - `codigoParceiro` integer — Código do parceiro consultado
  - `nivelAgrupador` string, nullable — Nível do agrupador vigente do parceiro (ex. 'CNAE', 'SEGMENTO')
  - `valorAgrupador` string, nullable — Valor do agrupador vigente (ex. o código CNAE do parceiro)
  - `identificadorExecucao` integer, nullable — Identificador da execução de pré-processamento que originou o ranking utilizado
  - `temRecomendacao` boolean — Indica se há recomendações disponíveis para o parceiro
  - `motivoAusencia` string, nullable — Motivo pelo qual não há recomendações. Presente apenas quando `temRecomendacao` é false. Valores possíveis: PARCEIRO_SEM_AGRUPADOR, SEM_RANKING_VIGENTE.
  - `itensRecomendados` ItemRecomendadoPerfilCliente[] — Lista de produtos recomendados para o perfil do parceiro, ordenados por rank ASC
    - `codigoProduto` integer — Código do produto recomendado (TGFPRO.CODPROD)
    - `controle` string — Controle de grade/lote do produto recomendado. Valor ' ' (espaço) indica produto sem controle de grade.
    - `descricaoProduto` string — Descrição do produto recomendado (TGFPRO.DESCRPROD)
    - `rank` integer — Posição do produto no ranking do perfil (1-indexed)
    - `frequencia` number, double — Frequência relativa de compra do produto pelo perfil (0.0 a 1.0). Proporção de clientes do agrupador que compraram este produto.
    - `cobertura` number, double — Cobertura do produto no perfil (0.0 a 1.0). Proporção do volume total do perfil representada por este produto.
    - `volume` number, double — Volume total comprado do produto pelo perfil no período de análise

## Other responses

- `400` — Informações Inválidas. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `401` — Não autenticado. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `403` — Autenticação inválida. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `500` — Erro interno no servidor. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.

---

[API](https://skmtc.net/sankhya/apis/api-sankhya.md) · [All operations](https://skmtc.net/sankhya/apis/api-sankhya/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sankhya/api-sankhya/revisions/0a3e81ca6195/schema)