Skip to main content

Field Service - Mobile

Beta License: AGPL-3 ursais/osi-addons

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

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

  1. Open the Field Service application.

  2. Under Configuration, open FSM Mobile Features.

  3. Select installed modules and feature lines for the mobile menu.

  4. Assign security groups to control which features each user can access.

  5. 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

Other credits

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

Maintainers

Current maintainer:

max3903

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

You are welcome to contribute.

Metadata

Release files for odoo-addon-fieldservice-mobile 19.0.1.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for odoo-addon-fieldservice-mobile 19.0.1.1.1
File Size Uploaded
odoo_addon_fieldservice_mobile-19.0.1.1.1.tar.gz 51.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for odoo-addon-fieldservice-mobile 19.0.1.1.1
File Interpreter ABI Platform
odoo_addon_fieldservice_mobile-19.0.1.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 127.1 kB

Release files / odoo_addon_fieldservice_mobile-19.0.1.1.1.tar.gz

Download URL odoo_addon_fieldservice_mobile-19.0.1.1.1.tar.gz
Size 51.8 kB
Tags Source
SHA-256 checksum
How to use checksums
52b7d52035860eb06174860c644ffcabb53b3b5282801f2e5d52bcc472acc7f3
BLAKE2b-256 checksum
How to use checksums
23e9057be1fc4af36ab6a68eac64bee80ac073ed7427b7ac512164c8ca29e2f1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / odoo_addon_fieldservice_mobile-19.0.1.1.1-py3-none-any.whl

Download URL odoo_addon_fieldservice_mobile-19.0.1.1.1-py3-none-any.whl
Size 75.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8b1a9bafd49638c810aee074a90cce415a4efc84fede9142dea6703a6e3f3abb
BLAKE2b-256 checksum
How to use checksums
7c09dbb399082c1109dee8b4ea4bcc6c10995341fd1ce29fe2b57e5673a12fb9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

This release

19.0.1.1.1 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page