Powersoft 365 API Documentation

item


Changelog

April 22, 2026
  • All GET methods includes in the response the property sort_positions which is a list indicating the sort position of an item within attributes such as category, department, and additional attributes. If the value is null, it should be treated as 9999 for all attributes.
April 17, 2026
  • All GET methods includes in the response a new property list_vat_groups

GET /item

To get a specific item by item code.

/item?token=XXXXX&item_code_365=ARTICLE01-AZURE-240

Returns


GET /item

To get a specific item by barcode.

/item?token=XXXXX&barcode=5290001001150&isBarcode=Y

Returns


GET /item

To get a specific item by barcode with or without stock per stores.

/item?token=XXXXX&barcode=5290001001150&isBarcode=Y&include_stock_per_stores=yes

Returns


POST /item

To create an item based on model/colour/size.


field type description
api_credentials
token string Credentials provided by Powersoft that allow access to the API
item
is_by_model_colour_size boolean Must have value true in order to create the item based on model/colour/size. Required.
model_code_365 string The 365 model code. Required.
colour_code_365 string The 365 colour code. Required.
size_code_365 string The 365 size code. Required.
variant_code string The secondary/other code of the item. Pass "" if no other or secondar code of the item exists.
loyalty_type integer The loyalty type. Can have only two values: 1 for fixed loyalty points and 2 for loyalty factor.
loyalty_factor decimal The loyalty factor for the points in case that points are given based on the factor.
loyalty_fixed decimal The fixed loyalty points.

Returns

The standard api_response object. When the item is created, the item code is returned in the response_id field.


POST /item

To create a regular item.


field type description
api_credentials
token string Credentials provided by Powersoft that allow access to the API
item
item_code_365 string The item code as will be registered in 365. Required. No more than 50 characters are allowed.
item_name string The name of the item. Required.
item_name_2 string The other name of the item.
vat_code_365 string The 365 vat code. Required.
supplier_code_365 string The 365 supplier code.In case that supplier code is not provided and in 365 it is defined the default supplier then the item will be assigned to the default supplier, otherwise it is a must to provide the supplier code.
item_cost decimal The cost, purchased value, of the item.
price_excl_1 decimal The first price excluding VAT of the item. In case that system works with price INCLUDING vat round(price_excl,2) = round(price_incl_vat/(1+vat_value),2)
price_incl_1 decimal The first price including VAT of the item. In case that system works with price EXCLUDING vat round(price_incl,2) =round(price_excl_vat*(1+vat_value),2)
price_excl_2 decimal The second price excluding VAT of the item. In case that system works with price INCLUDING vat round(price_excl,2) = round(price_incl_vat/(1+vat_value),2)
price_incl_2 decimal The second price including VAT of the item. In case that system works with price EXCLUDING vat round(price_incl,2) =round(price_excl_vat*(1+vat_value),2)
price_excl_3 decimal The third price excluding VAT of the item. In case that system works with price INCLUDING vat round(price_excl,2) = round(price_incl_vat/(1+vat_value),2)
price_incl_3 decimal The third price including VAT of the item. In case that system works with price EXCLUDING vat round(price_incl,2) =round(price_excl_vat*(1+vat_value),2)
price_excl_4 decimal The fourth price excluding VAT of the item. In case that system works with price INCLUDING vat round(price_excl,2) = round(price_incl_vat/(1+vat_value),2)
price_incl_4 decimal The fourth price including VAT of the item. In case that system works with price EXCLUDING vat round(price_incl,2) =round(price_excl_vat*(1+vat_value),2)
price_excl_5 decimal The fifth price excluding VAT of the item. In case that system works with price INCLUDING vat round(price_excl,2) = round(price_incl_vat/(1+vat_value),2)
price_incl_5 decimal The fifth price including VAT of the item. In case that system works with price EXCLUDING vat round(price_incl,2) =round(price_excl_vat*(1+vat_value),2)
price_excl_6 decimal The sixth price excluding VAT of the item. In case that system works with price INCLUDING vat round(price_excl,2) = round(price_incl_vat/(1+vat_value),2)
price_incl_6 decimal The sixth price including VAT of the item. In case that system works with price EXCLUDING vat round(price_incl,2) =round(price_excl_vat*(1+vat_value),2)
price_excl_7 decimal The seventh price excluding VAT of the item. In case that system works with price INCLUDING vat round(price_excl,2) = round(price_incl_vat/(1+vat_value),2)
price_incl_7 decimal The seventh price including VAT of the item. In case that system works with price EXCLUDING vat round(price_incl,2) =round(price_excl_vat*(1+vat_value),2)
price_excl_8 decimal The eighth price excluding VAT of the item. In case that system works with price INCLUDING vat round(price_excl,2) = round(price_incl_vat/(1+vat_value),2)
price_incl_8 decimal The eighth price including VAT of the item. In case that system works with price EXCLUDING vat round(price_incl,2) =round(price_excl_vat*(1+vat_value),2)
price_excl_9 decimal The nineth price excluding VAT of the item. In case that system works with price INCLUDING vat round(price_excl,2) = round(price_incl_vat/(1+vat_value),2)
price_incl_9 decimal The nineth price including VAT of the item. In case that system works with price EXCLUDING vat round(price_incl,2) =round(price_excl_vat*(1+vat_value),2)
price_excl_10 decimal The tenth price excluding VAT of the item. In case that system works with price INCLUDING vat round(price_excl,2) = round(price_incl_vat/(1+vat_value),2)
price_incl_10 decimal The tenth price including VAT of the item. In case that system works with price EXCLUDING vat round(price_incl,2) =round(price_excl_vat*(1+vat_value),2)
specifications string The specifications of the item.
notes string The notes of the item.
web_site string Any information to be displayed eventually only on the e-shop side for the item.
category_code_365 string The 365 item's category code.
dept_code_365 string The 365 item's department code.
brand_code_365 string The 365 item's brand code.
season_code_365 string The 365 item's season code.
attribute_1_code_365 string The 365 item's first attribute code.
attribute_2_code_365 string The 365 item's second attribute code.
attribute_3_code_365 string The 365 item's third attribute code.
attribute_4_code_365 string The 365 item's fourth attribute code.
attribute_5_code_365 string The 365 item's fifth attribute code.
attribute_6_code_365 string The 365 item's sixth attribute code.
um_code_365 string The 365 item's unit of measure code.
item_length decimal The length of the item.
item_width decimal The width of the item.
item_height decimal The height of the item.
item_volume decimal The volume of the item.
item_weight decimal The weight of the item.
ecommerce boolean If the item will be displayed on the e-shop site.
boolean_field_1_value boolean First custom boolean field.
boolean_field_2_value boolean Second custom boolean field.
boolean_field_3_value boolean Third custom boolean field.
boolean_field_4_value boolean Fourth custom boolean field.
boolean_field_5_value boolean Fifth custom boolean field.
text_field_1_value string First custom text field.
text_field_2_value string Second custom text field.
text_field_3_value string Third custom text field.
text_field_4_value string Fourth custom text field.
text_field_5_value string Fifth custom text field.
number_field_1_value decimal First custom decimal field.
number_field_2_value decimal Second custom decimal field.
number_field_3_value decimal Third custom decimal field.
number_field_4_value decimal Fourth custom decimal field.
number_field_5_value decimal Fifth custom decimal field.
date_field_1_value string First custom date field. The date format is yyyy-MM-dd.
date_field_2_value string Second custom date field. The date format is yyyy-MM-dd.
date_field_3_value string Third custom date field. The date format is yyyy-MM-dd.
date_field_4_value string Fourth custom date field. The date format is yyyy-MM-dd.
date_field_5_value string Fifth custom date field. The date format is yyyy-MM-dd.
variant_code string The secondary/other code of the item. Pass "" if no other or secondar code of the item exists.
loyalty_type integer The loyalty type. Can have only two values: 1 for fixed loyalty points and 2 for loyalty factor.
loyalty_factor decimal The loyalty factor for the points in case that points are given based on the factor.
loyalty_fixed decimal The fixed loyalty points.
storable boolean If the item is storable or not (if the system keeps the stock for the item).
weight_out boolean If the item is weightable.
weighted_by_supplier boolean If the item is weightable by supplier.
total_value_on_sale boolean If the item is weightable and on the label is displayed the total value.
serial_number boolean If the item has serial number.
piece boolean For scale label printing if the item price is for one piece.

Returns

The standard api_response object. When the item is created, the provided item code is returned in the response_id field.