Odoo 20.0 Community · Persistente

res.partner.bank: campos, relaciones y API

El modelo res.partner.bank («Cuenta bancaria») es un modelo persistente declarado por el módulo Base y ampliado por 4 módulos más. Expone 73 campos, 43 de ellos declarados directamente en el modelo; 16 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: res.partner.bank
Etiqueta: Cuenta bancaria
Tipo: Persistente (models.Model)
Tabla SQL: res_partner_bank
Módulo de origen: Base (base)
Ampliado por: account, account_qr_code_emv, account_qr_code_sepa, hr
Orden por defecto (_order): sequence, id
Campo mostrado (_rec_name): account_number
Hereda de (mixins): mail.thread mail.activity.mixin

Campos del modelo

43 campos propios, 24 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

73 de 73 campos mostrados

Nombre técnico	Etiqueta	Tipo	Detalles
account_number	Número de cuenta	`char`	obligatorio
account_type	Tipo Bank account type: Normal, IBAN, CLABE, or other from localization. Inferred from the bank account number.	`selection`	calculado Valores: `bank` (Normal)
active	Activo	`boolean`
allow_out_payment	Enviar dinero Con frecuencia se reciben correos que contienen facturas falsas con cuentas fraudulentas, a esta práctica se le llama phishing. Es importante verificar los nuevos números de cuenta y la mejor manera de hacerlo es llamar al proveedor, esto es esencial porque si esto llega a pasar, quiere decir que el correo del proveedor está en peligro. Una vez que haya comprobado que la información es correcta puede activar la función de enviar dinero.	`boolean`
bank_bic	BIC/SWIFT Código de identificación bancaria (BIC) para transferencias internacionales en el formato: Código bancario (4 letras) + Código del país (2 letras) + Código de ubicación (2 letras o números) + Código de sucursal opcional (3 letras o números).	`char`
bank_name	Nombre del banco	`char`
city	Ciudad	`char`
clearing_label_id	Clearing Label	`many2one` → clearing.label	obligatoriocalculado, almacenado
clearing_number	Número de compensación A clearing number (or routing number) refers to a bank, branch, or location and is used by domestic money transfer protocols (from/to bank accounts in the same country).	`char`
color	Color	`integer`	calculado
company_id	Compañía	`many2one` → res.company
company_qr_code	Company Qr Code	`boolean`	related: `company_id.qr_code` añadido por account_qr_code_emv (`account_qr_code_emv`)
country_code	Código de país	`char`	related: `country_id.code`
country_id	País	`many2one` → res.country	calculado, almacenado
country_proxy_keys	Claves proxy de país	`char`	calculado añadido por account_qr_code_emv (`account_qr_code_emv`)
currency_symbol	Currency Symbol	`char`	related: `employee_id.currency_id.symbol` añadido por Empleados (`hr`)
display_qr_setting	Mostrar ajustes QR	`boolean`	calculado añadido por account_qr_code_emv (`account_qr_code_emv`)
duplicate_bank_partner_ids	Duplicar contacto de banco	`many2many` → res.partner	calculado añadido por Facturación (`account`)
employee_has_multiple_bank_accounts	Employee Has Multiple Bank Accounts	`boolean`	related: `employee_id.has_multiple_bank_accounts` añadido por Empleados (`hr`)
employee_id	Empleado	`many2many` → hr.employee	calculado añadido por Empleados (`hr`)
employee_salary_amount	Asignación salarial	`float`	solo lecturacalculado añadido por Empleados (`hr`)
employee_salary_amount_is_percentage	El salario del empleado es un porcentaje	`boolean`	solo lecturacalculado añadido por Empleados (`hr`)
has_phishing_warnings	Has Phishing Warnings	`boolean`	calculado, almacenado añadido por Facturación (`account`)
holder_name	Holder Name Account holder name in case it is different than the name of the partner.	`char`	calculado, almacenado
include_reference	Incluir la referencia Incluya la referencia en el código QR.	`boolean`	añadido por account_qr_code_emv (`account_qr_code_emv`)
journal_id	Diario contable El diario contable que corresponde a esta cuenta bancaria.	`one2many` → account.journal	solo lectura inverso: `bank_account_id` añadido por Facturación (`account`)
lock_trust_fields	Bloquear campos de confianza	`boolean`	calculado añadido por Facturación (`account`)
note	Notas	`text`
partner_customer_rank	Partner Customer Rank	`integer`	related: `partner_id.customer_rank` añadido por Facturación (`account`)
partner_id	Contacto	`many2one` → res.partner	obligatorio
partner_supplier_rank	Partner Supplier Rank	`integer`	related: `partner_id.supplier_rank` añadido por Facturación (`account`)
phishing_warnings	Phishing Warnings Technical field used to display warnings if there's a potential phishing risk	`json`	calculado añadido por Facturación (`account`)
proxy_type	Account Identifier Type The identification method linked to this bank account (e.g., Mobile Number, Company ID) used to route QR payments to this account.	`selection`	Valores: `none` (Ninguno) añadido por account_qr_code_emv (`account_qr_code_emv`)
proxy_value	Identifier Value The specific number or ID linked to this bank account that matches the chosen Identifier Type.	`char`	añadido por account_qr_code_emv (`account_qr_code_emv`)
related_moves	Movimientos relacionados	`one2many` → account.move	inverso: `partner_bank_id` añadido por Facturación (`account`)
sanitized_account_number	Número de cuenta depurado	`char`	solo lecturacalculado, almacenado
sequence	Secuencia	`integer`
show_clearing_number	Show Clearing Number	`boolean`	calculado
state_id	Provincia	`many2one` → res.country.state
street	Calle	`char`
street2	Calle2	`char`
user_has_group_validate_bank_account	El usuario tiene un grupo para validar la cuenta bancaria	`boolean`	calculado añadido por Facturación (`account`)
zip	C.P.	`char`
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.journal: journal_id
account.move: related_moves
clearing.label: clearing_label_id
hr.employee: employee_id
res.company: company_id
res.country: country_id
res.country.state: state_id
res.partner: duplicate_bank_partner_ids, partner_id

Campos de otros modelos que apuntan aquí

account.journal: bank_account_id
account.move: partner_bank_id
account.payment: available_partner_bank_ids, available_return_partner_bank_ids, partner_bank_id, return_partner_bank_id
account.payment.register: available_partner_bank_ids, partner_bank_id, untrusted_bank_ids
account.setup.bank.manual.config: res_partner_bank_id
hr.bank.account.allocation.wizard.line: bank_account_id
hr.employee: bank_account_ids, primary_bank_account_id
payment.provider: partner_bank_id
res.users: bank_account_ids, employee_bank_account_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/res.partner.bank/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: su-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["account_number","clearing_label_id","partner_id","company_id","country_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}/res.partner.bank/search_read",
    headers=headers,
    json={"domain": [], "fields": ["account_number","clearing_label_id","partner_id","company_id","country_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/res-partner-bank">res.partner.bank (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