Checklist técnico para adaptar un ERP o aplicación PHP a VERI*FACTU
Adaptar un sistema existente exige localizar el momento de expedición, separar estados, proteger registros y probar rechazos, reintentos y recuperación.
En un ERP o aplicación PHP antigua, la factura puede nacer en varios controladores, tareas o consultas directas. Adaptar el sistema exige primero recuperar ese recorrido. Añadir una llamada al final de un script no resuelve ediciones posteriores, anulaciones, errores parciales ni cambios realizados directamente en base de datos.
1. Inventariar el flujo actual
Localiza pantallas, comandos y tareas que crean facturas; series y numeraciones; tablas; PDFs; integraciones contables y permisos. Registra qué acción convierte un borrador en factura expedida y qué código puede modificarla después.
2. Confirmar ámbito y modalidad
La empresa debe validar con asesoría qué sujetos y operaciones están incluidos y decidir la modalidad aplicable. El equipo técnico necesita esa decisión para diseñar remisión, firma, conservación y registro de eventos sin asumir criterios fiscales.
3. Separar estados del documento
Pedido, borrador, factura expedida, anulada y rectificativa necesitan estados distintos. Una factura expedida no debería volver silenciosamente a edición. Las correcciones deben producir las operaciones y referencias definidas, conservando historial.
4. Crear un adaptador versionado
Aísla construcción del registro, huella, comunicación y respuesta detrás de un módulo. Versiona esquemas y configuración. Esto permite probar la adaptación sin repartir reglas fiscales por controladores, plantillas y consultas.
5. Diseñar idempotencia y transacciones
Asigna una referencia interna estable antes de comunicar. Guarda solicitud, intento y respuesta sin incluir secretos innecesarios. Si la conexión se corta, consulta o reconcilia antes de crear otra operación. Una transacción local no puede confirmar por sí sola lo ocurrido en un servicio externo.
6. Proteger integridad y accesos
Revisa quién puede editar tablas, ejecutar scripts y cambiar reloj o configuración. Las copias y exportaciones deben conservar registros y eventos exigibles. Los logs necesitan protección de datos y retención definida, no volcados indiscriminados de clientes y credenciales.
7. Preparar migración de históricos y cambio de versión
No todos los documentos anteriores deben transformarse como si fueran nuevos. Define qué histórico queda en modo consulta, cómo se accede y qué versión del sistema lo produjo. La declaración responsable y la identificación de versión deben corresponder al producto realmente desplegado.
8. Probar recorridos normales y fallos
Factura ordinaria y simplificada cuando aplique
Series e impuestos distintos
Anulación y rectificación
Timeout y reintento
Rechazo por datos
Reinicio del worker
Credencial o certificado vencido
Restauración desde backup9. Desplegar con observación
Utiliza entorno de pruebas, datos controlados y un cambio reversible. Después del despliegue observa colas, rechazos, numeración y conciliación. Documenta quién atiende cada error y cómo se actualiza la adaptación cuando cambian especificaciones.
Un checklist técnico, no una validación fiscal
El objetivo es evitar que una adaptación correcta sobre el papel falle al operar. La conformidad final depende del sistema, versión, declaración responsable y situación de la empresa, y debe revisarse con fuentes oficiales y asesoría competente.