Odoo 19.0 Community · Persistent

pos.order: fields, relations and API

The pos.order model ("Point of Sale Orders") is a persistent model declared by the Point of Sale module, then extended by 12 other modules. It exposes 101 fields, 79 of them declared directly on the model; 15 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 19 JSON-2 API call.

View source code Search another model

Model identity

Technical name: pos.order
Label: Point of Sale Orders
Type: Persistent (models.Model)
SQL table: pos_order
Origin module: Point of Sale (point_of_sale)
Extended by: l10n_fr_pos_cert, pos_event, pos_sale, pos_hr, pos_restaurant, pos_loyalty, pos_mrp, pos_online_payment, pos_self_order, pos_online_payment_self_order, pos_restaurant_adyen, pos_sms
Default order (_order): date_order desc, name desc, id desc
Inherits from (mixins): portal.mixin pos.bus.mixin pos.load.mixin mail.thread

Model fields

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

Hide inherited fields

101 of 101 fields shown

Technical name	Label	Type	Details
account_move	Invoice	`many2one` → account.move	read-only
amount_difference	Difference	`monetary`	read-only
amount_paid	Paid	`monetary`	required
amount_return	Returned	`monetary`	requiredread-only
amount_tax	Taxes	`monetary`	requiredread-only
amount_total	Total	`monetary`	requiredread-only
attendee_count	Attendee Count	`integer`	computed added by POS - Event (`pos_event`)
available_payment_method_ids	Available Payment Methods	`many2many` → pos.payment.method	read-only related: `config_id.payment_method_ids`
cashier	Cashier name	`char`	computed, stored added by POS - HR (`pos_hr`)
company_id	Company	`many2one` → res.company	requiredread-only
config_id	Point of Sale	`many2one` → pos.config	computed, stored
country_code	Country Code	`char`	related: `company_id.account_fiscal_country_id.code`
course_ids	Courses	`one2many` → restaurant.order.course	inverse: `order_id` added by Restaurant (`pos_restaurant`)
crm_team_id	Sales Team	`many2one` → crm.team	added by POS - Sales (`pos_sale`)
currency_id	Currency	`many2one` → res.currency	related: `config_id.currency_id`
currency_rate	Currency Rate The rate of the currency to the currency of rate applicable at the date of the order	`float`	read-onlycomputed, stored
customer_count	Guests The amount of customers that have been served by this order.	`integer`	read-only added by Restaurant (`pos_restaurant`)
date_order	Date	`datetime`	read-only
email	Email	`char`	computed, stored
employee_id	Cashier The employee who uses the cash register.	`many2one` → hr.employee	added by POS - HR (`pos_hr`)
failed_pickings	Failed Pickings	`boolean`	computed
fiscal_position_id	Fiscal Position	`many2one` → account.fiscal.position
floating_order_name	Order Name	`char`
general_customer_note	General Customer Note	`text`
has_deleted_line	Has Deleted Line	`boolean`
has_refundable_lines	Has Refundable Lines	`boolean`	computed
internal_note	Internal Note	`text`
invoice_status	Invoice Status	`selection`	computed Values: `invoiced` (Fully Invoiced), `to_invoice` (To Invoice)
is_edited	Edited	`boolean`	computed
is_invoiced	Is Invoiced	`boolean`	computed
is_refund	Is Refund	`boolean`	read-only
is_tipped	Is this already tipped?	`boolean`	read-only
is_total_cost_computed	Is Total Cost Computed Allows to know if all the total cost of the order lines have already been computed	`boolean`	computed
l10n_fr_hash	Inalteralbility Hash	`char`	read-only added by France - VAT Anti-Fraud Certification for Point of Sale (CGI 286 I-3 bis) (`l10n_fr_pos_cert`)
l10n_fr_secure_sequence_number	Inalteralbility No Gap Sequence #	`integer`	read-only added by France - VAT Anti-Fraud Certification for Point of Sale (CGI 286 I-3 bis) (`l10n_fr_pos_cert`)
l10n_fr_string_to_hash	L10N Fr String To Hash	`char`	read-onlycomputed added by France - VAT Anti-Fraud Certification for Point of Sale (CGI 286 I-3 bis) (`l10n_fr_pos_cert`)
last_order_preparation_change	Last preparation change Last printed state of the order	`char`
lines	Order Lines	`one2many` → pos.order.line	inverse: `order_id`
margin	Margin	`monetary`	computed
margin_percent	Margin (%)	`float`	computed
mobile	Mobile	`char`	computed, stored
name	Order Ref	`char`	requiredread-only
nb_print	Number of Print	`integer`	read-only
next_online_payment_amount	Next online payment amount to pay	`float`	added by Point of Sale online payment (`pos_online_payment`)
online_payment_method_id	Online Payment Method	`many2one` → pos.payment.method	computed added by Point of Sale online payment (`pos_online_payment`)
order_edit_tracking	Order Edit Tracking	`boolean`	read-only related: `config_id.order_edit_tracking`
partner_id	Customer	`many2one` → res.partner
payment_ids	Payments	`one2many` → pos.payment	inverse: `pos_order_id`
picking_count	Picking Count	`integer`	computed
picking_ids	Picking	`one2many` → stock.picking	inverse: `pos_order_id`
picking_type_id	Operation Type	`many2one` → stock.picking.type	related: `session_id.config_id.picking_type_id`
pos_reference	Receipt Number	`char`	read-only
pos_version	Pos Version Version of Odoo that created the order	`char`	read-only added by France - VAT Anti-Fraud Certification for Point of Sale (CGI 286 I-3 bis) (`l10n_fr_pos_cert`)
preset_id	Preset	`many2one` → pos.preset
preset_time	Hour Hour of the day for the order	`datetime`
previous_order_id	Previous Order	`many2one` → pos.order	read-onlycomputed, stored added by France - VAT Anti-Fraud Certification for Point of Sale (CGI 286 I-3 bis) (`l10n_fr_pos_cert`)
pricelist_id	Pricelist	`many2one` → product.pricelist
refund_orders_count	Number of Refund Orders Number of orders where items from this order were refunded	`integer`	computed
refunded_order_id	Refunded Order Order from which items were refunded in this order	`many2one` → pos.order	computed
reversed_move_ids	Reversal Account Moves List of account moves created when this POS order was reversed and invoiced after session close.	`one2many` → account.move	inverse: `reversed_pos_order_id`
sale_journal	Sales Journal	`many2one` → account.journal	read-only related: `session_id.config_id.journal_id`
sale_order_count	Sale Order Count	`integer`	read-onlycomputed added by POS - Sales (`pos_sale`)
self_ordering_table_id	Table reference	`many2one` → restaurant.table	read-only added by POS Self Order (`pos_self_order`)
sequence_number	Sequence Number A session-unique sequence number for the order. Negative if generated from the client	`integer`
session_id	Session	`many2one` → pos.session
session_move_id	Session Journal Entry	`many2one` → account.move	read-only related: `session_id.move_id`
shipping_date	Shipping Date	`date`
source	Origin	`selection`	Values: `pos` (Point of Sale)
state	Status	`selection`	read-only Values: `draft` (New), `cancel` (Cancelled), `paid` (Paid), `done` (Posted)
stock_reference_ids	Reference	`many2many` → stock.reference
table_id	Table The table where this order was served	`many2one` → restaurant.table	read-only added by Restaurant (`pos_restaurant`)
table_stand_number	Table Stand Number	`char`	added by POS Self Order (`pos_self_order`)
ticket_code	Ticket Code 5 digits alphanumeric code to be used by portal user to request an invoice	`char`
tip_amount	Tip Amount	`monetary`	read-only
to_invoice	To invoice	`boolean`
tracking_number	Order Number	`char`	read-only
use_self_order_online_payment	Use Self Order Online Payment	`boolean`	read-onlycomputed, stored added by POS Self-Order / Online Payment (`pos_online_payment_self_order`)
user_id	Employee Employee who uses the cash register.	`many2one` → res.users
uuid	Uuid	`char`	read-only
access_token	Security Token	`char`	inherited from portal.mixin
access_url	Portal Access URL Customer Portal URL	`char`	computed inherited from portal.mixin
access_warning	Access warning	`text`	computed inherited from portal.mixin
has_message	Has Message	`boolean`	computed inherited from mail.thread
message_attachment_count	Attachment Count	`integer`	computed inherited from mail.thread
message_follower_ids	Followers	`one2many` → mail.followers	inverse: `res_id` inherited from mail.thread
message_has_error	Message Delivery error If checked, some messages have a delivery error.	`boolean`	computed inherited from mail.thread
message_has_error_counter	Number of errors Number of messages with delivery error	`integer`	computed inherited from mail.thread
message_has_sms_error	SMS Delivery error If checked, some messages have a delivery error.	`boolean`	computed inherited from mail.thread
message_ids	Messages	`one2many` → mail.message	inverse: `res_id` inherited from mail.thread
message_is_follower	Is Follower	`boolean`	computed inherited from mail.thread
message_needaction	Action Needed If checked, new messages require your attention.	`boolean`	computed inherited from mail.thread
message_needaction_counter	Number of Actions Number of messages requiring action	`integer`	computed inherited from mail.thread
message_partner_ids	Followers (Partners)	`many2many` → res.partner	computed inherited from mail.thread
rating_ids	Ratings	`one2many` → rating.rating	inverse: `res_id` inherited from mail.thread
website_message_ids	Website Messages Website communication history	`one2many` → mail.message	inverse: `res_id` inherited from mail.thread
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

account.fiscal.position: fiscal_position_id
account.journal: sale_journal
account.move: account_move, reversed_move_ids, session_move_id
crm.team: crm_team_id
hr.employee: employee_id
pos.config: config_id
pos.order: previous_order_id, refunded_order_id
pos.order.line: lines
pos.payment: payment_ids
pos.payment.method: available_payment_method_ids, online_payment_method_id
pos.preset: preset_id
pos.session: session_id
product.pricelist: pricelist_id
res.company: company_id
res.currency: currency_id
res.partner: partner_id
res.users: user_id
restaurant.order.course: course_ids
restaurant.table: self_ordering_table_id, table_id
stock.picking: picking_ids
stock.picking.type: picking_type_id
stock.reference: stock_reference_ids

Fields of other models pointing here

account.move: reversed_pos_order_id
account.payment: pos_order_id
account.sale.closing: last_order_id
event.registration: pos_order_id
loyalty.card: source_pos_order_id
payment.transaction: pos_order_id
pos.order: previous_order_id, refunded_order_id
pos.order.line: order_id
pos.pack.operation.lot: order_id
pos.payment: pos_order_id
report.pos.order: order_id
restaurant.order.course: order_id
stock.picking: pos_order_id
stock.reference: pos_order_ids

Reading this model through the API

Odoo 19 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.order/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: your-db" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","amount_paid","amount_return","amount_tax","amount_total"],"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.order/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","amount_paid","amount_return","amount_tax","amount_total"], "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-order">pos.order (Odoo 19.0)</a>

Sources

Data verified on September 23, 2026 · Odoo 19.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.