XML Import API
Import products and offers from external XML feeds. This is useful for syncing your product catalog from e-commerce platforms or ERP systems.
XML Import requires Shop API authentication using X-API-Key and X-API-Secret headers.
Overview
The XML Import API allows you to:
- Import products from a URL or uploaded file
- Validate XML structure before importing
- Track import statistics
- View supported field mappings
The API automatically detects common XML structures:
| Path Pattern | Example |
|---|
product | <product>...</product> |
item | <item>...</item> |
products/product | <products><product>...</product></products> |
items/item | <items><item>...</item></items> |
offer | <offer>...</offer> |
offers/offer | <offers><offer>...</offer></offers> |
Field Mappings
Product Fields
| Our Field | Accepted XML Tags |
|---|
name | name, title, product_name |
description | description, desc |
brand | brand, manufacturer |
model | model |
ean | ean, ean13, barcode |
sku | sku, code, id |
xml_id | id, xml_id, external_id |
image_url | image, image_url, picture |
external_url | url, link, product_url |
weight | weight |
color | color |
size | size |
Offer/Price Fields
| Our Field | Accepted XML Tags |
|---|
price | price, regular_price |
discounted_price | discounted_price, sale_price, loyalty_program_item_price |
currency | currency |
availability | availability, in_stock |
stock_quantity | stock, quantity |
delivery_info | delivery, shipping |
warranty_info | warranty |
external_url | url, link, product_url |
external_id | id, external_id |
featured | featured |
Category Fields
| Our Field | Accepted XML Tags |
|---|
categories | categories/category, category |
Endpoints
