════════════════════════════════════════════════════════════════════════════════
GUÍA: SUBIR ARCHIVOS AL SERVIDOR (MANUAL)
════════════════════════════════════════════════════════════════════════════════

ARCHIVOS A SUBIR:
─────────────────

1. config.php                  → Configuración del sistema
2. SRI.php                     → Clase principal de integración SRI
3. ejemplo_factura.php         → Script de prueba
4. README.md                   → Documentación
5. .htaccess                   → Protección de archivos

Total: 5 archivos

ESTRUCTURA FINAL EN TU SERVIDOR:
────────────────────────────────

TU_SERVIDOR/
  proyecto-sri/                        (Carpeta principal)
    ├── config.php                     (configuración)
    ├── SRI.php                        (clase SRI)
    ├── ejemplo_factura.php            (ejemplo)
    ├── README.md                      (documentación)
    ├── .htaccess                      (protección)
    │
    ├── certs/                         (CREAR CARPETA - vacía de momento)
    │   └── (aquí irá tu certificado.p12)
    │
    └── storage/                       (CREAR CARPETA - se crea sola)
        ├── xmls/                      (XML generados)
        ├── pdfs/                      (PDFs generados)
        └── comprobantes/              (Datos de comprobantes)

OPCIÓN 1: USANDO CPANEL/PANEL WEB
──────────────────────────────────

1. Accede a tu cPanel/Panel de control
2. Abre el Administrador de Archivos
3. Navega a la carpeta public_html (o donde alojar el proyecto)
4. Crea una carpeta nueva llamada "proyecto-sri"
5. Entra en esa carpeta
6. Crea subcarpetas:
   - certs
   - storage/xmls
   - storage/pdfs
   - storage/comprobantes
   - logs
7. Sube los 5 archivos PHP:
   - config.php
   - SRI.php
   - ejemplo_factura.php
   - README.md
   - .htaccess

OPCIÓN 2: USANDO FTP (Filezilla, WinSCP, etc.)
───────────────────────────────────────────────

1. Abre tu cliente FTP
2. Conecta con tus datos:
   - Host: tu-servidor.com
   - Usuario: tu-usuario
   - Contraseña: tu-contraseña
   - Puerto: 21 (o 22 para SFTP)

3. Navega a: /public_html (o carpeta raíz)

4. Crea carpeta: proyecto-sri
   - Haz clic derecho → Crear carpeta nueva

5. Dentro de proyecto-sri, crea subcarpetas:
   - certs
   - storage
     - xmls
     - pdfs
     - comprobantes
   - logs

6. Sube los 5 archivos a proyecto-sri/

OPCIÓN 3: USANDO SSH/TERMINAL
──────────────────────────────

1. Conecta por SSH:
   ssh usuario@tu-servidor.com

2. Ejecuta estos comandos:

   # Crear estructura
   mkdir -p ~/public_html/proyecto-sri/certs
   mkdir -p ~/public_html/proyecto-sri/storage/xmls
   mkdir -p ~/public_html/proyecto-sri/storage/pdfs
   mkdir -p ~/public_html/proyecto-sri/storage/comprobantes
   mkdir -p ~/public_html/proyecto-sri/logs

   # Cambiar permisos
   chmod 755 ~/public_html/proyecto-sri
   chmod 755 ~/public_html/proyecto-sri/certs
   chmod 755 ~/public_html/proyecto-sri/storage
   chmod 755 ~/public_html/proyecto-sri/logs

3. Sube los archivos usando SCP:
   scp config.php usuario@tu-servidor.com:~/public_html/proyecto-sri/
   scp SRI.php usuario@tu-servidor.com:~/public_html/proyecto-sri/
   scp ejemplo_factura.php usuario@tu-servidor.com:~/public_html/proyecto-sri/
   scp README.md usuario@tu-servidor.com:~/public_html/proyecto-sri/
   scp .htaccess usuario@tu-servidor.com:~/public_html/proyecto-sri/

PASO 4: COPIAR TU CERTIFICADO DIGITAL
──────────────────────────────────────

Una vez subidos todos los archivos PHP:

1. Localiza tu archivo: certificado.p12
   (Te lo proporcionó Security Data, Banco Central, etc.)

2. Sube el archivo a la carpeta: proyecto-sri/certs/
   
   Por FTP:
   - Abre carpeta proyecto-sri
   - Abre carpeta certs
   - Arrastra tu certificado.p12 aquí
   
   Por SSH:
   scp certificado.p12 usuario@tu-servidor.com:~/public_html/proyecto-sri/certs/

3. Verifica que esté:
   ls -la ~/public_html/proyecto-sri/certs/
   
   Deberías ver:
   -rw-r--r-- usuario grupo certificado.p12

PASO 5: VERIFICAR QUE TODO ESTÁ CORRECTO
──────────────────────────────────────────

Verifica la estructura de carpetas:

Por SSH:
  find ~/public_html/proyecto-sri -type f -o -type d

Deberías ver:
  proyecto-sri/
  proyecto-sri/config.php
  proyecto-sri/SRI.php
  proyecto-sri/ejemplo_factura.php
  proyecto-sri/README.md
  proyecto-sri/.htaccess
  proyecto-sri/certs/
  proyecto-sri/certs/certificado.p12
  proyecto-sri/storage/
  proyecto-sri/storage/xmls/
  proyecto-sri/storage/pdfs/
  proyecto-sri/storage/comprobantes/
  proyecto-sri/logs/

PASO 6: EJECUTAR LA PRUEBA
──────────────────────────

Opción A: Por SSH (RECOMENDADO)
  
  ssh usuario@tu-servidor.com
  cd ~/public_html/proyecto-sri
  php ejemplo_factura.php
  
  Deberías ver:
  ✓ Certificado cargado correctamente
  ✓ XML generado correctamente
  ...

Opción B: Por navegador web

  Accede a: https://tu-servidor.com/proyecto-sri/ejemplo_factura.php
  
  PERO: Asegúrate de que el archivo sea accesible
  (Algunos servidores pueden no permitir ejecutar PHP desde carpetas públicas)

SI HAY PROBLEMAS:
─────────────────

1. Error "Certificado no encontrado"
   - Verifica que certificado.p12 esté en: proyecto-sri/certs/
   - Verifica que el nombre sea exactamente: certificado.p12

2. Error "Contraseña incorrecta"
   - La contraseña configurada es: JialiVaras2014
   - Si no coincide con tu certificado, edita config.php:
     define('CONTRASEÑA_CERTIFICADO', 'TU_CONTRASEÑA_AQUI');

3. Error "SOAP no disponible"
   - Contacta a tu proveedor de hosting
   - Pide que habilite la extensión PHP SOAP
   - Ya verificaste que está activada: ✓

4. Permisos denegados
   - Asegúrate de que las carpetas tengan permisos 755:
     chmod 755 proyecto-sri/certs
     chmod 755 proyecto-sri/storage
     chmod 755 proyecto-sri/logs

5. No se puede conectar al SRI
   - El servidor debe tener acceso a internet
   - Contacta a tu proveedor para verificar

PRÓXIMO PASO:
─────────────

Una vez todo funcione:

1. Crea un formulario web para ingresar facturas
2. Integra la clase SRI con tu base de datos
3. Implementa la generación de PDF (RIDE)
4. Agrega sistema de múltiples RUCs
5. Integra con tu inventario

════════════════════════════════════════════════════════════════════════════════
