Pedido mínimo do seller
Lê e define o valor mínimo em centavos que o cliente precisa atingir para comprar os produtos do seller.
O pedido mínimo é o menor subtotal de itens do seller que o checkout aceita. Um atacadista que não quer despachar pedidos de R$ 20 define, por exemplo, 15000 (R$ 150,00). No carrinho, a plataforma soma só os itens daquele seller e compara com esse valor, usando a hierarquia descrita na visão geral: o mínimo da região de entrega vence o do seller, que vence o da loja. 0 quer dizer "sem mínimo".
O mesmo valor é lido pelo carrinho, pelo cálculo de frete e pelo atendimento no WhatsApp. A alteração vale no próximo cálculo, sem reprocessar carrinhos já abertos.
Ler o pedido mínimo
/api/v1/vendor/min-order-amountSellerLê o pedido mínimo do seller
Não tem parâmetros. Exige o privilégio de configurações (vendor_settings ou vendor_view_settings).
Exemplo de requisição: ler
curl "$BASE_URL/api/v1/vendor/min-order-amount" \
-H "Authorization: Bearer $TOKEN"Resposta: ler
{ "min_order_amount": 15000 }Campos da resposta
min_order_amountinteger0 = sem mínimo.Definir o pedido mínimo
/api/v1/vendor/min-order-amountSellerDefine o pedido mínimo do seller
Substitui o valor atual. Exige o privilégio vendor_settings (só leitura de configurações não basta).
Corpo da requisição
min_order_amountintegerobrigatório0 remove o mínimo. Se o campo faltar no corpo, o valor gravado é 0.Exemplo de requisição: definir
curl -X PUT "$BASE_URL/api/v1/vendor/min-order-amount" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{ "min_order_amount": 15000 }'Resposta: definir
{ "min_order_amount": 15000 }A resposta repete o valor enviado.
Erros
| Status | Quando | Corpo de exemplo |
|---|---|---|
| 401 | Token ausente ou inválido. | {"error":"missing authorization header"} |
| 403 | O token não é de um usuário seller, ou o seller não tem o privilégio de configurações. | {"error":"insufficient vendor privileges","privilege_required_any":["vendor_settings"]} |
| 400 | Corpo que não é JSON. | {"error":"INVALID_REQUEST_BODY","detail":"..."} |
| 400 | Valor negativo. | {"error":"INVALID_MIN_ORDER_AMOUNT","detail":"min_order_amount must be zero or positive"} |
| 404 | O usuário não está ligado a nenhum seller. | {"error":"VENDOR_NOT_FOUND"} |
| 500 | Falha ao ler ou gravar. | {"error":"MIN_ORDER_SAVE_FAILED","detail":"..."} |