Items

Endpoints

POSTGet itemsItems.get
POSTCreate itemsItems.set
POSTGet images for articleItems.getItemImages

Get items

POST/api/RPC.common.Api.Items.get?token=<TOKEN>

Key Items.get · Open page

Parameters

9 body parameters inside `data[]`
Field	Type	Description
`id`	Integer	Item ID
`sku`required	String	Item SKU
`name`required	String	Item name
`barcodes`required	String	Item barcodes (use , to add more than one barcode)
`from_date`	String	From date
`to_date`	String	To date
`get_all`	Boolean	Get all
`offset`	String	Offset
`limit`	String	Limit

Request example

Search By Id:
{
   "data" : [
      {
         "id" : 1224125036
      }
   ]
}
Search By Code:
{
   "data" : [
      {
         "sku" : 98765432
      }
   ]
}
Search By Barcode:
{
   "data" : [
      {
         "barcodes" : 34567
      }
   ]
}
Search By Name:
{
   "data" : [
      {
         "name" : "Nike Dunk Panda W - 39"
      }
   ]
}
Search By All Params:
{
   "data" : [
      {
         "sku" : 98765432,
         "barcodes" : 34567,
         "id" : 1224125036,
         "name" : "Nike Dunk Panda W - 39"
      }
   ]
}
Get All:
{
	"data":[
		{}
	],
	"get_all":1,
	"limit":10000,
	"offset":0
}

cURL

Search By Id:
curl -X POST -H 'Content-Type: application/json; charset=utf-8' -d '{   "data" : [      {         "id" : 1224125036      }   ]}' "https://<DOMAIN_NAME>/api/RPC.common.Api.Items.get?token=<TOKEN>"
Search By Code:
curl -X POST -H 'Content-Type: application/json; charset=utf-8' -d '{   "data" : [      {         "sku" : 98765432      }   ]}' "https://<DOMAIN_NAME>/api/RPC.common.Api.Items.get?token=<TOKEN>"
Search By Barcode:
curl -X POST -H 'Content-Type: application/json; charset=utf-8' -d '{   "data" : [      {         "barcodes" : 34567      }   ]}' "https://<DOMAIN_NAME>/api/RPC.common.Api.Items.get?token=<TOKEN>"
Search By Name:
curl -X POST -H 'Content-Type: application/json; charset=utf-8' -d '{   "data" : [      {         "name" : "Nike Dunk Panda W - 39"      }   ]}' "https://<DOMAIN_NAME>/api/RPC.common.Api.Items.get?token=<TOKEN>"
Search By All Params:
curl -X POST -H 'Content-Type: application/json; charset=utf-8' -d '{   "data" : [      {         "sku" : 98765432,         "barcodes" : 34567,         "id" : 1224125036,         "name" : "Nike Dunk Panda W - 39"      }   ]}' "https://<DOMAIN_NAME>/api/RPC.common.Api.Items.get?token=<TOKEN>"
Curl example Get All:
curl -X POST -H 'Content-Type: application/json; charset=utf-8' -d '{	"data":[		{}	],	"get_all":1,	"limit":10000,	"offset":0}	' "https://<DOMAIN_NAME>/api/RPC.common.Api.Items.get?token=<TOKEN>"

Response example

    HTTP/1.1 200 OK
{
   "result" : [
      {
         "bom_rows" : [],
         "createdon" : "2025-10-10 11:28:28",
         "name_multilang" : {
            "en" : "Nike Dunk Panda",
            "bg" : "Nike Dunk Panda W - 39"
         },
         "group" : {
            "id" : 1137309608,
            "code" : 67859689,
            "tp" : "items",
            "parent_name" : "Clothes",
            "expense_allocation_id" : 21652,
            "have_childs" : 0,
            "name" : "T-Shirts",
            "name_multilang" : {
               "bg" : "T-Shirts",
               "en" : "T-Shirts"
            },
            "parent_id" : 1137309595,
            "income_allocation_id" : 21561
         },
         "updatedon" : "2025-10-10 11:28:28",
         "service" : 0,
         "barcodes" : [
            {
               "barcode" : 34567,
               "tp" : "",
               "measure" : null,
               "sku" : 98765432,
               "is_system" : 0,
               "order_id" : 1
            }
         ],
         "sku" : 98765432,
         "other" : 0,
         "vendor_name" : "",
         "control_type" : null,
         "description_multilang" : {},
         "status" : "work",
         "description" : "",
         "vendor_code" : "",
         "id" : 1224125036,
         "brand" : {
            "id" : 3139787,
            "name" : "APPLE",
            "name_multilang" : {
               "bg" : "APPLE",
               "en" : "APPLE"
            },
            "code" : "APL"
         },
         "base_quantity_digits" : 1,
         "name" : "Nike Dunk Panda W - 39",
         "item" : 1,
         "image_url" : "",
         "measures" : [
            {
               "second" : null,
               "W" : "0.0000000000",
               "name_multilang" : {
                  "bg" : "Pieces"
               },
               "L" : "0.0000000000",
               "weight" : "0.0000000000",
               "code" : "pcs",
               "id" : 21765,
               "base" : 1,
               "si_label" : "pcs",
               "H" : "0.0000000000",
               "formula" : 1,
               "is_weight" : 0,
               "name" : "Pieces",
               "gross" : "0.0000000000",
               "tp" : "base",
               "si_label_multilang" : {
                  "bg" : "pcs"
               }
            }
         ],
         "tax_letters" : [],
         "tp" : "item"
      }
   ],
   "count" : 1,
   "total_count" : 1
}

Create items

POST/api/RPC.common.Api.Items.set?token=<TOKEN>

Key Items.set · Open page

Parameters

37 body parameters inside `data[]`
Field	Type	Description
`id`	Integer	Item ID
`sku`required	String	Item SKU
`name`required	String	Item name
`status`	String	Item status
`description`	String	Item description
`tp`required	String	Item Type
`income`	Boolean	To be bought
`expense`	Boolean	To be sold
`brand`required	Object	Brand object.
`brand.id`	String	Brand ID
`brand.code`	String	Brand ID
`brand.name`	String	Brand name
`group`required	Object	Group object.
`group.id`	String	ID category
`group.code`required	String	Category ID
`group.name`required	String	Category name
`supplier`required	Object	Supplier object.
`supplier.type`	String	Supplier type
`supplier.id`	String	Supplier ID
`supplier.code`	String	Supplier SKU
`supplier.measure`	String	Unit of measurement
`supplier.min_quantity`	String	Minimum order quantity
`supplier.quantity_step`	String	Quantity step
`measures`required	Object	Measures object.
`measures.id`	String	Unit of measurement ID
`measures.code`required	String	Unit of measurement ID
`measures.name`required	String	Unit of measurement name
`measures.base`	Boolean	Main UM
`measures.second`	Boolean	Second unit of measurement
`measures.weight`	String	Weight Net
`measures.gross`	String	Weight Gross
`measures.formula`	String	Formula
`measures.H`	String	Height
`measures.W`	String	Width
`measures.L`	String	Length
`barcodes`required	Object	Barcodes object.
`barcodes.barcodes`	String	Barcode

Request example

Create Item:
{
   "data" : [
      {
         "measures" : [
            {
               "code" : 134,
               "base" : 1,
               "weight" : 100,
               "L" : 20,
               "W" : 50,
               "formula" : 1,
               "H" : 100
            }
         ],
         "tp" : "item",
         "params" : {
            "Expiry date" : "03.09.2026"
         },
         "expense" : 1,
         "barcodes" : [
            163899578,
            121586934,
            {
               "tp" : "EAN",
               "barcode" : 4048451441772
            }
         ],
         "income" : 1,
         "group" : {
            "code" : "eyes"
         },
         "name" : "Test Item 77",
         "brand" : {
            "code" : "BUL"
         }
      }
   ]
}

cURL

Create Item:
curl -X POST -H 'Content-Type: application/json; charset=utf-8' -d '{   "data" : [      {         "measures" : [            {               "code" : 134,               "base" : 1,               "weight" : 100,               "L" : 20,               "W" : 50,               "formula" : 1,               "H" : 100            }         ],         "tp" : "item",         "params" : {            "Expiry date" : "03.09.2026"         },         "expense" : 1,         "barcodes" : [            163899578,            121586934,            {               "tp" : "EAN",               "barcode" : 4048451441772            }         ],         "income" : 1,         "group" : {            "code" : "eyes"         },         "name" : "Test Item 77",         "brand" : {            "code" : "BUL"         }      }   ]}' "https://<DOMAIN_NAME>/api/RPC.common.Api.Items.set?token=<TOKEN>"

Get images for article

POST/api/RPC.common.Api.Items.getItemImages?token=<TOKEN>

Key Items.getItemImages · Open page

Parameters

1 body parameter inside `data[]`
Field	Type	Description
`sku`required	String	Item SKU

Request example

Get Item Images:
{
   "data" : [
      {
         "sku" : 10026
      }
   ]
}

cURL

Get Item Images:
curl -X POST -H 'Content-Type: application/json; charset=utf-8' -d '{   "data" : [      {         "sku" : 10026      }   ]}' "https://<DOMAIN_NAME>/api/RPC.common.Api.Items.getItemImages?token=<TOKEN>"