Skip to main content
Cada insumo pode ter um custo vigente: um valor por unidade base, em uma moeda. Os custos são confidenciais. O servidor os remove de toda leitura, a menos que a pessoa tenha a permissão de custos, e cada alteração guarda o custo anterior em um histórico. Quando alguém adiciona o insumo a um pedido, a linha guarda uma cópia do custo vigente naquele momento.

​
Quem pode fazer

Nenhuma função inclui catalog.cost.read, nem mesmo Proprietário: ela é sempre concedida explicitamente, pessoa por pessoa. Tê-la não permite alterar custos nem unidades. Veja Funções e permissões.

​
Onde os custos aparecem

​
Valores, moedas e unidades menores

O muveya guarda cada valor como um número inteiro de unidades menores da moeda, como os centavos, junto com um código de moeda ISO 4217 de três letras maiúsculas. Assim os valores ficam exatos.
  • No console você digita o valor em unidades normais: dígitos, opcionalmente seguidos de um ponto ou uma vírgula decimal e no máximo tantas casas decimais quanto a moeda usa (duas para USD e BRL, nenhuma para CLP). Não use separadores de milhares: 1250,50 é válido, 1.250,50 não. O console converte o valor para unidades menores de forma exata e nunca adivinha a moeda.
  • Em arquivos CSV e na API o valor já está em unidades menores: um número inteiro como 1200.
  • 0 é um custo válido e é diferente de não ter custo. Valores negativos não são aceitos.

​
Registrar um custo

1

Abra o insumo

Vá até Catálogo e clique no nome do insumo.
2

Encontre a seção Custo do insumo

Ela fica no fim da página: As alterações de custo são salvas separadamente e mantêm seu histórico. A linha Custo por seguida da unidade, por exemplo Custo por Caixa, indica a qual unidade base o valor será aplicado.
3

Informe o valor e a moeda

Digite o Valor (Escolha uma moeda e informe o valor sem separadores de milhares.) e a Moeda, por exemplo BRL. Se o insumo já tem custo, os dois campos começam preenchidos com ele.
4

Salve

Clique em Salvar custo. Custo salvo confirma.
O que acontece ao salvar:
  • O custo anterior, se houver, é fechado e fica no histórico.
  • O novo valor passa a ser o custo vigente a partir daquele momento.
  • O custo fica vinculado à unidade de medida do insumo como ela estava quando você a revisou. Se a unidade mudou nesse meio-tempo, nada é salvo e o formulário diz A unidade revisada mudou. Confira a unidade atual antes de confirmar este valor., depois Unidade atual: com a unidade e um botão Revisar custo para a unidade atual. Clique nele, confira o valor e salve de novo.
O formulário de criação não tem campo de custo. Um insumo novo recebe o primeiro custo aqui ou por uma importação CSV.
Use uma única moeda para todos os insumos da sua clínica odontológica. O valor de um pedido soma apenas as linhas na moeda da sua primeira linha com custo; as linhas em outra moeda ficam fora do valor.

​
Estados do custo

Toda leitura que inclui um custo também inclui costStatus. Confira o estado antes de usar o valor. Um custo review_required costuma aparecer depois que alguém muda a unidade de medida do insumo enquanto ela ainda pode ser editada. Veja Insumos do catálogo. Onde ficaria um custo, podem aparecer outras duas mensagens:
  • A informação do custo não está disponível.: você tem a permissão, mas o custo não pôde ser lido. Recarregue a página.
  • A unidade registrada não está disponível.: o valor aparece, mas falta a unidade a que ele corresponde.

​
Histórico do custo

Toda vez que um custo é substituído, o anterior é fechado e guardado com o valor, a moeda, o momento em que passou a valer, quem o registrou e a unidade a que correspondia. O histórico só cresce: nada nele é editado ou apagado. A versão atual não tem tela, operação de API nem ferramenta MCP para consultar o histórico de custos. As linhas de pedido mantêm o custo que copiaram, então os pedidos antigos continuam mostrando o que foi pago na época.

​
Omissão de dados: quem vê o quê

Os custos são removidos no servidor, não apenas escondidos na tela. Para uma pessoa sem catalog.cost.read:
  • Os campos cost, currency, costStatus e costMeasurement não existem em nenhuma leitura do catálogo: o console, GET /v1/catalog/items, GET /v1/catalog/items/{itemId} e a ferramenta MCP catalog.search. Não existir significa não existir, nunca zero.
  • Uma exportação CSV não traz as seis colunas de custo.
  • As linhas de pedido não mostram a cópia do custo.
  • Salvar um custo nunca devolve o valor na resposta.
O valor total do pedido depende de outra permissão, orders.value.read. Veja Criar e acompanhar pedidos. Assim fica um custo em uma leitura da API feita com uma chave que tem catalog.cost:read:
Aqui o valor foi registrado por unit, mas o insumo agora é contado em pair, então o valor precisa ser confirmado antes de valer. costMeasurement indica a unidade de medida, a versão dela e a regra de quantidade (base_number_v1, números inteiros da unidade base) para as quais o valor foi registrado.

​
Como os pedidos usam o custo

Quando alguém adiciona um insumo a um pedido em rascunho, o muveya copia para a linha o custo vigente naquele momento, junto com o SKU, o nome, a unidade de medida, a categoria e a marca de alto valor.
  • Mudar o custo depois não altera as linhas já adicionadas.
  • O valor do pedido é a soma do custo vezes a quantidade solicitada nas linhas que têm custo, na moeda da primeira delas.
  • As regras de aprovação com valor mínimo ou máximo de pedido usam esse valor, então insumos sem custo não contam. Veja Política de aprovação.

​
O que o sistema registra

  • O custo vigente, com a moeda, o momento em que passou a valer, quem o registrou e a unidade a que corresponde.
  • Os custos anteriores fechados, no histórico.
  • Em cada linha de pedido, o custo e a moeda copiados.

​
O que pode dar errado

Nenhum desses erros aplica a alteração proposta. Confira as informações antes de tentar novamente.

​
Páginas relacionadas

Insumos do catálogo

Insumos, unidades de medida e status.

Importar e exportar

Custos em arquivos CSV.

Criar e acompanhar pedidos

Onde aparecem as cópias do custo e o valor do pedido.

Política de aprovação

Regras de aprovação pelo valor do pedido.

Funções e permissões

Conceda Ver custos dos materiais.

Escopos

catalog:read e catalog.cost:read.