Conhecimento Market Base de Conhecimento

Alterando preços e promoções

Este artigo faz parte do Manual do Integrador.

Seu usuário de integração precisa ter a permissão para alterar preços e promoções via API, antes de continuar solicite esta permissão para o seu usuário.

Segue algumas opções de alteração nos preços e promoções dos produtos nas lojas:

Estes preços precisam aguardar o processo de geração de preços no Market Gestor para ficar ativo na loja.

Alterar preço normal do produto na loja

Com o endpoint abaixo podemos alterar o preço normal do produto.

POST {{url}}v1/precos/preconormal

Authorization: Bearer {{token}}

Content-Type: application/json

{

"produtoId": 2,

"lojaId": 1,

"precoNormal": 12.89

}

Inserir campanha de preço promocional

Com esta opções nós podemos informar um preço promocional e o período que ele vai ficar ativo. Podemos passar um conjunto de produtos e lojas.

No atributo "precoPromocional" informe qual o preço norma do produto durante o período.

Esta opção retorna o código da campanha promocional para consultas posteriores.

POST {{url}}v1/precos/campanha/promocional

Authorization: Bearer {{token}}

Content-Type: application/json

{

"produtoId": [16949,16946],

"lojaId": [1, 2],

"precoNormal": 12.95,

"precoPromocional": 11.50,

"periodo": {

"dataInicial": "2026-09-22",

"dataFinal": "2026-09-30"

}

}

Inserir campanha de preço de atacado nível 1

A diferença dessa opção é que temos uma quantidade vinculada ao preço promocional, o cliente deve comprar no mínimo a quantidade informada em "qtdAtacado" para ativar o preço "precoAtacado".

POST {{url}}v1/precos/campanha/atacado/nivel1

Authorization: Bearer {{token}}

Content-Type: application/json

{

"produtoId": [18546, 17724],

"lojaId": [1, 2],

"precoNormal": 7.20,

"precoAtacado": 6.50,

"qtdAtacado": 3,

"periodo": {

"dataInicial": "2026-09-21",

"dataFinal": "2026-09-30"

}

}

Inserir campanha com dois níveis de atacado

A diferença nesse caso é que temos dois níveis de preços, para a quantidade mínima "qtdAtacadoNivel1" temos o preço de "precoAtacadoNivel1", se chegar na quantidade "qtdAtacadoNivel2" ou superior temos o preço "precoAtacadoNivel2".

POST {{url}}v1/precos/campanha/atacado/nivel2

Authorization: Bearer {{token}}

Content-Type: application/json

{

"produtoId": [ 18312, 124 ],

"lojaId": [1, 2],

"precoNormal": 9.00,

"precoAtacadoNivel1": 8.60,

"qtdAtacadoNivel1": 3,

"precoAtacadoNivel2": 8.10,

"qtdAtacadoNivel2": 6,

"periodo": {

"dataInicial": "2026-09-21",

"dataFinal": "2026-09-30"

}

}

Cancelar campanha promocional

Os processos acima de inserir uma campanha promocional geram um código que se for necessário cancelar esta campanha utilize a opção abaixo:

DELETE {{url}}v1/precos/campanha

Authorization: Bearer {{token}}

Content-Type: application/json

{

"campanhaId": 1

}

Consultando campanhas promocionais

Será possível consultar as campanhas promocionais passadas ou futuras. Para isso siga o exemplo abaixo:

GET {{url}}v1/precos/campanha/periodo?Periodo.DataInicial=2026-09-01&Periodo.DataFinal=2026-09-30&Page=1&PageSize=20

Authorization: Bearer {{token}}