🐍 ODOO · DESARROLLO · SECUENCIAS

Uso y creación de secuencias en Odoo

Las secuencias generan identificadores únicos para tus registros: INV/2023/0001, PER/05/0042. Con prefijos, sufijos, padding e incremento configurables.

1Componentes de una secuencia

📛 Prefijo / Sufijo

Texto estático o dinámico. Ej: INV/ + /2023.

🔢 Padding

Dígitos con ceros a la izquierda (padding=4 → 0001).

➕ Incremento

Paso entre números (default 1).

2Crear secuencias manuales

▸ Ruta: Ajustes  ›  Técnico  ›  Secuencias

Listado de secuencias en Ajustes técnicos

3Atributos de las secuencias

Atributo	Descripción
Código	Identificador único — se llama desde Python con `next_by_code()`.
Prefijo	Texto al inicio. Soporta variables: `PER/%(year)s/`
Sufijo	Texto al final. Ej: `/%(month)s` (mes actual 01-12).
Tamaño	Dígitos rellenados con ceros (4 → 0004).
Paso	Incremento entre números. Si es 2: 0001, 0003, 0005.
date_range	Sub-secuencias por período (reinicia anual: 2023/0001 → 2024/0001).
Implementación	Estándar (rápido, posibles saltos) o no_gap (sin saltos, con locks).

4Estándar vs no_gap

⚡ Estándar

Rápida, sin bloqueos estrictos. Si dos procesos piden número simultáneamente puede haber duplicados o saltos. Buena para modelos con poca actividad.

🔒 No_gap

Garantiza sin saltos usando bloqueos de BD hasta completar la transacción. Crítico para facturación y secuencias fiscales.

5Ejemplos de código

Crear secuencia desde XML

Código XML para crear una nueva secuencia

Obtener secuencia desde un modelo

Secuencia con date_range

📌 En resumen

Las secuencias en Odoo son la pieza estándar para generar identificadores únicos. Con prefijos dinámicos, padding, paso y date_range cubres casi cualquier caso. Para facturación o uso fiscal usa no_gap. Si tienes dudas escríbenos a info@exdoo.mx.

Uso y creación de secuencias