Understanding items

Items, items, items.

Within Fairmarkit, we have four different types of items. To help understand these four levels we'll discuss what a subitem is. An item with subitems is simply an item that has items. Therefore subitem is an item inside the item.

Fairmarkit types of items:

item with kind item
item with kind service
item with kind item with subitems
item with kind service with subitems

Let's see the difference between them.

Item kind "item"

An item with an item kind is just a regular item, which should have one of the uom specific to items, title, and might have quantity. Here you can find the list of Items UOMs Items' UOM. So, if you need to buy 100 Apple MacBook Pro laptops, your simple item might look like this:

{
    "title": "Macbook Pro",
    "uom": "each",
    "kind": "item",
    "quantity": 100
}

Item kind "service"

An item with a service kind should have one of the uom specific to services, title, and might have quantity. Here you can find the list of Services UOMs. So, if you need to ask the supplier a question, your payload might look like this:

{
  "title": "Have you ever watched the Office?",
  "uom": "yes/no",
  "kind": "service"
}

Item kind "item" with subitems

An item with item kind with at least 2 subitems. The item should have title, kind, uom, and quantity fields. On the subitem level all you need to specify is just the title. Let's look at the example:

{
   "title":"Apple MacBook Pro",
   "uom":"each",
   "kind":"item",
   "quantity":100,
   "items":[
      {
         "title":"MacBook Pro 13"
      },
      {
         "title":"MacBook Pro 16"
      }
   ]
}

Item kind "service" with subitems

An item with service kind with at least 1 subitem. The item should have just title and kind. Uom and quantity fields should be specified on the subitem level. As usual, let's look at the example:

{
   "title":"Apple MacBook Pro",
   "kind":"service",
   "items":[
      {
         "title":"Apple MacBook Pro 16'",
         "uom":"each",
         "quantity":100
      },
      {
         "title":"Apple Care",
         "uom":"yes/no"
      }
   ]
}

Example

Here is an example of an RFQ with all types of items:

{
    "title": "RFQ title",
    "buyer": "[email protected]",
    "closes_at": "2022-11-11T11:30:13.134044",
    "external_id": 213412,
    "items": [
        {
            "title": "item title",
            "uom": "each",
            "kind": "item",
            "quantity": 1
        },
        {
            "title": "service title",
            "uom": "each",
            "kind": "service",
            "quantity": 1
        },
        {
            "title": "Group of items title",
            "kind": "service",
            "items": [
                {
                    "title": "item A",
                    "uom": "each",
                    "quantity": 100
                },
                {
                    "title": "item B",
                    "uom": "each",
                    "quantity": 100
                }
            ]
        },
        {
            "title": "Group of service title",
            "uom": "each",
            "kind": "item",
            "quantity": 100,
            "items": [
                {
                    "title": "service A"
                },
                {
                    "title": "service B"
                }
            ]
        }
    ]
}