API atual/Referência completa/Compra B2B: atacado e pedidos programados

Preço de atacado

Faixas de preço por quantidade e quantidade mínima de compra de um produto.

Duas consultas por produto para montar a vitrine de atacado. Ambas exigem o token do cliente, porque a escada de preços pode depender do grupo de clientes a que ele pertence.

Faixas de preço por quantidade

Devolve a escada de preços de atacado do produto: quanto custa a unidade em cada faixa de quantidade. Serve para a tabela "compre mais, pague menos" da página do produto. As faixas incluem as regras gerais da loja e as dirigidas aos grupos de clientes do cliente logado.

GET/api/v1/storefront/b2b/products/{productId}/tiersCliente

Tabela de preço por faixa de quantidade de um produto

Parâmetros de caminho

productIduuidobrigatório

Id do produto.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/storefront/b2b/products/c3f92551-9dda-4fc7-b518-353d1c4e4035/tiers" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Faixas

json

{
  "product_id": "c3f92551-9dda-4fc7-b518-353d1c4e4035",
  "tiers": [
    {
      "min_qty": 1,
      "max_qty": 49,
      "unit_price": 2490,
      "source": "tier"
    },
    {
      "min_qty": 50,
      "max_qty": 199,
      "unit_price": 2290,
      "source": "tier"
    },
    {
      "min_qty": 200,
      "max_qty": 0,
      "unit_price": 2100,
      "discount_bps": 1566,
      "source": "b2b_rule"
    }
  ]
}

Campos da resposta

product_iduuid

O produto.

tiersarray

Faixas, da menor para a maior quantidade. Lista vazia quando o produto não tem escada.

min_qtyinteger

Quantidade mínima da faixa.

max_qtyinteger

Quantidade máxima. 0 = sem limite.

unit_priceinteger

Preço unitário na faixa, em centavos.

discount_bpsinteger

Desconto sobre o preço de tabela em pontos-base (1500 = 15%), quando a faixa vem de regra por percentual. Ausente nas demais.

sourcestring

tierb2b_rule

Origem: tier é a faixa de preço do catálogo; b2b_rule é uma regra B2B da loja.

value_per_kg, value_per_unitinteger

Valores de referência por kg ou por unidade, em centavos, só para exibição e só em faixas tier que os tenham.

Erros

Status	Quando	Corpo de exemplo
400	`productId` não é um UUID.	`{"error":"invalid productId","detail":"productId must be a valid UUID"}`
401	Sem token de cliente no cabeçalho `Authorization`.	`{"error":"missing authorization header"}`
404	Produto inexistente ou excluído.	`{"error":"product not found"}`

Quantidade mínima de compra

Devolve a quantidade mínima de pedido (MOQ, minimum order quantity) do produto. Atacadistas vendem, por exemplo, só caixas fechadas de 12: use o valor para iniciar o seletor de quantidade e validar o carrinho antes de enviar.

GET/api/v1/storefront/b2b/products/{productId}/min-qtyCliente

Menor quantidade que a loja vende desse produto

Parâmetros de caminho

productIduuidobrigatório

Id do produto.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/storefront/b2b/products/c3f92551-9dda-4fc7-b518-353d1c4e4035/min-qty" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Quantidade mínima

json

{
  "product_id": "c3f92551-9dda-4fc7-b518-353d1c4e4035",
  "min_order_qty": 12
}

Campos da resposta

product_iduuid

O produto.

min_order_qtyinteger

Quantidade mínima, no mínimo 1.

Erros

Status	Quando	Corpo de exemplo
400	`productId` não é um UUID.	`{"error":"invalid productId","detail":"productId must be a valid UUID"}`
401	Sem token de cliente no cabeçalho `Authorization`.	`{"error":"missing authorization header"}`
404	Produto inexistente ou excluído.	`{"error":"product not found"}`

Veja também

API atual/Referência completa/Compra B2B: atacado e pedidos programados

Preço de atacado

Faixas de preço por quantidade e quantidade mínima de compra de um produto.

Duas consultas por produto para montar a vitrine de atacado. Ambas exigem o token do cliente, porque a escada de preços pode depender do grupo de clientes a que ele pertence.

Faixas de preço por quantidade

GET/api/v1/storefront/b2b/products/{productId}/tiersCliente

Tabela de preço por faixa de quantidade de um produto

Parâmetros de caminho

productIduuidobrigatório

Id do produto.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/storefront/b2b/products/c3f92551-9dda-4fc7-b518-353d1c4e4035/tiers" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Faixas

json

{
  "product_id": "c3f92551-9dda-4fc7-b518-353d1c4e4035",
  "tiers": [
    {
      "min_qty": 1,
      "max_qty": 49,
      "unit_price": 2490,
      "source": "tier"
    },
    {
      "min_qty": 50,
      "max_qty": 199,
      "unit_price": 2290,
      "source": "tier"
    },
    {
      "min_qty": 200,
      "max_qty": 0,
      "unit_price": 2100,
      "discount_bps": 1566,
      "source": "b2b_rule"
    }
  ]
}

Campos da resposta

product_iduuid

O produto.

tiersarray

Faixas, da menor para a maior quantidade. Lista vazia quando o produto não tem escada.

min_qtyinteger

Quantidade mínima da faixa.

max_qtyinteger

Quantidade máxima. 0 = sem limite.

unit_priceinteger

Preço unitário na faixa, em centavos.

discount_bpsinteger

Desconto sobre o preço de tabela em pontos-base (1500 = 15%), quando a faixa vem de regra por percentual. Ausente nas demais.

sourcestring

tierb2b_rule

Origem: tier é a faixa de preço do catálogo; b2b_rule é uma regra B2B da loja.

value_per_kg, value_per_unitinteger

Valores de referência por kg ou por unidade, em centavos, só para exibição e só em faixas tier que os tenham.

Erros

Status	Quando	Corpo de exemplo
400	`productId` não é um UUID.	`{"error":"invalid productId","detail":"productId must be a valid UUID"}`
401	Sem token de cliente no cabeçalho `Authorization`.	`{"error":"missing authorization header"}`
404	Produto inexistente ou excluído.	`{"error":"product not found"}`

Quantidade mínima de compra

GET/api/v1/storefront/b2b/products/{productId}/min-qtyCliente

Menor quantidade que a loja vende desse produto

Parâmetros de caminho

productIduuidobrigatório

Id do produto.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/storefront/b2b/products/c3f92551-9dda-4fc7-b518-353d1c4e4035/min-qty" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Quantidade mínima

json

{
  "product_id": "c3f92551-9dda-4fc7-b518-353d1c4e4035",
  "min_order_qty": 12
}

Campos da resposta

product_iduuid

O produto.

min_order_qtyinteger

Quantidade mínima, no mínimo 1.

Erros

Status	Quando	Corpo de exemplo
400	`productId` não é um UUID.	`{"error":"invalid productId","detail":"productId must be a valid UUID"}`
401	Sem token de cliente no cabeçalho `Authorization`.	`{"error":"missing authorization header"}`
404	Produto inexistente ou excluído.	`{"error":"product not found"}`