---
title: "Buscar desconto progressivo"
method: GET
path: "/descontosProgressivos/{descontoProgressivoId}"
tags: ["Descontos Progressivos"]
---

# Buscar desconto progressivo

`GET /descontosProgressivos/{descontoProgressivoId}`

## Request

- Base URL: `https://app.vendizap.com/api`
- URL: `https://app.vendizap.com/api/descontosProgressivos/{descontoProgressivoId}`
- Auth: API key in header `X-Auth-Id` and API key in header `X-Auth-Secret`

Retorna um preço de atacado específico pelo ID.

## Response `200`

Preço de atacado encontrado.

- DescontoProgressivo
  - `id` string
  - `usuarioId` string
  - `nome` string
  - `tipo` 'produto' | 'pedido'
  - `ativa` boolean
  - `tipoFiltro` 'todosProdutos' | 'produtos' | 'categorias' | 'null', nullable: Null quando `tipo="pedido"` (desconto sobre o total do pedido, sem filtro de produto/categoria).
  - `produtos` ProdutoVinculado[]: Quando `tipoFiltro="produtos"`, retorna a lista com `id` e `descricao` resolvidos.
    - `id` string
    - `descricao` string
  - `categorias` CategoriaVinculada[]: Quando `tipoFiltro="categorias"`, retorna as categorias **raiz** selecionadas (id + nome). Os descendentes são expandidos internamente pelo servidor para vincular os produtos, mas não aparecem nesta lista.
    - `id` string
    - `nome` string
  - `faixaQuantidade` boolean: Modalidade de faixa por quantidade. Novas campanhas têm exatamente uma entre `faixaQuantidade`/`faixaPreco` ativa; campanhas antigas (dado legado, sem migração) podem aparecer aqui com as duas `true`.
  - `faixaQuantidadeLista` Faixa[]
    - `aPartirDe` number, required: Limiar mínimo a partir do qual a faixa passa a valer (quantidade de itens em `faixaQuantidadeLista`; valor do pedido/produto em `faixaPrecoLista`). Deve ser maior que zero e **estritamente crescente** entre as faixas da mesma lista (sem repetir nem sobrepor). A maior faixa atingida prevalece, não há limite superior.
    - `percentualDesconto` number, required: Percentual de desconto aplicado quando o limiar é atingido. Deve ser maior que zero e no máximo 99, e **estritamente crescente** entre as faixas da mesma lista.
  - `faixaPreco` boolean: Modalidade de faixa por valor. Novas campanhas têm exatamente uma entre `faixaQuantidade`/`faixaPreco` ativa; campanhas antigas (dado legado, sem migração) podem aparecer aqui com as duas `true`.
  - `faixaPrecoLista` Faixa[]
    - `aPartirDe` number, required: Limiar mínimo a partir do qual a faixa passa a valer (quantidade de itens em `faixaQuantidadeLista`; valor do pedido/produto em `faixaPrecoLista`). Deve ser maior que zero e **estritamente crescente** entre as faixas da mesma lista (sem repetir nem sobrepor). A maior faixa atingida prevalece, não há limite superior.
    - `percentualDesconto` number, required: Percentual de desconto aplicado quando o limiar é atingido. Deve ser maior que zero e no máximo 99, e **estritamente crescente** entre as faixas da mesma lista.
  - `permiteCupom` boolean: Indica se cupons podem ser aplicados sobre os itens cobertos por esta campanha. Sempre presente na resposta (`true` para campanhas legadas).

## Other responses

- `400`: Erro na requisição que não foi possível ser completada. O erro é retornado em uma string (não JSON).
- `401`: Credenciais informadas inválidas.

---

[API](https://skmtc.dev/vendizap/apis/api-vendizap.md) · [All operations](https://skmtc.dev/vendizap/apis/api-vendizap/llms.txt) · [OpenAPI document](https://skmtc.dev/vendizap/apis/api-vendizap/revisions/2c0d0a254abb?raw)