Field Service - Mobile

This module provides backend support for the Field Service mobile application. It manages mobile-specific stage visibility, stage duration tracking, portal configuration, dynamic feature mapping by security group, and payment link generation for field service orders linked to sales orders.

It also exposes HTTP endpoints used by the offline-capable mobile client:

POST /fsm/sync — apply order updates, clock punches (fsm.stage.history) and signature in a single atomic transaction
POST /fsm/photo — multipart upload that creates ir.attachment without base64 RPC
POST /fsm/pull — delta pull of orders assigned to the current technician (person_id / person_ids), filtered by write_date

Table of contents

Configuration
Usage
- Mobile sync API
Bug Tracker
Credits

Configuration

To configure mobile stages:

Go to Field Service > Configuration > Stages.
Enable Display in Mobile for stages that should appear in the mobile app.
Enable Display in Odoo for stages that should appear on FSM orders in Odoo.
Assign a server action on stages that require automated updates.

To configure automated actions tied to stage sequences, adjust the domain on each automation under Settings > Technical > Automation > Automated Actions.

To configure mobile features:

Go to Field Service > Configuration > FSM Mobile Features.
Select installed modules for the dynamic mobile menu.
Activate a feature mapping record and assign security groups per feature line.

Usage

Open the Field Service application.
Under Configuration, open FSM Mobile Features.
Select installed modules and feature lines for the mobile menu.
Assign security groups to control which features each user can access.
Activate the desired feature mapping record.

Portal users can access allowed features and attachments according to the configured security rules and settings for stock move visibility and updates.

Mobile sync API

Authenticated mobile sessions (portal or internal workers linked to an fsm.person via partner_id) can call:

Batch sync — `POST /fsm/sync` (`type=jsonrpc`)

{
  "jsonrpc": "2.0",
  "method": "call",
  "params": {
    "order_id": 12,
    "order": {"stage_id": 5, "resolution": "Done"},
    "clocks": [
      {
        "stage_id": 6,
        "start_datetime": "2026-07-24 15:00:00",
        "duration": 0.5,
        "total_duration": 1.0
      }
    ],
    "signature": {
      "signed_by": "Jane Doe",
      "signature": "<base64 png>"
    }
  }
}

Use "mutations": [ {...}, {...} ] to push several orders in the same request / transaction.

Photo upload — `POST /fsm/photo` (`multipart/form-data`)

Fields: order_id, optional name, and a file field named ufile, file, photo or attachment.

Delta pull — `POST /fsm/pull` (`type=jsonrpc`)

{
  "params": {
    "since": "2026-07-24 00:00:00",
    "limit": 80,
    "offset": 0
  }
}

Returns only orders where the current user’s fsm.person is person_id or in person_ids, optionally filtered with write_date > since.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

Credits

Authors

Open Source Integrators

Contributors

Wolfgang Hall <whall@graymatterlogic.com>
Sandip Mangukiya <smangukiya@graymatterlogic.com>
Ammar Officewala <aofficewala@graymatterlogic.com>
Serpent Consulting Services Pvt. Ltd. <support@serpentcs.com>
Gray Matter Logic:
- Maxime Chambreuil <maxime.chambreuil@graymatterlogic.com>

Other credits

The development of this module was originally supported by Open Source Integrators.

Maintainers

Current maintainers:

This module is part of the ursais/osi-addons project on GitHub.

You are welcome to contribute.