Documentation Index
Fetch the complete documentation index at: https://docs.loyalty.lt/llms.txt
Use this file to discover all available pages before exploring further.
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
Supported XML Formats
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
Import from URL
POST
/shop/xml-import/from-urlImport from File
POST
/shop/xml-import/from-fileValidate XML
POST
/shop/xml-import/validateField Mappings
GET
/shop/xml-import/field-mappings