Saltar al contenido principal

Instalación

Nueva dirección del repositorio

Desde noviembre de 2026 el repositorio del API vive en https://git.buho.la/facturalatam/apidian/co-apidian2027.git. Úsela en el git clone y, si ya tiene una instalación, en el git remote antes de actualizar:

git remote set-url origin https://git.buho.la/facturalatam/apidian/co-apidian2027.git
Requisitos del API 2027

Laravel 13 con PHP 8.5 recomendado (mínimo 8.3). Las guías de instalación (Windows, Ubuntu LAMP y Docker) usan 8.5; el mínimo que admite el API es 8.3, pensado para el hosting compartido que todavía no ofrezca 8.5. Con menos de 8.3 el composer install se detiene.

  • Windows: PHP 8.5 en su versión NTS (Non Thread Safe) más el Visual C++ 2015-2022 (x64). Con la Thread Safe, Laragon falla al recargar con un error de nghttp2 en php_curl.dll.
  • Ubuntu (LAMP): hacen falta 22.04 o 24.04. En 20.04 no hay PHP 8.5 (el PPA de ondrej dejó de publicar para focal), así que primero hay que subir el sistema: Actualización de Ubuntu 20.04 a 22.04 en VPS LAMP. Con Docker, 20.04 sigue sirviendo: PHP va dentro de la imagen.
  • Docker: no hay que instalar PHP; los servicios del API usan la imagen publicada jeremyabel710/php85-api:8.5.12. El Dockerfile del repositorio (PHP 8.3.36) sigue disponible para quien prefiera construir la imagen en su propio servidor.
  • Extensiones: curl, fileinfo, gd, intl, mbstring, openssl, pdo_mysql, soap, xml y zip (más pdo_pgsql y pgsql si usa PostgreSQL). En cPanel se agregan además mysqlnd, bcmath, tokenizer y dom.
  • Composer: debe ser 2.10.3.
  • Despliegue en local (Windows)​

  • Despliegue en linux​

    • Exclusivo para Ubuntu 22.04 / 24.04 | entorno LAMP | ejecucion de comandos de forma manual.
    • Exclusivo para Ubuntu 22.04 / 24.04 | Entorno LAMP | ejecución de script.
      • Pasos aquí — script scripts/scriplamp.sh
      • El script instala Apache, MariaDB, PHP 8.5, Composer 2.10.3 y el API en /var/www/html/apidian. Al terminar imprime los datos de MySQL, la clave de administración (X-Admin-Token) y el enlace para registrar al administrador, que vence en 60 minutos.
  • Despliegue con Docker​

    • Los servicios php_api y scheduling_api usan la imagen publicada jeremyabel710/php85-api:8.5.12: PHP 8.5.12 con las extensiones del API, OpenSSL con soporte para certificados .p12 antiguos, pdftotext para las fichas RUT, OPcache y PHP-FPM con 20 procesos (se cambia con la variable PHP_FPM_MAX_CHILDREN del docker-compose.yml). Ya no se construye en el servidor: se baja con docker compose pull.
    • Ubuntu 20.04 , 22.04 y 24.04 | sólo API | sin dominio | proceso manual
    • Sólo API | con dominio | ejecución de script | incluye el extractor de CUFEs (cufes-worker)
  • Base de datos PostgreSQL (opcional)​

    • El API funciona con MySQL/MariaDB (por defecto) o PostgreSQL; el motor se elige solo con el .env.
      • Conexión y puesta en marcha (requisitos, .env, migraciones): Ver manual aquí
      • PostgreSQL en Docker con instalador interactivo (instalar-postgres-docker.sh, genera su docker-compose.postgres.yml): Ver manual aquí
  • Extractor DIAN (Factura de compras)​

    • Despliegue e integración — cómo conectar el worker del extractor a una instalación del API (Docker o LAMP): Ver manual aquí
    • API del extractor — rutas, autenticación y ejemplos para consumirlo desde sistemas externos: Ver manual aquí
  • CPanel (hosting compartido)​

    • Pasos aquí
    • La guía va con capturas de cada paso en cPanel e incluye: asignar al dominio PHP 8.5 (mínimo 8.3) en Select PHP Version o MultiPHP Manager, apuntar el Document Root a public, instalar un Composer 2.10.3 propio en ~/bin, el registro del administrador con php artisan setup:token y la clave de administración con php artisan api:admin-token.
    • Trae además la alternativa cuando el proveedor no deja cambiar el Document Root, qué hacer si el PHP de la terminal es más viejo que el de la web, el cron del scheduler, el pdftotext para las fichas RUT y los errores frecuentes propios de cPanel.
  • Migracion Api2026 a Api2027 (Windows, Linux y Docker)​