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.csvque 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,currencyy 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.
Columnas
Ejemplo:
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.
Exportar el catálogo
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.
Contenido de la exportación
El archivo se llamacatalog.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
trueofalse;costycurrencyquedan vacíos cuando el costo esunset. - 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
categoryIdpor 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
statusse ignora: todo insumo se crea como borrador. - Si el archivo trae las columnas de costo, el
costStatusde cada fila decide qué pasa:unset: las demás celdas de costo deben estar vacías.verified:costUnitOfMeasuredebe ser igual aunitOfMeasure,costMeasurementVersionun número entero desde 1,costQuantityProtocoldebe serbase_number_v1,costun número entero ycurrencytres letras mayúsculas. Si no, la fila se rechaza con Revisa los campos de esta fila.review_requiredoinvalid: 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.