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

# How to connect

> How to connect the Shopee data source to Adriel: choose a server and connection type, authorize the Shopee account, and select a shop.

Shopee is a Southeast Asian e-commerce marketplace with shop-level seller accounts across markets including Singapore, Malaysia, Indonesia, Thailand, Vietnam, the Philippines, and Taiwan. Connecting it reads shop orders and product catalog data from the Shopee Open Platform API v2, and is distinct from Shopee Ads, which covers paid advertising performance.

## Before you connect

The following are required:

* A Shopee shop with a Shopee Open Platform seller account that has API access on the target shop.
* Permission to authorize third-party applications on the Shopee account.

Each Shopee connection is scoped to a single data type — orders or products — locked at creation. Reporting that needs both requires two data sources per shop. Authorization can be granted at the single-shop level or at the merchant level, where one main account grants access to every shop under the merchant.

## Connect Shopee

<Steps>
  <Step title="Set the connection details">
    On the **Data Sources** page, search for **Shopee** and select it. Fill in the three required fields, then click **Submit**:

    * **Connection Name**: any identifiable name.
    * **Server**: choose between **Global** and **China**. To connect both, repeat the flow after the first connection completes.
    * **Connection Type**: choose between **Orders** and **Products**. To connect both, repeat the flow after the first connection completes.
  </Step>

  <Step title="Authorize the Shopee account">
    Sign in to the Shopee account when the pop-up window opens.
  </Step>

  <Step title="Select the shop">
    Choose the **Shop** to connect from the dropdown list, then click **Submit** to complete the connection. Initial data availability can take up to one business day.
  </Step>
</Steps>

## What gets imported

The connector imports orders and their revenue components (order amount, payment, tax, discount, shipping fee) along with product catalog data (name, SKU, price, status, image, and creation and update dates) from the Shopee Open Platform API v2. Currency follows the shop's regional Shopee marketplace (for example SGD, MYR, IDR, THB, VND, PHP, TWD). Products are fully refreshed daily, and orders made or modified within the last two days are re-synced at every refresh.

For the complete metric list, breakdown shape, and order-status semantics, see the [Shopee data reference](/data-sources/o-z/shopee/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Invalid signature errors">
    The most common cause is clock skew between Adriel and Shopee's servers; transient skew typically self-recovers within a few minutes. Persistent errors usually mean the OAuth tokens have expired or the partner credentials rotated upstream — disconnect and re-authorize to issue a fresh token pair.
  </Accordion>

  <Accordion title="Orders show up but products do not (or vice versa)">
    Each connection is locked to a single data type at creation. Create a second data source against the same shop and pick the other type.
  </Accordion>

  <Accordion title="Cancelled or refunded orders are inflating revenue">
    Cancelled and returned orders carry distinct Shopee order statuses. Some return categories adjust the original order's revenue, while others record separate negative entries. Break revenue down by order status when reconciling gross versus net sales.
  </Accordion>

  <Accordion title="Cross-region totals do not add up">
    Each shop reports in its regional currency. Aggregating across regions requires currency-aware normalization downstream, or one data source per region with conversions applied in the dashboard.
  </Accordion>

  <Accordion title="Merchant-level account is missing some shops">
    Merchant-level OAuth stores the shop list at authorization time. Newly added shops are not picked up retroactively — re-authorize the merchant connection to refresh the shop list.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Shopee data reference" href="/data-sources/o-z/shopee/data-reference">
    Metrics, breakdowns, order-status semantics, and limits for Shopee.
  </Card>

  <Card title="Shopee FAQs" href="/data-sources/o-z/shopee/faqs">
    Common questions and expected behaviors for the Shopee data source.
  </Card>

  <Card title="How to connect Shopee Ads" href="/data-sources/o-z/shopee-ads/how-to-connect">
    Connect Shopee paid advertising performance (separate connector).
  </Card>

  <Card title="How to connect Lazada" href="/data-sources/g-n/lazada/how-to-connect">
    Connect an alternative Southeast Asian marketplace.
  </Card>
</CardGroup>