Odoo 20.0 Community · Persistente

pos.session: campos, relaciones y API

El modelo pos.session («Sesión TPV») es un modelo persistente declarado por el módulo Punto de venta y ampliado por 8 módulos más. Expone 65 campos, 34 de ellos declarados directamente en el modelo; 12 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 20.

Ver el código fuente Buscar otro modelo

Ficha de identidad

Nombre técnico: pos.session
Etiqueta: Sesión TPV
Tipo: Persistente (models.Model)
Tabla SQL: pos_session
Módulo de origen: Punto de venta (point_of_sale)
Ampliado por: l10n_fr_pos_cert, pos_event, pos_sale, pos_hr, pos_restaurant, pos_loyalty, pos_stock, pos_self_order
Orden por defecto (_order): id desc
Hereda de (mixins): mail.thread mail.activity.mixin pos.bus.mixin pos.load.mixin

Campos del modelo

34 campos propios, 25 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

65 de 65 campos mostrados

Nombre técnico	Etiqueta	Tipo	Detalles
account_move_count	Number of related journal entries	`integer`	calculado
bank_statement_id	Extracto bancario	`many2one` → account.bank.statement	solo lectura
bank_statement_line_ids	Bank Statement Lines	`one2many` → account.bank.statement.line	solo lectura related: `bank_statement_id.line_ids`
closing_balance	Closing Balance	`monetary`	solo lectura related: `bank_statement_id.balance_end_real`
closing_difference	Closing Difference	`monetary`	calculado
closing_notes	Notas de cierre	`text`
company_id	Compañía	`many2one` → res.company	solo lectura related: `config_id.company_id`
config_id	Punto de venta	`many2one` → pos.config	obligatorio
correction_move_ids	Correction Entries	`one2many` → account.move	inverso: `pos_session_correction_id`
crm_team_id	Equipo de ventas	`many2one` → crm.team	solo lectura related: `config_id.crm_team_id` añadido por POS - Sales (`pos_sale`)
currency_id	Moneda	`many2one` → res.currency	related: `config_id.currency_id`
employee_id	Cajero El empleado que utiliza la caja registradora en este momento	`many2one` → hr.employee	añadido por POS - HR (`pos_hr`)
failed_pickings	Pickings fallidos	`boolean`	calculado añadido por PoS - Stock (`pos_stock`)
is_in_company_currency	Está utilizando la moneda de la compañía	`boolean`	calculado
logged_employee_ids	Logged In Cashiers All employees who have logged into this session	`many2many` → hr.employee	calculado, almacenado añadido por POS - HR (`pos_hr`)
move_ids	Related Journal Entries	`many2many` → account.move	calculado
name	ID de la sesión	`char`	solo lectura
opening_balance	Saldo de apertura	`monetary`	solo lectura related: `bank_statement_id.balance_start`
opening_notes	Notas de apertura	`text`
order_count	Número de pedidos	`integer`	calculado
order_ids	Pedidos	`one2many` → pos.order	inverso: `session_id`
payment_method_ids	Métodos de pago	`many2many` → pos.payment.method	related: `config_id.payment_method_ids`
picking_count	Número de operaciones de inventario	`integer`	calculado añadido por PoS - Stock (`pos_stock`)
picking_ids	Albarán	`one2many` → stock.picking	inverso: `pos_session_id` añadido por PoS - Stock (`pos_stock`)
refund_move_count	Number of related refunds journal entries	`integer`	calculado
refund_move_ids	Refunds Entry	`one2many` → account.move	inverso: `pos_session_refunds_id`
sale_move_count	Number of related sales journal entries	`integer`	calculado
sale_move_ids	Sales Entry	`one2many` → account.move	inverso: `pos_session_sales_id`
start_at	Fecha de apertura	`datetime`	solo lectura
state	Estado	`selection`	obligatoriosolo lectura Valores: `opening_control` (Control de apertura), `opened` (En proceso), `closing_control` (Control de cierre), `closed` (Cerrado y registrado)
stop_at	Fecha de cierre	`datetime`	solo lectura
total_payments_amount	Importe total de pagos	`float`	calculado
update_stock_at_closing	El stock debe actualizarse al cierre	`boolean`	añadido por PoS - Stock (`pos_stock`)
user_id	Abierta por	`many2one` → res.users	obligatorio
access_token	Token de seguridad	`char`	heredado de pos.bus.mixin
activity_calendar_event_id	Siguiente evento en el calendario de actividades.	`many2one` → calendar.event	calculado heredado de mail.activity.mixin
activity_date_deadline	Fecha límite de la siguiente actividad	`date`	solo lecturacalculado heredado de mail.activity.mixin
activity_exception_decoration	Decoración de Actividad de Excepción Tipo de actividad de excepción en el registro.	`selection`	calculado Valores: `warning` (Alerta), `danger` (Error) heredado de mail.activity.mixin
activity_exception_icon	Icono Icono para indicar una actividad de excepción.	`char`	calculado heredado de mail.activity.mixin
activity_ids	Actividades	`one2many` → mail.activity	inverso: `res_id` heredado de mail.activity.mixin
activity_plans_ids	Planes de actividades	`many2many` → mail.activity.plan	calculado heredado de mail.activity.mixin
activity_state	Estado de la actividad Status based on activities Overdue: Due date is already passed Today: Activity date is today Planned: Future activities.	`selection`	calculado Valores: `overdue` (De retraso), `today` (Hoy), `planned` (Planificado) heredado de mail.activity.mixin
activity_summary	Resumen de la siguiente actividad	`char`	related: `activity_ids.summary` heredado de mail.activity.mixin
activity_type_icon	Icono de tipo de actividad	`char`	related: `activity_ids.icon` heredado de mail.activity.mixin
activity_type_id	Tipo de la siguiente actividad	`many2one` → mail.activity.type	related: `activity_ids.activity_type_id` heredado de mail.activity.mixin
activity_user_id	Usuario responsable	`many2one` → res.users	solo lecturacalculado heredado de mail.activity.mixin
has_message	Tiene un mensaje	`boolean`	calculado heredado de mail.thread
message_attachment_count	Número de archivos adjuntos	`integer`	calculado heredado de mail.thread
message_follower_ids	Seguidores	`one2many` → mail.followers	inverso: `res_id` heredado de mail.thread
message_has_error	Error de envío de mensaje Si está marcada, algunos mensajes tienen error de envío.	`boolean`	calculado heredado de mail.thread
message_has_error_counter	Número de errores Número de mensajes con error de envío	`integer`	calculado heredado de mail.thread
message_has_sms_error	Error de envío del SMS Si está marcada, algunos mensajes tienen error de envío.	`boolean`	calculado heredado de mail.thread
message_ids	Mensajes	`one2many` → mail.message	inverso: `res_id` heredado de mail.thread
message_is_follower	Es un seguidor	`boolean`	calculado heredado de mail.thread
message_needaction	Acción requerida Si está marcada, hay nuevos mensajes que requieren su atención.	`boolean`	calculado heredado de mail.thread
message_needaction_counter	Número de acciones Número de mensajes que requieren una acción	`integer`	calculado heredado de mail.thread
message_partner_ids	Seguidores (Contactos)	`many2many` → res.partner	calculado heredado de mail.thread
my_activity_date_deadline	Fecha límite de mi actividad	`date`	solo lecturacalculado heredado de mail.activity.mixin
rating_ids	Calificaciones	`one2many` → rating.rating	inverso: `res_id` heredado de mail.thread
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

account.bank.statement: bank_statement_id
account.bank.statement.line: bank_statement_line_ids
account.move: correction_move_ids, move_ids, refund_move_ids, sale_move_ids
crm.team: crm_team_id
hr.employee: employee_id, logged_employee_ids
pos.config: config_id
pos.order: order_ids
pos.payment.method: payment_method_ids
res.company: company_id
res.currency: currency_id
res.users: user_id
stock.picking: picking_ids

Campos de otros modelos que apuntan aquí

account.bank.statement.line: pos_session_id
account.move: pos_session_correction_id, pos_session_refunds_id, pos_session_sales_id
account.payment: pos_session_id
pos.config: current_session_id
pos.daily.sales.reports.wizard: pos_session_id
pos.order: session_id
pos.payment: session_id
pos.payment.method: open_session_ids
report.pos.order: session_id
stock.picking: pos_session_id

Leer este modelo por la API

Ejemplo de llamada a la API JSON-2 de Odoo 20: 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/pos.session/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: su-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","config_id","state","user_id","bank_statement_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}/pos.session/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","config_id","state","user_id","bank_statement_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/pos-session">pos.session (Odoo 20.0)</a>

Fuentes

Datos verificados el 25 de septiembre de 2026 · Odoo 20.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