Documentation

Complete installation and usage guide for Doli2Shop

Installation

Requirements

  • PHP : 7.2.5 - 8.4.x
  • Dolibarr : 18.0 - 23.x (18 LTS maintenu jusqu'à fin de son cycle LTS Dolibarr, estimé mi-2027)
  • Required PHP extensions : cURL, JSON

Installation steps

  1. Download the module

    Purchases and updates are handled on DoliStore (www.dolistore.com): My account → Order history and details. Sign in with the address used for the purchase. The module is also available through the Shopify App Store.

  2. Deploy via Home → Setup → Modules/Applications, tab “Deploy/install external app/module” htdocs/custom/shopifyintegration/
  3. Activate the module

    Go to Home → Setup → Modules and activate Doli2Shop.

Configuration

API Connection

Enter your Shopify store connection credentials.

votre-boutique.myshopify.com
Available in your Shopify app
Available in your Shopify app
Available in your Shopify app

Shopify API

Create a Shopify application

  1. Log in to your Shopify admin
  2. Go to Settings → Apps and sales channels
  3. Click on Develop apps
  4. Create a new app and configure API scopes

Required permissions

  • read_products - Read products
  • write_products - Write products
  • read_inventory - Read inventory
  • write_inventory - Write inventory
  • read_orders - Read orders
  • read_customers - Read customers

Synchronization

Products

Products are automatically synchronized between Dolibarr and Shopify, including variants, images and prices.

D → S Dolibarr to Shopify

Inventory

Stock levels are updated in real-time on both platforms. Supports virtual and real stock.

Scheduled tasks (CRON)

Two CRON tasks ensure automatic synchronization:

  • Real-time sync : 15 minutes
  • Historical sync : 30 minutes

Orders

Note : Orders are imported from Shopify to Dolibarr only.

Imported data

  • Customer and shipping/billing addresses
  • Order lines (products, quantities, prices)
  • Shipping method and costs
  • Promo codes and discounts
  • Taxes and VAT

Troubleshooting

Shopify API connection error

Check that your API credentials are correct and that your Shopify store is accessible. Make sure PHP cURL and JSON extensions are installed.

Synchronization is not working

Check that CRON tasks are properly configured in Dolibarr (Home → Setup → Scheduled tasks). Check the logs in the module diagnostic.

Stock mismatch between Shopify and Dolibarr

Run a full synchronization from the module maintenance page. Verify that the stock type (virtual/real) is correctly configured.