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.4/catalogs/items
Authentication required
Access level company
Response JSON / XML
Class Masterdata entity

Item data

name

required

A name of item.

Type: String

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

groupId

required

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

Type: GUID

request, response

EAN

optional

The EAN (International Article Number) of item.

Type: String

request, response

Create new item

Url https://api.profit365.eu/1.4/catalogs/items
Method POST
Example POST https://api.profit365.eu/1.4/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.4/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.4/catalogs/items?editedAt=[2015-04-08;]

 

Get all items with name starting as "Some Item"

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