Odoo 19.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 13 módulos más. Expone 130 campos, 124 de ellos declarados directamente en el modelo; 15 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: 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_discount, pos_event, pos_sale, pos_hr, pos_restaurant, pos_loyalty, pos_online_payment, pos_self_order, pos_online_payment_self_order, pos_self_order_qfpay, pos_sms
Hereda de (mixins): pos.bus.mixin pos.load.mixinhr.mixin

Campos del modelo

124 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

130 de 130 campos mostrados

Nombre técnico	Etiqueta	Tipo	Detalles
access_token	Token de acceso	`char`
active	Activo	`boolean`
advanced_employee_ids	Empleados con acceso de gerente Los empleados vinculados a usuarios con el rol de administrador de TPV se añaden automáticamente a esta lista	`many2many` → hr.employee	añadido por TPV - RR. HH. (`pos_hr`)
adyen_ask_customer_for_tip	Solicitar propina a los clientes	`boolean`	añadido por TPV 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_terminal_payment	Validar automáticamente el pago por terminal Valida automáticamente los pedidos pagados con una terminal de pago.	`boolean`
available_preset_ids	Preajustes 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_employee_ids	Empleados con acceso básico Si se deja vacío, todos los empleados pueden acceder al TPV	`many2many` → hr.employee	añadido por TPV - RR. HH. (`pos_hr`)
basic_receipt	Recibo básico Imprima un recibo básico sin precios. Es útil 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 de efectivo	`boolean`
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 TPV - Ventas (`pos_sale`)
currency_id	Moneda	`many2one` → res.currency	calculado, almacenado
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
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_preset_id	Preajuste por defecto	`many2one` → pos.preset
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	Porcentaje de descuento El porcentaje automático de descuento al hacer clic en el botón de descuento	`float`	añadido por Descuentos del punto de venta (`pos_discount`)
discount_product_id	Producto de descuento El producto usado para aplicar el descuento en el recibo.	`many2one` → product.product	añadido por Descuentos del punto de venta (`pos_discount`)
down_payment_product_id	Producto de anticipo Este producto se usará como anticipo en un pedido de venta.	`many2one` → product.product	añadido por TPV - Ventas (`pos_sale`)
epson_printer_ip	Dirección IP de la impresora Epson Dirección IP local de una impresora de recibos Epson, o su número de serie si la opción «Actualización automática de certificados» está habilitada en la configuración de la impresora.	`char`
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`)
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 Autopedido del TPV (`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_cashdrawer	Cajón portamonedas Abra automáticamente el cajón portamonedas.	`boolean`
iface_discount	Descuentos de pedidos Permita al cajero ofrecer descuentos en todo el pedido.	`boolean`	añadido por Descuentos del punto de venta (`pos_discount`)
iface_electronic_scale	Báscula electrónica Habilita la integración de una balanza electrónica.	`boolean`
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_print_skip_screen	Saltar pantalla de vista previa La pantalla del recibo se omitirá si el recibo se puede imprimir automáticamente.	`boolean`
iface_print_via_proxy	Imprimir vía Proxy Omita la impresión del navegador y las impresiones a través del proxy del hardware.	`boolean`
iface_printbill	Impresión de la cuenta Permite imprimir la cuenta antes de pagar.	`boolean`	añadido por Restaurante (`pos_restaurant`)
iface_scan_via_proxy	Escanear vía Proxy Habilita el escaneo de códigos de barras con un lector de códigos de barras conectado de forma remota y lee las tarjetas con un lector de tarjetas Vantiv.	`boolean`
iface_splitbill	Dividir la cuenta Permite dividir la cuenta en el punto de venta.	`boolean`	añadido por Restaurante (`pos_restaurant`)
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`
invoice_journal_id	Diario de factura Diario contable utilizado para crear facturas.	`many2one` → account.journal
is_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`
is_header_or_footer	Encabezado y pie de página personalizado	`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`
is_order_printer	Impresora de pedidos	`boolean`
is_posbox	PosBox	`boolean`
journal_id	Diario de punto de venta Diario contable utilizado para publicar los asientos de sesiones y pagos de TPV.	`many2one` → account.journal
last_data_change	Fecha de la última edición	`datetime`	solo lecturacalculado, almacenado
last_session_closing_cash	Efectivo en el cierre de la última sesión	`float`	calculado
last_session_closing_date	Fecha del cierre de la última sesión	`date`	calculado
limit_categories	Restringir categorías	`boolean`
manual_discount	Línea de descuentos	`boolean`
minimal_employee_ids	Empleados con acceso mínimo Si se deja vacío, todos los empleados pueden acceder al TPV	`many2many` → hr.employee	añadido por TPV - RR. HH. (`pos_hr`)
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`	obligatorio
note_ids	Modelos de nota Las notas predefinidas de este punto de venta.	`many2many` → pos.note
number_of_rescue_session	Número de sesión de rescate	`integer`	calculado
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_edit_tracking	Llevar seguimiento de los cambios de pedidos Almacene los pedidos editados en el backend	`boolean`
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 Conecte dispositivos a su TPV sin una IoT Box.	`boolean`
payment_method_ids	Métodos de pago	`many2many` → pos.payment.method
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), `one` (Cuando todos los productos estén listos)
picking_type_id	Tipo de operación	`many2one` → stock.picking.type	obligatorio
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
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
printer_ids	Impresoras de pedido	`many2many` → pos.printer
proxy_ip	Dirección IP El nombre de host o la dirección IP del proxy de hardware. Se detectarán automáticamente si los campos están vacíos.	`char`
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`
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`
rounding_method	Redondeo de efectivo	`many2one` → account.cash.rounding
route_id	Especifique la ruta para entregar los productos más tarde.	`many2one` → stock.route
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 Autopedido del TPV/Pago en línea (`pos_online_payment_self_order`)
self_ordering_available_language_ids	Idiomas disponibles Idiomas disponibles para el modo quiosco	`many2many` → res.lang	añadido por Autopedido del TPV (`pos_self_order`)
self_ordering_default_language_id	Idioma predeterminado Idioma predeterminado para el modo quiosco	`many2one` → res.lang	añadido por Autopedido del TPV (`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 Autopedido del TPV (`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 Autopedido del TPV (`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 Autopedido del TPV (`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 Autopedido del TPV (`pos_self_order`)
self_ordering_image_home_ids	Añadir imágenes Imagen que se mostrará en la pantalla de autoservicio	`many2many` → ir.attachment	añadido por Autopedido del TPV (`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 Autopedido del TPV (`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 Autopedido del TPV (`pos_self_order`)
self_ordering_service_mode	Modo de autoservicio Seleccionar el modo quiosco	`selection`	obligatorio Valores: `counter` (Zona de recogida), `table` (Mesa) añadido por Autopedido del TPV (`pos_self_order`)
self_ordering_url	URL para autopedido	`char`	calculado añadido por Autopedido del TPV (`pos_self_order`)
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`	añadido por Restaurante (`pos_restaurant`)
ship_later	Enviar más tarde	`boolean`
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 para recibo por SMS El cliente recibirá un SMS basado en esta plantilla	`many2one` → sms.template	añadido por TPV - 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 Autopedido del TPV (`pos_self_order`)
tax_regime_selection	Valor de la selección del régimen fiscal	`boolean`
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_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_presets	Utilizar preajustes	`boolean`
use_pricelist	Utilice una lista de precios.	`boolean`
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
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: invoice_journal_id, journal_id
barcode.nomenclature: fallback_nomenclature_id
crm.team: crm_team_id
hr.employee: advanced_employee_ids, basic_employee_ids, minimal_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: printer_ids
pos.session: current_session_id, session_ids
product.pricelist: available_pricelist_ids, pricelist_id
product.product: 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.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.printer: pos_config_ids
pos.session: 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 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/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","company_id","iface_tax_included","picking_policy","picking_type_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","company_id","iface_tax_included","picking_policy","picking_type_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 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