Skip to main content
Una importación CSV crea insumos nuevos en bloque. Nunca actualiza ni elimina insumos existentes. Una exportación CSV descarga todo el catálogo en un archivo, con costos solo para quienes pueden verlos.

Quién puede hacerlo

La importación y la exportación están marcadas como acciones sensibles. En la versión actual, la verificación en dos pasos (MFA) es opcional y no las bloquea; si alguna vez la consola muestra Verifica tu identidad para continuar., confirma con tu app autenticadora y vuelve a intentar. Consulta Seguridad de la cuenta y Roles y permisos.

Dónde

No existe una lista de importaciones anteriores. Guarda la dirección de la página Estado de importación si quieres revisarla después.

Prepara el archivo

La pantalla Importar CSV (Agrega insumos desde un archivo CSV. Los insumos existentes no se actualizan.) incluye una guía, Prepara tu archivo, con:
  • Columnas obligatorias y Columnas opcionales.
  • Unidades admitidas y Criticidades admitidas, con sus códigos.
  • Descargar plantilla de columnas: un archivo llamado muveya-catalog-template.csv que solo trae la fila de encabezado.
  • ID de categorías para tu CSV: cada Nombre de la categoría junto a su categoryId, con Copiar ID de categoría.

Formato del archivo

  • CSV simple con coma como separador. Los campos que contienen comas, comillas dobles o saltos de línea van entre comillas dobles, y una comilla doble dentro de ellos se escribe dos veces ("").
  • Codificado en UTF-8, con o sin marca de orden de bytes. En una hoja de cálculo, guárdalo como “CSV UTF-8”.
  • El primer registro es el encabezado. Los nombres de columna son los nombres en inglés de abajo, escritos exactamente igual (importan las mayúsculas), en cualquier orden.
  • Las columnas que muveya no conoce se ignoran. Si una columna aparece dos veces se usa la primera, salvo unitOfMeasure, cost, currency y las columnas de metadatos de costo: un duplicado de cualquiera de ellas rechaza el archivo completo.
  • Las líneas vacías se omiten. Se quitan los espacios alrededor de cada valor.
Las hojas de cálculo configuradas en español o portugués suelen guardar los CSV con punto y coma. muveya lee ese archivo como una sola columna y la importación falla con El archivo no contiene las columnas CSV obligatorias. Guárdalo con comas.

Columnas

Ejemplo:
La segunda fila no tiene costo: cost y currency están vacíos.

Límites

Importar insumos

1

Prepara las categorías

Crea primero las categorías que falten y copia sus identificadores desde ID de categorías para tu CSV. Consulta Categorías.
2

Elige el archivo

En Importar CSV, haz clic en Archivo CSV y elige tu archivo .csv.
3

Carga el archivo

Haz clic en Importar insumos. Cuando el archivo se acepta, la consola abre Estado de importación.
4

Sigue el avance

La página se actualiza sola mientras la importación está pendiente o en curso. Actualizar estado vuelve a consultar cuando quieras.
5

Revisa el resultado

Lee los totales y las filas rechazadas. Corrige esas filas en un archivo nuevo y haz clic en Importar otro archivo.
6

Activa los nuevos insumos

Los insumos importados quedan en borrador. Abre cada uno y actívalo cuando esté listo para pedirse. No existe activación masiva. Consulta Insumos del catálogo.

Estados de la importación

Al terminar, la página muestra Filas de datos, Creados y Rechazados. Si alguna fila se rechazó, agrega Algunas filas fueron rechazadas. Revisa los motivos antes de cargar un archivo corregido. y una tabla con Fila de datos y Motivo. Cada fila es independiente: una fila rechazada nunca detiene a las demás, y las filas creadas antes de un rechazo siguen creadas.

Números de fila

Se cuentan registros de datos, sin la cabecera; un registro CSV puede ocupar varias líneas de texto. La fila de datos 1 es el primer registro después del encabezado. Las líneas vacías no se cuentan y un valor entre comillas con saltos de línea cuenta como una sola fila, así que el número de fila de datos puede no coincidir con el número de línea que muestra tu editor.

Fallas del archivo completo

Filas rechazadas

Para corregir filas rechazadas, prepara un archivo nuevo con solo esas filas, ya corregidas. Deja fuera las filas que se crearon: ahora se rechazarían con Este SKU ya existe.

Las importaciones nunca actualizan insumos

  • Una importación solo crea insumos. Una fila cuyo SKU ya existe se rechaza, sin importar sus demás valores. Para cambiar insumos existentes, edítalos en la consola.
  • Dentro de un archivo, la primera fila con un SKU se crea y las siguientes con el mismo SKU se rechazan.
  • Cargar dos veces el mismo archivo no crea nada la segunda vez: todas las filas se rechazan por SKU existente.
  • Si el procesamiento se interrumpe y se retoma, muveya recuerda qué filas ya creó y no las vuelve a crear.
  • El costo de una fila pasa a ser el costo vigente del insumo, confirmado para la unidad importada. Consulta Costos.
1

Inicia la exportación

En Catálogo, haz clic en Exportar CSV. El archivo se genera en el momento.
2

Descarga

Haz clic en Descargar CSV. Bajo el enlace, El enlace vence: muestra la fecha y la hora.
El enlace es válido por 5 minutos. Después, la consola muestra Este enlace venció. Genera una nueva exportación.; haz clic otra vez en Exportar CSV. Si la consola no puede verificar el enlace, muestra No se pudo verificar el enlace de descarga. Genera una nueva exportación.

Contenido de la exportación

El archivo se llama catalog.csv y contiene todos los insumos de la clínica dental, en todos los estados, del más antiguo al más reciente.
  • Los valores opcionales vacíos son celdas vacías; las columnas de trazabilidad valen true o false; cost y currency quedan vacíos cuando el costo es unset.
  • El archivo está en UTF-8 con marca de orden de bytes, separado por comas y con saltos de línea de Windows, para que las hojas de cálculo abran bien los nombres con tildes.
  • Un valor que empieza con =, +, - o @ se escribe con un apóstrofo (') delante, para que la hoja de cálculo no lo ejecute como fórmula.
  • Las categorías aparecen como categoryId, no por nombre. No se exportan presentaciones, códigos de envase ni existencias.

Reimportar un archivo exportado

Una exportación tiene los mismos nombres de columna que la importación, así que puedes usarla como punto de partida, por ejemplo para cargar el mismo catálogo en otra clínica dental. Antes de cargarla:
  • Reemplaza cada categoryId por los identificadores de la clínica dental de destino.
  • Quita el apóstrofo que la exportación agregó delante de los valores que empiezan con =, +, - o @.
  • La columna status se ignora: todo insumo se crea como borrador.
  • Si el archivo trae las columnas de costo, el costStatus de cada fila decide qué pasa:
    • unset: las demás celdas de costo deben estar vacías.
    • verified: costUnitOfMeasure debe ser igual a unitOfMeasure, costMeasurementVersion un número entero desde 1, costQuantityProtocol debe ser base_number_v1, cost un número entero y currency tres letras mayúsculas. Si no, la fila se rechaza con Revisa los campos de esta fila.
    • review_required o invalid: la fila se rechaza con El costo registrado requiere revisión. Confirma su unidad e importe antes de importar esta fila.
    • Vacío o cualquier otro valor: la fila se rechaza con Revisa los campos de esta fila.
  • Volver a importar en la misma clínica dental no crea nada, porque todos los SKU ya existen.

Qué registra el sistema

La importación también guarda, para cada fila de datos, si se creó y el motivo cuando no se creó. Ese resumen nunca guarda valores de costo. La versión actual no tiene una pantalla para consultar la auditoría.

Qué puede salir mal al cargar o exportar

La API pública no importa ni exporta el catálogo. Para leerlo desde otro sistema, usa GET /v1/catalog/items. Consulta API para desarrolladores.

Páginas relacionadas

Insumos del catálogo

Reglas de los campos y activación.

Categorías

Crea categorías y encuentra sus identificadores.

Costos

Unidades menores y estados del costo.

Roles y permisos

Roles que pueden importar y exportar.