S Salla → Odoo

User guide

Everything needed to connect your Salla store to your own Odoo, from install to the first order landing.

1 · What the connector does

It listens to what happens in your Salla store - a new order, a status change, a new customer - and creates the matching record in your own Odoo: a contact, a sale order, an invoice, a payment, a delivery order.

The Odoo it writes to is yours. The connector keeps no copy of your accounting data; it writes directly to your system through a user you create and can revoke at any time.

Sync is one-way: Salla to Odoo. Changes made inside Odoo are not sent back.

2 · Before you start

  • Your own Odoo 17, reachable over the internet
  • An Odoo user with an API key
  • Permission to change settings in your Salla store
Create a dedicated Odoo user for the connector rather than using your own login. You then know exactly what the connector created, and you can revoke its access without locking anyone out.

To create the key: Odoo → Preferences → Account Security → New API Key. Copy it immediately; it is not shown again.

3 · Install and create your account

  1. Install the app from the Salla App Store
  2. An email arrives at your store address with a link to set a password
  3. Choose a password - this is for the connector dashboard, not for Salla

The password is deliberately separate: it lets you give a colleague or your Odoo consultant access to the connector without giving them access to your store.

4 · Connect Odoo

Settings → Odoo connection. Four fields: the address, the database name (case sensitive), the username, and the API key.

Press Test connection. On success you choose which company records are created in, then the connector checks compatibility and loads your journals, warehouses, sales teams, analytic accounts and taxes.

That step takes a while - around thirty requests to your system. Let it finish.

5 · Choose documents and their settings

Settings → Documents. Nothing is created in Odoo unless you switch it on here. Each document has two essentials: when it fires, and where the record lands.

The most important setting in the system: the statuses that create a sale order. An order that never passes through one of them gets no sale order - and therefore no invoice and no delivery, because everything downstream depends on it. If your orders go straight to "In progress", make sure that status is in the list.

Documents depend on each other: an invoice needs a sale order, a payment needs an invoice. Turning one off turns off everything beneath it.

6 · Map your products

Products. For a sale order to be built correctly, the connector needs to know which Odoo product each Salla product corresponds to.

  1. Refresh from Salla to read your catalogue
  2. Run matching to match automatically on SKU or barcode
  3. Review, then map whatever is left by hand
Preview first: leave "Write the mappings" unticked to see what would match before anything is saved.

7 · Watching the sync

  • Applied - reached Odoo
  • Skipped - an event for a document you have not switched on. Normal
  • Waiting - queued. More than a few minutes means something is wrong
  • Dead letter - failed and needs you

The connector also checks Salla twice a day for orders that never arrived. You can run that check yourself with Check Salla for missed orders.

8 · When an order does not arrive

Open the Errors page. Every record that failed appears with the reason Odoo gave and a retry button. Common causes: an unmapped product, a field your Odoo requires that the connector does not supply, or a missing permission on the connector user.

When Odoo refuses an order for several reasons, all of them are listed together - fix the list, then retry once.

Sign in