Saltar al contenido
Facturador

Parámetros del archivo .env

El archivo .env está en la raíz del proyecto y guarda la configuración de la instalación: dominio, credenciales de base de datos y correo, servicios externos y opciones que activan o desactivan funciones.

La columna Valor en .env.example muestra el valor con el que se crea una instalación nueva. Si una variable no está en tu .env, el sistema usa su propio valor por defecto, que puede ser distinto.

⚠️ Después de modificar cualquier valor, regenera la caché de configuración, o el cambio no se aplicará:

php artisan config:clear
php artisan config:cache

En instalaciones Docker, ejecútalo dentro del contenedor fpm.


Aplicación y dominio

Parámetro Descripción Valor en .env.example
APP_NAME Nombre de la aplicación. Facturador
APP_ENV Entorno de Laravel. En servidores debe ser production; local solo en la PC de desarrollo (con local queda expuesta la ruta /_dusk/login/{id}). production
APP_KEY Clave de cifrado de la aplicación. Se genera con php artisan key:generate; no la cambies en una instalación con datos. —
APP_DEBUG Muestra el detalle de los errores. Mantener en false en producción. Ver Habilitar modo debug. false
APP_URL_BASE Dominio base del sistema, sin http:// ni barra final. Las empresas se crean como subdominios de este dominio. —
PREFIX_URL Subdominio del administrador. Si se define (por ejemplo admin), el administrador queda en admin.APP_URL_BASE. sin definir
APP_URL URL completa de la aplicación. Normalmente se deja como http://${APP_URL_BASE}. http://${APP_URL_BASE}
FORCE_HTTPS Genera las URL en https y redirige HTTP → HTTPS. Recomendado cuando el dominio tiene SSL. false
LOG_CHANNEL Forma de guardar los logs de Laravel. daily crea un archivo por día. daily

Base de datos

Parámetro Descripción Valor en .env.example
DB_CONNECTION Conexión de la base central. No cambiar. system
DB_HOST Servidor de MariaDB/MySQL. En Docker es el nombre del servicio de base de datos. 127.0.0.1
DB_PORT Puerto de la base de datos. 3306
DB_DATABASE Nombre de la base de datos central. tenancy
DB_USERNAME Usuario de la base de datos. root
DB_PASSWORD Contraseña del usuario de la base de datos. —
PREFIX_DATABASE Prefijo de las bases de datos de cada empresa (tenancy_...). tenancy
LIMIT_UUID_LENGTH_32 Limita a 32 caracteres los nombres de base y de usuario de cada empresa. Necesario en MySQL; no en MariaDB. true
TENANCY_DATABASE_AUTO_DELETE Al eliminar una empresa, elimina también su base de datos. true
TENANCY_DATABASE_AUTO_DELETE_USER Al eliminar una empresa, elimina también su usuario de base de datos. true

Caché, colas y sesiones

Parámetro Descripción Valor en .env.example
CACHE_DRIVER Dónde se guarda la caché. redis
QUEUE_CONNECTION Dónde se guardan los trabajos en cola (envíos, descargas de reportes). database
SESSION_DRIVER Dónde se guardan las sesiones de usuario. file
SESSION_LIFETIME Minutos de inactividad antes de cerrar la sesión. 120
TENANT_SESSION_LIFETIME_ENABLED Permite que cada empresa configure su propio tiempo de sesión. true
BROADCAST_DRIVER Driver de eventos en tiempo real. log
REDIS_HOST Servidor de Redis. 127.0.0.1
REDIS_PASSWORD Contraseña de Redis. null
REDIS_PORT Puerto de Redis dentro del servidor o contenedor. 6379
REDIS_PUBLIC_PORT Puerto de Redis publicado hacia fuera del servidor. Es el que usa BuhoPrinter para conectarse. 6379
SOCKET_SERVER URL del servidor de sockets. http://localhost:8070
PUSHER_APP_ID, PUSHER_APP_KEY, PUSHER_APP_SECRET, PUSHER_APP_CLUSTER Credenciales de Pusher, si se usa para eventos en tiempo real. — / mt1
MIX_PUSHER_APP_KEY, MIX_PUSHER_APP_CLUSTER Copia de las credenciales de Pusher para el frontend. —

Correo

Parámetro Descripción Valor en .env.example
MAIL_DRIVER Protocolo de envío (smtp, sendmail). smtp
MAIL_HOST Servidor SMTP. smtp.gmail.com
MAIL_PORT Puerto SMTP (465 con SSL, 587 con TLS). 465
MAIL_USERNAME Correo de la cuenta que envía. —
MAIL_PASSWORD Contraseña de aplicación de esa cuenta. —
MAIL_ENCRYPTION Cifrado (ssl, tls). ssl
TEMPLATE_DOCUMENT_MAIL Plantilla del correo con el que se envían los comprobantes. default

Para que cada empresa use su propio correo, ver Correo emisor por empresa.

SUNAT, PSE y validación

Parámetro Descripción Valor en .env.example
SUNAT_ALTERNATE_SERVER Usa el servidor alterno de SUNAT. Ver Servidor alterno de SUNAT. false
PSE_TIMEOUT Segundos máximos de espera por cada llamada al PSE (firma y envío). 30
EMISSION_SLOW_LOG_MS Registra en el log las emisiones que tarden más de estos milisegundos, con el tiempo de cada paso. 0 lo desactiva. 0
SIGNATURE_NOTE_OSE Texto de la nota de firma que va en el XML. FACTURALO
SIGNATURE_URI_OSE Identificador de la firma en el XML. signatureFACTURALOPERU
APIPERUDEV_VALIDATOR_CPE Muestra en el listado de comprobantes el validador de CPE de APIPERU.DEV. true
VALIDATOR_CPE Muestra en el listado de comprobantes el validador de CPE alternativo. false
CHANGE_TO_REGISTERED_STATUS Muestra el botón Cambiar a estado registrado en los comprobantes en estado Registrado. Pese al nombre, el botón los marca como Aceptado sin enviarlos a SUNAT; úsalo solo si el comprobante ya fue aceptado por otra vía. false

Consulta de RUC y DNI

Parámetro Descripción Valor en .env.example
API_SERVICE_URL URL del servicio de consulta de RUC y DNI. https://apiperu.dev
API_SERVICE_TOKEN Token del servicio de consulta. Ver Configuración de APIPERU.DEV. false
ALLOW_CLIENT_USE_OWN_APIPERU_TOKEN Permite que cada empresa configure su propio token de APIPERU. Esas empresas dejan de usar el token general. false

Comprobantes y ventas

Parámetro Descripción Valor en .env.example
DOCUMENT_TYPE_03_FILTER En boletas, al buscar el cliente solo muestra clientes con DNI. false
SELECT_FIRST_DOCUMENT_TYPE_03 En el formulario de nuevo comprobante, selecciona la boleta como tipo por defecto. false
DELETE_DOCUMENT_TYPE_03 Permite eliminar boletas desde el listado de comprobantes. false
ENABLED_DISCOUNT_GLOBAL Activa el descuento global en los comprobantes. true
IMPORT_DOCUMENTS Muestra la opción de importar comprobantes. false
IMPORT_DOCUMENTS_SECOND_FORMAT Activa el segundo formato de importación de comprobantes. false
DOCUMENT_IMPORT_EXCEL Muestra la importación de comprobantes desde Excel. false
INTERNAL_DISPATCH Muestra el botón para generar un comprobante desde una guía de remisión. false
RECREATE_DOCUMENT Solo afecta al módulo de suscripciones. En el listado de comprobantes, el botón para recrear depende del permiso Recrear documentos del usuario. Ver Regeneración de comprobantes. false
AUTO_PRINT Activa la impresión automática de comprobantes. false

PDF

Parámetro Descripción Valor en .env.example
PDF_TEMPLATE Plantilla PDF por defecto. Ver Plantilla PDF personalizada. default
PDF_TEMPLATE_FOOTER Agrega el pie de página de la plantilla al PDF. true
PDF_NAME_REGULAR Nombre de una fuente personalizada para el texto normal del PDF. false usa la de la plantilla. false
PDF_NAME_BOLD Nombre de una fuente personalizada para el texto en negrita del PDF. false usa la de la plantilla. false
ENABLED_TEMPLATE_TICKET_80 Ajusta el ticket al ancho de papel de 80 mm. false

Administrador, usuarios y límites del reseller

Parámetro Descripción Valor en .env.example
ADMIN_DELETE_CLIENT Permite eliminar empresas desde el administrador. true
MULTI_USER_ENABLED Permite cambiar entre usuarios o empresas desde el menú del usuario. true
PASSWORD_CHANGE Permite cambiar la contraseña al editar un usuario. true
ITEMS_PER_PAGE Registros por página en las tablas principales. 20
ITEMS_PER_PAGE_SIMPLE_D_TABLE Registros por página en las tablas simples. 5
API_RATE_LIMIT Peticiones por minuto que admite la API por usuario. 60
LIMITE_RESELLER Límite de consultas del reseller a los servicios extra (consulta de documentos, placa, licencia, etc.). 999
LIMITE_ALMACENAMIENTO_GB Espacio total en GB para los archivos de todas las empresas. Al superarlo se bloquea el acceso a todas. 0 lo desactiva. 0
LIMITE_DOCUMENTOS_MENSUAL Total de documentos tributarios que pueden emitir todas las empresas en el mes. Al llegar al límite se bloquea la emisión hasta el día 1. 0 lo desactiva. 0
ENABLE_MARKETPLACE Activa el módulo Marketplace. false

WhatsApp

Parámetro Descripción Valor en .env.example
BUHO_PROXY_URL, BUHO_PROXY_CLIENT_ID, BUHO_PROXY_CLIENT_SECRET Proxy del bot de WhatsApp. Solo se definen para apuntar a un proxy distinto del predeterminado (por ejemplo, uno de pruebas). En producción no hacen falta. sin definir
EVOLUTION_API_URL, EVOLUTION_API_KEY Evolution API propio, para instalaciones que lo tienen en su mismo servidor. Si se definen ambas, el bot y QR Api se conectan directamente a ese Evolution en lugar del proxy. sin definir
WHATSAPP_WEBHOOK_BASE_URL URL pública del webhook del bot. Solo para desarrollo local con un túnel (ngrok u otro). sin definir
WHATSAPP_CLOUD_API_VERSION Versión de la API de WhatsApp Cloud. v14.0

Actualizaciones desde el panel (Git)

Parámetro Descripción Valor en .env.example
GIT_USER Usuario de GitLab para descargar actualizaciones. —
GIT_TOKEN Token de GitLab. Va sin comillas. —
GIT_PROJECT_TAGS_URL URL de las versiones (tags) del proyecto. —
GIT_REMOTE_URL URL HTTPS para clonar, si no coincide con la que se deduce de GIT_PROJECT_TAGS_URL. sin definir
GIT_FILESYSTEM_USER Usuario dueño de los archivos del proyecto. www-data
GIT_AUTO_FIX_PERMISSIONS Corrige los permisos de los archivos después de actualizar. true

Otros

Parámetro Descripción Valor en .env.example
URL_APIDOCS URL del servicio extra de documentación de la API. https://api.uio.la
WIKI_PHARMACY Enlace a la guía del módulo de farmacia. ${APP_URL}/legacy-docs/4.X/modulo-farmacia
IS_CLIENT, TOKEN_SERVER, URL_SERVER Modo offline. Ya no se leen del .env: se configuran en la base de datos. Se mantienen solo por compatibilidad. —