Reescritura e implementación en Php de script de integración Thrivecart - Holded

# Objetivo general

Reescribir y mejorar un script existente desarrollado en Google Apps Script que conecta ThriveCart (plataforma de pagos) con Holded (software de facturación y gestión) para automatizar la creación y actualización de facturas, pagos y estados de impago.
El nuevo sistema debe estar desarrollado en PHP moderno (8.1 o superior, preferiblemente 8.4), con una arquitectura limpia, idempotente y preparada para ejecutarse mediante cronjobs o manualmente desde línea de comandos.
El script actual está funcionando, pero para mayor estabilidad y control, y para añadir mejoras, queremos reescribirlo en PHP en nuestro propio entorno.

---

# Alcance del proyecto

* Reescribir el código actual de Google Apps Script a PHP desde cero (sin frameworks).
* Mantener todas las funcionalidades actuales: sincronización de transacciones, creación de facturas, registro de pagos y etiquetado de impagos.
* Eliminar dependencias de Google Sheets y usar MySQL como base de datos local (para logs, control de idempotencia, contactos y tareas pendientes).
* Añadir nuevo modo de funcionamiento: el script actual solo revisa las nuevas transacciones desde la última ejecución. Queremos añadir un modo adicional que permita "repasar" o "reconciliar" las transacciones de cierto rango de fechas (ejemplo: 1 al 5 de noviembre), por si hubiese fallado algo (sin generar duplicados, solo tomando acción cuando falte alguna transacción de ThriveCart en el sistema de facturación, Holded).
* Código limpio, documentado y fácilmente mantenible.
* Total compatibilidad con las APIs de ThriveCart y Holded.
* Ejecución idempotente, sin duplicar facturas ni pagos.
* Logs e informes claros y exhaustivos que permitan auditar cualquier ejecución.

---

# Qué debe entregar el desarrollador

1. Código fuente completo en PHP (organizado y comentado).
2. Script de migración inicial de base de datos (SQL).
3. Documentación técnica básica (cómo instalar, configurar y ejecutar).
4. Entrega final del script funcionando en nuestro entorno.
5. Soporte durante ciertos días (a determinar) ante bugs, incidencias o comportamientos inesperados del script, que el desarrollador deberá resolver hasta que el script funcione como se espera.

---

# Requisitos del desarrollador

* Experiencia sólida con PHP 8+, integración de APIs REST y autenticación por token.
* Buen conocimiento de MySQL, gestión de errores y logs.
* Capacidad para escribir código limpio, modular y mantenible.
* Deseable: experiencia previa con Holded API o ThriveCart API.