Marco genérico de documentos con seguimiento de caducidad para el TMS.
Adjunta documentos tipados (licencia, seguro, inspección, ...) a cualquier recurso del TMS (conductores, vehículos). La validez del documento (válido / próximo a caducar / caducado) se calcula a partir de la fecha de caducidad frente a un horizonte configurable.
Un documento puede marcarse como crítico: un documento crítico caducado en el conductor o el vehículo de un viaje bloquea el inicio de ese viaje.
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 19.0Adjunta documentos con seguimiento de caducidad (licencia, seguro, inspección, otros) a conductores y vehículos, consulta de un vistazo si cada uno es válido, está por caducar o ha caducado, y bloquea el inicio de un viaje cuando un documento crítico ha caducado.
Este módulo añade una pestaña Documents a los formularios de conductor y vehículo, además de un menú Documents bajo el menú de datos de TMS. En un conductor o vehículo puedes subir uno o varios archivos a la vez; cada archivo se convierte en un registro de documento donde estableces el tipo (Driving License, Insurance, Vehicle Inspection, Other), un nombre de referencia, fecha de emisión, fecha de caducidad, notas y si es crítico.
Cada documento muestra automáticamente un estado: Valid, Expiring o Expired. Expiring significa que la fecha de caducidad cae dentro de un horizonte configurable (30 días por defecto, almacenado en el parámetro del sistema tms.document.expiry_horizon_days). Los documentos sin fecha de caducidad son siempre Valid. En la lista de documentos, las líneas caducadas se muestran en rojo y las que están por caducar en naranja, y puedes filtrar por Expired o Critical.
Regla de negocio: cuando alguien intenta iniciar un viaje (tms.order), el sistema comprueba el conductor y el vehículo del viaje. Si algún documento crítico de estos tiene una fecha de caducidad en el pasado, el viaje no puede iniciarse y un error enumera los documentos infractores.
Los archivos están protegidos: se rechaza eliminar un adjunto que pertenece a un documento, y eliminar un documento lo archiva y elimina su archivo. Eliminar un conductor o vehículo archiva sus documentos en lugar de perderlos. Los documentos son específicos de la compañía, y un grupo dedicado 'Manage TMS Documents' controla quién puede crearlos, editarlos o eliminarlos.
Depende de
Menús que añade
Modelos y campos (5)
- tms.order · amplía un modelo existente
- tms.driver · amplía un modelo existentedocument_ids (Documents)
- tms.document · modelo nuevoname (Reference), notes, state, active, res_id (Holder ID), file_id (File), res_ref (Holder), critical, doc_type (Type), res_model (Holder Model), company_id (Company), issue_date, expiry_date
- fleet.vehicle · amplía un modelo existentedocument_ids (Documents)
- ir.attachment · amplía un modelo existente
Texto generado por IA (DeepSeek) al leer el código de la versión 19.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 1 confirmada, 8 sin información de 9 versiones.
Fuentes · Odoo 19.0
Confirmado el 2026-11-03 en la rama 19.0 de OCA/stock-logistics-transport.
terminal Instalación y uso
Documentación de OCA · Odoo 19.0Configuración
Fuente · Odoo 19.0El horizonte de caducidad se controla mediante el parámetro de configuración tms.document.expiry_horizon_days (por defecto: 30 días).
Un documento cuya fecha de caducidad esté dentro de este número de días se considera próximo a caducar; una vez que pasa la fecha de caducidad, está caducado.
Para cambiar el horizonte, establezca el parámetro en Ajustes > Técnico > Parámetros (o mediante ir.config_parameter.set_param). Un valor menor hace que los documentos pasen a próximo a caducar más tarde; un valor mayor avisa antes.
Creación de un documento
Los documentos se pueden crear desde el menú Documents en TMS > Documents, o directamente desde un formulario de conductor o vehículo usando la pestaña Documents. Haga clic en Create y complete:
- Document type: por ejemplo, permiso de conducir, seguro del vehículo, inspección.
- Number / reference: la referencia impresa en el documento.
- Holder: el recurso TMS al que pertenece el documento (un conductor o un vehículo).
- Expiry date: se usa para calcular el estado de validez.
- Critical: marque el documento como crítico para exigirlo al iniciar el viaje.
Al subir un archivo desde la pestaña Documents de un formulario de titular, el documento se vincula automáticamente a ese titular y el archivo se adjunta al chatter del titular.
Una vez guardado, el documento aparece en modo solo lectura en la pestaña Documents del formulario de su titular, de modo que todos los documentos de un conductor o vehículo son visibles en un solo lugar.
Estados de validez
El estado del documento se calcula a partir de su fecha de caducidad y el horizonte configurado (consulte Configure):
- Valid — la fecha de caducidad está más lejos que el horizonte.
- Expiring — la fecha de caducidad cae dentro del horizonte.
- Expired — la fecha de caducidad está en el pasado.
Bloqueo del inicio del viaje
Cuando se inicia un viaje, se comprueban todos los documentos de su conductor y vehículo. Si algún documento crítico está caducado, se genera un error de usuario y el viaje no se puede iniciar hasta que el documento se renueve, se corrija su fecha de caducidad o deje de estar marcado como crítico.
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.