Integración entre OkTicket y Odoo. OkTicket es una aplicación móvil de gestión de gastos: el empleado fotografía el ticket y se acabó el papel. Este conector lleva esos gastos a Odoo automáticamente, sin introducirlos a mano.
La sincronización va principalmente de OkTicket a Odoo:
- Gastos — importa tickets, facturas y kilometrajes con su importe, fecha, impuestos, empleado y compañía, adjuntando la fotografía del recibo y, cuando existe, el PDF de la factura.
- Hojas de gasto — agrupa los gastos importados en hojas de gasto según el método configurado en la compañía y mantiene sincronizados los estados de la hoja entre Odoo y OkTicket.
- Usuarios — empareja los usuarios de OkTicket con empleados de Odoo por correo electrónico.
- Categorías — crea en Odoo un producto de gasto por cada categoría de OkTicket, incluidas las variantes facturables, y rellena su tabla de impuestos con los criterios del IVA español que corresponden a esa categoría.
Y en sentido inverso, de Odoo a OkTicket:
- Centros de coste — publica cuentas analíticas de Odoo como centros de coste, desde una acción en la lista de cuentas analíticas o automáticamente al crear un proyecto, para poder imputar un ticket desde el móvil.
Está construido sobre el framework connector de la OCA:
cada entidad tiene un modelo binding que mantiene la correspondencia entre el registro de Odoo
y su identificador remoto.
| Documento | Para quién | Contenido |
|---|---|---|
| Manual técnico · descargar PDF | Implantadores y administradores | Clonado del repositorio, dependencias, instalación de los módulos, grupos y permisos, configuración de la compañía y del backend, acciones planificadas, hojas de gasto y sincronización de estados, centros de coste, multi-compañía y resolución de problemas. |
| Manual de usuario · descargar PDF | Usuarios finales | Cómo llegan los gastos, dónde consultarlos, qué añade el conector a la ficha del gasto, adjuntos, hojas de gasto, categorías, empleados, cuentas analíticas y centros de coste, y dudas frecuentes. |
Los enlaces del título se leen aquí mismo. El PDF es la versión maquetada, pensada para imprimir
o enviar al cliente. También existe el .html de cada manual
(técnico ·
usuario), que es la fuente con la que se genera el
PDF; los visores lo descargan en vez de renderizarlo.
| Módulo | Descripción |
|---|---|
okticket_connector |
Base del conector: backend de configuración, cliente HTTP con OAuth, registro de eventos e importación de gastos. Obligatorio. |
okticket_connector_user_synchronization |
Importa los usuarios de OkTicket y los vincula con empleados de Odoo. |
okticket_connector_product_synchronization |
Importa el árbol de categorías de OkTicket como productos de gasto. |
okticket_connector_cost_center |
Publica cuentas analíticas de Odoo como centros de coste en OkTicket. |
okticket_connector_hr_expense_sheet |
Agrupa los gastos importados en hojas de gasto y sincroniza sus estados con OkTicket. |
okticket_connector_hr_expense_sheet_grouping |
Métodos de agrupación de los gastos en hojas: por cuenta analítica, estándar, individual o sin agrupar. |
okticket_hr_expense_reporting |
Informes PDF de gastos y hojas de gasto con las imágenes de los recibos. |
okticket_hr_timesheet_cost_center |
Evita una sincronización espuria al crear una compañía nueva con hr_timesheet. Opcional. |
El conector reúne los gastos importados en hojas de gasto. Tres módulos añaden ese flujo por encima de la importación:
- Agrupación — los gastos importados se reúnen en hojas de gasto según el método elegido en la compañía (por cuenta analítica, estándar, hoja individual o sin agrupar) y el intervalo temporal configurado.
- Sincronización de estados — al enviar o aprobar una hoja en Odoo, el conector marca los gastos como contabilizados en OkTicket y actualiza el estado del informe; los cambios viajan en ambos sentidos.
- Informes — genera informes PDF de gastos y hojas incorporando las imágenes de los recibos.
Un gasto importado nunca lleva IVA. La ley solo deja deducir el IVA soportado con una factura (art. 97 de la Ley 37/1992), y Odoo contabiliza como deducible cualquier impuesto que lleve un gasto: acabaría en la 472 y en el modelo 303 sin pasar por el SII. El gasto entra por su total y el desglose que manda OkTicket se guarda en el propio gasto. La tabla de impuestos que se describe a continuación es la que se usa al registrar el justificante como factura de proveedor.
OkTicket no envía un impuesto: envía un porcentaje. Un plan contable español trae doce impuestos de
compra por cada tipo, y en Odoo 16 no hay forma de distinguirlos automáticamente: sobre el plan
PGCE PYMEs 2008 el campo tax_scope está vacío en los 46 impuestos y los tres candidatos base de
cada tipo comparten grupo y cuenta.
Por eso el conector escribe él mismo la tabla de impuestos de cada producto, con lo que dice la Ley 37/1992 para esa categoría: 10 % de servicios en un taxi, 21 % de bienes en un repostaje, 0 % exento en un vuelo internacional y 0 % no sujeto en un tren transfronterizo. Se rellena en cada sincronización de productos, solo crea lo que falta y no vuelve a tocar lo que haya editado una persona.
El manual técnico detalla los criterios categoría por categoría, con su base legal, y lo que queda deliberadamente fuera: la categoría Otros, las categorías propias del cliente, los gastos no deducibles y los territorios con IGIC o IPSI.
cd /opt/odoo/addons
# el conector
git clone --branch 16.0 https://github.com/Alialabs/connector-okticket.git
# dependencias OCA
git clone --branch 16.0 https://github.com/OCA/connector.git
git clone --branch 16.0 https://github.com/OCA/queue.git
# dependencia Python
pip install -r connector-okticket/requirements.txtAñade las rutas a addons_path, reinicia Odoo e instala los módulos:
odoo -d <base_de_datos> --stop-after-init \
-i okticket_connector,okticket_connector_user_synchronization,\
okticket_connector_product_synchronization,okticket_connector_cost_center,\
okticket_connector_hr_expense_sheet,okticket_connector_hr_expense_sheet_grouping,\
okticket_hr_expense_reportingEl módulo okticket_hr_timesheet_cost_center es opcional y solo hace falta si se crean compañías
nuevas con hr_timesheet.
Después hay que configurar el identificador de compañía, el backend con las credenciales que facilita OkTicket, y activar las tres acciones planificadas —que se instalan desactivadas a propósito. El manual técnico lo detalla paso a paso.
Las credenciales de la API son secretos de producción. No las escribas en documentación, capturas ni ficheros versionados.
Una rama por versión de Odoo: 19.0, 18.0, 16.0, 16.0, 15.0, 14.0, 12.0, 10.0.
Usa siempre la que corresponda a tu instancia.
Las incidencias y propuestas se gestionan en el repositorio interno de Alia. Para cualquier consulta, escribe a contacto@alialabs.com.
AGPL-3. Copyright © Alia Technologies, S.L.
Alia Technologies S.L.
Rúa Nova 8, Ourense · 988 319 612
contacto@alialabs.com ·
alialabs.com