Shopify Integration

The Shopify integration connects your Shopify online store(s) with NexWave, enabling multi-store management with automatic synchronisation of products, orders, inventory, and customer data.

Key Differentiator: Multi-Store Architecture

Unlike single-store integrations, the NexWave Shopify connector is designed from the ground up for multi-store operations:

• Connect multiple Shopify stores to a single NexWave instance

• Each store maps to a specific Company for proper accounting separation

• Manage AU, NZ, US stores (or any regional stores) from one central system

• Independent configuration per store

Data Flow Overview

Features Overview

Item Synchronisation

Direction: NexWave → Shopify (Push Only)

• Push product data from NexWave Items to Shopify

• Flexible field mapping to Shopify standard fields or metafields

• Per-store field mapping configuration

• Automatic SKU assignment (item_code → SKU)

• Inventory tracking enabled for stock items

Item Eligibility Control:

• Manual override per item per store

• Automatic eligibility filters (e.g., "if AU RRP has value, sync to AU store")

• Filter types: Field Has Value, Field Equals, Field Not Empty

For Existing Shopify Products:

• SKU-based pre-mapping tool for migrations

• Fetch products from Shopify and match by SKU to NexWave items

• Migration report showing matched, unmatched, and conflicts

Collection Mapping

• Map NexWave field values to Shopify Custom Collections

• Example: item_group "Outdoor" → Shopify Collection "Outdoor Living"

• Example: brand "Artisan" → Shopify Collection "Artisan Collection"

• Automatic collection assignment during item sync

Order Synchronisation

Direction: Shopify → NexWave (Pull via Webhooks)

• Webhook-based real-time order sync

• HMAC signature validation for security

• Store resolution via X-Shopify-Shop-Domain header

• Orders routed to correct Company based on store configuration

• Global customers (email-based lookup across stores)

Order Automation Options:

• Auto-submit Sales Order for paid orders

• Auto-create Sales Invoice (requires auto-submit)

• Auto-create Payment Entry (requires auto-create invoice)

• Configurable Cash/Bank account for payment entries

Custom Fields on Sales Order:

• Shopify Store reference

• Shopify Order ID

• Shopify Order Number

• Financial Status

• Fulfillment Status

Tax Handling

The connector uses an "On Net Total" approach for tax calculation, which provides cleaner tax rows and handles large orders efficiently.

How It Works:

1. Single GST Row - Instead of creating a tax row per line item, a single "On Net Total" GST row is created at the order level

2. Zero-Rated Detection - Items marked as non-taxable in Shopify (taxable=false or empty tax_lines) are automatically detected

3. Item Tax Templates - Zero-rated items can have an Item Tax Template applied for proper GST/BAS reporting

4. Multi-Region Support - Handles different tax rates automatically (e.g., NZ 15% GST, AU 10% GST)

Tax Calculation Flow:

Shipping Options:

• As Line Item - Shipping added as an item, taxed via the On Net Total GST row

• As Tax Row - Shipping added as an "Actual" tax row with separate GST on shipping

Rounding Adjustments:

Due to differences in tax calculation between Shopify and NexWave (especially with tax-inclusive pricing), small discrepancies may occur. The connector automatically applies a rounding adjustment using:

1. Store-level Write Off Account (if configured)

2. Company's default Write Off Account (fallback)

Tax Configuration Options:

Fulfillment Synchronisation

Direction: Shopify → NexWave (Pull via Webhooks)

• Webhook-based fulfillment sync (orders/fulfilled, orders/partially_fulfilled)

• Automatic Delivery Note creation when orders are fulfilled in Shopify

• Duplicate prevention - checks for existing Delivery Notes before creating

• Partial fulfillment support - option to create DNs for remaining quantities

• Tracking information captured from Shopify fulfillment data

Customer & Address Handling

• Customer lookup by shopify_customer_id first, then by email

• Addresses deduplicated by content (title, address_line1, city, country)

• Both billing and shipping addresses set on Sales Order

• Global customer base across all connected stores

Inventory Synchronisation

Direction: NexWave → Shopify (Push)

• Push stock levels from NexWave warehouses to Shopify locations

• Warehouse-to-Location mapping per store

• Multi-location support within Shopify

• Configurable sync frequency per store

• Real-time stock updates to prevent overselling

Multi-Store Use Cases

Regional Stores

Brand Stores

Custom Fields Added

The integration adds custom fields to track Shopify data:

Data Flow Summary

Store Configuration Options

Each Shopify Store in NexWave can be configured with:

• Authentication - Shop domain and OAuth credentials (or legacy access token)

• Company Mapping - Which NexWave company receives orders

• Warehouse Mappings - NexWave warehouses to Shopify locations

• Field Mappings - Item fields to Shopify fields/metafields

• Collection Mappings - NexWave values to Shopify collections

• Item Filters - Auto-eligibility rules for items

• Tax Mappings - Shopify tax titles to NexWave accounts, templates, and write-off account

• Order Settings - Auto-submit, auto-invoice, payment accounts

• Webhook Events - Control which events are processed

Permissions

Related Documentation

• Shopify Connector Setup Guide - Guide on setting up Shopify connector on NexWave

• Selling - Sales Order management in NexWave

• Stock - Inventory management

• Accounting - Financial management