---
title: "Consulta por Itens da cesta"
method: GET
path: "/v1/vendas/recomendacoes/market-basket"
tags: ["Sugestões de Vendas"]
---

# Consulta por Itens da cesta

`GET /v1/vendas/recomendacoes/market-basket`

Recebe a cesta de produtos do cliente via query params e retorna recomendações de produtos complementares ordenadas por relevância (score DESC, codigoProduto ASC). Produtos já presentes na cesta e produtos inativos são excluídos automaticamente dos resultados. O parâmetro `codigoProduto` pode ser repetido para informar múltiplos produtos; `controle` é alinhado por posição com `codigoProduto`.

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

## Query parameters

- `codigoProduto` integer[], required
- `controle` string[]
- `maxSuggestions` integer
- `pageSize` integer
- `pageNumber` integer
- `codigoTipoOperacao` integer
- `codigoNota` integer

## Response `200`

Operação bem sucedida

- RetornoSugestoesVendas
  - `requestId` string, uuid — Identificador único da requisição (para rastreabilidade em logs)
  - `identificadorExecucao` integer — Identificador da execução de pré-processamento que originou as regras utilizadas
  - `itensRecomendados` ItemRecomendadoMarketBasket[] — Lista de produtos recomendados, ordenados por score DESC, codigoProduto ASC. Pode ser vazia quando não há regras ativas para a cesta.
    - `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)
    - `tituloControle` string — Título da grade de controle (ex. 'Grade', 'Lote')
    - `textoSugestao` string — Texto de apresentação da sugestão ao usuário final
    - `score` number, double — Score agregado determinístico: soma dos scores de todas as regras ativadas pelos itens da cesta.
    - `rank` integer — Posição global do item na lista ordenada (1-indexed, não relativo à página)
    - `produtosBase` ProdutoBase[] — Lista de produtos da cesta que originaram esta recomendação
      - `codigoProdutoBase` integer — Código do produto antecedente (da cesta do cliente)
      - `controleBase` string — Controle de grade/lote do produto antecedente. Valor ' ' (espaço) indica produto sem controle de grade.
      - `descricaoProdutoBase` string — Descrição do produto antecedente (TGFPRO.DESCRPROD)
      - `score` number, double — Contribuição individual deste antecedente para o score do produto recomendado
  - `pagination` SugestoesVendaspaginacao
    - `pageNumber` integer — Número da página retornada (1-indexed)
    - `pageSize` integer — Tamanho de página solicitado
    - `totalItems` integer — Total de recomendações disponíveis (limitado por maxSuggestions)
    - `totalPages` integer — Total de páginas (ceil(totalItems / pageSize))

## 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/versions/0a3e81ca6195/schema)