| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Inventory (stock)
• Sales (sale_management) • Discuss (mail) • Invoicing (account) |
| Community Apps Dependencies | Show |
| Lines of code | 9198 |
| Technical Name |
grev_od_shopify_connector |
| License | OPL-1 |
| Website | https://grevlin.com |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Inventory (stock)
• Sales (sale_management) • Discuss (mail) • Invoicing (account) |
| Community Apps Dependencies | Show |
| Lines of code | 9198 |
| Technical Name |
grev_od_shopify_connector |
| License | OPL-1 |
| Website | https://grevlin.com |
|
|
Grevlin Shopify Connector |
Native Shopify Integration for Grevlin Marketplace Suite
Enterprise-grade Shopify integration with near-realtime KPIs powered by TimescaleDB. Full bidirectional synchronization using Shopify GraphQL Admin API with bulk operations support.
Required Dependencies: This module requires grev_od_ecommerce_connector to be installed. TimescaleDB extension must be enabled in your PostgreSQL database. This module does not operate standalone.
Why Choose This Shopify Connector?
![]() Accelerate GrowthSeamless integration that scales with your business. Real-time sync ensures your operations keep pace with demand. |
![]() Automate SynchronizationBidirectional sync with bulk operations. Webhook-driven updates keep your data current without manual intervention. |
![]() Smart AnalyticsNear-realtime KPIs powered by TimescaleDB. Make data-driven decisions with comprehensive dashboard insights. |
![]() 30 days free support |
![]() Customization service available |
Shopify Integration Capabilities
Comprehensive Shopify integration leveraging GraphQL Admin API for optimal performance and reliability.
Products & VariantsFull product and variant synchronization with support for images, collections, tags, and metafields. Bulk import and export operations via Shopify GraphQL Bulk API. |
Orders & Order LifecycleComplete order synchronization with real-time webhook updates. Tracks order status, fulfillment, payments, and refunds. Supports order updates and cancellations. |
CustomersCustomer synchronization with address management and order history. Supports bulk customer import with optimized GraphQL queries for large datasets. |
Inventory & StockReal-time inventory level synchronization across multiple locations. Bulk inventory updates with automatic reconciliation and conflict resolution. |
Collections (Categories)Custom Collections and Smart Collections synchronization. Maps Shopify collections to Odoo product categories with automatic product assignment. |
Pricelists / Market PricingShopify Price Lists synchronization with support for market-specific pricing strategies. Bidirectional sync ensures price consistency across platforms. |
WebhooksAutomated webhook registration and management. Real-time event processing for orders, products, inventory, and customers with normalized event mapping. |
Bulk SynchronizationHigh-performance bulk operations using Shopify GraphQL Bulk API. Supports bulk queries for products, variants, customers, and inventory with automatic JSONL parsing. |
Supported Sync Directions
Full bidirectional synchronization with intelligent fallback mechanisms and bulk operation support.
Shopify â Odoo (Inbound)
|
Odoo â Shopify (Outbound)
|
Bulk Sync Support
|
KPI Coverage (Shopify-Specific)
Comprehensive Shopify-specific KPIs with near-realtime refresh capabilities via webhooks and TimescaleDB materialized views.
Revenue KPIs
|
Order KPIs
|
Inventory KPIs
|
Customer KPIs
|
Operational KPIs
|
Near-Realtime Refresh
|
Architecture Highlights (Shopify Focused)
Provider-isolated implementation ensuring zero impact on other marketplace integrations.
ShopifyAPIClient (GraphQL Admin API)
Dedicated GraphQL client targeting Shopify Admin API version 2026-01. Implements rate limiting, retry logic, and error handling. Supports both REST and GraphQL endpoints with automatic format selection.
Bulk Operations Infrastructure
Comprehensive bulk operation support using Shopify GraphQL Bulk API. Implements bulk query and mutation operations with automatic polling, JSONL parsing, and error handling. Graceful fallback to single-record operations on failure.
Webhook â Queue â Refresh Pipeline
Normalized webhook event processing with Shopify-specific event mappers. Events trigger refresh queue entries that update TimescaleDB materialized views. Debouncing prevents database overload during peak webhook traffic.
Provider-Isolated Implementation
All Shopify-specific logic resides within this module. Zero coupling with other provider modules ensures independent versioning, testing, and deployment. Base connector provides abstraction layer only.
OAuth 2.0 Implementation
Complete OAuth 2.0 flow implementation with HMAC verification, state token validation, and secure token storage. Automatic token refresh handling with graceful error recovery.
Multi-Shop Support
Supports multiple Shopify stores simultaneously with complete data isolation. Each shop maintains independent OAuth tokens, webhook configurations, and sync schedules. Consolidated analytics across all shops.
Getting Started (Shopify)
Follow these steps to integrate your Shopify store with the Grevlin Marketplace Suite.
Installation Steps
- Enable TimescaleDB Extension: Ensure TimescaleDB extension is installed and enabled in your PostgreSQL database. This is required for KPI analytics and materialized views.
-
Install Base Connector: Install
grev_od_ecommerce_connectormodule. This provides the foundational abstraction layer and sync framework. -
Install Shopify Connector: Install
grev_od_shopify_connectormodule. This extends the base connector with Shopify-specific implementations. - Configure Shopify OAuth: Create a Shopify provider record and configure OAuth credentials (Client ID and Client Secret). Complete the OAuth authorization flow to obtain access tokens.
- Activate Webhooks: Use the provider form view to register required webhooks with Shopify. Webhooks enable real-time event processing for orders, products, inventory, and customers.
- Start Synchronization: Begin initial data synchronization using the provider form actions. Configure sync schedules and monitor sync status through the unified dashboard.
Shopify API Requirements
This connector requires Shopify API access with appropriate scopes for the operations you intend to perform. Minimum required scopes include:
- read_products, write_products (for product sync)
- read_orders, write_orders (for order sync)
- read_customers, write_customers (for customer sync)
- read_inventory, write_inventory (for inventory sync)
- read_webhooks, write_webhooks (for webhook management)
Revision History
Provider-specific updates and enhancements aligned with Shopify API evolution.
| Version | Release Date | Key Highlights |
|---|---|---|
| 19.0.2.2.0 | 2026-01 | Update provider metadata handling. |
| 19.0.2.1.0 | 2026-01 | Shop agnostic objects. |
| 19.0.1.1.1 | 2026-01 | Reorganization, Sync UX Standardization & Provider Computed Helpers. |
| 19.0.1.0.0 | 2026-01 | Bulk sync support for products, variants, customers, and inventory using GraphQL Bulk API. Enhanced webhook refresh pipeline. Product category and pricelist sync implementation. |
| 19.0.0.5.0 | 2025-12 | Shopify GraphQL API version 2026-01 alignment. Product media field migration from images to media structure. Webhook event mapping enhancements. |
| 19.0.0.4.0 | 2025-11 | KPI engine alignment with unified snapshot system. Provider-dependent sync pages implementation. Enhanced error handling and logging for all sync operations. |
| 19.0.0.3.0 | 2025-10 | Complete OAuth 2.0 flow implementation with HMAC verification. Outbound sync implementation for products, variants, customers, orders, and inventory. Provider-specific sync action handlers. |
| 19.0.0.1.0 | 2025-08 | Initial release. Basic inbound sync for products, variants, orders, and customers. ShopifyAPIClient implementation with GraphQL support. Webhook infrastructure foundation. |
Support & Maintenance
Enterprise-grade support policies specific to Shopify integration requirements.
Supported Odoo VersionsFully compatible with Odoo 18 and Odoo 19 (Community and Enterprise editions). Version compatibility verified with each release. Requires base connector module version alignment. |
Shopify API Version AlignmentTargets Shopify GraphQL Admin API version 2026-01. All GraphQL queries and mutations validated against this API version. Backward compatibility maintained where possible. |
Upgrade & CompatibilityBackward-compatible updates within major Odoo versions. Provider module upgrades maintain compatibility with base connector updates. Database migrations handled automatically. |
API Rate LimitingAutomatic rate limit handling with retry logic and exponential backoff. Respects Shopify API rate limits (GraphQL: 1000 points per second, REST: 40 requests per app per store). Bulk operations optimized for rate limit efficiency. |
Error Handling & LoggingComprehensive error handling with provider-specific error codes and messages. Per-record error logging with HTTP status, Shopify error details, and payload snapshots. Non-blocking transaction behavior. |
Enterprise SupportIssues and feature requests tracked through standard Odoo App Store channels. Response times aligned with enterprise SLA requirements. Priority support available for critical integration scenarios. |
Installation & Integration
Install this module as part of the Grevlin Marketplace Suite to enable Shopify integration with consolidated multi-marketplace analytics.
-
This module extends
grev_od_ecommerce_connectorand requires the base module to be installed first - Install additional provider modules (WooCommerce, BigCommerce, etc.) to enable consolidated multi-marketplace analytics
- All Shopify-specific functionality is isolated within this module, ensuring zero impact on other marketplace integrations
- Access unified analytics dashboards that aggregate Shopify data with other marketplace providers for comprehensive business intelligence
Multi-Marketplace Benefits: Combine Shopify with other marketplace providers to achieve unified analytics, consolidated inventory management, and cross-channel customer intelligence through the Grevlin Marketplace Suite platform.
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