> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arcuserp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Marketplace Connectors

> Marketplace connectors bring external orders, fulfillments, tracking updates, listings, and sync history into Arcus. Use this guide for Shopify, Amazon, eBay, and other marketplace-style connections managed from Integrations.

## Use Integrations For Connector-Owned Channels

Custom sales channels are managed from Sales Channels settings. Connector-owned channels,
such as Shopify, Amazon, and eBay, are managed from Integrations because the connector
controls order import, sync, status, and disconnect behavior.

<Frame caption={"Shopify uses the connector configuration surface for connection health, sync settings, mapping, webhooks, logs, and accounting tabs."}>
  <img src="https://mintcdn.com/arcuserp/MrJkb10V6EpIZu0o/images/support/screenshots/integrations/shopify-connect-modal.png?fit=max&auto=format&n=MrJkb10V6EpIZu0o&q=85&s=3a04caae46d2068340f6dc06fb7fe773" alt="Configure Shopify modal with connection tab, live mode, health status, last sync, reconnect, and disconnect actions" width="1200" height="1000" data-path="images/support/screenshots/integrations/shopify-connect-modal.png" />
</Frame>

## Shopify Connection Flow

1. Open **Integrations**.
2. Open the **Shopify** card.
3. If connecting for the first time, enter the store handle or myshopify.com domain.
4. Continue to Shopify and grant the requested access.
5. After returning to Arcus, open **Configure Shopify**.
6. Review Connection, Sync Settings, Mapping, Webhooks, Logs, and Accounting tabs.
7. Run a test sync or small order workflow before relying on production volume.

<Note>
  **Use the Shopify subdomain**
  Use the store's myshopify.com domain or admin store handle. Do not use a custom public
  storefront domain when connecting Shopify.
</Note>

## Shopify Configure Tabs

* **Connection**: connection health, mode, last sync, reconnect, and disconnect.
* **Sync Settings**: controls which Shopify data moves and how frequently.
* **Mapping**: connects Shopify data to Arcus records and locations.
* **Webhooks**: verifies real-time events from Shopify.
* **Logs**: shows recent connector activity and failures.
* **Accounting**: future or connector-specific accounting context when available.

<Warning>
  **Disconnecting stops future sync, not history**
  Disconnecting a marketplace connector stops future import or push activity. Existing
  orders, products, listings, accounting records, and audit history should remain in Arcus.
</Warning>

## Amazon And eBay Setup

Amazon and eBay use connector cards with credentials, environment selection, setup guides,
test actions, and logs. Their credentials and required permissions come from each external
marketplace account.

* **Amazon**: seller identity, marketplace, application credentials, refresh token, region, and FBA ship-from setup.
* **eBay**: application credentials and seller refresh token from the OAuth consent flow.
* **Mode**: use sandbox keys for test entities and production keys for live selling.
* **Logs**: use connector logs to review import, fulfillment, and sync failures.

## Use Sync Dashboard For Marketplace Troubleshooting

The Sync Dashboard helps admins review recent marketplace activity across connectors. Use
it when orders did not import, fulfillment did not push, or listing/report data seems stale.

<Frame caption={"Sync Dashboard separates inbound and outbound activity so admins can tell whether import or push work is delayed."}>
  <img src="https://mintcdn.com/arcuserp/MrJkb10V6EpIZu0o/images/support/screenshots/integrations/integrations-sync-dashboard.png?fit=max&auto=format&n=MrJkb10V6EpIZu0o&q=85&s=30a8e27816eb0be47dc13118671de5a9" alt="Sync Dashboard modal showing all, inbound, and outbound sync filters for marketplace and connector activity" width="1200" height="1000" data-path="images/support/screenshots/integrations/integrations-sync-dashboard.png" />
</Frame>

<Tip>
  **Separate channel defaults from connector health**
  If orders import but defaults look wrong, review Sales Channels settings. If orders do
  not import at all, start with the connector status, permissions, webhooks, and logs.
</Tip>

## Marketplace Drift And Missing SKU Review

Marketplace data can drift when a listing, SKU, inventory quantity, fulfillment, or price
changes outside Arcus. Use connector logs, product mapping, and listing performance to decide
whether Arcus or the marketplace should be corrected.

* **Missing SKU**: review whether the connector should auto-create a placeholder product or block for manual mapping.
* **Inventory drift**: compare Arcus available inventory, marketplace available inventory, open orders, transfers, and recent sync activity.
* **Price drift**: compare product price, pricing rules, marketplace listing price, and any marketplace-side override.
* **Fulfillment drift**: confirm whether tracking was pushed from Arcus or updated directly in the marketplace.
* **Deleted external record**: clear stale mapping only after confirming the marketplace record is truly gone.

## Common Blocks

* **Orders do not import**: check connector health, sync logs, store permissions, webhook status, and whether the order is inside the configured sync scope.
* **Fulfillment does not push back**: review fulfillment sync settings, tracking data, carrier/service mapping, and external order status.
* **Listings look unmapped**: review product SKUs, marketplace listing mapping, and external SKU consistency.
* **Wrong channel defaults apply**: review Sales Channels settings after confirming the connector is healthy.
* **Production marketplace connected to sandbox**: disconnect or reconnect with the correct environment and test before continuing.

## Related Articles

<CardGroup cols={2}>
  <Card title="Connector Dashboard" href="/support/integrations/connector-dashboard">
    Review connector mode, health, masked credentials, tests, logs, sync dashboard, and safe reconnect steps.
  </Card>

  <Card title="Connector Troubleshooting" href="/support/integrations/connector-troubleshooting">
    Recover authorization failures, webhook issues, sync delays, mode mismatch, and stale external records.
  </Card>

  <Card title="Marketplace Listings and Mapping" href="/support/products/marketplace-listings">
    Map Arcus products and variants to marketplace listings, resolve drift, and use Shopify Bulk Map.
  </Card>

  <Card title="Sales Channels and Customer Portal" href="/support/settings/sales-channels-portal">
    Configure order-source defaults, connector-owned channels, customer portal access, shared links, and portal branding.
  </Card>

  <Card title="Listings Performance" href="/support/reports/listings-performance">
    Analyze marketplace listings by channel, units sold, revenue, status, and zero-sales candidates.
  </Card>

  <Card title="Creating Orders" href="/support/orders/creating-orders">
    Build a sales order, add customers, set addresses, and add products.
  </Card>

  <Card title="Shipping Labels" href="/support/fulfillment/labels">
    Buy labels, void labels, track shipments, and handle carrier errors.
  </Card>
</CardGroup>
