Your Shopify store, connected.

NovexERP connects to Shopify using a standard OAuth flow configured with your SHOPIFY_CLIENT_ID and SHOPIFY_CLIENT_SECRET environment variables. During the authorization handshake, HMAC validation ensures the request originated from Shopify. You configure which API scopes the integration needs, and the resulting access token is stored securely in the shopify_shops table alongside the shop domain and metadata.

Product synchronization maps Shopify product IDs to NovexERP product IDs through the shopify_product_mappings table. This mapping lets incoming orders automatically resolve to the correct internal products without manual intervention. Bulk customer synchronization is also available, importing customer records from Shopify so that order history and contact details stay consistent across both systems.

Webhooks are the backbone of real-time data flow. NovexERP registers for a comprehensive set of Shopify topics: orders/create, orders/updated, orders/paid, orders/cancelled, orders/fulfilled, orders/partially_fulfilled, orders/delete, refunds/create, fulfillment_orders/assigned, fulfillment_orders/cancelled, fulfillment_orders/closed, customers/create, and customers/update. Every incoming webhook payload is verified using the X-Shopify-Hmac-Sha256 header with SHA256 signature validation against the raw request body. Events are stored idempotently using a unique constraint on the combination of shop_domain and webhook_id, so duplicate deliveries from Shopify are safely ignored.

Event processing uses a claim-lock worker pattern to prevent duplicate processing. A background cron job claims pending events by writing its hostname and PID to the event record, then processes them sequentially. If processing fails, the event is retried with configurable retry logic defaulting to 8 attempts with exponential backoff. This approach ensures reliable synchronization even when temporary errors occur. For full details on the event queue, see the Webhooks event processing page.

When you ship an order that originated from Shopify, NovexERP automatically detects the Shopify origin and pushes fulfillment data back via the GraphQL API. The tracking number and carrier information are sent to Shopify, which then notifies the customer directly. This closes the loop between your ERP shipping workflow and the customer-facing Shopify storefront. For order lifecycle details, see Orders.