Brasil: preço por UF e destinos

Vender no Brasil traz regras que não existem em outros mercados: o preço de um produto pode mudar conforme a UF do comprador, certos produtos só podem ser entregues em algumas regiões, e empresas são identificadas pelo CNPJ e classificadas por CNAE (a atividade econômica oficial). Esta área reúne essas ferramentas do painel.

Como funciona

Preço por UF

Cada regra diz: "para este produto, em SP, a partir de min_qty unidades, o preço é X". Na hora de calcular o preço (carrinho e checkout), a plataforma escolhe a regra ativa da UF cuja min_qty é a maior que não passa da quantidade pedida. Sem regra aplicável, vale o preço normal do produto (source: "default").

Destinos permitidos e bloqueados

Cada regra é allow (permitir) ou deny (bloquear) e se aplica a uma entidade: product, vendor, category ou global. Pode ser restrita por UF, cidade e faixa de CEP. Ao avaliar um destino a plataforma procura a regra mais específica: produto vence seller, que vence categoria, que vence global. Em empate de especificidade, deny vence allow. Sem nenhuma regra aplicável, a entrega é permitida.

Status das regras

A (ativa) e D (desativada). Nas entradas você pode enviar active/disabled ou a letra; nas respostas a letra sempre volta. Regras desativadas não entram no cálculo.

Endpoints

Erros comuns

• Usar o UUID em regra de destino. entity_id é um número: o display_id do produto ou do seller, ou o legacy_id da categoria. Um UUID é recusado como corpo inválido.
• Esperar que o bloqueio valha para o catálogo. A regra de destino é conferida na criação do pedido. A vitrine continua mostrando o produto.
• Achar que deny global bloqueia tudo. Uma regra allow mais específica (por exemplo, para um produto) vence a regra global.
• Criar a mesma regra de preço duas vezes. O par (produto, UF, min_qty) é único: a segunda criação volta 400. Use o endpoint de lote, que atualiza.
• Confundir id de regra com id de produto. As rotas {id} de preço e destino usam o id numérico da regra.
• Contar com a paginação padrão. A lista de destinos aceita page e per_page, mas os campos page e per_page da resposta vêm 0 quando você não os envia (a página real é 1 com 20 itens).

Próximos passos