Preços

Preço Mínimo (`min_price`)

⚠️ FUNCIONALIDADE EM DESENVOLVIMENTO. O campo ainda não está disponível. Esta seção será atualizada quando o recurso for liberado.

Campo opcional que define o menor preço de venda permitido (em R$) para o produto em uma lista de preço. O mesmo produto pode ter um preço mínimo diferente em cada lista.

Como funciona na loja B2B

O preço mínimo limita o desconto que o vendedor pode dar ao alterar o preço de um item no pedido. O vendedor pode reduzir o preço até o preço mínimo, mas não abaixo dele.

Exemplo: produto com preço de venda de R$ 180,00 e preço mínimo de R$ 160,00 na lista.

O vendedor altera para R$ 170,00 ou R$ 160,00: o preço é aceito.

O vendedor altera para R$ 150,00: o preço é recusado e a loja informa que o valor está abaixo do mínimo permitido.

O vendedor não altera o preço: o item segue com o preço normal da lista.

Se o produto não tiver preço mínimo na lista, a loja segue o fluxo atual, sem limite.

Regras do campo

Obrigatório: não.

Formato: decimal com ponto (ex.: "160.00").

Valor: maior ou igual a zero.

Não enviado: mantém o preço mínimo já cadastrado (ou segue sem preço mínimo).

null ou "": remove o preço mínimo da lista.

Rotas que utilizam o campo

POST /products e PUT /products/{product_key}: em cada item de prices.

POST /products/{product_key}/prices: em cada item de data.

PUT /products/{product_key}/prices/{segmentation}: na raiz do corpo.

POST /price_list_bulk: em cada item de data.

GET /orders e GET /orders/{order_id}: em cada item de items (somente leitura).

Exemplos

POST /products e PUT /products/{product_key}

"prices": [
    {
        "segmentation": "codigo_lista_preco_1",
        "segmentation_name": "nome_lista_preco_1",
        "distribution_center_code": "COD_CD1",
        "home_state": "SP",
        "destination_state": null,
        "value_of": "199.99",
        "value_for": "180.00",
        "spot_value": "180.00",
        "value_for_taxes": "0",
        "min_price": "160.00"
    },
    {
        "segmentation": "codigo_lista_preco_2",
        "segmentation_name": "nome_lista_preco_2",
        "distribution_center_code": "COD_CD1",
        "home_state": "SP",
        "destination_state": null,
        "value_of": "200.99",
        "value_for": "190.00",
        "spot_value": "190.00",
        "value_for_taxes": "0",
        "min_price": null
    }
]

Neste exemplo, a lista 1 passa a ter preço mínimo de R$ 160,00 e a lista 2 fica sem preço mínimo.

POST /products/{product_key}/prices

{
    "data": [
        {
            "segmentation": "codigo_lista_preco_1",
            "distribution_center_code": "COD_CD1",
            "home_state": "SP",
            "value_of": "199.99",
            "value_for": "180.00",
            "spot_value": "180.00",
            "min_price": "160.00"
        }
    ]
}

PUT /products/{product_key}/prices/{segmentation}

É possível enviar apenas o preço mínimo:

{
    "min_price": "160.00"
}

Para remover:

{
    "min_price": null
}

O PUT atualiza todos os registros do produto na lista informada (todos os centros de distribuição e regiões).

POST /price_list_bulk

{
    "process_id": "precos_20261005_001",
    "data": [
        {
            "product_code": "001",
            "segmentation": "codigo_lista_preco_1",
            "segmentation_name": "nome_lista_preco_1",
            "distribution_center_code": "COD_CD1",
            "home_state": "SP",
            "value_of": "199.99",
            "value_for": "180.00",
            "spot_value": "180.00",
            "min_price": "160.00"
        },
        {
            "product_code": "002",
            "segmentation": "codigo_lista_preco_1",
            "segmentation_name": "nome_lista_preco_1",
            "distribution_center_code": "COD_CD1",
            "home_state": "SP",
            "value_of": "99.90",
            "value_for": "89.90",
            "spot_value": "89.90",
            "min_price": null
        }
    ]
}

O processamento em lote é assíncrono e precisa estar habilitado para a loja.

GET /orders e GET /orders/{order_id}

Cada item do pedido exibe o preço mínimo vigente no momento da venda:

"items": [
    {
        "product_code": "001",
        "price_list_code": "codigo_lista_preco_1",
        "quantity": 2,
        "min_price": 160.00
    },
    {
        "product_code": "002",
        "price_list_code": "codigo_lista_preco_1",
        "quantity": 1,
        "min_price": null
    }
]

min_price: null indica que o item não tinha preço mínimo na venda. Pedidos anteriores à liberação do recurso também retornam null.

Dúvidas frequentes

Preciso enviar min_price em toda atualização de preço?
Não. Se o campo não for enviado, o preço mínimo atual é mantido.

Como removo um preço mínimo?
Envie "min_price": null na lista de preço desejada.

Guia Preços

Preços#

Preço Mínimo (min_price)#

Como funciona na loja B2B#

Regras do campo#