# Carga masiva del maestro de clientes

En Maestro de clientes, abrir **Carga masiva Excel**. Dentro de la ventana está **Descargar plantilla actual**. Seleccionar una empresa de referencia para obtener los campos activos de su cuenta. La plantilla incluye RUC y razón social de las empresas autorizadas de esa cuenta y todos los campos activos, incluidos los accesos protegidos, pero nunca exporta sus valores existentes.

La primera hoja identifica cada empresa por RUC. No crea empresas ni cambia su razón social o estado. Admite 500 empresas, 300 columnas y 5 MB por carga. Las celdas vacías conservan los valores existentes. Los campos nuevos aparecen en la siguiente descarga; conservar el identificador entre corchetes del encabezado.

Las fechas admiten día/mes/año, año-mes-día, fechas de Excel o día y mes en español. El año indicado en la ventana se usa cuando no está escrito. Los booleanos admiten SI/NO y 1/0. Las fórmulas no se ejecutan: se usa el resultado guardado en Excel. El RUC debe ser un valor de 13 dígitos, no una fórmula.

El formato original MASTER FILE se reconoce por sus encabezados agrupados: se asignan sus columnas a los campos existentes. Se excluyen número, razón social, activo/inactivo, noveno dígito y la tabla auxiliar del calendario tributario. Un campo desconocido o inactivo bloquea la carga para evitar perder información.

La importación es transaccional: un error revierte toda la carga. Usa los permisos del usuario conectado, conserva la auditoría y genera solicitudes si el operario necesita aprobación. No envía formularios ni correos a los clientes.

## Archivos para hosting

- app/Filament/Pages/CompanyMaster.php
- app/Services/Work/CompanyMasterImportService.php
- app/Services/Work/MasterWorkbook.php
- app/Services/Accounting/AccountingReportExportService.php (generador XLSX existente)

Requiere extensiones PHP Zip y SimpleXML. No añade dependencias Composer ni migraciones. Después de subir, ejecutar `php artisan view:clear`.

## Carga inicial solicitada

Archivo MASTER FILE carga.xlsx, base local, usuario de la sesión ISAAC MOLINARES, año 2026 para fechas sin año. Por instrucción del usuario se conservan sin modificar dos campos con fechas inválidas: fecha de impuesto a la renta de TACTIQA y vencimiento MSP de PLATINUM DENTAL. El archivo original no se altera.