Otto Store Management

This is the installation and configuration guide for Otto Store Management, the module you downloaded from your ECOSIRE dashboard or the Odoo App Store. Everything on this page describes the otto_store_management module exactly as it ships today — the facts below were read out of the released build, not from a roadmap.

Technical name	otto_store_management
Odoo versions	17.0, 18.0, 19.0 (Community or Enterprise)
Current shipped version	17.0 → 17.0.3.1.0, 18.0 → 18.0.3.1.0, 19.0 → 19.0.3.2.1
Price	$499 USD — one-time, per Odoo version
Odoo module licence	OPL-1 (Odoo Proprietary License)
Category	Connector

The module installs and runs standalone — nothing to unlock and no separate companion module to install first. Licensing is contractual: buying it entitles you to run the software and receive updates, per the licence terms above.

What's new in 3.2.1 — product-update tasks confirm their outcome

Version 3.2.1 is a defect fix on the confirmation cycle that 3.2.0 introduced.

• A finished product update no longer fails on its success path. After you push products to OTTO, the connector polls the export task and, once OTTO reports it DONE, reads that task's three result lists back. In 3.2.0 those read-back calls passed their arguments in the wrong order, so the moment a task completed successfully the poll raised TypeError instead of recording the outcome. The lists are now read with the arguments the helper declares, so a completed update is confirmed rather than crashed.

You only need this release if you are on 19.0.3.2.0. The 17.0 and 18.0 builds never carried this code — neither tree has the result-list read-back — so they are unaffected and their versions are unchanged.

What 3.2.0 added, for context

• Outcome confirmation. When a product export task finishes, the connector reads OTTO's succeeded, unchanged and failed variation lists for that task (GET /v5/products/update-tasks/{processUuid}/succeeded and /unchanged) and sets each product's Otto Sync Status to what OTTO actually accepted. Before this, every submitted product showed Synced as soon as it was sent — even when OTTO later rejected it. A rejected variation now shows Error with the task reference, and a variation OTTO stored unchanged is confirmed without a false error.
• Lowercase task states. OTTO's pending / done spellings are handled the same as the uppercase ones, so polling follows the correct branch whichever casing the API answers with.
• Partial reads survive. If one of a finished task's result lists cannot be read — a temporary rate limit on a single sub-resource, for example — the others are still read and applied, and the failed read is recorded on the task result instead of discarding the whole poll. Each variation status is applied in its own savepoint, so one malformed row cannot abort the remaining confirmations.

What 3.1.0 changed

Version 3.1.0 removed the historical companion-module dependency. The module now installs and runs standalone: there is no second download to install first and nothing to unlock afterwards. Licensing is contractual, under the OPL-1 terms in the table above.

Requirements

Requirement	Detail
Odoo	17.0, 18.0 or 19.0, Community or Enterprise. Self-hosted or Odoo.sh — Odoo Online (SaaS) cannot install third-party modules
Odoo apps	base, sale_management, stock, account, delivery, mail, web, product, contacts — Odoo installs any that are missing automatically
Python packages	requests
Platform account	An Otto Market partner account with API access

Install the Python packages into the same interpreter that runs Odoo:

sudo -u odoo pip install requests

Installation

1. Download the ZIP for your Odoo version

Sign in at ecosire.com and open your dashboard downloads, or use the ZIP attached to your Odoo App Store purchase.

2. Extract into your addons path

unzip otto_store_management_v19_*.zip -d /opt/odoo/addons/
ls /opt/odoo/addons/otto_store_management/__manifest__.py   # sanity check

The module must end up as a single top-level otto_store_management/ directory with __manifest__.py directly inside it. If your ls check fails, the folder landed one level too deep or too shallow — move it so the path above resolves.

3. Restart Odoo and install

sudo systemctl restart odoo

1. Go to Apps and click Update Apps List (developer mode must be on).
2. Search for Otto Store Management and click Install.
3. Odoo pulls in the Odoo apps listed above automatically.

When the install finishes, a Otto menu appears in the main Odoo app switcher.

Configuration

Connect to Otto

Create a connection record on the otto.configuration model. The fields the module defines for the connection are:

Field	Technical name	Type	Required
Configuration Name	name	Char	Yes
Client ID	client_id	Char	Yes
Client Secret	client_secret	Char	Yes
Partner ID	partner_id	Char	Yes
Company	company_id	Many2one	Yes
Sandbox Mode	sandbox	Boolean	No
Timeout	timeout	Integer	No
Otto URL	otto_url	Char	No
Marketplace	marketplace	Char	No

The fields marked Yes are enforced by the model — Odoo will not let you save the record without them. The technical name is the reliable identifier if your screen wording differs.

Sandbox Mode switches the client between OTTO's production host and its sandbox host. Turn it on while you are testing credentials, and off for live trading.

The same record carries 7 behaviour checkboxes — sync_products, sync_orders, sync_customers, sync_inventory, auto_sync_products, auto_sync_orders, auto_sync_customers. They gate what the module is allowed to do automatically once it is connected. Leave anything you are not ready for switched off, and turn them on one at a time.

Authentication is OAuth2 client credentials: the module exchanges client_id and client_secret for a bearer token at POST /v1/token. There is no refresh token — the client requests a new token when the current one expires. These are the credentials from OTTO's Partner Portal, not your portal login.

The module's own source contacts these hosts: api.otto.market, sandbox.api.otto.market. Your firewall must allow outbound HTTPS to them.

Scheduled actions

The module installs 6 scheduled actions (Settings → Technical → Scheduled Actions):

Scheduled action	Runs every	Enabled on install
otto: Sync Products	1 hour	Yes
otto: Sync Orders	30 minutes	Yes
otto: Sync Customers	6 hours	Yes
otto: Sync Inventory	15 minutes	Yes
otto: Test Connection	1 day	Yes
otto: Cleanup Old Logs	1 day	Yes

Intervals above are the shipped defaults. Adjust them to your volume — but be aware that the platform, not Odoo, sets the API rate limits, and shortening a sync interval is the usual cause of throttling errors in the logs.

OTTO signals rate limits with HTTP 429 and a Retry-After header; the module waits as instructed and retries rather than hammering the API.

Webhook and API endpoints your server exposes

These are the HTTP routes this module adds to your Odoo instance. Only the public ones are reachable without an Odoo login.

Endpoint	Auth	Purpose
/otto/webhook	public	Webhook receiver — see the note below; OTTO has no webhook push, so it rejects every delivery
/otto/api/status	logged-in user	connection and sync status read by the dashboard
/otto/api/sync	logged-in user	triggers a sync from the dashboard
/otto/dashboard/data	logged-in user	dashboard KPI data

/otto/webhook is closed in this build — sync runs on the scheduled actions

The route exists and is publicly reachable, but it fails closed: otto.webhook._verify_signature() rejects every delivery and the endpoint answers HTTP 403. OTTO Market does not offer webhooks — polling is required — so no inbound payload to this route could be authentic. The module will not process an unauthenticated payload, so there is nothing to register in your OTTO Market seller portal today — there is no OTTO-side webhook setting to fill in. Leave the scheduled actions above enabled; they are how this build stays current.

Using the module

The module's menu is laid out as:

• Otto → Dashboard
• Otto → Orders
• Otto → Products
• Otto → Customers
• Otto → Operations — Import Wizard, Export Wizard, Mapping Wizard, Test Connection, Logs, Reports
• Otto → Configuration — Settings

A normal first run is:

1. Save the connection record and confirm the module reports a successful connection before importing anything.
2. Review the mapping records so imported data lands on the right Odoo records.
3. Run a small import first — restrict it by date or by a handful of products — and check the results before letting the scheduled actions take over.
4. Watch the log records during the first full sync. Failures are recorded there rather than raised at the user.
5. After your first product push, let the export task finish and re-read the product's Otto Sync Status. That status is OTTO's own verdict on each variation, so it is the check that tells you the catalog was really accepted.

Troubleshooting

Syncing

Symptom	Cause and fix
The connection will not validate	Re-check every required field in the table above. Most failures are a mistyped secret, or credentials created for a sandbox while the module points at production (or vice-versa). Check Sandbox Mode matches where the credentials were issued.
Nothing syncs even though the connection is fine	The scheduled actions are disabled at the Odoo level, or Odoo's cron worker is not running. Check Settings → Technical → Scheduled Actions and that --max-cron-threads is greater than zero.
Sync starts then stops part-way	Read the module's log records for that run. Rate limiting and rejected field values are the two common causes; both are logged with the platform's own error text.
A product stayed on Synced after a rejected update	You are on 19.0.3.2.0, where the outcome read-back crashed on a successful task. Move to 19.0.3.2.1; see What's new.
Records import but map to the wrong Odoo values	Fix the mapping records under the module's configuration, then re-run the import.
Duplicated products or customers	Run the initial import once. If a first attempt half-finished, check the existing records before re-running rather than importing on top.
The requests library is required	requests is missing from Odoo's Python environment. Install it into the interpreter that runs Odoo.

Version history

Odoo version	Version you download today
17.0	17.0.3.1.0
18.0	18.0.3.1.0
19.0	19.0.3.2.1

ECOSIRE module versions are <odoo major>.<module major>.<minor>.<patch>, so 19.0.3.2.1 is the Odoo 19 build of module version 3.2.1. Your installed version is shown in Apps.

Support

• General troubleshooting
• Email: info@ecosire.com
• Support portal