> ## 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 Imweb data source to Adriel: authorize the Imweb Open API over OAuth, confirm the site, and sync orders and products.

Imweb (아임웹) is a Korean website builder with built-in e-commerce, popular with DTC merchants running a single branded storefront. Connecting it authenticates against the official Imweb Open API over OAuth 2.0 and syncs order and product data, from which sales metrics are reconstructed. The default currency is KRW.

## Before you connect

The following are required:

* An Imweb site with admin access and e-commerce enabled.
* Permission to grant OAuth 2.0 access for the Imweb Open API.
* The Imweb account that owns the storefront to be connected. The site code is captured automatically from the redirect URL during authorization.

## Connect Imweb

<Steps>
  <Step title="Select Imweb">
    On the **Data Sources** page, search for **Imweb** and select it.
  </Step>

  <Step title="Authorize via OAuth">
    Sign in to the Imweb account and grant the requested order and product scopes. The site code is captured automatically from the redirect URL, and the connector finalizes the integration handshake immediately after the token exchange. If the handshake fails, the connection cannot be saved.
  </Step>

  <Step title="Confirm the site">
    Confirm the Imweb site bound to the OAuth grant.
  </Step>

  <Step title="Save the connection">
    Click **Save** to register the connection and queue the initial sync.
  </Step>
</Steps>

## What gets imported

Orders and products are imported from the Imweb Open API. The product catalog is fully refreshed once per day. Orders refresh daily, or hourly for higher-volume sites, with the last 90 days of made-or-modified orders re-fetched on every cycle to capture cancellations and returns. Sales metrics — order count, payment amount, discounts, shipping, and refunds — are reconstructed from raw order, payment, cancellation, and return records; tax fields are not available from the Imweb Open API.

For the complete list of metrics and breakdowns, see the [Imweb data reference](/data-sources/g-n/imweb/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Connection breaks after a sync failure">
    Both the access token and the refresh token rotate on every refresh cycle, and the previous refresh token becomes invalid as soon as the new pair is issued. A partial failure during persistence can leave the connection unable to refresh. Reconnect through OAuth to restore it.
  </Accordion>

  <Accordion title="Save fails with an integration-complete error">
    After the OAuth authorization code is exchanged, the connector calls Imweb's integration-complete endpoint. A falsy response causes the credential exchange to fail outright. Confirm the Imweb account has accepted the integration and retry.
  </Accordion>

  <Accordion title="Cancellations or refunds older than 90 days do not update totals">
    Each refresh re-pulls orders made or modified in the last 90 days. Status transitions inside that window update reported metrics; transitions outside it do not.
  </Accordion>

  <Accordion title="Order Tax Amount shows as unavailable">
    The Imweb Open API does not expose tax fields on orders. Net-of-tax revenue calculations require deriving tax externally.
  </Accordion>

  <Accordion title="Refund totals exclude cancelled orders">
    Cancellation and return are separate sections on an Imweb order. Order Cancelled Payment Amount draws from cancellation refunds and return refunds separately; regular orders contribute zero to that metric.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Imweb data reference" href="/data-sources/g-n/imweb/data-reference">
    Metrics, breakdowns, and limits for Imweb.
  </Card>

  <Card title="Imweb FAQs" href="/data-sources/g-n/imweb/faqs">
    Common questions and expected behaviors for the Imweb data source.
  </Card>

  <Card title="How to connect Cafe24" href="/data-sources/a-f/cafe24/how-to-connect">
    Connect an alternative Korean DTC commerce platform.
  </Card>

  <Card title="How to connect Godomall" href="/data-sources/g-n/godomall/how-to-connect">
    Connect an alternative Korean DTC commerce platform.
  </Card>
</CardGroup>