> ## Documentation Index
> Fetch the complete documentation index at: https://docs.staffpass.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Odoo

> Módulo oficial para importar asientos de nómina de StaffPass en Odoo.

El conector oficial de Odoo es público en [Staff-Pass/staffpass-odoo-connector](https://github.com/Staff-Pass/staffpass-odoo-connector). Instálalo desde la rama que corresponda exactamente a la versión principal de tu servidor.

## Disponible en Odoo Apps

1. [Odoo 19](https://apps.odoo.com/apps/modules/19.0/staffpass_payroll_connector): publicado y gratuito.
2. [Odoo 18](https://apps.odoo.com/apps/modules/18.0/staffpass_payroll_connector): publicado y gratuito.

| Odoo | Rama   | Versión del módulo | Transporte              |
| ---- | ------ | ------------------ | ----------------------- |
| 19.0 | `19.0` | `19.0.1.0.0`       | JSON-2 autenticado      |
| 18.0 | `18.0` | `18.0.1.0.0`       | RPC externo autenticado |

Ambas ramas pasaron una instalación limpia contra la imagen oficial de Odoo y pruebas transaccionales de importación, idempotencia, rechazo de conflictos, validación contable y reversión. Esta evidencia valida el código del módulo; el administrador debe verificar su entorno y configuración.

## Qué hace

* recibe el asiento canónico de nómina generado por StaffPass;
* valida empresa, moneda, fecha, cuentas, centros de costo y balance;
* crea únicamente movimientos contables en borrador;
* evita duplicados con una identidad externa y un hash del contenido;
* conserva auditoría sin copiar el detalle personal de la nómina;
* genera reversiones idempotentes sin borrar el movimiento original.

El módulo no calcula nómina, no publica asientos, no guarda credenciales de StaffPass y no abre controladores anónimos.

## Requisitos

* Odoo.sh o una instalación administrada que permita módulos Python externos;
* plan de Odoo con acceso a la API externa;
* usuario técnico exclusivo, API key y acceso solo a las empresas autorizadas;
* diario general dedicado y cuentas contables configuradas;
* conexión HTTPS pública o túnel explícito para instalaciones privadas.

Odoo Online no permite instalar este tipo de módulo Python de terceros.

<Note>
  La API Enterprise de StaffPass también está disponible, pero es un producto separado del transporte Odoo: requiere plan Enterprise, `api_enabled` y un token de integración dedicado.
</Note>