# Setup E-Commerce Store

**VU OS** offers pre-configured "One-Click" integrations with many E-Commrce platforms such as Shopify, Salesforce, Oracle, and others. VU OS also is built on an **Open Integration Architecture**. This means \***any platform** can be connected to VU OS to power a customized product experience.

\*Platforms must have an accessible catalog and cart API

## **Integration Types: OOTB vs. Custom**

When setting up your store in the VU Admin Panel (**Settings > Stores**), you can choose between two primary paths:

### **1. Out-of-the-Box (OOTB) Configurations**

These are pre-built templates where VU OS already understands the API language of the platform. You need to provide the credentials.

<figure><img src="https://3295576361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP4xZUKOSmKW52VquplA7%2Fuploads%2FskA5u6nocr3xd3FS9QGL%2Fimage.png?alt=media&#x26;token=5dc13155-863d-472b-bb56-fadaf31b00d5" alt=""><figcaption></figcaption></figure>

| Platform        | Required Fields (per VU OS UI)                                      |
| --------------- | ------------------------------------------------------------------- |
| **BigCommerce** | Name\*, URL\*, Access Token\*, Token Secret\*                       |
| **EMUN**        | Name\*, EMUN URL\*                                                  |
| **Magento**     | Name\*, Magento URL\*, Access Token\*                               |
| **Odoo**        | Name\*, URL\*, Db Name\*, Username\*, API Key\*                     |
| **Oracle ATG**  | Name\*, ATG URL\*, Username\*, Password\*                           |
| **Salesforce**  | Name\*, Salesforce URL\*, Client Hash\*, Site ID\*, Version ID      |
| **Shopify**     | Name\*, Shopify URL\*, Shopify Token\*, Fulfillment/Webhook Toggles |
| **WooCommerce** | Name\*, Woo URL\*, Consumer Key\*, Secret\*                         |

### **2. Custom & Unlisted Platforms (Standalone Path)**

If your platform is not listed above (e.g., a custom React/Vue build, or an unlisted ERP-driven store), select **Standalone Store**.

<figure><img src="https://3295576361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP4xZUKOSmKW52VquplA7%2Fuploads%2F3UPAex6yLKBz5ZPFxVdU%2Fimage.png?alt=media&#x26;token=7128d151-d3e8-4fe8-bd9f-cf10e4faee4f" alt=""><figcaption></figcaption></figure>

* **The Standalone Advantage:** This allows you to use the **VU OrderAPI**. Your development team can "push" order data (including the vital RecipeID) directly to VU OS using our standardized API endpoints.
* **Field Requirements:** Only **Name**\* and **Standalone Store URL**\* are required in the initial configuration.

<figure><img src="https://3295576361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP4xZUKOSmKW52VquplA7%2Fuploads%2FWjz3HnDb0ie5iw0Y0WTg%2Fimage.png?alt=media&#x26;token=c45bd21a-b2d9-4493-b7bb-7e9626ead4f8" alt=""><figcaption></figcaption></figure>

***

## **Global Configuration Standards**

Regardless of the platform you choose (OOTB or Standalone), you will always configure the following global settings as shown in your VU OS dashboard:

1. **Store Key:** A unique internal ID that connects your storefront calls to this specific store instance in VU OS.
2. **Currency:** Supports global currencies including&#x20;
   * Major: USD, EUR, GBP, CAD, AUD.
   * Regional: AED, SAR, JPY, CNY, etc. (Full list available in the selection menu).
3. **Locale:** Defines the default language/regional context for order data.&#x20;
4. **Store Domain:** Your customer-facing web address (e.g., [www.yourbrand.com](http://www.yourbrand.com)).

***

## **How the Integration Works (Universal Logic)**

VU OS creates a relationship between your e-commerce catalog and your custom product templates. No matter which platform you use, the "handshake" follows this standard process:

* **Order Ingestion:** When an order is placed on your storefront, the store notifies VU OS via **Webhook** (Pull) or **API Call** (Push).
* **The RecipeID:** This is a mandatory piece of information for all custom orders. It is the "digital blueprint" of the customer's design. Your store sends this ID to VU OS to ensure the factory produces exactly what the customer saw.
* **Two-Way Fulfillment:** Once an order is processed in VU OS, the system can push a "Shipped" status back to your store, automatically updating your customer's tracking information.

***

## **Next Steps**

1. **Select Your Store Type:** Go to VU OS Settings and click "Create Store."

<figure><img src="https://3295576361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP4xZUKOSmKW52VquplA7%2Fuploads%2FdZiISAteJjPPri2QEXP9%2FScreenshot%202024-10-14%20at%2012.23.03%E2%80%AFPM.png?alt=media&#x26;token=97f9ad7c-4ae1-46a1-bc1b-b98798c77d91" alt="" width="375"><figcaption></figcaption></figure>

2. **Gather Credentials:** Use the platform-specific guides to find your API keys or Access Tokens.
3. **Link your Products:** After the store is created, proceed to Product Linking to map your SKUs to their respective VU templates.

> **Need help with a Custom Platform?**\
> If you are using the **Standalone** path, our team will assist you with your integration&#x20;