Importar plan desde Excel
Importar plan desde Excel
Sección titulada «Importar plan desde Excel»Si tu cliente viene de otro sistema contable con un plan de cuentas personalizado, podés importarlo en lugar de adaptar manualmente el plan NIIF PYME CR sembrado por default. El importador acepta CSV, valida la jerarquía completa antes de aplicar nada, y soporta dos modos: reemplazo total o merge con el plan existente.
Antes de empezar
Sección titulada «Antes de empezar»Formato del archivo CSV
Sección titulada «Formato del archivo CSV»El archivo debe estar en UTF-8, con encabezados en la primera fila. Las columnas son:
| Columna | Requerida | Descripción | Ejemplo |
|---|---|---|---|
| codigo | Sí | Código único, dígitos separados por puntos | 1.1.1.2 |
| nombre | Sí | Nombre descriptivo de la cuenta | Banco Nacional ₡ |
| tipo | Sí | activo, pasivo, patrimonio, ingreso, gasto, costo, orden, cierre | activo |
| naturaleza | Sí | deudora o acreedora | deudora |
| parent_code | Sí para no raíz | Código del padre directo | 1.1.1 |
| nivel | No | Número de nivel (calculado si se omite) | 4 |
| permite_asientos | No | true o false (default true para hojas) | true |
| niif_mapping | No | Categoría NIIF; vacío = sin mapping | Efectivo y equivalentes |
Descargá la plantilla desde Plan de cuentas → Importar → Descargar plantilla.
Proceso de importación
Sección titulada «Proceso de importación»Subí el archivo y elegí el modo
Andá a Plan de cuentas → Importar. Subí el CSV y seleccioná el modo:
- Merge: agrega cuentas nuevas y actualiza nombres de cuentas existentes (por código). No elimina cuentas del plan actual.
- Reemplazo: elimina el plan actual completo y lo reemplaza con el CSV. Solo disponible si no hay asientos.
Corré el dry-run
Hacé click en Validar sin aplicar. El sistema:
- Construye el árbol completo a partir del CSV.
- Detecta ciclos en la jerarquía (una cuenta que sea su propio ancestro).
- Verifica que cada
parent_codeexista en el CSV o en el plan actual (modo merge). - Valida tipos y naturalezas consistentes.
- Verifica códigos únicos.
El reporte muestra errores por fila con descripción. No se aplica nada hasta que el dry-run pase limpio.
Corregí los errores y re-validá
Errores comunes de jerarquía (ciclos, códigos padre faltantes) requieren editar el CSV. Volvé a subir y corré el dry-run hasta que el reporte muestre cero errores.
Aplicá la importación
Con el dry-run limpio, hacé click en Aplicar importación. El proceso es atómico — si algo falla a mitad, no queda un plan parcial.
Después de la importación, verificá:
- Árbol con la estructura esperada.
- Cuentas hoja tienen
permite_asientos: true. - Cuentas clave tienen
niif_mappingasignado.
Asignar mappings NIIF después de importar
Sección titulada «Asignar mappings NIIF después de importar»Las cuentas importadas con niif_mapping vacío no aparecerán en los estados financieros automáticos. Asientra muestra en el panel de Plan de cuentas cuántas cuentas están sin mapping. Asignados los mappings correctos, los reportes Balance y Estado de Resultados funcionan automáticamente.
Si el plan tiene muchas cuentas sin mapping, podés exportarlo, llenar la columna niif_mapping en Excel, y re-importar en modo merge.
Errores comunes
Sección titulada «Errores comunes»| Mensaje | Causa probable | Cómo resolverlo |
|---|---|---|
| “parent_code ‘X’ no existe” | La cuenta padre no está en el CSV ni en el plan actual | Agregá la cuenta padre al CSV o corregí el código del padre |
| “Código duplicado: ‘X’” | El mismo código aparece dos veces en el CSV | Buscá las filas duplicadas y eliminá o renombrá una |
| “Tipo inválido en fila N” | El tipo no es uno de los 8 valores permitidos | Revisá los valores exactos sin tildes ni variantes |
| “Ciclo detectado: X → Y → X” | Una cuenta es descendiente de sí misma | Revisá la cadena de parent_code e identificá dónde se forma el ciclo |