Shopify Connector
Connect your Shopify store with Odoo 18. Sync products, orders, customers, inventory, refunds, payouts, and collections. Automate your entire e-commerce workflow.
What you can import from Shopify
Products
Variants, attributes (Color, Size), images, compare-at-price, vendor, tags, categories, and collections. Attributes are mapped to native Odoo product.attribute records.
Orders
Line items, shipping charges, discounts, taxes, duties, tips, gift cards, and custom lines. Automatic Sale Order, Invoice, and Payment creation based on configurable workflows.
Customers
Name, email, phone, addresses, tags, and marketing consent. Deduplication by email prevents duplicate contacts.
Inventory
Stock levels per Shopify location, mapped to Odoo warehouses. Supports multiple locations with independent warehouse mapping.
Refunds
Partial and full refunds with automatic credit note creation. Refund lines are matched to invoice lines for accurate accounting.
Collections
Custom and smart collections imported as Odoo product categories. Products are automatically assigned to the matching category.
Payouts
Shopify Payments payout reports with transaction details. Reconcile payouts against bank statement lines directly in Odoo.
Shipment Info
Tracking number, URL, and carrier are imported for fulfilled orders. Already-shipped orders are marked as fulfilled in Odoo.
What you can push to Shopify
Export Products
Create or update products in Shopify with title, description, variants, prices, SKU, barcode, and weight.
Sync Prices
Push Odoo pricelist prices to Shopify variants. Pull Shopify prices into Odoo pricelists. Bidirectional.
Update Stock
Export inventory levels per location from Odoo warehouses to Shopify. Runs automatically every 2 hours.
Fulfillment + Tracking
Mark orders as fulfilled with tracking number, URL, and carrier. Customer is notified automatically by Shopify.
Mark as Paid
Update payment status in Shopify for pending orders. Creates a manual transaction in Shopify.
Cancel Orders
Cancel orders in Shopify with a reason (customer request, fraud, inventory, payment declined). Cancels the Odoo SO too.
Create Refunds
Issue partial or full refunds in Shopify from Odoo. Checks already-refunded quantities to avoid errors.
Publish / Unpublish
Control product visibility on Shopify directly from Odoo with one click.
Synchronization at a glance
| Data | Cron | Webhook | Manual | Direction |
|---|---|---|---|---|
| Products | ✓ | ✓ | ✓ | Bidirectional |
| Orders | ✓ | ✓ | ✓ | Import |
| Customers | ✓ | ✓ | ✓ | Import |
| Inventory | ✓ | — | ✓ | Bidirectional |
| Prices | ✓ | — | ✓ | Bidirectional |
| Fulfillment | — | — | ✓ | Export |
| Refunds | — | ✓ | ✓ | Bidirectional |
| Payouts | — | — | ✓ | Import |
| Collections | — | — | ✓ | Import |
Everything else included
Chart.js Dashboard
KPI cards, revenue line chart, order status donut, top products bar chart, recent errors list. Dark mode, date range filter, and per-instance view.
Payment Workflows
Configure different order processing rules per payment gateway and financial status. Each gateway can have its own journal.
Queue System
Large imports are processed in batches with progress tracking, retry on failure, and smart activity alerts when errors occur.
Multiple Stores
Connect as many Shopify stores as you need. Each instance has its own warehouse, pricelist, payment journal, and workflow rules.
Shopify Markets
Multi-currency orders handled via pricelist mapping per market.
Pickup Orders
Mark orders as Ready for Pickup and Picked Up from Odoo. Status syncs back to Shopify.
Tax Mapping
Map Shopify tax names to Odoo taxes. Auto-detection by rate with manual override.
Webhooks
9 webhook topics for real-time sync. Register and delete from Odoo. HMAC signature verification.
Detailed Logs
Every sync creates a log with individual lines per record. Filter by success, error, or warning.
POS Orders
Shopify POS orders are detected and flagged automatically during import.
Gift Cards
Gift card line items are imported as service products, keeping your accounting clean.
API Retry Logic
3 retries with exponential backoff. Handles rate limiting (429) and server errors (500/502/503) gracefully.
Odoo 18 · Python 3.10+ · Shopify Admin API v2024-10 · No external Python dependencies
Built by Aldo Quintal
Shopify Connector
Installation
- Copy the shopify_connector folder to your Odoo addons path
- Update the apps list: Settings > Apps > Update Apps List
- Search for "Shopify Connector" and install
Configuration
- Go to Shopify > Configuration > Instances
- Create a new instance: - Instance Name: your store name - Shop URL: yourstore.myshopify.com - Access Token: from Shopify Admin > Settings > Apps > Develop apps
- Click Test Connection
- Configure: - Warehouse for inventory - Payment Journal for auto-payment - Enable Auto Create Invoice / Auto Register Payment
- Click Import Locations to map Shopify locations to Odoo warehouses
Usage
Import Operations
Go to Shopify > Operations > Import from Shopify to access the unified import panel. Select your instance and click the operation you want to run.
Export Operations
Go to Shopify > Operations > Export to Shopify for the export panel.
Dashboard
The Shopify > Dashboard shows KPIs, revenue charts, top products, and order status. Supports dark mode and date range filtering.
Webhooks
Enable webhooks in the instance configuration and click Register Webhooks. Requires HTTPS URL (works automatically on Odoo.sh).
Support
For support, please contact support@yourcompany.com
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module