Odoo 19.0 Community · Persistente

loyalty.program: campos, relaciones y API

El modelo loyalty.program («Programa de fidelización») es un modelo persistente declarado por el módulo Cupones y fidelidad y ampliado por 4 módulos más. Expone 44 campos, 37 de ellos declarados directamente en el modelo; 6 campos de otros modelos apuntan a él. A continuación encontrará cada campo con su nombre técnico, tipo, etiqueta en español y relaciones, y un ejemplo de llamada a la API JSON-2 de Odoo 19.

Ver el código fuente Buscar otro modelo

Ficha de identidad

Nombre técnico: loyalty.program
Etiqueta: Programa de fidelización
Tipo: Persistente (models.Model)
Tabla SQL: loyalty_program
Módulo de origen: Cupones y fidelidad (loyalty)
Ampliado por: pos_loyalty, sale_loyalty, sale_loyalty_delivery, website_sale_loyalty
Orden por defecto (_order): sequence
Campo mostrado (_rec_name): name
Hereda de (mixins): pos.load.mixin website.multi.mixin

Campos del modelo

37 campos propios, 1 heredados de mixins y 6 campos automáticos del ORM. Haga clic en un nombre para obtener el enlace directo al campo.

Ocultar los campos heredados

44 de 44 campos mostrados

Nombre técnico	Etiqueta	Tipo	Detalles
active	Activo	`boolean`
applies_on	Aplica en	`selection`	obligatoriocalculado, almacenado Valores: `current` (Pedido actual), `future` (Pedidos futuros), `both` (Pedidos actuales y futuros)
available_on	Disponible en Gestione dónde debería estar disponible su programa.	`boolean`
communication_plan_ids	Plan de comunicación	`one2many` → loyalty.mail	calculado, almacenado inverso: `program_id`
company_id	Compañía	`many2one` → res.company
coupon_count	Número de cupones	`integer`	calculado
coupon_count_display	Artículos	`char`	calculado
coupon_ids	Cupón	`one2many` → loyalty.card	inverso: `program_id`
currency_id	Moneda	`many2one` → res.currency	obligatoriocalculado, almacenado
currency_symbol	Currency Symbol	`char`	related: `currency_id.symbol`
date_from	Fecha de inicio La fecha de inicio está incluida en el periodo de validez de este programa	`date`
date_to	Fecha límite La fecha de finalización se incluye en el periodo de validez de este programa	`date`
ecommerce_ok	Disponible en el sitio web	`boolean`	añadido por Cupones, promociones, tarjetas de regalo y programa de fidelización para comercio electrónico (`website_sale_loyalty`)
is_nominative	Es nominativo	`boolean`	calculado
is_payment_program	Es un programa de pago	`boolean`	calculado
limit_usage	Límite de uso	`boolean`
mail_template_id	Plantillas de correo electrónico	`many2one` → mail.template	calculado
max_usage	Uso máximo	`integer`
name	Nombre del programa	`char`	obligatoriotraducible
order_count	Número de pedidos	`integer`	calculado añadido por Ventas fidelidad (`sale_loyalty`)
payment_program_discount_product_id	Producto de descuento Producto utilizado en el pedido de venta para aplicar el descuento.	`many2one` → product.product	solo lecturacalculado
portal_point_name	Nombre de punto del portal	`char`	calculado, almacenadotraducible
portal_visible	Portal visible Show in web portal, PoS customer ticket, eCommerce checkout, the number of points available and used by reward.	`boolean`
pos_config_ids	Punto de venta Limitar la publicación a esas tiendas. Nota: el programa solo se utilizará en las tiendas que operen con la misma divisa que el programa.	`many2many` → pos.config	calculado, almacenado añadido por Punto de venta - Cupones y fidelidad (`pos_loyalty`)
pos_ok	Punto de venta	`boolean`	añadido por Punto de venta - Cupones y fidelidad (`pos_loyalty`)
pos_order_count	Número de pedidos de TPV	`integer`	calculado añadido por Punto de venta - Cupones y fidelidad (`pos_loyalty`)
pos_report_print_id	Imprimir informe Se utiliza para imprimir tarjetas de regalo desde el TPV.	`many2one` → ir.actions.report	calculado añadido por Punto de venta - Cupones y fidelidad (`pos_loyalty`)
pricelist_ids	Lista de precios Este programa es específico a la lista de precios configurada.	`many2many` → product.pricelist
program_type	Tipo de programa	`selection`	obligatorio Valores: `coupons` (Cupones), `gift_card` (Tarjeta regalo), `loyalty` (Tarjetas de fidelidad), `promotion` (Promociones), `ewallet` (Monedero electrónico), `promo_code` (Código de descuento), `buy_x_get_y` (Comprar X y recibir Y), `next_order_coupons` (Cupones del próximo pedido)
reward_ids	Recompensas	`one2many` → loyalty.reward	calculado, almacenado inverso: `program_id`
rule_ids	Reglas condicionales	`one2many` → loyalty.rule	calculado, almacenado inverso: `program_id`
sale_ok	Ventas	`boolean`	añadido por Ventas fidelidad (`sale_loyalty`)
sequence	Secuencia	`integer`
show_non_published_product_warning	Mostrar advertencia de producto no publicado	`boolean`	calculado añadido por Cupones, promociones, tarjetas de regalo y programa de fidelización para comercio electrónico (`website_sale_loyalty`)
total_order_count	Número total de pedidos	`integer`	calculado
trigger	Activador Automatic: Customers will be eligible for a reward automatically in their cart. Use a code: Customers will be eligible for a reward if they enter a code.	`selection`	calculado, almacenado Valores: `auto` (Automático), `with_code` (Usar un código)
trigger_product_ids	Trigger Product	`many2many` → product.product	related: `rule_ids.product_ids`
website_id	Sitio web Restringir a un sitio web específico.	`many2one` → website	heredado de website.multi.mixin
create_date	Creado el	`datetime`	solo lecturaautomático
create_uid	Creado por	`many2one` → res.users	solo lecturaautomático
display_name	Nombre mostrado	`char`	solo lecturacalculadoautomático
id	ID	`integer`	solo lecturaautomático
write_date	Última actualización el	`datetime`	solo lecturaautomático
write_uid	Última actualización por	`many2one` → res.users	solo lecturaautomático

Relaciones

Modelos enlazados desde este modelo

ir.actions.report: pos_report_print_id
loyalty.card: coupon_ids
loyalty.mail: communication_plan_ids
loyalty.reward: reward_ids
loyalty.rule: rule_ids
mail.template: mail_template_id
pos.config: pos_config_ids
product.pricelist: pricelist_ids
product.product: payment_program_discount_product_id, trigger_product_ids
res.company: company_id
res.currency: currency_id

Campos de otros modelos que apuntan aquí

coupon.share: program_id
loyalty.card: program_id
loyalty.generate.wizard: program_id
loyalty.mail: program_id
loyalty.reward: program_id
loyalty.rule: program_id

Leer este modelo por la API

Ejemplo de llamada a la API JSON-2 de Odoo 19: lectura de los cinco primeros registros con campos reales del modelo. Sustituya la instancia, la base y la clave API por las suyas.

curl

curl -X POST "https://su-instancia.odoo.com/json/2/loyalty.program/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: su-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","applies_on","currency_id","program_type","company_id"],"limit":5}'

Python (requests)

import requests

BASE_URL = "https://su-instancia.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "su-base"}

res = requests.post(
    f"{BASE_URL}/loyalty.program/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","applies_on","currency_id","program_type","company_id"], "limit": 5},
)
res.raise_for_status()
print(res.json())

El acceso a la API externa está reservado al plan Custom de Odoo.
XML-RPC y JSON-RPC se retirarán en Odoo 22 (otoño de 2028): use JSON-2.
Se aplican los permisos de acceso y las reglas de registro del usuario de la clave.

Citar esta herramienta

¿Escribe un tutorial, una documentación interna o una respuesta en un foro? Copie este enlace para dirigir a sus lectores a la ficha actualizada.

<a href="https://aidoo.ai/es/outils/explorateur-modeles-odoo/loyalty-program">loyalty.program (Odoo 19.0)</a>

Fuentes

Datos verificados el 23 de septiembre de 2026 · Odoo 19.0 Community

¿Tiene un proyecto Odoo o quiere aprovechar su ERP con la IA? Hablemos

Implantación, desarrollo de módulos, conexión de Claude o ChatGPT a sus datos: cuéntenos su contexto y le responderemos en 24 horas laborables.

Contactarnos Ver una demo