Qué hace la tarea en cada pasada

¿Qué es esta tarea y cada cuánto corre?
Es la tarea programada Octopia: descargar finanzas (operaciones, liquidaciones, facturas, DAC7) (Octopia: pull finance (operations, payouts, invoices, DAC7)). Corre una vez al día y viene activa al instalar el módulo. Existe en Odoo 17, 18, 19 y 20; en Odoo 17 lleva el valor que la repite sin fin. En Odoo 20, la tarea sigue los pasos y el orden que se describen a continuación.

¿Sobre qué cuentas trabaja y dónde las veo?
Solo sobre las cuentas de Octopia conectadas. Las fichas se abren desde Octopia › Configuración › Cuentas (Octopia › Configuration › Accounts). Según tus permisos ves unos tramos del menú u otros: Cuentas pide Administrador de Octopia (Octopia Admin), Configuración pide Gestor de Octopia (Octopia Manager) y Octopia pide Usuario de Octopia (Octopia User); si no tienes uno, no ves ese tramo.
¿En qué orden descarga?
Cuenta por cuenta: primero las operaciones, luego las liquidaciones, después las facturas nuevas y, al final, los informes DAC7. Si un paso de una cuenta falla del todo, los que quedaban para esa cuenta no se ejecutan en esa pasada. En los informes DAC7, la tarea pide la lista de informes de la cuenta y, por cada uno con identificador, lo crea o lo actualiza con canal de venta, nombre del canal, referencia del informe, código de país y año de validez.
¿Qué periodo pide y cómo evita duplicados?
Operaciones: las pide por fecha de cambio, desde la última fecha guardada menos 30 minutos (un pequeño solape) hasta el momento de la pasada; sin fecha guardada, retrocede 90 días. La nueva marca es la fecha de cambio más reciente que ha visto, no la hora de la pasada. Si una operación ya existe (misma referencia, mismos tipos de evento y misma fecha de creación), la actualiza en lugar de duplicarla. Liquidaciones: las pide por fecha de pago, desde la última guardada menos 2 días, o 365 días atrás si no hay marca; como no traen identificador, considera la misma liquidación la que coincide en fecha de pago, canal de venta e importe total. Lo que no se puede guardar se salta y se anota en el log del servidor.
¿Qué comprobación hace al terminar las operaciones?
Si Octopia indica el total de la ventana, se importó algo y ese total difiere en más de un céntimo de la suma de lo importado, la tarea marca el resultado como error, con un aviso de posible desfase de paginación que aconseja volver a descargar.

Facturas de comisión y facturas de proveedor
¿Qué hace con las facturas de comisión?
Tras operaciones y liquidaciones, la tarea mira las referencias de factura que traen las operaciones de la cuenta. Por cada referencia que aún no tiene ficha de factura en Odoo, crea una. A cada factura nueva le descarga las líneas de detalle (si ya tuviera líneas, las borra y las vuelve a crear) y el PDF, que guarda como adjunto de la factura cuando Octopia devuelve contenido. Las facturas que ya existían no entran en esta parte de la pasada.
¿Cuándo crea la factura de proveedor y cómo queda?
Solo si está marcada la casilla Crear facturas de proveedor de comisiones automáticamente (Auto-create Commission Vendor Bills), en la ficha de Cuentas de Octopia (Octopia Accounts), pestaña Automatización (Automation), grupo Contabilidad (Accounting). Su ayuda dice: Crear un borrador de factura de proveedor por cada factura de comisión de Octopia importada por la sincronización financiera. La tarea la aplica a las facturas nuevas de esa pasada, justo después de descargar su detalle y su PDF. Si la factura ya tenía factura de proveedor asociada, no crea otra; si no tenía líneas, las descarga antes. Los signos se conservan: las líneas de devolución o abono llegan en negativo y restan, y si el total neto sale negativo se crea una factura rectificativa de proveedor en lugar de una factura. La referencia es Factura de comisión de Octopia … (Octopia commission invoice …) seguida de la referencia de la factura de Octopia.
Si no hace nada
¿Por qué puede no hacer nada con una cuenta?
La tarea no hace nada con una cuenta en estos casos: la cuenta no está conectada, así que ni entra en la tarea; o la cuenta va a través de FlexigoTech Cloud y no tiene guardadas allí las credenciales, o no hay servicio según el permiso guardado. En ese caso la tarea no llama a Octopia con esa cuenta y pasa a la siguiente. Esa comprobación se hace sin red y no afecta a las cuentas con conexión directa. Si el servicio se pausa en mitad de una pasada, la tarea no marca nada, a FlexigoTech Cloud solo llega el código de la pausa y la siguiente ejecución continúa. Sin suscripción, o con el servicio suspendido, se para lo que da la suscripción; los datos se quedan en tu Odoo.
¿Qué pasa si falla una cuenta y qué reviso?
El error queda en el log del servidor de Odoo con el identificador de la cuenta y la tarea sigue con la siguiente cuenta. En la que falló, los pasos posteriores al fallo no se ejecutan en esa pasada; la tarea vuelve a correr en su siguiente ejecución diaria. Qué mirar: que la cuenta esté conectada, que tenga credenciales y servicio si va por FlexigoTech Cloud, que la casilla de facturas de proveedor esté marcada si esperabas borradores, que tus permisos te dejen ver el menú de cuentas y, si hay un fallo de descarga, el log del servidor.
¿Qué versiones, qué cuesta y quién puede ayudarme?
El módulo es de pago único por versión de Odoo y necesita la suscripción a FlexigoTech Cloud (plan Conector). Está publicado en Odoo Apps para 17, 18, 19 y 20 (consulta la ficha de Odoo Apps). En el Odoo App Store, cada versión de Odoo se compra allí. El plan Conector cuesta 49 €/mes o 490 €/año sin IVA, con hasta 3 cuentas de la plataforma. La conexión pasa por FlexigoTech Cloud, que guarda cifradas las credenciales, vigila la sincronización y avisa por correo si falla. Si necesitas implantar Odoo o una integración a medida, FlexigoTech implanta Odoo 17, 18, 19 y 20 y desarrolla conectores e integraciones a medida.
Sigue leyendo
Comprobado en el código del conector (versión 17.0 y 20.0) y en las fuentes enlazadas
Fuentes
- Código del módulo: flexigobe_octopia_connector 20.0 (4848da6a): data/octopia_cron_data.xml
- Código del módulo: flexigobe_octopia_connector 17.0 (c53d3736): data/octopia_cron_data.xml
- Código del módulo: flexigobe_octopia_connector 20.0 (4848da6a): models/octopia_finance.py
- Código del módulo: flexigobe_octopia_connector 20.0 (4848da6a): models/octopia_account.py
- apps.odoo.com/apps/modules/20.0/flexigobe_octopia_connector
- flexigotech.com/precios.html
- flexigotech.com/en/services.html
