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

# Shopify Connector

> Set up Shopify import integration and field mapping.

## Overview

Shopify is typically used for catalog and order feeds, with optional inventory sync by location.
Normalize Shopify IDs into stable external identifiers before import.

## Common Mapping

| Shopify Field                | Better Data Field             | Notes                              |
| ---------------------------- | ----------------------------- | ---------------------------------- |
| `variants.sku`               | `products[].externalId`       | Preferred SKU key                  |
| `products.title`             | `products[].name`             | Catalog display name               |
| `orders.id`                  | `orders[].externalOrderId`    | Prefix if needed for uniqueness    |
| `line_items.sku`             | `orders[].lines[].skuId`      | Order line SKU                     |
| `line_items.quantity`        | `orders[].lines[].quantity`   | Ordered quantity                   |
| `fulfillment location`       | `orders[].lines[].locationId` | Map to Better Data location code   |
| `inventory_levels.available` | `levels[].quantityOnHand`     | Treat as absolute on-hand snapshot |

## Example Orders Payload

```json theme={null}
{
  "orders": [
    {
      "externalOrderId": "SHOPIFY-112233",
      "lines": [
        { "skuId": "SKU-001", "quantity": 2, "locationId": "DC-EAST" }
      ]
    }
  ]
}
```