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

# Datamodels

> How Kariz uses Shopify Datamodels

To make setting up an integration to Kariz as easy as possible, we use the same data models as the Shopify REST API Version 2025/04. This is done to allow you to reuse your existing connector to Shopify. The setup process to connect to new channels should only take a few hours if you already have a Shopify integration.

## Simplified API Structure

We've simplified the API structure to allow you to fetch all the product & order information in a single call:

* For **products**, this includes products, variants, inventory and inventory location across different channels.
* For **orders**, this returns the order information, shipments, fulfillment and refund info all in one call.

This approach ensures you have access to all possible data without needing to set up calls to multiple endpoints.

## Exceptions

By default, we return all of the data that is available from the E-commerce platforms. When a platform doesn't support some functionality, we simply leave it out of the response. For example, some channels don't include inventory location information.

Here is an overview of the exceptions by channel:

| Channel     | Exceptions                                                                                                                |
| ----------- | ------------------------------------------------------------------------------------------------------------------------- |
| Shopify     | None                                                                                                                      |
| WooCommerce | No inventory location [user needs to install this add-on](https://wordpress.org/plugins/stock-locations-for-woocommerce/) |
| BigCommerce | None                                                                                                                      |
| Lightspeed  | None                                                                                                                      |
| Amazon      | None                                                                                                                      |
| Bol         | None                                                                                                                      |
| Mirakl      | None                                                                                                                      |
| Magento     | None                                                                                                                      |

## Product Data

The unified product data model includes inventory details for all product variants. With one API call, you receive:

<CardGroup cols={1}>
  <Card title="Products" icon="shirt">
    Core product details including title, description, and options
  </Card>

  <Card title="Product Variants" icon="palette">
    All variations of each product with their specific attributes
  </Card>

  <Card title="Inventory" icon="warehouse">
    Current stock levels for each product variant
  </Card>

  <Card title="Inventory Levels by Location" icon="location-dot">
    Stock levels broken down by physical location (if applicable)
  </Card>
</CardGroup>

For more details on product models, refer to the Shopify 2025/04 REST API Documentation:

* **Products**: [API Documentation](https://shopify.dev/docs/api/admin-rest/2025-04/resources/product)
* **Product Variants**: [API Documentation](https://shopify.dev/docs/api/admin-rest/2025-01/resources/product-variant)
* **Inventory**: [API Documentation](https://shopify.dev/docs/api/admin-rest/2025-01/resources/inventorylevel)
* **Inventory Level**: [API Documentation](https://shopify.dev/docs/api/admin-rest/2025-01/resources/inventorylevel)
* **Inventory Location**: [API Documentation](https://shopify.dev/docs/api/admin-rest/2025-01/resources/location)

## Order Data

The unified order data model includes comprehensive information about orders, their fulfillment status, and financial details. With one API call, you receive:

<CardGroup cols={1}>
  <Card title="Orders" icon="cart-shopping">
    Complete order details including customer information and line items
  </Card>

  <Card title="Shipments" icon="truck">
    Fulfillment status and shipping information for each order
  </Card>

  <Card title="Refunds" icon="rotate-left">
    Any refunds associated with the orders
  </Card>
</CardGroup>

For more details on order models, refer to the Shopify 2025/04 REST API Documentation:

* **Orders**: [API Documentation](https://shopify.dev/docs/api/admin-rest/2025-04/resources/order)
* **Shipments**: [API Documentation](https://shopify.dev/docs/api/admin-rest/2025-04/resources/fulfillment)
* **Refunds**: [API Documentation](http://shopify.dev/docs/api/admin-rest/2025-04/resources/refund)