# Product Integration (XML Feed)

### 1. Requirements

The XML feed should be segmented by each unique combination of country, language, and currency to ensure accurate localization. 

| Parameter          | Description                             | Required for Separate Feed? |
| ------------------ | --------------------------------------- | --------------------------- |
| `target_country`   | Country where the product is sold       | ✅                           |
| `content_language` | Language used for product content       | ✅                           |
| `currency`         | Currency in which the product is priced | ✅                           |

> **Rule of thumb**:\
> You must provide **one XML feed per unique combination** of `target_country` + `content_language` + `currency`

### 2. XML Tags & Descriptions

| Field                       | Description                                  | Required       |
| --------------------------- | -------------------------------------------- | -------------- |
| `id`                        | Unique ID of the variant (e.g. color + size) | ✅              |
| `item_group_id`             | Common ID for all variants of a product      | ✅              |
| `title`                     | Product title (localized)                    | ✅              |
| `description`               | Product description (localized)              | ✅              |
| `link`                      | Product detail page URL (localized)          | ✅              |
| `image_link`                | Main image of the variant                    | ✅              |
| `additional_image_link`     | Additional images for the variant            | ✅ if available |
| `brand`                     | Product brand                                | ✅              |
| `product_type`              | Product taxonomy (breadcrumb-style format)   | ✅              |
| `price`                     | Regular price                                | ✅              |
| `sale_price`                | Promotional price (if applicable)            | ❌              |
| `sale_price_effective_date` | Promotion date range (ISO 8601 format)       | ❌              |
| `availability`              | Stock status (`in stock`, `out of stock`)    | ✅              |
| `size`                      | Variant size                                 | ✅              |
| `color`                     | Variant color                                | ✅              |
| `gender`                    | Target gender (`male`, `female`, `unisex`)   | ✅              |
| `age_group`                 | Target age group (`adult`, `kids`)           | ✅              |
| `gtin`                      | GTIN / EAN / UPC                             | ✅ if available |

### 3. Sample XML Entry

```
<item>
  <id>12345-RED-M</id>
  <item_group_id>12345</item_group_id>
  <title>Basic Men's T-Shirt - Red</title>
  <description>Comfortable cotton t-shirt for daily wear.</description>
  <link>https://store.com/en/product/basic-tshirt-red</link>
  <image_link>https://store.com/img/12345-red.jpg</image_link>
  <additional_image_link>https://store.com/img/12345-red_1.jpg</additional_image_link>
  <brand>Nike</brand>
  <product_type>Apparel & Accessories > Clothing > Tops > T-Shirts</product_type>
  <price>49.90 USD</price>
  <sale_price>39.90 USD</sale_price>
  <sale_price_effective_date>2025-06-01T00:00:00/2025-06-07T23:59:59</sale_price_effective_date>
  <availability>in stock</availability>
  <size>M</size>
  <color>Red</color>
  <gender>male</gender>
  <age_group>adult</age_group>
  <gtin>7891234567890</gtin>
</item>
```

### 4. Feed Update Frequency

Sizebay fetches your XML feed **once per day** at **05:00 AM (GMT+0)**.

* **If the product does not exist**, it will be **automatically added** to our system.
* **If the product already exists**, it will be **updated** based on changes in:
* `title`
* `price`
* `sale_price`
* `sale_price_effective_date`
* `availability`

> Make sure your XML is accessible and up-to-date before the scheduled fetch time.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sizebay.com/fashion-hub/product-integration-xml-feed.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.