Skip to main content

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 PatternExample
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 FieldAccepted XML Tags
namename, title, product_name
descriptiondescription, desc
brandbrand, manufacturer
modelmodel
eanean, ean13, barcode
skusku, code, id
xml_idid, xml_id, external_id
image_urlimage, image_url, picture
external_urlurl, link, product_url
weightweight
colorcolor
sizesize

Offer/Price Fields

Our FieldAccepted XML Tags
priceprice, regular_price
discounted_pricediscounted_price, sale_price, loyalty_program_item_price
currencycurrency
availabilityavailability, in_stock
stock_quantitystock, quantity
delivery_infodelivery, shipping
warranty_infowarranty
external_urlurl, link, product_url
external_idid, external_id
featuredfeatured

Category Fields

Our FieldAccepted XML Tags
categoriescategories/category, category

Endpoints

Import from URL

POST /shop/xml-import/from-url

Import from File

POST /shop/xml-import/from-file

Validate XML

POST /shop/xml-import/validate

Field Mappings

GET /shop/xml-import/field-mappings