Skip to content

Items

Item schema

An item can have the properties as listed bellow:

  • item_id str: the id of the item in your database
  • title str: the title of the item
  • description str: the description of the item
  • category str: the category of the item
  • link str: the link of the item in your e-shop
  • image_link str: the link of some image of the item
  • price float: the price of the item
  • vat_rate float: the vat rate this item has on your e-shop (Optional)
  • availability str: a short string with when is this item available (Optional)
  • in_stock boolean: is the item in stock?
  • manufacturer str: the manufacturer of the item (Optional)
  • isbn str: the isbn (The International Standard Book Number) of the item if available (Optional)
  • barcode str: the barcode of the item (Optional)
  • weight str: the weight of the item (Optional)
  • color str: the color of the item (Optional)
  • shipping_cost float: the shipping cost of the item in your e-shop (Optional)
  • quantity int: the quantity of the item in your e-shop (Optional)

The required properties are the ones who doesn't have "(Optional)" on the right. See a full xml example bellow.

XML Sample

Here you can find how your XML should be formed when the Advisable.ai's scraper tries to parse it and add the items on our database.

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <created_at>2022-10-06 08:55:17.099386</created_at>
  <CATALOG>
    <ITEMS>
      <item_id>1</item_id>
      <title>Frezyderm Nazal Cleaner 6</title>
      <description>NaCl saline solution, compatible with homeopathy.</description>
      <category>Acetaminophen (Paracetamol)</category>
      <link>http://myshop.com/items/465332</link>
      <image_link>http://myshop.com/items/465332/images/1</image_link>
      <price>4.34</price>
      <vat_rate>24</vat_rate>
      <availability>in a week</availability>
      <in_stock>true</in_stock>
      <manufacturer>Fujitsu</manufacturer>
      <isbn>54-534-6-347-23</isbn>
      <barcode>567634287234</barcode>
      <weight>11</weight>
      <color/>
      <shipping_cost>2.3</shipping_cost>
      <quantity>6</quantity>
    </ITEMS>
    <ITEMS>
      <item_id>2</item_id>
      <title>Calm Life 2</title>
      <description>It has analgesic, antipyretic and weak anti-inflammatory action.</description>
      <category>Acetaminophen (Paracetamol)</category>
      <link>http://myshop.com/items/465332</link>
      <image_link>http://myshop.com/items/465332/images/1</image_link>
      <price>9.12</price>
      <vat_rate>24</vat_rate>
      <availability>in a week</availability>
      <in_stock>true</in_stock>
      <manufacturer>Xiaomi</manufacturer>
      <isbn>54-534-6-347-23</isbn>
      <barcode>543799678957689</barcode>
      <weight>12.0</weight>
      <color/>
      <shipping_cost>12.0</shipping_cost>
      <quantity>2</quantity>
    </ITEMS>
  </CATALOG>
</root>

XML Validator

If you are not sure whether your XML is valid you can check it here. Also even if you are sure please use the validator. You will receive instructional errors in case your XML is not in the expected form.