Shopify Integration
by Digital Economics LLC. https://de.com.eg , Eng. Ahmed Nasreldin https://de.com.eg$ 144.99
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Inventory (stock)
• Invoicing (account) • Sales (sale_management) • Discuss (mail) |
| Lines of code | 4092 |
| Technical Name |
de_shopify_integration |
| License | OPL-1 |
| Website | https://de.com.eg |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Inventory (stock)
• Invoicing (account) • Sales (sale_management) • Discuss (mail) |
| Lines of code | 4092 |
| Technical Name |
de_shopify_integration |
| License | OPL-1 |
| Website | https://de.com.eg |
| Versions | 18.0 19.0 |
Shopify Integration
تكامل شوبيفاي مع أودو
Full Bidirectional Sync via Shopify Admin GraphQL API
مزامنة ثنائية الاتجاه كاملة عبر واجهة برمجة Shopify GraphQL
Connect one or multiple Shopify stores to your Odoo instance with full bidirectional synchronization. Built on the modern Shopify Admin GraphQL API (v2025-01) — not the deprecated REST API — this module syncs Products, Orders, Customers, Inventory, and Fulfillment in real time via webhooks and scheduled cron jobs. Designed for production use with comprehensive audit logging, HMAC webhook verification, and idempotent sync operations.
قم بربط متجر شوبيفاي واحد أو أكثر بنظام أودو الخاص بك مع مزامنة ثنائية الاتجاه كاملة. مبني على واجهة Shopify Admin GraphQL API الحديثة، يقوم هذا الموديول بمزامنة المنتجات والطلبات والعملاء والمخزون والشحن في الوقت الفعلي عبر Webhooks والمهام المجدولة.
✔ Supports Both: Partner Apps & Custom Apps
This module supports two types of Shopify apps:
| App Type | PII Access | Installation | Best For |
|---|---|---|---|
| Partner App 🌟 | Full access on ALL plans | One-click OAuth | Agencies, consultants, multi-store |
| Custom App | Restricted on Basic plans | Manual token | Single-store, internal use |
💡 Tip: Partner Apps are free to create at partners.shopify.com and provide full customer data access on any Shopify plan, including Basic ($39/mo).
تطبيقات الشريك مجانية الإنشاء وتوفر وصولاً كاملاً لبيانات العملاء على جميع خطط Shopify
⚠ Custom App PII Restrictions (Basic Plan)
This only applies to Custom Apps. If you use a Partner App, you have full PII access on all plans.
Since 2024, Shopify restricts Custom Apps on the Basic plan from accessing customer PII. Solutions:
- Use a Partner App (Recommended) — free and provides full access
- Upgrade to Shopify plan ($79/month) or higher
- Enable Protected Customer Data add-on on Basic plan
| Feature | Custom App (Basic) | Custom App (Shopify+) | Partner App (Any) |
|---|---|---|---|
| Product sync | ✔ | ✔ | ✔ |
| Customer name & email | ✘ | ✔ | ✔ |
| Full shipping address | ✘ | ✔ | ✔ |
| Customer phone | ✘ | ✔ | ✔ |
100% GraphQL
Shopify deprecated REST API in April 2025. Built entirely on GraphQL v2025-01.
One-Click OAuth
Partner Apps install via OAuth — no manual token copying. Professional installation flow.
Zero Bloat
Only 6 standard Odoo dependencies. No OCA libraries, no queue jobs.
Production-Ready
121 unit tests, HMAC-SHA256 security, cost-based rate limiting.
▾ Key Features | الميزات الرئيسية
Product Sync
مزامنة المنتجات
Bidirectional product sync via productSet GraphQL mutation. Maps variants, SKUs, barcodes, prices, and attributes.
Order Import
استيراد الطلبات
Import orders with line items, discounts, taxes, shipping lines, and customer notes. Auto-confirm and auto-create missing products.
Customer Sync
مزامنة العملاء
Bidirectional customer sync with address mapping, country/state resolution, and duplicate detection by email.
Inventory Push
دفع المخزون
Push stock quantities from Odoo to Shopify using inventorySetQuantities. Warehouse-aware with batch processing.
Fulfillment Push
تحديث الشحن
Automatically push fulfillment and tracking info to Shopify when deliveries are validated in Odoo.
Real-time Webhooks
إشعارات فورية
13 webhook topics with HMAC-SHA256 verification. Orders, products, customers, inventory, and fulfillment events.
Multi-Currency
دعم العملات المتعددة
Automatic currency resolution from Shopify orders. Maps to Odoo currencies and pricelists. Shop currency auto-detected on connection.
Image Sync
مزامنة الصور
Bidirectional image sync. Downloads Shopify product images on import, uploads via staged uploads on export.
Collection Sync
مزامنة المجموعات
Import Shopify collections mapped to Odoo product categories. Export categories as custom collections with product membership.
Metafield Sync
مزامنة الحقول الوصفية
Import and manage Shopify metafields for products and customers. Configure each metafield as a product attribute or product tag for seamless catalog enrichment.
Order Cancel Export
إلغاء الطلبات
Cancel orders on Shopify directly from Odoo. Auto-push cancellation when orders are cancelled locally.
Multi-Store
دعم متاجر متعددة
Connect unlimited Shopify stores. Each store has its own credentials, warehouse, and sync settings.
OAuth Installation
تثبيت بنقرة واحدة
Partner Apps install via OAuth 2.0. No manual token copying — just enter API Key/Secret and click Install.
Partner App Support
دعم تطبيقات الشريك
Full customer PII access on ALL Shopify plans when using Partner Apps. Bypass Basic plan restrictions.
Scheduled Sync
المزامنة المجدولة
9 cron jobs: Orders (15min), Products (1hr), Customers (2hr), Inventory (30min), Collections (6hr), Refunds (1hr), Payouts (6hr), Gift Cards (6hr), Log cleanup (monthly).
Full Audit Trail
سجل تدقيق كامل
Every API call logged with raw request/response JSON. Filter by operation, state, shop, and date.
▾ Why Choose This Module? | لماذا تختار هذا الموديول؟
How we compare to the leading Shopify connectors on the Odoo App Store
| Feature | This Module $142 |
Emipro shopify_ept $585 + $23 lib |
VentorTech PRO $585 |
Others $158 - $210 |
|---|---|---|---|---|
| Total Cost | $142 All-inclusive |
$609+ + Common Connector Lib $23 |
$585+ + OCA queue job libs |
$158 - $210 |
| Shopify API | 100% GraphQL v2025-01 |
Not disclosed Users ask about GraphQL |
GraphQL + REST | REST / Not disclosed |
| Dependencies | 6 standard sale, stock, delivery, loyalty, account |
4 + paid library common_connector_library |
6+ modules + OCA connector core |
5+ modules |
| Self-Contained | ✓ No extra purchases | ✗ Requires paid lib | ✗ Requires OCA modules | Varies |
| Webhook Topics | 13 topics | Supported Requires SSL + DB filter |
Supported | Limited |
| HMAC Webhook Security | ✓ SHA-256 | Not disclosed | ✓ | Not disclosed |
| Auto-Fulfillment Push | ✓ On Validate | ✓ | ✓ | Varies |
| Full API Audit Log | ✓ Request + Response JSON | Queue error logs | Process logs | Limited |
| Smart Rate Limiting | ✓ Cost-based backoff | Not disclosed | ✓ Queue jobs | Not disclosed |
| Codebase Size | Lean & auditable | 3,286 + 2,336 lib = 5,622 lines total |
3,361 lines | 8,000 - 56,000+ |
| Product Attributes | ✓ Full mapping | Max 3 attributes (export limitation) |
Not disclosed | Not disclosed |
| Multi-Company Rules | ✓ Full record rules | Limited Same-company stock only |
✓ | Varies |
| Arabic Translation | ✓ Included | — | — | — |
| Unit Tests | 121 tests | Not disclosed | Not disclosed | Not disclosed |
| OAuth App Installation | ✓ One-click | Manual token | Manual token | Manual token |
| Partner App Support | ✓ Full PII on all plans | Not disclosed | Not disclosed | Not disclosed |
| Refund/Return Processing | ✓ Bidirectional | ✓ | Varies | Varies |
| Payout Reports | ✓ | ✓ Enterprise only |
— | Varies |
| Gift Card Import | ✓ | ✓ | — | Varies |
| Multi-Currency | ✓ Auto-detect + pricelist | ✓ | ✓ | Varies |
| Image Sync | ✓ Bidirectional | ✓ | ✓ | Varies |
| Collection Mapping | ✓ Bidirectional | ✓ | — | Varies |
| Metafield Sync | ✓ Attributes + Tags mapping | ✓ Enterprise only |
— | — |
| Metafield as Attributes/Tags | ✓ Auto-apply | — | — | — |
| Order Cancel Export | ✓ Auto-push | ✓ | ✓ | Varies |
Save over $460 vs. the leading competitor. The Emipro shopify_ept connector costs $585.93 and requires a separate paid library (common_connector_library at $23.48) — a total of $609+. This module delivers the same core functionality at $142, fully self-contained with no extra purchases required.
The REST API Problem: Shopify deprecated the REST Admin API in April 2025. The Emipro connector does not disclose its API type (users have asked about GraphQL support in reviews with no clear answer). This module is 100% GraphQL-native — no REST dependency, no future migration needed.
▾ How It Works | كيف يعمل
Partner App Setup (OAuth) | إعداد تطبيق الشريك
Create Shop
أنشئ المتجر
Enter API Key
أدخل مفتاح API
Click OAuth Install
اضغط OAuth
Authorize in Shopify
وافق في Shopify
Connected!
متصل!
No manual token copying! OAuth handles authentication automatically. | بدون نسخ الرموز يدوياً!
Order Flow | تدفق الطلبات
Order in Shopify
طلب على شوبيفاي
Webhook / Cron
إشعار فوري أو مجدول
Sale Order in Odoo
أمر بيع في أودو
Fulfill → Shopify
شحن → شوبيفاي
▾ Sync Capabilities & Webhooks | المزامنة و Webhooks
| Entity | Shopify → Odoo | Odoo → Shopify | Webhook | Cron |
|---|---|---|---|---|
| Products | ✓ | ✓ | ✓ | ✓ 1hr |
| Orders | ✓ | — | ✓ | ✓ 15min |
| Customers | ✓ | ✓ | ✓ | ✓ 2hr |
| Inventory | — | ✓ | — | ✓ 30min |
| Fulfillment | — | ✓ | ✓ | Auto |
| Refunds/Returns | ✓ | ✓ | ✓ | ✓ 1hr |
| Collections | ✓ | ✓ | — | ✓ 6hr |
| Metafields | ✓ | — | — | — (with import) |
| Images | ✓ | ✓ | — | — (with product) |
13 Supported Webhook Topics
▾ Configuration | الإعداد
1. Shopify API Credentials
Navigate to Shopify > Configuration > Shops, create a new shop record, and enter your store URL and Admin API access token. Click Test Connection to verify.
انتقل إلى شوبيفاي > الإعدادات > المتاجر
2. Shop Settings
| Setting | Description | الوصف |
|---|---|---|
| Shop URL | mystore.myshopify.com | رابط المتجر |
| Access Token | Admin API token (admin-only) | مفتاح الوصول |
| Warehouse | Default warehouse for orders | المستودع |
| Shopify Location | Auto-detected for inventory sync | موقع شوبيفاي |
| Webhook Base URL | Public Odoo URL (HTTPS) | رابط أودو العام |
| Auto Confirm | Auto-confirm imported orders | تأكيد تلقائي |
3. Webhook Registration
Click Register Webhooks on the shop form to create all 13 webhook subscriptions in Shopify. Requires a publicly accessible HTTPS URL.
انقر تسجيل Webhooks في نموذج المتجر.
Menu Structure
▾ Automated Actions & Why GraphQL | الإجراءات و GraphQL
| Action | Frequency | Description |
|---|---|---|
| Sync Orders | 15 min | Import new/updated orders from all connected shops |
| Sync Products | 1 hour | Import new/updated products with variants |
| Sync Customers | 2 hours | Import new/updated customers with addresses |
| Push Inventory | 30 min | Push Odoo stock levels to Shopify |
| Sync Collections | 6 hours | Import collections from all connected shops |
| Clean Logs | Monthly | Remove logs older than 3 months |
Why GraphQL?
Shopify deprecated the REST Admin API — all new apps must use GraphQL as of April 2025. This module uses Admin GraphQL API v2025-01:
- Upsert operations —
productSetandcustomerSetcreate-or-update in one call - Efficient queries — Request only needed fields
- Cost-based rate limiting — Automatic backoff
- Cursor pagination — Reliable large dataset iteration
- Future-proof — No migration when REST is removed
▾ Technical Information & Changelog | المعلومات التقنية
| Current Version | 19.0.1.5.0 |
| Odoo Version | 19.0 (Community and Enterprise) |
| Dependencies | sale_stock, sale_management, stock, delivery, loyalty, account |
| External Libraries | requests (Python standard) |
| Shopify API | Admin GraphQL API v2025-01 |
| App Types Supported | Partner Apps (OAuth 2.0) & Custom Apps (Manual Token) |
| Authentication | OAuth 2.0 (Partner Apps) / X-Shopify-Access-Token (Both) |
| Webhook Security | HMAC-SHA256 |
| Multi-Company | Yes — record rules |
| Multi-Store | Yes — unlimited |
| Languages | English, Arabic (ar_001) |
| Test Coverage | 121 unit tests (fully mocked) |
| License | OPL-1 |
Changelog | سجل التغييرات
v19.0.1.5.0 — OAuth Installation Flow for Partner Apps (Latest)
- One-click OAuth installation for Partner Apps — no manual token copying
- New fields: API Key (Client ID), API Secret (Client Secret) for OAuth credentials
- OAuth callback controller with HMAC verification and state parameter CSRF protection
- Automatic connection test after successful OAuth authorization
- "Install App (OAuth)" button in shop form header
- OAuth error handling pages for failed installations
- 17 new unit tests for OAuth functionality
v19.0.1.4.0 — App Type Support & Plan Detection
- Partner App vs Custom App selection with app_type field
- Automatic Shopify plan detection on connection test
- Smart PII warning system — only warns for Custom Apps on Basic/Starter plans
- Partner Apps bypass all PII restrictions on any Shopify plan
- Plan warning banner with upgrade recommendations
- Warning state support in sync logs
- 11 new unit tests for plan detection
v19.0.1.3.0 — Pricelist-Based Pricing for Product Export
- Use Pricelist Prices for Export — calculate export prices from Odoo pricelists
- Compare-at Price Export — show strikethrough pricing on Shopify
- Full pricelist rule support (fixed, percentage, formula, date-based, quantity-based)
- Manual compare-at price field on product variants
- Pricing Configuration section in shop form
v19.0.1.2.0 — Multi-Currency, Images, Collections, Metafields, Cancel & Refund Export
- Multi-currency order sync with automatic currency and pricelist resolution
- Bidirectional image synchronization via Shopify staged uploads
- Collection/category mapping with bidirectional sync
- Metafield synchronization for products and customers
- Order cancellation export to Shopify (manual + auto-push)
- Bidirectional refund/return processing (credit notes push to Shopify on post)
- 9 scheduled cron jobs for automated background sync
v19.0.1.1.0 — Gift Card Import & Payout Reports
- Gift card import from Shopify to Odoo loyalty.card model
- Payout report import with transaction-level details
- Gift card program auto-creation per shop
- Payout reconciliation support
v19.0.1.0.0 — Initial Release
- Full Shopify Admin GraphQL API integration (v2025-01)
- Bidirectional Product sync (productSet upsert)
- Order import with line items, discounts, shipping, and taxes
- Customer sync with address mapping and duplicate detection
- Inventory push via inventorySetQuantities
- Automatic fulfillment push on delivery validation
- 13 webhook topics with HMAC-SHA256 verification
- 5 scheduled cron jobs for background sync
- Multi-store support (unlimited stores)
- Import/Export wizards for manual bulk operations
- Full audit trail with raw API request/response logging
- Multi-company and security group support
- Arabic (ar_001) translation included
Support | الدعم
Need help? Contact our support team
هل تحتاج مساعدة؟ تواصل مع فريق الدعم
Copyright 2025 Digital Economics LLC. All rights reserved.
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