Skip to content
2 changes: 1 addition & 1 deletion docs/integration/xstore/dashboard.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
sidebar_position: 4
title: Dashboard
description: A guide on Dashboard
description: Guide to Dashboard
slug: /integration/xstore/dashboard
tags: ["e-Commerce", "X-Store", "Dashboard"]
---
Expand Down
18 changes: 6 additions & 12 deletions docs/integration/xstore/getting-started.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
---
sidebar_position: 1
title: Getting Started
description: A guide to getting started
description: Guide to Getting Started
slug: /integration/xstore/getting-started
tags: ["e-Commerce", "X-Store", "Getting Started"]
---

## Sign In

If you already have an account, you can [sign in](https://x-store-demo.sql.com.my/login) using one of the following methods:
If you already have an account, you can [sign in](https://x-store.sql.com.my/login) using one of the following methods:

- **Sign in with Passkey** - Use your registered passkey for quick and secure access
- **Sign in with Email** - Enter your email address and click the verification link to sign in
- **Sign in with Passkey** - Use your registered passkey for quick and secure access.
- **Sign in with Email** - Enter your email address and click the verification link to sign in.
- **Google Single Sign-On (SSO)** - Sign in with your Google account (Gmail only). Click the Google button, select your Gmail account, and you'll be signed in automatically.

For detailed instructions, please refer to the [sign up section](#sign-up) below.
Expand All @@ -20,7 +20,7 @@ For detailed instructions, please refer to the [sign up section](#sign-up) below

## Sign Up

If you don't have an account yet, click [sign up here](https://x-store-demo.sql.com.my/register) to create a new account.
If you don't have an account yet, click [sign up here](https://x-store.sql.com.my/register) to create a new account.

### Sign Up with Passkey

Expand Down Expand Up @@ -53,7 +53,7 @@ Passkeys provide a secure, passwordless way to access your account.
6. Use your smartphone to scan the QR code displayed

:::info
Ensure both **Bluetooth** and **WiFi/Mobile data** are turned on for both your laptop and smartphone.
Ensure both **Bluetooth** and **Wi-Fi/Mobile data** are turned on for both your laptop and smartphone.
:::

![passkey-creation](../../../static/img/xstore/getting-started/passkey-creation.png)
Expand Down Expand Up @@ -98,12 +98,6 @@ For email-based registration:

8. Once successful, you'll be redirected to the **Company List** page

## Try Demo

Feel free to explore the available features in X-Store by using **Try Demo** without signing in.

![demo-overview](../../../static/img/xstore/getting-started/demo-overview.png)

## Company List Page

After successful sign-in or sign-up, you'll land on the **Company List** page.
Expand Down
68 changes: 0 additions & 68 deletions docs/integration/xstore/inventory.md

This file was deleted.

9 changes: 9 additions & 0 deletions docs/integration/xstore/inventory/_category_.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
{
"label": "Inventory",
"position": 6,
"link": {
"type": "generated-index",
"slug": "/integration/x-store/inventory-category",
"description": "Guide to Inventory"
}
}
94 changes: 94 additions & 0 deletions docs/integration/xstore/inventory/products.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,94 @@
---
sidebar_position: 1
title: Products
description: Guide to managing products in X-Store
slug: /integration/xstore/products
tags: ["e-Commerce", "X-Store", "Inventory", "Products"]
---

The **Manage Products** page allows you to view and manage all products across your connected platform stores. X-Store currently supports 5 platforms: **Lazada**, **Shopee**, **TikTok**, **Shopify**, and **WooCommerce**. You can quickly find specific products by searching using **store name**, **product name**, **product id**, **shop sku** or **seller sku**.

![product-overview](../../../../static/img/xstore/products/product-overview.png)

## Create Product

The **Create Product** feature allows you to publish new products to a specific store on your chosen platform.

![create-overview](../../../../static/img/xstore/products/create-overview.png)

### Basic Flow

1. **Select Platform and Store**: Choose the platform and the relevant store where you want to create your product.

![create-select](../../../../static/img/xstore/products/create-select.png)

2. **Fill in Product Information**: Complete all required fields across five form steps:
- Basic Information
- Product Description
- Product Specifications
- Product Variants
- Other Information

![create-form](../../../../static/img/xstore/products/create-form.png)

3. **Save and Publish**: After saving, wait a moment for the product to be created. Your product will be successfully created and activated in the seller center. You will then be redirected to the product list page, where your newly created product will automatically appear.

![create-save](../../../../static/img/xstore/products/create-save.png)

### Specific Information

1. Product variants may have different configuration options based on the platform.

- **Pre-Order** allows customers to purchase products that require additional preparation time. When you enable Pre-Order, you need to specify the number of days needed to ship the product after receiving an order.

- **GTIN Code** (Global Trade Item Number) is a unique identifier used to distinguish products and services in the supply chain. When you enable GTIN Code, you need to enter a specific numerical code for product identification.

- When your product has more than two variant combinations, **Per-Variant Dimensions** allows each combination to have its own dimensions and weight. When enabled, you'll need to fill in the specific dimensions and weight parameters for each variant combination.

- If multiple variant combinations share similar information, you can use the **Apply to Selected** feature for convenience as you will just need to input information once and the information will automatically apply to all selected variants.

![create-variants](../../../../static/img/xstore/products/create-variants.png)

2. In the **Other Information** section, you'll find logistics details.

- If your input weight or dimensions **exceed the logistics item limit**, the specific logistics option will be disabled.

- You can read the **error hint** and **logistics item limit** in the tooltip.

- You can adjust your product dimensions or weight according to the limits if you wish to use specific logistics options.

![create-logistics](../../../../static/img/xstore/products/create-logistics.png)

## Copy Listing

**Copy Listing** allows you to duplicate an existing product to another store. This feature supports one-to-one cross-platform copying, making it faster and easier to create similar products across different stores and platforms.

- Most common product information will be copied automatically
- **Platform-specific details** need to be filled in manually

![copy-overview](../../../../static/img/xstore/products/copy-overview.png)

![copy-details](../../../../static/img/xstore/products/copy-details.png)

## Edit Product

The **Edit Product** feature allows you to update product information if you discover any outdated or incorrect information in your product details.

![edit-overview](../../../../static/img/xstore/products/edit-overview.png)

![edit-details](../../../../static/img/xstore/products/edit-details.png)

## Deactivate Product

You can change your product status between active and inactive:

- **Deactivate**: Update an active product to inactive status to unlist it from the platform
- **Activate**: Update an inactive product to active status to publish it again on the platform

![deactivate-overview](../../../../static/img/xstore/products/deactivate-overview.png)

## Delete Product

The **Delete Product** feature allows you to permanently remove a product from both X-Store and your platform's seller center.

![delete-overview](../../../../static/img/xstore/products/delete-overview.png)
75 changes: 75 additions & 0 deletions docs/integration/xstore/inventory/scrape.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
---
sidebar_position: 3
title: Scrape Product
description: Guide to Scrape Product
slug: /integration/xstore/scrape
tags: ["e-Commerce", "X-Store", "Inventory", "Scrape Product"]
---

Scrape Products from E-Commerce Platforms

1. Click **Scrape Product** in the sidebar

![scrape-sidebar](../../../../static/img/xstore/scrape/scrape-sidebar.png)

2. Click **Scrape Platforms**

![scrape-platform](../../../../static/img/xstore/scrape/scrape-platform.png)

3. Choose a platform from the dropdown to visit its official website for copying product URL

![choose-platform](../../../../static/img/xstore/scrape/choose-platform.png)

4. Paste URL and press **Enter** on keyboard or Click **Download** button for scraping

![paste-link](../../../../static/img/xstore/scrape/paste-link.png)

![scrape-inProgress](../../../../static/img/xstore/scrape/scrape-inProgress.png)

5. After successful scraping

- A success message will appear

- The product will be added to the data table.

![scrape-success](../../../../static/img/xstore/scrape/scrape-success.png)

6. Can click **Trash** icon to delete the product

![delete-scrape](../../../../static/img/xstore/scrape/delete-scrape.png)

7. Click **Continue** to delete

![delete-confirm](../../../../static/img/xstore/scrape/delete-confirm.png)

8. Can click **Edit** icon to edit the product details

![edit-scrape](../../../../static/img/xstore/scrape/edit-scrape.png)

9. Click any section on the left to scroll automatically to the corresponding section

10. Click **Update** to update the changes

![edit-confirm](../../../../static/img/xstore/scrape/edit-confirm.png)

11. Can click **Create** icon to create the product in the selected store

![create-scrape](../../../../static/img/xstore/scrape/create-scrape.png)

12. Select **Platform** and **Store**, then click **Select Store**

![select-create](../../../../static/img/xstore/scrape/select-create.png)

📌 For detailed instructions on creating product, navigate to **Integration > XStore > [Products](./products.md)**

13. To clear all scrape products, can click **Clear All** button

![clear-scrape](../../../../static/img/xstore/scrape/clear-scrape.png)

14. Click **Continue** to delete

![delete-all](../../../../static/img/xstore/scrape/delete-all.png)

📌 The maximum scrape limit is 5 products. Please delete some products before continuing

![scrape-limit](../../../../static/img/xstore/scrape/scrape-limit.png)
78 changes: 78 additions & 0 deletions docs/integration/xstore/inventory/stocks.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
---
sidebar_position: 2
title: Stocks
description: Guide to Stocks
slug: /integration/xstore/stocks
tags: ["e-Commerce", "X-Store", "Inventory", "Stocks"]
---

## Overview

The **Stocks** module allows you to view and manage stock items synced from SQL Account.

:::info
For more information regarding **Sync Stock Item**, please refer to **[Setup](../setup.md#step-5-sync-stock-items-from-sql-account)**
:::

![stock-overview](../../../../static/img/xstore/stocks/stock-overview.png)

## Map Products

Mapping platform products to stock items allows you to manage stock and quantity using the main stock item, improving stock quantity accuracy. There are two ways to map products:

### Map Multiple Stock Items

1. Go to **Inventory > Stocks**

2. Click the **Map Product** button

![multi-stock-item-map](../../../../static/img/xstore/stocks/multi-stock-item-map.png)

3. Select the **Platform Products** and then a **Stock Item** to map them together

![multi-stock-item-dialog](../../../../static/img/xstore/stocks/multi-stock-item-dialog.png)

:::info
Use the **Filter Button** to narrow your **Platform Products** view, or use the **Search Bar** to find specific e-commerce products and stock items.
:::

### Map Single Stock Item

1. Go to **Inventory > Stocks**

2. Click the icon to view stock details

![single-stock-item-map](../../../../static/img/xstore/stocks/single-stock-item-map.png)

:::info
**Location Description** and **Code** are fetched from SQL Account
:::

3. Click the **Map Product** button

![stock-details](../../../../static/img/xstore/stocks/stock-details.png)

4. Select the **Platform Products** and click **Map Product** to map them directly to this **Stock Item UOM**

![single-stock-item-dialog](../../../../static/img/xstore/stocks/single-stock-item-dialog.png)

:::info
Ensure your store is mapped to the correct stock item location, or mapped items won't appear.
To map the location code, please refer to **[Setup](../setup.md#step-4-code-mapping)**
:::

## Update Quantity

1. Go to **Inventory > Stocks**

2. Click the icon to view stock details

![single-stock-item-map](../../../../static/img/xstore/stocks/single-stock-item-map.png)

3. Click the **+/-** icon

![update-quantity](../../../../static/img/xstore/stocks/update-quantity.png)

4. Click the **Update** button to update the mapped products' quantity with the stock item's quantity

![update-quantity-dialog](../../../../static/img/xstore/stocks/update-quantity-dialog.png)
Loading