Odoo 20.0 Community · Persistent

pos.category: fields, relations and API

The pos.category model ("Point of Sale Category") is a persistent model declared by the Point of Sale module, then extended by 2 other modules. It exposes 21 fields, 15 of them declared directly on the model; 7 fields from other models point to it. Below you will find every field with its technical name, type, label and relations, followed by an Odoo 20 JSON-2 API call.

View source code Search another model

Model identity

Technical name: pos.category
Label: Point of Sale Category
Type: Persistent (models.Model)
SQL table: pos_category
Origin module: Point of Sale (point_of_sale)
Extended by: pos_restaurant, pos_self_order
Default order (_order): sequence, name
Display field (_rec_name): complete_name
Inherits from (mixins): pos.load.mixin

Model fields

15 own fields, 0 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.

Hide inherited fields

21 of 21 fields shown

Technical name	Label	Type	Details
active	Active	`boolean`
child_ids	Children Categories	`one2many` → pos.category	inverse: `parent_id`
color	Color	`integer`
complete_name	Complete Name	`char`	computed, stored
course_id	Course	`many2one` → pos.course	added by Restaurant (`pos_restaurant`)
has_image	Has Image	`boolean`	computed
hour_after	Availability After The product will be available after this hour for online order and self order.	`float`
hour_until	Availability Until The product will be available until this hour for online order and self order.	`float`
image_128	Image 128	`image`	related: `image_512`
image_512	Image	`image`
name	Category Name	`char`	requiredtranslatable
parent_id	Parent Category	`many2one` → pos.category
pos_config_ids	Linked PoS Configurations	`many2many` → pos.config
product_count	Product Count	`integer`	computed
sequence	Sequence Gives the sequence order when displaying a list of product categories.	`integer`
create_date	Created on	`datetime`	read-onlyautomatic
create_uid	Created by	`many2one` → res.users	read-onlyautomatic
display_name	Display Name	`char`	read-onlycomputedautomatic
id	ID	`integer`	read-onlyautomatic
write_date	Last Updated on	`datetime`	read-onlyautomatic
write_uid	Last Updated by	`many2one` → res.users	read-onlyautomatic

Relations

Models linked from this model

pos.category: child_ids, parent_id
pos.config: pos_config_ids
pos.course: course_id

Fields of other models pointing here

pos.category: parent_id
pos.config: iface_available_categ_ids
pos.printer: product_categories_ids
product.template: pos_categ_ids
report.pos.order: pos_categ_id
res.config.settings: pos_iface_available_categ_ids, pos_selectable_categ_ids

Reading this model through the API

Odoo 20 JSON-2 API call reading the first five records with real fields of the model. Replace the instance, database and API key with your own.

curl

curl -X POST "https://your-instance.odoo.com/json/2/pos.category/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: your-db" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["complete_name","name","course_id","parent_id","active"],"limit":5}'

Python (requests)

import requests

BASE_URL = "https://your-instance.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "your-db"}

res = requests.post(
    f"{BASE_URL}/pos.category/search_read",
    headers=headers,
    json={"domain": [], "fields": ["complete_name","name","course_id","parent_id","active"], "limit": 5},
)
res.raise_for_status()
print(res.json())

External API access requires Odoo's Custom plan.
XML-RPC and JSON-RPC will be removed in Odoo 22 (fall 2028): use JSON-2.
The access rights and record rules of the key's user apply.

Cite this tool

Writing a tutorial, internal documentation or a forum answer? Copy this link to send your readers to the up-to-date reference.

<a href="https://aidoo.ai/en/outils/explorateur-modeles-odoo/pos-category">pos.category (Odoo 20.0)</a>

Sources

Data verified on September 25, 2026 · Odoo 20.0 Community

Have an Odoo project, or want to put your ERP to work with AI? Let's talk

Implementation, custom module development, connecting Claude or ChatGPT to your data: tell us about your context and we will reply within 24 business hours.