# IVA 8% en los RIDE (A4 y small): guía para replicar en otros servidores

Instalado en el servidor facCampoLocal el 2026-10-07.
Respaldo de ese servidor: `/root/backup_ride_iva8_20261007_212025`.

Este paquete complementa los cambios PHP/BD del IVA 8% (`README_IVA8.md`, `db/migration_iva8.sql`).
Sin este paquete, el SRI autoriza bien el XML con `codigoPorcentaje=8`, pero los PDF (RIDE) no muestran el 8%.

---

## 1. Qué genera cada RIDE

Los dos PDF los genera el servicio Java `MasterOfflineRideYJasper` (Tomcat). PHP lo llama por SOAP en
`http://127.0.0.1:8080/MasterOfflineRideYJasper/ProcesarComprobanteElectronico?wsdl`.

| PDF | Clase Java | Plantilla |
|---|---|---|
| A4 (`<archivo>.pdf`) | `Ride/Ride.class` (iText, el diseño está en el código) | ninguna |
| small (`<archivo>-small.pdf`) | `JasperRide/JasperRide.class` | `/home/reportes/IReport/Default/*.jrxml` (se compilan al generar el PDF; los `.jasper` de factura, NC y LC no se usan) |

Antes del cambio:
- **A4:** solo reconocía los códigos 4 (15%) y 5 (5%). Con 8% mostraba "SUBTOTAL 15%" en 0.00 y no mostraba el IVA.
- **small:** en facturas, el código 8 se descartaba.

En los servidores no hay código fuente Java. Las clases se recuperaron con el decompilador CFR 0.152, se corrigieron y se volvieron a compilar (javac 1.8, `-target 1.6`, igual que el original).

## 2. Cambios

| Archivo | Cambio |
|---|---|
| `JasperComprobantes/ComprobanteGeneral` | Propiedades nuevas `baseImponible8` y `valor8` (valor inicial `"0.00"`). |
| `JasperRide/JasperRide` | `codigoPorcentaje = 8` se guarda en `baseImponible8`/`valor8` para factura, NC, LC y ND. `baseImponible4`/`valor4` empiezan en `"0.00"` (antes el small mostraba `IVA 15% null`). |
| `Ride/Ride` (`crearTablaResumenValores`) | Imprime una fila SUBTOTAL y una fila IVA por cada tarifa gravada que tenga el XML (15%, 5%, 8%, …), en vez de solo 15% y 5%. Si no hay ninguna, se mantiene la fila por defecto en 0.00. |
| `Util/configuracion.properties` | Agrega `codigo8 = 8%` y `codigo10 = 13%` (son las etiquetas del A4). |
| `factura.jrxml` | Filas `SUBTOTAL 8%` (después de 5%) e `IVA 8%` (después de IVA 5%). La banda de totales pasa de 153 a 183 de alto. |
| `notaCredito.jrxml`, `liquidacionCompra.jrxml` | Filas `SUBTOTAL 8%` e `IVA 8%`. El recuadro de totales pasa de 133 a 163 de alto y la banda de 179 a 209. |

## 3. Contenido del paquete `ride_iva8/`

```
ride_iva8/
├── deploy.sh                 # instalador con respaldo
├── README_RIDE_IVA8.md       # este documento
├── classes/                  # .class compilados + configuracion.properties (se copian a WEB-INF/classes)
│   ├── JasperComprobantes/ComprobanteGeneral.class
│   ├── JasperRide/JasperRide.class
│   ├── Ride/Ride.class
│   └── Util/configuracion.properties
├── jrxml/                    # plantillas del small (se copian a /home/reportes/IReport/Default)
│   ├── factura.jrxml
│   ├── notaCredito.jrxml
│   └── liquidacionCompra.jrxml
└── src/                      # fuentes .java decompiladas y corregidas (para recompilar si hace falta)
```

## 4. Antes de instalar en otro servidor (IMPORTANTE)

Las clases y las plantillas compiladas salen del WAR y de los jrxml **de este servidor**. Si el otro
servidor tiene otra versión, sobrescribirlos quitaría cambios propios de ese servidor (logo, textos, RIMPE,
etc.). Verifica primero:

```bash
# 1) ¿Qué WAR usa PHP? (debe ser MasterOfflineRideYJasper)
grep -rn "MasterOfflineRide" /var/www/html/<proyecto>/src/FactelBundle/Controller/ProcesarComprobanteElectronico.php

# 2) Compara las clases ORIGINALES (antes de parchear) con las que tenía facCampoLocal
cd /opt/tomcat/webapps/MasterOfflineRideYJasper/WEB-INF/classes
md5sum Ride/Ride.class JasperRide/JasperRide.class JasperComprobantes/ComprobanteGeneral.class
#   Valores esperados (originales de facCampoLocal):
#   63aa87f975badaeca5a60aa8bd7aa36b  Ride/Ride.class
#   2e0ebeb2d5da874a1629e0218735df8d  JasperRide/JasperRide.class
#   a9ac6a657a4499be4c37d33bbab3c149  JasperComprobantes/ComprobanteGeneral.class

# 3) Compara las plantillas jrxml ORIGINALES
md5sum /home/reportes/IReport/Default/{factura,notaCredito,liquidacionCompra}.jrxml
#   cd5eebbc64607d43b61075bab227e547  factura.jrxml
#   7c19d36dbea3132ab0deea6d732f51a1  notaCredito.jrxml
#   a25c86ef29f33a2f7f47d2732832b72e  liquidacionCompra.jrxml
```

- **Si son iguales:** usa el paquete tal cual (sección 5).
- **Si son distintas:** NO copies `classes/` ni `jrxml/`. Aplica los cambios sobre los archivos de ese servidor (sección 6).

Requisitos: Java 8 (`java`, `javac` y `jar` en el PATH), Tomcat con `autoDeploy="true"` y `unpackWARs="true"` en `server.xml`.
Si el WAR o las plantillas están en otras rutas, ajusta las variables al inicio de `deploy.sh`
(`APP`, `WEBAPPS`, `PLANTILLAS`). `APP` también se puede pasar por variable de entorno.

## 5. Instalación (servidor con la misma versión)

```bash
# Copiar el paquete
scp -r /var/www/html/facCampoLocal/ride_iva8 usuario@otro-servidor:/var/www/html/<proyecto>/

# En el otro servidor
cd /var/www/html/<proyecto>
bash ride_iva8/deploy.sh
```

Qué hace `deploy.sh`:
1. Respalda el `.war` y los 3 `.jrxml` en `/root/backup_ride_iva8_<fecha>/`.
2. Actualiza `WEB-INF/classes` dentro del `.war` (`jar uf`) y lo reemplaza con un `mv` atómico.
   Tomcat lo detecta y vuelve a cargar el contexto en unos 8 s (no hace falta reiniciar Tomcat).
3. Espera a que las clases nuevas estén cargadas y **recién entonces** copia los `.jrxml`.

> El orden importa: las clases nuevas funcionan con los jrxml viejos, pero los jrxml nuevos con las clases viejas
> rompen el small (`Error retrieving field value from bean : baseImponible8`).

Si el script dice que el contexto no se volvió a cargar: `systemctl restart tomcat`, y después
`cp ride_iva8/jrxml/*.jrxml /home/reportes/IReport/Default/`.

### Verificación

```bash
# El servicio responde
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8080/MasterOfflineRideYJasper/ProcesarComprobanteElectronico?wsdl   # 200

# Los archivos instalados son los del paquete
W=/opt/tomcat/webapps/MasterOfflineRideYJasper/WEB-INF/classes
for f in Ride/Ride.class JasperRide/JasperRide.class JasperComprobantes/ComprobanteGeneral.class Util/configuracion.properties; do
  cmp -s ride_iva8/classes/$f $W/$f && echo "ok $f" || echo "DIFF $f"; done

# Log de despliegue
grep MasterOfflineRideYJasper $(ls -t /opt/tomcat/logs/catalina.*.log | head -1) | tail -3
```

Los mensajes `SEVERE ... checkThreadLocalMapForLeaks` al volver a cargar el contexto son normales (avisos de Tomcat al descargar la versión anterior).

Por último, emite una factura con un producto al 8% y revisa el `.pdf` y el `-small.pdf`: deben aparecer las filas
"SUBTOTAL 8%" e "IVA 8%".

### Revertir

```bash
B=/root/backup_ride_iva8_<fecha>
cp $B/plantillas/*.jrxml /home/reportes/IReport/Default/
cp $B/MasterOfflineRideYJasper.war /opt/tomcat/webapps/MasterOfflineRideYJasper.war   # Tomcat vuelve a cargar solo
```

Revierte en este orden (primero los jrxml), por la misma regla de la sección 5.

## 6. Servidor con otra versión del WAR o de los jrxml (aplicar a mano)

### 6.1 Clases Java

```bash
W=/opt/tomcat/webapps/MasterOfflineRideYJasper/WEB-INF
mkdir -p ~/ride8 && cd ~/ride8
curl -sLO https://repo1.maven.org/maven2/org/benf/cfr/0.152/cfr-0.152.jar
cd $W/classes
java -jar ~/ride8/cfr-0.152.jar Ride/Ride.class JasperRide/JasperRide.class \
     JasperComprobantes/ComprobanteGeneral.class --outputdir ~/ride8/src
```

Edita los `.java` en `~/ride8/src`. Usa `ride_iva8/src/` como referencia y compara con `diff`:

1. **ComprobanteGeneral.java:** agrega los campos `baseImponible8 = "0.00"` y `valor8 = "0.00"`, con sus getters y setters.
2. **JasperRide.java:**
   - Declara las variables locales `baseImponibleIva8` / `valorIva8 = "0.00"`. No uses `valor8`, porque ese nombre ya existe más abajo, en la guía de remisión.
   - En el bucle de `totalImpuesto`, después del `if (codigoPorcentaje.equals("5"))`, agrega el caso `"8"`, que asigna esas variables y hace `continue`.
   - Llama a `setBaseImponible8`/`setValor8` en factura, liqCompra, notaCredito y notaDebito.
   - Cambia `HashMap<String, String> parameters` por `HashMap<String, Object>`. CFR lo genera mal y no compila.
   - Opcional: `baseImponible4`/`valor4` con valor inicial `"0.00"`.
3. **Ride.java:** en `crearTablaResumenValores`, reemplaza la lógica `codigo4Presente/codigo5Presente` por un
   `LinkedHashMap<String, String[]> tarifasIVA` (codigoPorcentaje → {base, valor}). Agrega ahí todo código 2 que no sea 0, 6 ni 7,
   y luego recorre el mapa para las filas "SUBTOTAL x%" y otra vez para las filas "IVA x%".
   La etiqueta sale de `configuracion.getProperty("codigo" + cod).trim()`. Agrega los imports `java.util.LinkedHashMap` y `java.util.Map`.

Compila:

```bash
mkdir -p ~/ride8/out
javac -nowarn -encoding UTF-8 -source 1.6 -target 1.6 -cp "$W/classes:$W/lib/*" -d ~/ride8/out \
  ~/ride8/src/JasperComprobantes/ComprobanteGeneral.java ~/ride8/src/JasperRide/JasperRide.java ~/ride8/src/Ride/Ride.java
```

Copia `configuracion.properties` del servidor a `~/ride8/out/Util/` y agrégale `codigo8 = 8%` (y `codigo10 = 13%`).
El archivo usa fin de línea CRLF. Revisa que la última línea no quede pegada a texto previo.

### 6.2 Plantillas jrxml

En `factura.jrxml`, `notaCredito.jrxml` y `liquidacionCompra.jrxml` del servidor:

1. Después de `<field name="subTotalSinImpuesto" .../>` (el del nivel principal, no el de un subDataset), agrega:
   ```xml
   <field name="baseImponible8" class="java.lang.String"/>
   <field name="valor8" class="java.lang.String"/>
   ```
2. En la sección de totales, duplica la fila "SUBTOTAL 5%" (factura) o "SUBTOTAL 12%" (NC/LC), es decir, la etiqueta y su textField.
   Cambia el texto a `SUBTOTAL 8%` y el campo a `$F{baseImponible8}`. Haz lo mismo con la fila de IVA (`IVA 8%`, `$F{valor8}`).
   Usa un `uuid` nuevo en cada elemento.
3. Baja 15 px las filas que quedan debajo de cada inserción y aumenta la altura de la banda y del frame de totales (+30).

Se puede hacer con iReport/Jaspersoft Studio o tomando como modelo los jrxml de `ride_iva8/jrxml/`
(`diff` contra el original del backup muestra exactamente qué cambió).

### 6.3 Instalar

Pon el resultado en la estructura del paquete (`classes/` con `out/*`, `jrxml/`) y ejecuta `deploy.sh`.

### 6.4 Probar sin tocar Tomcat (opcional, recomendado)

Puedes generar los PDF fuera de Tomcat con un programa de prueba que llame a
`new Ride.Ride().CrearRide(doc, clave, salida + ".xml", logo)` y
`new JasperRide.JasperRide().CrearRide(doc, clave, salida + "-small.xml", logo, dirIReport)`.
Usa el classpath `out:$W/classes:$W/lib/*` y un XML autorizado (debe tener `etsi:SigningTime`) con un `<totalImpuesto>` de código 8.
El texto del PDF se extrae con `com.itextpdf.text.pdf.parser.PdfTextExtractor` (ya está en `WEB-INF/lib/itextpdf-5.5.4.jar`).

## 7. Problemas conocidos que ya existían (no se corrigieron)

- El A4 de **liquidación de compra** solo genera la cabecera: `Ride` no implementa el cuerpo para codDoc 03.
- El small de **NC y LC** tiene filas 12% pero ninguna de 15%: el código 4 no se muestra en esos dos.
- El small de factura muestra siempre las filas 5% y 8% aunque estén en 0.00 (igual que ya hacía con el 5%).
- `MasterOfflineRideYJasper2` (el otro WAR en Tomcat) **no** se modificó: PHP no lo usa en este servidor.
