Items

In Profit365, item is a product item, service stock keeping unit, which can be therefore used to create pricelists, invoiced (for sale or purchase), included in stock operations (in, out) so you can also track their current stock level. For example, an item can be a product you sell, service you provide, goods you buy. Item is widely used in Profit365.

Content:

Resource information

Url https://api.profit365.eu/1.6/catalogs/items
Authentication required
Access level company
Response JSON / XML
Class Masterdata entity

Update item

Url https://api.profit365.eu/1.6/catalogs/items/{id}
Method PUT
Example PUT https://api.profit365.eu/1.6/catalogs/items/d2d5e296-2b46-4587-aa40-6c7bf7ba484b

Authorization: Basic *** hidden credentials ***
ClientID: C7A36D...
ClientSecret: j7896WnI0U1...
CompanyID: CCA256B...
Content-Type: application/json

{
"name": "Amadeus X100 plus",
"code": "WCH-AMD-X100-L",
"groupId": "ac480b53-ec3f-43dd-b017-a583a943ba13"
"costPrice": 95,
"price": 110,
}

Create new item

Url https://api.profit365.eu/1.6/catalogs/items
Method POST
Example POST https://api.profit365.eu/1.6/catalogs/items

Authorization: Basic *** hidden credentials ***
ClientID: C7A36D...
ClientSecret: j7896WnI0U1...
CompanyID: CCA256B...
Content-Type: application/json

{
"name": "Amadeus X100",
"code": "WCH-AMD-X100-L",
"groupId": "ac480b53-ec3f-43dd-b017-a583a943ba13"
}

List items

Url https://api.profit365.eu/1.6/catalogs/items
Method GET
Params
{take} optional Limit results range for given count.
{page} optional Split result into pages and take selected page
{name} optional

Query items by item name

Type: String range
{editedAt} optional

Query items by date of edit

Type: DateTime range
Example

Get all items edited after 2015-04-08

https://api.profit365.eu/1.6/catalogs/items?editedAt=[2015-04-08;]

 

Get all items with name starting as "Some Item"

https://api.profit365.eu/1.6/catalogs/items??name=Some%20Item*

Item data

id

ID of the item.

Type: GUID

 response

groupId

required

ID of the item group to which the item should be assigned.

Type: GUID

 request, response

code

required

Code is a custom unique identifier of the item. May be used as SKU (Stock keeping unit)

Type: String

 request, response

name

required

The name of the item.

Type: String

 request, response

description

optional

Item description

Type: String

 request, response

costPrice

optional

Default unit cost price of the item. Can be overridden in a price list.

Type: Number

 request, response

price

optional

Default unit selling price of the item, without VAT. Can be overridden in a price list.

Type: Number

 request, response

pricevat

optional

Default unit selling price of the item, with VAT. If empty, will be calculated automatically.

Type: Number

 request, response

vatLevel

optional

VAT level. Leave empty or set to 0 for standard VAT rate and 1 for first lowered VAT rate. Additional lowered rates and zero VAT rate may vary according to legislation. For SK, 2 is for zero VAT rate.

Type: Number

 request, response

isWarehouse

optional

True if item can be stocked, otherwise false.

Type: Boolean

 request, response

isPurchase

optional

True if item can be purchased, otherwise false.

Type: Boolean

 request, response

isSales

optional

True if item can be sold, otherwise false.

Type: Boolean

 request, response

isLotNumber

optional

True if item is stocked in lots, otherwise false.

Type: Boolean

 request, response

isSet

optional

True if item is part of a set, otherwise false.

Type: Boolean

 request, response

unitID

optional

ID of the unit.

Type: GUID

 request, response

weight

optional

Physical weight.

Type: Decimal

 request, response

size

optional

Physical dimensions.

Type: String

 request, response

warranty

optional

Item warranty.

Type: String

 request, response

itemCategory

optional

Item category.

Type: String

 request, response

scs

optional

Type according to common tariff register (SCS).

Type: String

 request, response

stockPosition

optional

Physical position in the warehouse.

Type: String

 request, response

EAN

optional

The EAN (International Article Number) of item.

Type: String

request, response
  • Pubished at 5/11/2016 8:32:06 AM
  • Last edited 5/29/2022 8:36:31 PM

Back to top ↑