Cin7 Omni
Quick Answer: The Cin7 Omni integration syncs your inventory, sales, and purchase orders to Moselle automatically. Setup currently requires assistance from Moselle support.
What is the Cin7 Omni Integration?
The Cin7 Omni integration connects your warehouse management system directly to Moselle's planning engine. It automates the flow of critical supply chain data, ensuring your forecasts and replenishment plans are based on real-time stock levels.
Key Benefits:
Automated Sync: Daily updates of inventory, sales, and orders.
Unified Planning: View all your warehouse data in one dashboard.
Accurate Forecasting: Use historical sales data from Cin7 to predict future demand.
Prerequisites
Time Required: 5-10 minutes (with Support) Difficulty: Easy
Before you begin, ensure you have:
How to Connect
Currently, the setup process is handled by our team to ensure proper configuration of your warehouse mappings.
Gather Your Credentials
Log in to Cin7 Omni and retrieve your Account ID and generate an API Application Key.
Contact Support
Email [email protected] with your credentials and request the Cin7 Omni integration activation.
Verification
Once configured, our team will confirm that data is flowing correctly. You should see your products and inventory populate in Moselle within 24 hours.
Data Synchronization Details
Sync Schedule
Moselle performs a full sync daily. This ensures your "Stock on Hand" and order statuses are current.
Data Sync Strategy: The 90-Day Lookback
To keep your account fast and responsive, Moselle uses a "Lookback Period" strategy for syncing large datasets.
Why we do this: Instead of re-downloading your entire history every single day (which can be slow and cause timeouts), we only check for changes made in the last 90 days. This is efficient because historical data rarely changes once an order is closed.
What you need to know: If you need to update an old record, you must be mindful of this window.
Recent Update: Prior to January 21, 2026, the lookback period for Branch Transfers was limited to 2 days. If you find transfers missing from before this update, please request a historical re-sync.
Backdating Limitation
If you modify a Sales Order, Purchase Order, or Branch Transfer to a date older than 90 days, Moselle will not see the change automatically because it falls outside the daily sync window.
Fix: If you must change data older than 90 days, please contact [email protected] to request a one-time "Historical Re-sync."
Data Mapping
Products
Name
name
SKU
productOptions.code
Unique identifier used for matching.
Category
category
Used for grouping in forecasts.
Sales Orders (Historical Sales)
Order Number
reference
Date
invoiceDate
Only "Dispatched" orders are imported.
Channel
Derived
Mapped based on settings; Shopify orders excluded.
Purchase Orders
Order Number
reference
Status
status
Voided Purchase Orders in Cin7 are imported as Archived in Moselle.
Inventory
Available
available
Stock currently available for sale.
Incoming
incoming
Stock on order (PO).
Branch
branchId
Mapped to Moselle Warehouses.
Branch Transfers
Reference
reference
Used as the Order Number in Moselle.
Source
sourceBranchId
The sending warehouse.
Destination
destinationBranchId
The receiving warehouse.
Status
Derived
Maps to Moselle's Draft, Active, or Delivered states.
How Transfers Work in Moselle
Moselle treats Cin7 Omni Branch Transfers as a type of replenishment. This allows you to plan stock movements between your own warehouses just like you plan purchases from suppliers.
Transfers as Purchase Orders
In the Moselle app, your Cin7 Branch Transfers are displayed alongside your regular Purchase Orders. This provides a unified view of all incoming stock for any specific warehouse.
In-Transit Visibility: When a transfer is "Dispatched" in Cin7, Moselle shows it as "Active" in your replenishment plan, accurately reflecting stock that is currently in transit.
Replenishment Planning: Moselle's engine accounts for these transfers when calculating your "Projected Stock," ensuring you don't over-order from suppliers when a transfer is already on its way.
Troubleshooting & FAQ
Custom fields not mapping
Contact Support to map specific Cin7 attributes to Moselle.
Missing recent orders
Check if the order is marked as "Dispatched" in Cin7. Only dispatched orders are imported.
Inventory count mismatch
Verify that the correct Warehouses are enabled in settings and products exist in Moselle.
Duplicate sales
Ensure "Shopify" orders aren't being double-counted if both integrations are active.
Can I trigger a manual sync?
Yes, typically via Settings > Integrations or Beta tab in Moselle.
Does Moselle write data back to Cin7?
No, the integration is currently one-way (Cin7 to Moselle) for planning purposes.
Why aren't my open orders showing?
Moselle only imports "Dispatched" orders for sales history. Open/pending orders are excluded.
Last updated