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
nghttp2enphp_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. ElDockerfiledel 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,xmlyzip(máspdo_pgsqlypgsqlsi usa PostgreSQL). En cPanel se agregan ademásmysqlnd,bcmath,tokenizerydom. - Composer: debe ser 2.10.3.
-
Despliegue en local (Windows)
- Video de instalación. Aquí
- Pasos aquí
-
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_apiyscheduling_apiusan la imagen publicadajeremyabel710/php85-api:8.5.12: PHP 8.5.12 con las extensiones del API, OpenSSL con soporte para certificados.p12antiguos,pdftotextpara las fichas RUT, OPcache y PHP-FPM con 20 procesos (se cambia con la variablePHP_FPM_MAX_CHILDRENdeldocker-compose.yml). Ya no se construye en el servidor: se baja condocker 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)- Ubuntu 22.04: scripts/scripapi.sh —
bash scripapi.sh midominio.com - Ubuntu 20.04: scripts/scripapi20.sh —
bash scripapi20.sh midominio.com
- Ubuntu 22.04: scripts/scripapi.sh —
- Los servicios
-
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 sudocker-compose.postgres.yml): Ver manual aquí
- Conexión y puesta en marcha (requisitos,
- El API funciona con MySQL/MariaDB (por defecto) o PostgreSQL; el motor se elige solo con el
-
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 conphp artisan setup:tokeny la clave de administración conphp 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
pdftotextpara las fichas RUT y los errores frecuentes propios de cPanel.
-
Migracion Api2026 a Api2027 (Windows, Linux y Docker)
- Guía completa, con requisitos previos, comprobaciones y vuelta atrás: Actualización a APIDIAN 2027.
- Pasos aquí