# Revisión de carga total MASTER FILE (1).xlsx

La hoja ARCHIVO MAESTRO contiene 58 empresas, con RUC de 13 dígitos y sin duplicados dentro del archivo, y 10 filas auxiliares que no son empresas. La existencia de cada RUC en las empresas autorizadas del usuario se comprueba al importar; no se crea ninguna empresa desde esta carga.

Se actualizan las fichas por RUC y se relacionan las columnas por sus títulos, incluso si cambian de posición. El usuario confirmó que **BJ: EMPRESA** corresponde al **vencimiento de firma electrónica**. Las columnas numeradas de usuarios y contraseñas se relacionan con su organismo correspondiente. Los porcentajes numéricos de Excel se convierten a puntos porcentuales para el campo Inflación (%).

## Corregir antes de cargar

| Celdas | Problema | Acción |
|---|---|---|
| AC8, AC12, AC27, AC38, AC48, AC52, AC54 | Fecha de impuesto a la renta: “0 de Abril” | Indicar el día real; no se deduce automáticamente. |
| AQ13 | Vencimiento MSP: texto en lugar de fecha | Indicar una fecha válida. |
| BJ15, BJ24, BJ57 | Vencimiento de firma electrónica: valores que no son fechas | Indicar una fecha válida. |
| BN57 | Correo de contacto inválido | Corregir el correo. |

Si se deja una celda vacía, se conserva el valor guardado. Esto no elimina un vencimiento anterior ni sustituye una fecha obligatoria cuando un permiso aplica. Las fechas sin año usarán el año seleccionado en la carga. Los textos N/A o No aplica en campos numéricos, fechas o booleanos conservan el dato existente.

RUC identifica la empresa. Razón social, estado, número de fila y noveno dígito se consideran informativos: esta carga modifica el maestro, no la identidad ni el estado de la empresa. Se mantienen permisos, aprobaciones y auditoría. Cualquier error de validación cancela la carga completa para evitar actualizaciones parciales inadvertidas.

No se han importado los datos de este archivo ni modificado el Excel original. La revisión usa los campos predeterminados; los campos personalizados de la cuenta se validan en la carga.

## Archivos de la actualización

La ventana incluye revisión previa: **Revisar archivo** muestra todos los errores detectados con celda y título, sin guardar cambios. El usuario corrige su Excel y lo vuelve a adjuntar. Si no hay errores, muestra el resumen y habilita el paso **Confirmar carga** (o solicitar aprobación). La confirmación vuelve a validar permisos y datos actuales. Si cambió el archivo o el año, exige otra revisión antes de guardar.

- `app/Services/Work/CompanyMasterImportService.php`
- `app/Services/Work/MasterWorkbook.php`
- `app/Filament/Pages/CompanyMaster.php`
- `resources/views/filament/pages/partials/master-import-review.blade.php`

No requiere migraciones. Se recomienda limpiar vistas con `php artisan view:clear` al publicar.
