Link Search Menu Expand Document
Shopify Odoo Connector
Shopify Odoo Connector
User Guide
Odoo Version Contact Us

Path B — Generate Token for a Partner-Linked App

Use this guide after creating the app from dev.shopify.com/dashboard, when the app shows a Distribution section/card or requires installation through Custom Distribution.

Note that this process requires a live domain; local environments (localhost) are not supported. If you are using an on-premise server, make sure that a database filter is applied in the Odoo configuration file.

Important:

  1. Shopify Connector version should be 17.0.7.1 or higher to use this method.
  2. Open the Odoo wizard first and keep it open throughout the entire process. Do not close it until the token is generated.

1. Initial Setup in Odoo

  1. Install the Shopify Connector module.
  2. In Odoo, go to Shopify → Configuration → Settings and click Set Shopify Authorization Details to open the wizard.

  3. The wizard displays two URLs in the App Integration URLs section — the App URL and the Callback / Redirect URL.

    Odoo Wizard — App Integration URLs

  4. Keep this window open. You will need both URLs in the next steps.

2. Confirm You Are in the Partner-Linked Flow

Before continuing, verify that your app shows a Distribution section/card and requires Custom Distribution for installation.

The app overview should look like the screenshot below — note the Distribution section/card on the right side:

Shopify Dev Dashboard — Partner-Linked App Overview (Distribution section visible)

If your app installs directly without distribution, switch to Path A - Generate Token for a Direct Install App.

3. Create a Version and Set URLs

  1. Inside the app, go to Versions and click Create version.
  2. In the App URL field, paste the App URL copied from the Odoo wizard.

  3. In the Redirection URL(s) field, paste the Callback / Redirect URL copied from the Odoo wizard.

    Shopify — Version configuration with URLs

Note: Copy both URLs exactly as shown in the Odoo wizard. Any mismatch — including a trailing slash — will cause the authorization to fail.

4. Set API Scopes

Copy the following string exactly and paste it into the Access Scopes field of your app version:

read_assigned_fulfillment_orders,write_assigned_fulfillment_orders,read_custom_fulfillment_services,write_custom_fulfillment_services,read_customers,write_customers,read_price_rules,write_price_rules,read_discounts,write_discounts,read_fulfillments,write_fulfillments,read_gift_cards,write_gift_cards,write_inventory,read_inventory,write_locations,read_locations,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders,read_metaobject_definitions,write_metaobject_definitions,read_orders,write_orders,read_product_listings,write_product_listings,read_products,write_products,read_publications,write_publications,read_returns,write_returns,read_shipping,write_shipping,read_shopify_payments_accounts,read_shopify_payments_payouts,read_third_party_fulfillment_orders,write_third_party_fulfillment_orders,write_order_edits,read_order_edits,write_locales,read_locales,write_translations,read_translations

Note: All scopes listed above are required. The token will only work for permissions that are explicitly set on the released app version.

Shopify — Access scopes field

📦 Importing orders older than 60 days?
Do not configure read_all_orders in this step. First complete app installation (Step 6) and token generation (Step 8). After that, follow Step 10 in this guide.
→ Continue first, then follow Step 10 — Importing Orders Older Than 60 Days (read_all_orders)

5. Release the Version

  1. Confirm that the App URL, Redirect URL, and all required scopes are correctly entered.
  2. Click Release version.

Note: The app must have a released version before it can be installed in a store or used to generate a token.

6. Install the App in Your Shopify Store

Before generating the token, the app must be installed in your Shopify store.

  1. In the Shopify developer dashboard, open your app and go to Distribution.
  2. Select distribution method Custom Distribution.
  3. Enter your store domain (for example, demo.myshopify.com). If needed, enable Allow multi-store install for one Plus organization.
  4. Click Generate link.
  5. Copy the generated link and open it in your browser.

  6. Your Shopify store’s app installation page will open. Click Install.

    Shopify — Custom Distribution, generate link

Note: Make sure you are logged in to the correct Shopify store before opening the installation link.

Note for read_all_orders: In partner-linked apps, Shopify shows the read_all_orders access option only after distribution is configured and required customer data configuration is completed.

7. Copy Credentials into the Odoo Wizard

  1. In the Shopify developer dashboard, open your app and go to Settings.
  2. Copy the Client ID and paste it into the API Key (Client ID) field in the Odoo wizard.
  3. Copy the Client Secret and paste it into the API Secret Key field in the Odoo wizard.

  4. Enter your store domain in the Shopify Store Domain field, for example demo.myshopify.com. Do not include https://.

    Shopify App Settings — Client ID and Secret

8. Authorize and Generate the Token

  1. Switch back to the Odoo wizard.
  2. Click Authorize with Shopify.
  3. Your browser will redirect to the Shopify authorization screen.
  4. You will be redirected back to Odoo automatically. If the Odoo login page appears, log in — the wizard will reopen on its own.

  5. The wizard switches to the Token Generated view and displays your access token.

    Odoo Wizard — Token Generated view

Important: Copy the access token immediately using the copy icon next to the token field. This is the only time it will be shown — once the wizard is closed, the token is cleared from storage.

9. Create the Shopify Instance

After the token is generated you have two options:

Option A — Create Instance Immediately (Recommended)

  1. Click Create Shopify Instance → in the wizard.
  2. The instance configuration wizard opens, pre-filled with your store domain, API key, shared secret, and access token.
  3. Enter an Instance Name and select the Company.
  4. Click Create to verify your credentials and complete the setup.

Option B — Save Token and Create Instance Later

  1. Copy the token and store it securely, for example in a password manager.
  2. Click Close to dismiss the wizard.
  3. When ready, go to Shopify → Configuration → Instances → New and paste the token into the Password field.

10. Importing Orders Older Than 60 Days (read_all_orders)

Use this section only after you complete app installation and base token setup (Steps 6 to 9).

If you need to import orders older than 60 days, your app must include the read_all_orders scope.

In partner-linked apps, this scope may not be available by default. Shopify requires the Distribution and customer data configuration to be completed first, and then an explicit access request before the scope appears in the scope picker.

Full guide: Enabling read_all_orders Scope

Note: For multiple stores, create a separate app for each store and repeat this process.

Table of contents