Creating Scheduled Actions (Cron Jobs) in Odoo: Complete Guide

from odoo import models, fields, api
from datetime import datetime, timedelta
import logging

_logger = logging.getLogger(__name__)

class SaleOrder(models.Model):
    _inherit = 'sale.order'
    
    @api.model
    def action_cancel_expired_orders(self):
        """Cron Job: Cancels draft orders older than 48 hours."""
        expiration_time = datetime.now() - timedelta(hours=48)
        
        # Find orders: Draft state AND created before 48 hours ago
        expired_orders = self.search([
            ('state', '=', 'draft'),
            ('create_date', '<', expiration_time)
        ])
        
        if not expired_orders:
            _logger.info("Cron: No expired orders found.")
            return
        
        _logger.info(f"Cron: Cancelling {len(expired_orders)} expired orders.")
        
        for order in expired_orders:
            try:
                order.action_cancel()
                # Log to chatter so we know WHY it was cancelled
                order.message_post(body="Auto-cancelled by system (Expired).")
            except Exception as e:
                _logger.error(f"Failed to cancel order {order.name}: {e}")

<?xml version="1.0" encoding="utf-8"?>
<odoo>
    <data noupdate="1">
        <record id="ir_cron_cancel_expired_sales" model="ir.cron">
            <!-- Name visible in Settings -->
            <field name="name">Sales: Auto-Cancel Expired Orders</field>
            
            <!-- Model to execute on -->
            <field name="model_id" ref="sale.model_sale_order"/>
            
            <!-- User to run as (usually OdooBot or Admin) -->
            <field name="user_id" ref="base.user_root"/>
            
            <!-- Configuration -->
            <field name="state">code</field>
            <field name="code">model.action_cancel_expired_orders()</field>
            <field name="interval_number">1</field>
            <field name="interval_type">days</field>
            <field name="numbercall">-1</field> <!-- -1 means run forever -->
            <field name="doall" eval="False"/>
            <field name="active" eval="True"/>
        </record>
    </data>
</odoo>

# You can write python directly here!
env['sale.order'].action_cancel_expired_orders()

def action_process_queue(self):
    for item in self.search([]):
        try:
            with self.env.cr.savepoint():
                item.do_processing()
        except Exception as e:
            _logger.error(f"Failed item {item.id}: {e}")
            # The loop continues! Other items are saved.

# Process only 100 at a time
records = self.search([('state', '=', 'pending')], limit=100)
# If you have more work, the next run will pick them up.