# Despliegue IVA 8% + Placa en factura

Fecha: 2026-10-07. Paquete: `iva8_placa_20261007.tar.gz`.

Reemplaza a `iva8_cambios_20261007.tar.gz` y `ride_iva8_20261007.tar.gz`. **No usar esos paquetes en este servidor.**
Se armaron en otro servidor (facCampoLocal): quitaban funcionalidad de este (`regenerarRideAction`, el filtro por
punto de emisión del listado, `anularAccion` de liquidaciones, el 0.00 de las anuladas en reportes), cambiaban la URL
del correo de NC a otro dominio y traían ids de IVA de otra base de datos (el producto "IVA 15%" quedaba grabado al 5%).

Este paquete aplica **solo** los cambios del 8% y de la placa sobre los archivos de este servidor.

## Qué cambia

**IVA 8% (código SRI `codigoPorcentaje=8`)**
- Factura, Nota de Crédito y Liquidación de Compra: columnas `subtotal8` / `iva8`, cálculo al guardar, bloque
  `<totalImpuesto>` con código 8 en el XML y filas 8% en las pantallas crear, editar y ver.
  Antes de este cambio, un producto al 8% caía en la rama del IVA 12% y salía con el código porcentaje equivocado.
- `ProcesarFacturaCommand` (envío masivo/automático): bloque 8% en el XML.
- Reportes: Excel detallado con columnas Subtotal 8% / IVA 8%; reporte PDF detallado y listado "Detalladas" con el 8%.
- Modal "nuevo producto" en factura: opción `IVA 8%` = `ImpuestoIVA.id 7` (ya existe en la BD; **no** insertar otro).
- RIDE A4 (`Ride`): una fila SUBTOTAL e IVA por cada tarifa que traiga el XML. Si no hay 8%, el PDF queda idéntico al actual.
- RIDE ticket (`JasperRide` + `factura.jrxml`): filas SUBTOTAL 8% / IVA 8%. Las filas 15% y 5% muestran `0.00`
  en vez de quedar vacías o decir `null`.
- Ticket de NC y LC (`notaCredito.jrxml`, `liquidacionCompra.jrxml`): filas SUBTOTAL 8% / IVA 8%.

**Placa (pedido del SRI)**
- Columna `Factura.placa` (VARCHAR 20, opcional). Campo "Placa" en crear y editar factura (se convierte a mayúsculas;
  solo admite letras, números y guion; el servidor lo vuelve a validar) y se muestra en "ver factura". Se copia al clonar.
- XML: `<placa>` dentro de `<infoFactura>`, entre `<moneda>` y `<pagos>`. Solo se emite si hay placa: sin placa, el XML queda igual que hoy.
- RIDE: aparece como campo adicional "Placa" (A4, en "Información Adicional") y como línea "Placa: …" en el ticket (solo si hay placa).

## Contenido

```
deploy.sh / rollback.sh        despliegue y reversión con respaldo
db/                            migration_iva8_placa.sql, rollback_iva8_placa.sql
php/src/FactelBundle/...       19 archivos (ver php/ARCHIVOS.txt); php/cambios.diff = diff completo
php/ORIGINALES.md5             huellas de los archivos del servidor sobre los que se armó el paquete
ride/classes/                  5 clases + Util/configuracion.properties (se insertan en el WAR)
ride/jrxml/                    factura, notaCredito, liquidacionCompra (para /home/reportes/IReport/Default)
ride/src/, ride/cambios_*.diff fuentes Java (decompiladas con CFR y corregidas) y diff contra el original
```

Clases del WAR modificadas: `TiposComprobantes/Factura` (genera `<placa>`), `Ride/Ride`, `JasperRide/JasperRide`,
`JasperComprobantes/ComprobanteGeneral`, `JasperComprobantes/Factura`. Se compilaron con `-source/-target 1.6`
contra el `rt.jar` de Java 8, igual que las originales (bytecode 50). Se agrega `codigo8 = 8%` y `codigo10 = 13%`
a `configuracion.properties`.

## Pasos

Hacerlo en horario de poca emisión: al recargarse el WAR (~10 s) fallan los envíos al SRI de ese momento.

```bash
cd /var/www/html/src/FactelBundle
tar -xzf iva8_placa_20261007.tar.gz
cd iva8_placa_20261007
bash deploy.sh --check     # solo verifica; no toca nada
bash deploy.sh             # pide escribir SI antes de modificar
```

`deploy.sh` hace, en este orden:

1. **Comprobaciones** (aborta sin tocar nada si algo no cuadra): `ImpuestoIVA.id=7` es el 8%; las columnas no existen
   aún; los 19 archivos, las clases del WAR y los jrxml son exactamente los esperados (md5); el `.war` coincide con
   lo desplegado.
2. **Respaldo** en `/root/backup_iva8_placa_<fecha>/`: dump completo de la BD (`--single-transaction`, ~270 MB sin
   comprimir), los 19 archivos originales, el `.war` y los 3 jrxml.
3. **BD**: `db/migration_iva8_placa.sql` (`ALGORITHM=INPLACE, LOCK=NONE`: la tabla Factura sigue operativa).
   El código actual funciona con las columnas nuevas, por eso va primero.
4. **WAR**: inserta las clases en el `.war` actual con `jar uf` (conserva el resto, incluido el arreglo del catálogo
   SRI del 05-oct) y espera a que Tomcat recargue y el WSDL exponga `placa`.
5. **jrxml** (después del WAR: jrxml nuevos con clases viejas rompen el ticket).
6. **PHP/Twig**: copia los 19 archivos y verifica sus md5.
7. **Caché**: `cache:clear` + `cache:warmup` como `www-data`, y borra la caché del WSDL de PHP
   (`/tmp/wsdl-*`, también en el PrivateTmp de Apache). Sin esto PHP no envía `<placa>` hasta por 24 h.

## Verificación

1. Crear una factura de prueba con un producto al 8% y placa `ABC1234`, y procesarla.
2. En el XML firmado (`/home/demo/<RUC>/<cliente>/FAC….xml`) debe estar
   `<moneda>DOLAR</moneda><placa>ABC1234</placa><pagos>` y un `<totalImpuesto>` con `<codigoPorcentaje>8</codigoPorcentaje>`.
3. El SRI debe autorizarla. **Probar primero con un emisor en ambiente de pruebas (celcer)**: confirma que el
   esquema del SRI acepta `<placa>` en la versión 1.1.0 que emite el sistema.
4. `FAC….pdf` (A4): filas "SUBTOTAL 8%" e "IVA 8%" y "Placa ABC1234" en Información Adicional.
   `FAC…-small.pdf`: filas 8% y la línea "Placa: ABC1234".
5. Una factura sin 8% y sin placa debe verse igual que antes.

## Revertir

```bash
bash rollback.sh /root/backup_iva8_placa_<fecha>            # PHP + caché, jrxml, WAR
bash rollback.sh /root/backup_iva8_placa_<fecha> --con-bd   # además borra las columnas
```

Las columnas pueden quedarse: el código viejo funciona con ellas. Borrarlas pierde las placas y los valores 8%
guardados desde el despliegue. Nunca borrarlas con el código nuevo activo: Doctrine fallaría al leer o guardar.

## Pruebas hechas antes de armar el paquete

- `php -l` de los PHP, `twig:lint` de las 10 vistas tocadas y `doctrine:schema:update --dump-sql`: para estas
  columnas, el mapeo pide exactamente lo que crea la migración. **No** correr `schema:update --force`: el esquema
  ya tenía otras diferencias que no son de este cambio.
- XML generado con la clase nueva: con placa sale `<moneda>…</moneda><placa>…</placa><pagos>`; sin placa (null o
  vacía) el XML queda igual al actual.
- RIDE generados fuera de Tomcat con un XML real de producción: con las clases y plantillas actuales salen
  con el mismo tamaño que los PDF de producción. Con las nuevas, el texto del A4 sin 8% queda idéntico. Con 8% y placa, el A4 y el ticket
  muestran las filas y la placa. El A4 de una NC real queda con el mismo tamaño y el mismo texto. Las 3 plantillas compilan con Jasper.

## Pendientes / problemas que ya existían (no se tocaron)

- El ticket (`-small.pdf`) de **Nota de Crédito** falla en este servidor (`Error retrieving field value from bean :
  ivaParametro`): solo ~136 de ~507 NC lo tienen. Ya pasaba antes; las filas 8% quedan listas para cuando se corrija.
- El ticket de factura ocupa 2 páginas aun con un solo ítem (ya pasaba antes).
- El ticket de NC/LC no muestra el 15% (lo maneja aparte del "SUBTOTAL 12%"). Ya pasaba antes.
- Nota de Débito no maneja 5%/8%/15% (solo 12%).
- En `procesarAccion` y `regenerarRideA4`, el bucle de `getComposAdic()` agrega la entidad en vez del objeto SOAP
  (`$camposAdicionales[] = $campoAdic;`). Esos campos adicionales salen vacíos. Ya pasaba antes.
