Descontos Progressivos

Atualizar parcialmente desconto progressivo (merge)

Atualiza apenas os campos enviados; os demais permanecem como estavam. O payload mesclado é re-validado pelas regras gerais, incluindo a modalidade de faixa exclusiva (exatamente uma entre faixaQuantidade/faixaPreco), senão HTTP 400. A exigência de ao menos uma modalidade ativa vale sempre, mesmo quando o PATCH não toca faixa. Exceção: só a checagem de exclusividade (as duas ativas ao mesmo tempo) é pulada quando o payload não envia nenhuma das quatro chaves de faixa (faixaQuantidade, faixaPreco, faixaQuantidadeLista, faixaPrecoLista) — cobre campanhas legadas ainda com as duas modalidades ativas.

patch/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

Request body

nomestring
tipo'produto' | 'pedido'
ativaboolean
tipoFiltro'todosProdutos' | 'produtos' | 'categorias'
categoriasstring[]
faixaQuantidadeboolean

Exclusivo com faixaPreco no documento mesclado — exatamente uma das duas deve ficar true, senão HTTP 400. Desativar uma modalidade zera a lista correspondente ([]).

faixaPrecoboolean

Exclusivo com faixaQuantidade no documento mesclado — exatamente uma das duas deve ficar true, senão HTTP 400. Desativar uma modalidade zera a lista correspondente ([]).

permiteCupomboolean

Quando false, os itens cobertos por esta campanha (com a faixa atingida) saem da base de cálculo de cupons. Omitir mantém o valor atual.

Example request

{
  "produtos": [
    {
      "id": "6682f7b065be87123fd4d157",
      "codigo": "SKU-001"
    }
  ],
  "faixaQuantidadeLista": [
    {
      "aPartirDe": 2,
      "percentualDesconto": 10
    }
  ],
  "faixaPrecoLista": [
    {
      "aPartirDe": 2,
      "percentualDesconto": 10
    }
  ]
}

Response

Preço de atacado atualizado.

idstring

Example response

{
  "id": "6048f2b4b6fa7c28844582d5"
}

Changes

No recorded changes to this operation across all 1 revision of this API.