Ajuste de preço (admin)
Mercadorias
Usuários com a permissão price_adjustment_create (em geral administradores) acessam Financeiro → Ajuste de preço para alterar o preço de venda de tabela e o markup % no cadastro da mercadoria simples ou de uma variante (com variações, é obrigatório escolher a variante). Sem a diretiva abaixo, o custo exibido na tela é somente leitura.
Busca de mercadoria: o seletor é um campo de busca dinâmica (nome, SKU, código ou ID) em todo o catálogo — não há limite de 200 itens como em listas fixas. Digite ao menos um caractere, escolha o resultado e, se houver variações, selecione a variante.
Escolha ajustar por preço (informa o novo valor em R$; o sistema recalcula o markup quando o custo > 0) ou por markup (informa o percentual sobre o custo; o preço é recalculado — exige custo > 0). Informe uma categoria de motivo e uma descrição com pelo menos 10 caracteres (auditoria). O registro aparece nos logs de atividade e nos alertas para administradores (push, quando configurado).
Preço de custo: a opção Por preço de custo só aparece quando o administrador marca Permitir ajuste do preço de custo das mercadorias em Configurações → Diretivas Financeiras. A opção nasce desmarcada. Com ela marcada, informe o novo custo em R$. O sistema grava esse valor no cadastro (mercadoria simples ou variante escolhida) e recalcula o markup % para o preço de venda permanecer o mesmo. A última compra, os títulos a pagar e o caixa gerados por essa compra não são alterados. Estoque e vendas já registradas também permanecem.
Promoções: mercadorias em campanha Ativa ou Pausada não podem receber ajuste de preço de venda ou de markup por aqui (o mesmo critério usado para bloquear itens em novas compras). O ajuste de custo do cadastro continua disponível e não reescreve o custo congelado na campanha. Vendas já registradas mantêm os valores gravados nas linhas da venda; apenas o catálogo (próximas vendas) muda.
Se nas Configurações → Diretivas financeiras estiver ativo o markup mínimo na compra, o markup resultante do ajuste de preço de venda ou de markup também deve respeitar esse piso. O ajuste só de custo não usa esse piso, porque o preço de venda não muda.
API: o mesmo fluxo está disponível para integrações com POST /api/v1/_t/{tenant}/products/price-adjustment (JWT de administrador, permissão price_adjustment_create). Para custo, envie adjustBy cost e o campo cost. A flag allowProductCostPriceAdjustment vem em GET /lookups/settings (falsa por padrão). O contrato JSON está na documentação OpenAPI do projeto.

