N Nexus Docs
Foundation

Orders

Centralized order management with real-time sync across all connected marketplaces.

Overview

The Orders section consolidates every order from every connected marketplace into a single queue. Orders flow in via webhooks (where supported) or polling adapters, are normalized to NexusCommerce's internal order schema, and are available for fulfillment management, analytics, and customer service — without switching between marketplace dashboards.

Key Concepts

Order Lifecycle — Orders move through a standard lifecycle regardless of marketplace:

pendingconfirmedprocessingshippeddeliveredcompleted

Returns branch off to the return_initiatedreturn_receivedrefunded flow. See Returns.

Fulfillment Method — Each order line item has a fulfillment method:

  • FBM (Fulfilled by Merchant) — You ship the item
  • FBA (Fulfilled by Amazon) — Amazon ships from their warehouse
  • FBS (Fulfilled by Shopify) / marketplace-equivalent — Marketplace ships

NexusCommerce tracks all fulfillment methods but only requires action for FBM orders.

Order Source — The marketplace and connection that generated the order. Orders from Amazon US and Amazon UK are tracked as separate sources.

Getting Started

Navigate to Orders in the left sidebar. Orders are populated automatically by the adapter sync process.

To manually refresh the order queue, click Sync Now in the top-right. This triggers a full adapter pull for all active connections.

Features

Order List

The Orders list shows all orders with columns:

ColumnDescription
Order IDMarketplace-native order ID (e.g., 123-4567890-1234567 for Amazon)
MarketplaceMarketplace icon and name
CustomerCustomer name (where available)
ItemsNumber of line items
TotalOrder total in the marketplace currency
StatusCurrent lifecycle status
FulfillmentFBM / FBA / FBS indicator
DateOrder placement time

Filters available:

  • Status (pending, confirmed, processing, shipped, delivered, completed, cancelled)
  • Marketplace (any connected marketplace)
  • Fulfillment method (FBM, FBA, FBS)
  • Date range (custom or preset: today, yesterday, last 7d, last 30d)
  • Has returns (yes/no)

Order Detail Page

Click any order to open the detail view:

Header:

  • Order ID, marketplace, placement timestamp
  • Order status with timeline
  • Customer name and shipping address (where available)

Line Items:

  • SKU, title, quantity, unit price, line total
  • Fulfillment method per line item
  • Link to the product detail page

Shipment Section:

  • Carrier, tracking number (editable for FBM orders)
  • Estimated and actual delivery dates
  • Shipping cost

Sync History:

  • Log of every sync event for this order
  • Timestamp, event type, and raw payload (expandable)

Fulfillment Actions

For FBM orders in confirmed status, the Fulfillment Actions panel appears:

  • Mark as Shipped — Enter carrier and tracking number. NexusCommerce pushes the shipment confirmation to the marketplace via the adapter's shipping notification endpoint.
  • Request Cancellation — Sends a cancellation request to the marketplace. Note: cancellations are subject to marketplace approval and timing windows.
  • Print Packing Slip — Generates a PDF packing slip with order details and shipping address.

Bulk Actions

Select multiple orders from the list and use the Bulk Actions menu:

ActionApplicable Status
Export to CSVAny
Mark as Shipped (with tracking import)Confirmed
Generate packing slipsConfirmed, Processing

Tracking Import

For bulk fulfillment, upload a CSV with tracking numbers:

order_id,carrier,tracking_number
123-4567890-1234567,DHL,1234567890
234-5678901-2345678,UPS,1Z999AA10123456784

NexusCommerce matches by order_id, updates the shipment record, and pushes confirmations to the respective marketplaces.

Order Analytics

Aggregate order metrics are available in the Analytics section. On the Orders list, a summary row shows:

  • Total orders in current filter view
  • Total revenue in current filter view
  • Average order value

Configuration

SettingDescriptionDefault
Order lookback (initial sync)Days of historical orders to import30 days
Auto-confirm thresholdAuto-confirm orders under this valueDisabled
Packing slip templateCustom HTML template for packing slipsDefault template
Shipment carrier listCarriers available in the fulfillment dropdownAll carriers
FBM auto-alertAlert when FBM order is not shipped within N hours24 hours