Shopify Integration

Overview

Nexus syncs orders, customers, and fulfillment status with Shopify stores. When a customer places an order on Shopify, it automatically appears in Nexus. Fulfillment updates in Nexus are pushed back to Shopify.

Capabilities

• Automatic order sync (create, update).
• Customer sync and merge with CRM contacts.
• Fulfillment status push-back.
• Abandoned cart detection and recovery.
• Shopify KPI import for analytics.

Required permissions / scopes

• read_orders, write_orders
• read_customers
• read_products
• read_fulfillments, write_fulfillments

Edge Functions

Function	Direction	Purpose
shopify-webhook	Inbound	Receives Shopify order/customer events
shopify-webhook-public	Inbound	Public webhook endpoint for Shopify
shopify-orders	Read	Fetches orders from Shopify
shopify-order-update	Outbound	Pushes order updates to Shopify
shopify-fulfill	Outbound	Updates fulfillment status in Shopify
shopify-abandoned	Read	Fetches abandoned carts
fetch-shopify-customer	Read	Fetches customer by phone/email
fetch-shopify-customer-by-id	Read	Fetches customer by Shopify ID

Webhook setup

Nexus registers Shopify webhooks automatically during connection. Topics: orders/create, orders/updated, customers/create, customers/update.

Common troubleshooting

Issue	Resolution
Orders not syncing	Verify Shopify API credentials. Check webhook registration in Shopify Admin → Settings → Notifications → Webhooks.
Duplicate orders	Check for duplicate webhook deliveries. The system deduplicates by shopify_order_id.
Fulfillment not pushing back	Ensure write_fulfillments scope is granted.