Odoo 20.0 Community · Persistente

pos.config: campos, relaciones y API

El modelo pos.config («Configuración del TPV») es un modelo persistente declarado por el módulo Punto de venta y ampliado por 16 módulos más. Expone 150 campos, 144 de ellos declarados directamente en el modelo; 17 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.config
Etiqueta: Configuración del TPV
Tipo: Persistente (models.Model)
Tabla SQL: pos_config
Módulo de origen: Punto de venta (point_of_sale)
Ampliado por: l10n_fr_pos_cert, pos_adyen, pos_bancontact_pay, pos_discount, pos_event, pos_sale, pos_hr, pos_restaurant, pos_loyalty, pos_stock, pos_online_payment, pos_self_order, pos_online_payment_self_order, pos_self_order_bancontact_pay, pos_self_order_event, pos_sms
Hereda de (mixins): pos.bus.mixin pos.load.mixinhr.mixin

Campos del modelo

144 campos propios, 0 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

150 de 150 campos mostrados

Nombre técnico	Etiqueta	Tipo	Detalles
access_token	Token de acceso	`char`
active	Activo	`boolean`
adyen_ask_customer_for_tip	Solicitar propina a los clientes	`boolean`	añadido por POS Adyen (`pos_adyen`)
amount_authorized_diff	Importe de la diferencia permitida Este campo representa la diferencia máxima permitida entre el saldo final y el efectivo teórico al cerrar una sesión, para usuarios no administradores de TPV. Si se alcanza este máximo, el usuario tendrá un mensaje de error en el cierre de su sesión diciendo que él tiene que ponerse en contacto con su gerente.	`float`
auto_validate_electronic_payment	Validación automática de pagos electrónicos Valida automáticamente los pedidos pagados con un método de pago electrónico (terminales, códigos QR, etc.).	`boolean`
available_preset_ids	Ajustes preestablecidos disponibles	`many2many` → pos.preset
available_pricelist_ids	Listas de precio disponibles Disponer de varias listas de precios disponibles en el punto de venta. También puede aplicar una lista de precios para clientes específicos desde su formulario de contacto (en la pestaña de Ventas). Para ser válida, esta lista de precios tiene que enumerarse aquí como una lista de los precios disponibles. De lo contrario, se aplicará la lista de precios por defecto.	`many2many` → product.pricelist
basic_receipt	Ticket regalo Imprime el vale regalo sin precios. Se puede utilizar para regalos.	`boolean`
cash_control	Control de efectivo avanzado Revise la cantidad en la caja al inicio y al cierre.	`boolean`	calculado
cash_rounding	Redondeo total	`boolean`
cashier_employee_ids	Employees with cashier level access Full register access. Can process sales, discounts, refunds, and close out payments.	`many2many` → hr.employee	añadido por POS - HR (`pos_hr`)
closing_journal_id	Closing Journal Journal used specifically for PoS session closing and reverse entries	`many2one` → account.journal	obligatoriocalculado, almacenado
company_has_template	La compañía tiene un plan contable	`boolean`	calculado
company_id	Compañía	`many2one` → res.company	obligatorio
crm_team_id	Equipo de ventas Las ventas de este punto de venta estarán relacionadas con este equipo de ventas.	`many2one` → crm.team	añadido por POS - Sales (`pos_sale`)
currency_id	Moneda	`many2one` → res.currency	calculado, almacenado
current_cash_register_balance	Cash Register	`float`	calculado
current_session_id	Sesión actual	`many2one` → pos.session	calculado
current_session_state	Estado de la sesión actual	`char`	calculado
current_user_id	Responsable de la sesión actual	`many2one` → res.users	calculado
custom_email	Correo electrónico	`char`
custom_logo	Logotipo	`image`
custom_logo_name	Nombre del logotipo	`char`
custom_phone	N.º de teléfono	`char`
custom_receipt_address	Dirección	`char`
custom_website	Sitio web	`char`
customer_display_bg_img	Imagen de fondo	`image`
customer_display_bg_img_name	Nombre de la imagen de fondo	`char`
default_bill_ids	Monedas/billetes	`many2many` → pos.bill
default_fiscal_position_id	Posición fiscal por defecto	`many2one` → account.fiscal.position
default_partner_id	Default Customer The default customer used in PoS session closing	`many2one` → res.partner	obligatorio
default_preset_id	Preajuste por defecto	`many2one` → pos.preset
default_product_id	Producto predeterminado Este producto se utilizará como producto predeterminado en las líneas del pedido de venta sin un producto.	`many2one` → product.product	obligatorio añadido por POS - Sales (`pos_sale`)
default_screen	Pantalla por defecto	`selection`	Valores: `tables` (Tablas), `register` (Caja) añadido por Restaurante (`pos_restaurant`)
device_seq_id	Secuencia del dispositivo	`many2one` → ir.sequence	solo lectura
discount_pc	Discount Value The default discount value when clicking on the Discount button	`float`	añadido por Point of Sale Discounts (`pos_discount`)
discount_product_id	Producto de descuento El producto usado para aplicar el descuento en el recibo.	`many2one` → product.product	añadido por Point of Sale Discounts (`pos_discount`)
down_payment_product_id	Producto de anticipo Este producto se usará como anticipo en un pedido de venta.	`many2one` → product.product	obligatorio añadido por POS - Sales (`pos_sale`)
email	Correo electrónico del ticket	`char`	calculado, almacenado
fallback_nomenclature_id	Nomenclatura alternativa	`many2one` → barcode.nomenclature
fast_payment_method_ids	Métodos de pago rápidos Estos métodos de pago estarán disponibles para pagos rápidos	`many2many` → pos.payment.method	calculado, almacenado
fiscal_position_ids	Posiciones fiscales Esto es útil para los restaurantes que cuentan con servicio para llevar y para consumir allí, y que suponen tipos impositivos específicos.	`many2many` → account.fiscal.position
floor_ids	Salas del restaurante Las salas del restaurante asignadas a este punto de venta.	`many2many` → restaurant.floor	añadido por Restaurante (`pos_restaurant`)
floor_plan	Plano de sala	`json`	calculado añadido por Restaurante (`pos_restaurant`)
floor_plan_settings	Configuración del plano de sala	`json`	añadido por Restaurante (`pos_restaurant`)
group_pos_manager_id	Grupo de gerente del punto de venta Este campo se encuentra aquí para pasar el identificador del grupo de gerentes del TPV al cliente del punto de venta.	`many2one` → res.groups
group_pos_user_id	Grupo de usuario del punto de venta Este campo se encuentra aquí para pasar el identificador del grupo de usuarios del punto de venta al cliente del punto de venta.	`many2one` → res.groups
has_active_session	Tiene una sesión activa	`boolean`	calculado
has_paper	Tiene papel	`boolean`	añadido por POS Self Order (`pos_self_order`)
iface_available_categ_ids	Categorías de productos TPV disponibles El punto de venta solo mostrará los productos que se encuentren dentro de uno de los árboles de categorías seleccionados. Si no se especifica ninguna categoría, se mostrarán todos los productos disponibles	`many2many` → pos.category
iface_big_scrollbars	Barras de desplazamiento grandes Para pantallas táctiles industriales imprecisas.	`boolean`
iface_discount	Descuentos de pedidos Permita al cajero ofrecer descuentos en todo el pedido.	`boolean`	añadido por Point of Sale Discounts (`pos_discount`)
iface_group_by_categ	Agrupar productos por categorías Mostrar productos agrupados por categorías.	`boolean`
iface_print_auto	Impresión automática del recibo El recibo se imprimirá automáticamente al final de cada pedido.	`boolean`
iface_printbill	Impresión de la cuenta Permite imprimir la cuenta antes de pagar.	`boolean`
iface_tax_included	Visualización de impuestos	`selection`	obligatorio Valores: `subtotal` (Precios sin impuestos), `total` (Precio con impuestos incluidos)
iface_tipproduct	Propinas de productos	`boolean`
is_installed_account_accountant	Contabilidad está totalmente instalada	`boolean`	calculado
is_margins_costs_accessible_to_every_user	Márgenes y costes Cuando se deshabilita, solo el gerente del TPV puede ver el margen y el coste del producto entre la información del producto.	`boolean`
journal_id	Diario de punto de venta Journal used for customer invoices and refunds credit notes.	`many2one` → account.journal
kanban_dashboard_graph	Gráfico del tablero kanban	`text`	calculado
last_data_change	Fecha de la última edición	`datetime`	solo lecturacalculado, almacenado
last_session_closing_date	Fecha del cierre de la última sesión	`date`	calculado
limit_categories	Restringir categorías	`boolean`
logged_employee_ids	Logged Employee All employees who have logged into the current session	`many2many` → hr.employee	solo lectura related: `current_session_id.logged_employee_ids` añadido por POS - HR (`pos_hr`)
logo	Logotipo del ticket	`image`	calculado, almacenado
manager_employee_ids	Employees with manager level access Full access, including reporting, cash management, and session close.	`many2many` → hr.employee	añadido por POS - HR (`pos_hr`)
manual_discount	Línea de descuentos	`boolean`
module_pos_appointment	Reserva en línea	`boolean`
module_pos_avatax	Integración entre AvaTax y TPV Use el mapeo automático de impuestos con AvaTax en el TPV	`boolean`
module_pos_discount	Descuentos globales	`boolean`
module_pos_hr	Módulo PdV RR. HH. Mostrar pantalla de inicio de sesión de empleado	`boolean`
module_pos_restaurant	Es un bar/restaurante	`boolean`
module_pos_sms	SMS habilitado Active la función de SMS para point_of_sale	`boolean`
name	Punto de venta Una identificación interna del punto de venta.	`char`	obligatoriotraducible
note_ids	Modelos de nota Las notas predefinidas de este punto de venta.	`many2many` → pos.note
only_round_cash_method	Solo aplique redondeo en efectivo	`boolean`
order_backend_seq_id	Secuencia del back-end de pedidos	`many2one` → ir.sequence	solo lectura
order_line_seq_id	Secuencia de líneas de pedido	`many2one` → ir.sequence	solo lectura
order_seq_id	Secuencia de pedidos	`many2one` → ir.sequence	solo lectura
other_devices	Otros dispositivos Conecta impresoras a tu PdV.	`boolean`
payment_method_ids	Métodos de pago	`many2many` → pos.payment.method
phone	Teléfono del ticket	`char`	calculado, almacenado
picking_policy	Política de envío Si entregas todos los productos a la vez, el albarán se programará teniendo en cuenta el plazo de entrega más largo. De lo contrario, se programará según el más corto.	`selection`	obligatorio Valores: `direct` (Lo antes posible, con entregas parciales), `one` (Cuando todos los productos estén listos) añadido por PoS - Stock (`pos_stock`)
picking_type_id	Tipo de operación	`many2one` → stock.picking.type	obligatorio añadido por PoS - Stock (`pos_stock`)
pos_session_duration	Duración de la sesión de TPV	`char`	calculado
pos_session_state	Estado de la sesión de TPV	`char`	calculado
pos_session_username	Nombre de usuario de la sesión de TPV	`char`	calculado
pos_snooze_ids	Snoozed Records	`one2many` → pos.snooze	inverso: `pos_config_id`
preparation_devices	Dispositivos de preparación Conecta las impresoras de preparación para imprimir en la barra, la cocina, etc.	`boolean`
preparation_printer_ids	Impresoras de preparación	`many2many` → pos.printer
pricelist_id	Lista de precios por defecto La lista de precios que se utiliza si no se selecciona un cliente o si los clientes no tienen una lista de precios de venta configurada.	`many2one` → product.pricelist
receipt_address	Dirección del ticket	`char`	calculado, almacenado
receipt_footer	Pie del recibo Un texto corto que se insertará como pie de página en el recibo impreso.	`text`
receipt_header	Encabezado del recibo Un texto corto que se insertará como encabezado de página en el recibo impreso.	`text`
receipt_printer_ids	Impresoras de recibos	`many2many` → pos.printer
restrict_price_control	Restringir las modificaciones de los precios a los gerentes Solo los usuarios con permisos de acceso de gerente en la aplicación Punto de Venta pueden modificar los precios de los productos en los pedidos.	`boolean`
restrictive_employee_ids	Employees with restrictive level access Can process sales and close payments, but not apply discounts, refunds, or cancel orders.	`many2many` → hr.employee	añadido por POS - HR (`pos_hr`)
rounding_method	Método de redondeo	`many2one` → account.cash.rounding
route_id	Ruta específica para productos entregados más tarde.	`many2one` → stock.route	añadido por PoS - Stock (`pos_stock`)
self_order_online_payment_method_id	Autopago en línea El método de pago en línea a usar cuando el cliente realice una compra en línea.	`many2one` → pos.payment.method	añadido por POS Self-Order / Online Payment (`pos_online_payment_self_order`)
self_ordering_available_language_ids	Idiomas disponibles Idiomas disponibles para el modo quiosco	`many2many` → res.lang	añadido por POS Self Order (`pos_self_order`)
self_ordering_default_language_id	Idioma predeterminado Idioma predeterminado para el modo quiosco	`many2one` → res.lang	añadido por POS Self Order (`pos_self_order`)
self_ordering_default_user_id	Usuario predeterminado Los permisos de acceso de este usuario se utilizarán al visitar el sitio web de autopedido cuando no haya ninguna sesión abierta.	`many2one` → res.users	añadido por POS Self Order (`pos_self_order`)
self_ordering_image_background_ids	Establecer la imagen de fondo Imagen que se mostrará en el fondo	`many2many` → ir.attachment	añadido por POS Self Order (`pos_self_order`)
self_ordering_image_brand	Imagen de marca del quiosco de autoservicio Imagen que se mostrará en la pantalla de autoservicio	`image`	añadido por POS Self Order (`pos_self_order`)
self_ordering_image_brand_name	Nombre de la imagen de marca del quiosco de autoservicio Nombre de la imagen que se mostrará en la pantalla de autoservicio	`char`	añadido por POS Self Order (`pos_self_order`)
self_ordering_image_home_ids	Añadir archivo multimedia Elementos multimedia que se mostrarán en la pantalla de autopedido	`many2many` → ir.attachment	añadido por POS Self Order (`pos_self_order`)
self_ordering_mode	Modo de autopedido Elegir el modo de autopedido	`selection`	obligatorio Valores: `nothing` (Deshabilitar), `consultation` (Menú QR), `mobile` (Menú QR + Pedidos), `kiosk` (Quiosco) añadido por POS Self Order (`pos_self_order`)
self_ordering_pay_after	Pagar después: Elegir cuándo pagará el cliente	`selection`	obligatorio Valores calculados dinámicamente añadido por POS Self Order (`pos_self_order`)
self_ordering_primary_color	Color	`char`	añadido por POS Self Order (`pos_self_order`)
self_ordering_service_mode	Modo de autoservicio Seleccionar el modo quiosco	`selection`	obligatorio Valores: `counter` (Zona de recogida), `table` (Tabla), `dynamic_qr` (Dynamic QR) añadido por POS Self Order (`pos_self_order`)
self_ordering_url	URL para autopedido	`char`	calculado añadido por POS Self Order (`pos_self_order`)
session_closing_daily_hour	Daily Closing Hour The hour at which the session will be automatically closed when the closing mode is set to 'Daily'.	`float`
session_closing_mode	Closing Mode	`selection`	solo lectura Valores: `daily` (Diariamente), `closing` (At closing)
session_ids	Sesiones	`one2many` → pos.session	inverso: `config_id`
set_maximum_difference	Establecer la diferencia máxima Establezca una diferencia máxima permitida entre el dinero esperado y el dinero contado durante el cierre de la sesión.	`boolean`
set_tip_after_payment	Establecer una propina después del pago Ajusta la cantidad autorizada por los terminales de pago para añadir una propina una vez que el cliente se haya marchado o al final del día.	`boolean`
ship_later	Enviar más tarde	`boolean`	añadido por PoS - Stock (`pos_stock`)
show_category_images	Mostrar imágenes de la categoría Mostrar las imágenes de la categoría en la interfaz de punto de venta.	`boolean`
show_product_images	Mostrar imágenes del producto Muestre imágenes del producto en la interfaz del TPV.	`boolean`
sms_receipt_template_id	Plantilla de ticket por SMS El cliente recibirá un SMS basado en esta plantilla	`many2one` → sms.template	añadido por POS - SMS (`pos_sms`)
statistics_for_current_session	Estadísticas de sesión	`json`	calculado
status	Estado	`selection`	calculado Valores: `inactive` (Inactivo), `active` (Activo) añadido por POS Self Order (`pos_self_order`)
supervised_employee_ids	Employees with supervised level access Can process sales, but a higher level must approve before payment is closed	`many2many` → hr.employee	añadido por POS - HR (`pos_hr`)
tax_regime_selection	Valor de la selección del régimen fiscal	`boolean`
tip_percentage_1	Porcentaje de propina 1	`integer`
tip_percentage_2	Porcentaje de propina 2	`integer`
tip_percentage_3	Porcentaje de propina 3	`integer`
tip_product_id	Producto de propina Este producto se utiliza como referencia en los recibos del cliente.	`many2one` → product.product
trusted_config_ids	Ajustes del TPV de confianza	`many2many` → pos.config
use_closing_entry_by_product	Asiento de cierre por producto Muestre el desglose de las líneas de venta por producto en el asiento de cierre que se genera automáticamente.	`boolean`
use_course_allocation	Activar la asignación de pases	`boolean`	añadido por Restaurante (`pos_restaurant`)
use_custom_receipt_info	Personalizar información Rellena este campo si la información de tu tienda es distinta de la de tu empresa	`boolean`
use_download_invoice	Descargar factura Descarga automáticamente el PDF de la factura al facturar un pedido.	`boolean`
use_fast_payment	Validación rápida de pagos Activa métodos de pago rápidos para validar pedidos en la pantalla del producto.	`boolean`
use_header_or_footer	Encabezado y pie de página personalizado	`boolean`
use_order_printer	Impresora de pedidos	`boolean`
use_presets	Utilizar ajustes preestablecidos	`boolean`
use_pricelist	Utilice una lista de precios.	`boolean`
use_show_items_on_course_ticket	Show Items on Fired Course Ticket Show items again on the fired course ticket in preparation printer	`boolean`	añadido por Restaurante (`pos_restaurant`)
uuid	UUID Un identificador único global para esta configuración del TPV, usado para prevenir conflictos en datos generados por el cliente.	`char`	solo lectura
warehouse_id	Almacén	`many2one` → stock.warehouse	calculado, almacenado añadido por PoS - Stock (`pos_stock`)
website	Sitio web del ticket	`char`	calculado, almacenado
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.cash.rounding: rounding_method
account.fiscal.position: default_fiscal_position_id, fiscal_position_ids
account.journal: closing_journal_id, journal_id
barcode.nomenclature: fallback_nomenclature_id
crm.team: crm_team_id
hr.employee: cashier_employee_ids, logged_employee_ids, manager_employee_ids, restrictive_employee_ids, supervised_employee_ids
ir.attachment: self_ordering_image_background_ids, self_ordering_image_home_ids
ir.sequence: device_seq_id, order_backend_seq_id, order_line_seq_id, order_seq_id
pos.bill: default_bill_ids
pos.category: iface_available_categ_ids
pos.config: trusted_config_ids
pos.note: note_ids
pos.payment.method: fast_payment_method_ids, payment_method_ids, self_order_online_payment_method_id
pos.preset: available_preset_ids, default_preset_id
pos.printer: preparation_printer_ids, receipt_printer_ids
pos.session: current_session_id, session_ids
pos.snooze: pos_snooze_ids
product.pricelist: available_pricelist_ids, pricelist_id
product.product: default_product_id, discount_product_id, down_payment_product_id, tip_product_id
res.company: company_id
res.currency: currency_id
res.groups: group_pos_manager_id, group_pos_user_id
res.lang: self_ordering_available_language_ids, self_ordering_default_language_id
res.partner: default_partner_id
res.users: current_user_id, self_ordering_default_user_id
restaurant.floor: floor_ids
sms.template: sms_receipt_template_id
stock.picking.type: picking_type_id
stock.route: route_id
stock.warehouse: warehouse_id

Campos de otros modelos que apuntan aquí

loyalty.program: pos_config_ids
pos_self_order.custom_link: pos_config_ids
pos.bill: pos_config_ids
pos.category: pos_config_ids
pos.config: trusted_config_ids
pos.details.wizard: pos_config_ids
pos.make.payment: config_id
pos.order: config_id
pos.payment.method: config_ids
pos.price.inclusion.wizard: config_id
pos.printer: pos_config_ids
pos.session: config_id
pos.snooze: pos_config_id
report.pos.order: config_id
res.config.settings: pos_config_id, pos_trusted_config_ids
restaurant.floor: pos_config_ids

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.config/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: su-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","closing_journal_id","company_id","default_partner_id","default_product_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.config/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","closing_journal_id","company_id","default_partner_id","default_product_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-config">pos.config (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