Quién puede hacerlo
Ningún rol incluye
catalog.cost.read, ni siquiera el de Propietario: siempre se otorga de forma explícita, persona por persona. Tenerlo no permite cambiar costos ni unidades. Consulta Roles y permisos.
Dónde aparecen los costos
Montos, monedas y unidades menores
muveya guarda cada monto como un número entero de unidades menores de la moneda, como los centavos, junto con un código de moneda ISO 4217 de tres letras mayúsculas. Así los montos son exactos.- En la consola escribes el monto en unidades normales: dígitos, opcionalmente seguidos de un punto o una coma decimal y como máximo tantos decimales como use la moneda (dos para USD y BRL, ninguno para CLP). No uses separadores de miles:
1250,50es válido,1.250,50no. La consola convierte el monto a unidades menores de forma exacta y nunca adivina la moneda. - En archivos CSV y en la API el monto ya está en unidades menores: un número entero como
1200. 0es un costo válido y es distinto de no tener costo. No se aceptan montos negativos.
Registrar un costo
1
Abre el insumo
Ve a Catálogo y haz clic en el nombre del insumo.
2
Busca la sección Costo del insumo
Está al final de la página: Los cambios de costo se guardan por separado y conservan su historial. La línea Costo por seguida de la unidad, por ejemplo Costo por Caja, indica a qué unidad base se aplicará el monto.
3
Ingresa el monto y la moneda
Escribe el Monto (Elige una moneda e ingresa el monto sin separadores de miles.) y la Moneda, por ejemplo
CLP. Si el insumo ya tiene costo, ambos campos empiezan con él.4
Guarda
Haz clic en Guardar costo. Costo guardado lo confirma.
- El costo anterior, si existe, se cierra y queda en el historial.
- El nuevo monto pasa a ser el costo vigente desde ese momento.
- El costo queda asociado a la unidad del insumo tal como estaba cuando la revisaste. Si la unidad cambió mientras tanto, no se guarda nada y el formulario dice La unidad que revisaste cambió. Revisa la unidad actual antes de confirmar este importe., luego Unidad actual: con la unidad y un botón Revisar costo para la unidad actual. Haz clic en él, revisa el monto y guarda otra vez.
Estados del costo
Toda lectura que incluye un costo incluye tambiéncostStatus. Revisa el estado antes de usar el monto.
Un costo
review_required suele aparecer después de que alguien cambia la unidad del insumo mientras todavía se puede editar. Consulta Insumos del catálogo.
Donde iría un costo pueden aparecer otros dos mensajes:
- La información del costo no está disponible.: tienes el permiso, pero no se pudo leer el costo. Vuelve a cargar la página.
- La unidad registrada no está disponible.: se muestra el monto, pero falta la unidad a la que corresponde.
Historial del costo
Cada vez que se reemplaza un costo, el anterior se cierra y se guarda con su monto, su moneda, el momento en que empezó a regir, quién lo registró y la unidad a la que correspondía. El historial solo crece: nada se edita ni se borra. La versión actual no tiene pantalla, operación de API ni herramienta MCP para consultar el historial de costos. Las líneas de pedido conservan el costo que copiaron, así que los pedidos pasados siguen mostrando lo que se pagó en su momento.Omisión de datos: quién ve qué
Los costos se omiten en el servidor; no solo se ocultan en la pantalla. Para una persona sincatalog.cost.read:
- Los campos
cost,currency,costStatusycostMeasurementno existen en ninguna lectura del catálogo: la consola,GET /v1/catalog/items,GET /v1/catalog/items/{itemId}y la herramienta MCPcatalog.search. No existir significa no existir, nunca cero. - Una exportación CSV no trae las seis columnas de costo.
- Las líneas de pedido no muestran su copia del costo.
- Guardar un costo nunca devuelve el monto en la respuesta.
orders.value.read. Consulta Crear y seguir pedidos.
Así se ve un costo en una lectura de la API hecha con una clave que tiene catalog.cost:read:
unit, pero el insumo ahora se cuenta en pair, así que el monto debe confirmarse antes de aplicarse. costMeasurement indica la unidad, su versión y la regla de cantidad (base_number_v1, números enteros de la unidad base) para las que se registró el monto.
Cómo usan el costo los pedidos
Cuando alguien agrega un insumo a un pedido en borrador, muveya copia en la línea el costo vigente en ese momento, junto con el SKU, el nombre, la unidad, la categoría y la marca de alto valor.- Cambiar el costo después no modifica las líneas ya agregadas.
- El valor del pedido es la suma del costo por la cantidad solicitada en las líneas que tienen costo, en la moneda de la primera de ellas.
- Las reglas de aprobación con valor mínimo o máximo de pedido usan ese valor, así que los insumos sin costo no cuentan. Consulta Política de aprobación.
Qué registra el sistema
- El costo vigente, con su moneda, el momento en que empezó a regir, quién lo registró y la unidad a la que corresponde.
- Los costos anteriores cerrados, en el historial.
- En cada línea de pedido, el costo y la moneda copiados.
Qué puede salir mal
Ninguno de estos errores aplica el cambio propuesto. Revisa la información antes de volver a intentar.
Páginas relacionadas
Insumos del catálogo
Insumos, unidades y estados.
Importar y exportar
Costos en archivos CSV.
Crear y seguir pedidos
Dónde aparecen las copias del costo y el valor del pedido.
Política de aprobación
Reglas de aprobación según el valor del pedido.
Roles y permisos
Otorga Ver costos de insumos.
Scopes
catalog:read y catalog.cost:read.