Etapa 0: Requisitos y parte previa

Esta etapa inicial establece las bases para el proceso de certificación tributaria. Incluye la verificación de requisitos, instalación del procesador de Sets de Pruebas y la preparación del entorno técnico necesario.

Requisitos Previos

Lista de Verificación

Antes de iniciar, confirma que tienes todos los elementos necesarios:

Certificado Digital

• Firma electrónica válida del representante legal.
• Contraseña del certificado disponible y funcional.

Información de la Empresa

• RUT: Rol Único Tributario.
• Razón social: Nombre registrado oficialmente.
• Giro comercial: Actividad económica según clasificación SII.
• Dirección fiscal: Domicilio registrado en el SII.
• Comuna: Ubicación administrativa.

Documentos Tributarios

• Certificado de Autorización de Folios (CAF) para cada tipo de documento a certificar.

Importante: Todos estos elementos deben estar actualizados y corresponder exactamente a la información registrada en el SII.

Procesador del Set de Pruebas

¿Qué es?

El Procesador del Set de Pruebas es una herramienta automatizada que:

• Extrae y valida casos del Set de Pruebas del SII.
• Procesa documentos tributarios automáticamente.
• Genera archivos necesarios para libros tributarios.
• Reduce errores manuales en el proceso de certificación.

Descarga: [Enlace al repositorio]

Configuración del Entorno

Requisitos Técnicos

Requisitos técnicos

Verificación del Sistema

# Verificar PHP.
php --version

# Verificar Composer.
composer --version

# Verificar permisos de escritura.
ls -la /ruta/del/proyecto

Instalación

Paso 1: Configurar Composer

# Verificar instalación existente.
composer --version

Si no está instalado:

# Descargar e instalar Composer.
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

# Verificar instalación.
composer --version

Paso 2: Instalar Dependencias del Proyecto

# Navegar al directorio del proyecto
cd /ruta/del/proyecto

# Instalar dependencias
composer install

Resultado esperado: Carpeta vendor/ creada con las dependencias instaladas.

Configuración de Archivos

Estructura de Directorios

proyecto/
├── data/
│   ├── input/          # ← Sets de Pruebas (.txt)
│   └── output/         # ← Archivos procesados
├── logs/               # ← Registros del sistema
├── vendor/             # ← Dependencias (generado)
└── src/
    └── Command.php     # ← Script principal

Formato de Archivos de Entrada

Nomenclatura obligatoria:

[RUT_solicitante] [cantidad_certificaciones].txt

Componentes del Nombre

Ejemplos Válidos

1234567-8 2.txt     → RUT: 1.234.567-8, segunda certificación
34567890-1.txt      → RUT: 34.567.890-1, primera certificación

Consideraciones Especiales

Si el RUT es incorrecto:

1. Procesar normalmente el archivo.
2. Editar manualmente 5 - libro de guías.csv.
3. Corregir la columna RUTDoc con el RUT válido.

Para certificaciones múltiples sin especificar cantidad:

1. Editar compras (exentas).csv y compras.csv.
2. Modificar columna “Fecha Emisión” con meses diferentes.
3. Guardar cambios.

Procesamiento Principal

Comando Básico

# Opción recomendada.
composer procesar

# Alternativa directa.
./src/Command.php procesar

Directorios Personalizados

# Especificar directorios custom.
composer procesar input /mi/entrada output /mi/salida

Configuración por Defecto

Generación del Libro de Guías

Prerrequisitos

1. Haber ejecutado composer procesar exitosamente.
2. Generar archivo XML en LibreDTE.
3. Mover el XML generado a /data/output/.

Ejecución

# Comando estándar
composer generar-guia

# Con directorio personalizado
composer generar-guia output /directorio/custom

Resolución de Problemas

Errores Frecuentes

Diagnóstico de Logs

# Revisar errores del sistema
cat logs/error.log

# Revisar proceso completo
cat logs/process.log

# Verificar archivos generados
ls -la data/output/

Correcciones Manuales Comunes

Corrección de RUT:

# Editar archivo generado.
nano "data/output/5 - libro de guías.csv"
# Modificar columna 'RUTDoc' con RUT correcto.

Ajuste de fechas para múltiples certificaciones:

# Editar archivos de compras.
nano "data/output/compras.csv"
nano "data/output/compras (exentas).csv"
# Cambiar columna "Fecha Emisión" a meses diferentes.

Validación Final

Archivos Esperados

Al finalizar correctamente, debes tener:

data/output/
├── compras.csv
├── compras (exentas).csv
├── 5 - libro de guías.csv
├── [archivo-xml-libredte].xml
└── [otros-documentos-procesados]

Lista de Verificación Pre-Certificación

• Todos los archivos CSV están presentes.
• No hay errores críticos en /logs/.
• XML de LibreDTE procesado correctamente.
• Fechas de emisión son coherentes.
• RUTs coinciden con información oficial.

Próximos Pasos

Una vez completada esta etapa exitosamente:

1. Verificar que todos los archivos estén completos.
2. Revisar los logs para confirmar procesamiento sin errores.
3. Proceder a la Etapa 1 del proceso de certificación.

Recomendación: Mantén una copia de seguridad de todos los archivos generados antes de continuar con las siguientes etapas.