Item

Endpoints

Create new item

/companies/{companycode}/items

Description

Returns created item.

Parameters

Type Name Description Schema Business Rules

Path

companyCode
required

Current context company code

string

2 characters max

Body

body
required

Item

Responses

HTTP Code Description Schema

201

Successfully created

Item

400

Functionnal error

No Content

500

Internal server error

No Content

Consumes

  • application/json

Produces

  • application/json

Get entity list

/companies/{companycode}/items

Description

Returns entities.

Parameters

Type Name Description Schema Business Rules

Path

companyCode
required

Current context company code

string

2 characters max

Query

page
optional

Page index

integer (int32)

Query

size
optional

Entity count per page

integer (int32)

Responses

HTTP Code Description Schema

200

Successfull

< Item > array

400

Functionnal error

No Content

500

Internal server error

No Content

Produces

  • application/json

Import entity list

/companies/{companycode}/items/import

Parameters

Type Name Description Schema Business Rules

Path

companyCode
required

Current context company code

string

2 characters max

Body

body
required

ImportItemList

Responses

HTTP Code Description Schema

202

Accepted

No Content

400

Functionnal error

No Content

500

Internal server error

No Content

Consumes

  • application/json

Produces

  • application/json

Get one item

/companies/{companycode}/items/{code}

operation.deprecated

Description

Returns retrieved item.

Parameters

Type Name Description Schema Business Rules

Path

code
required

Entity code to retrieve

string

20 characters max

Responses

HTTP Code Description Schema

200

Successful

Item

404

Entity not found

No Content

500

Internal server error

No Content

Produces

  • application/json

Delete item

/companies/{companycode}/items/{code}

Description

In fact disable this entity.

Parameters

Type Name Description Schema Business Rules

Path

code
required

Entity public uuid code to delete

string

20 characters max

Responses

HTTP Code Description Schema

204

Succefully deleted

No Content

400

Functionnal error

No Content

500

Internal server error

No Content

Produces

  • application/json

Data structure

Item

Item data structure.

Name Description Value Business Rules

allExpeditionSites
optional

All expedition sites

boolean

code
required

Item code

string

20 characters max

companyCode
required

Current company code

string

2 characters max

consumerPriceUnitCode
optional

Consumer price unit code

string

5 characters max

downgradedItems
optional

list

ean
optional

GTIN

string

14 characters max

establishments
optional

All establishments code

Establishment list

expeditionSites
optional

list

firstUnitCode
required

First unit code

string

5 characters max

hierarchies
optional

GroupLink list

imageCode
optional

string

label
required

Item label

string

50 characters max

outer
optional

Outer

integer

planningInfos
optional

Planning informations

ItemPlanningInfos

priceUnitCode
optional

Price unit code

string

5 characters max

publicUuid
optional
read-only

Item public uuid

string

qualityInfos
optional

ItemQualityInfos list

secondUnitCode
optional

Second unit code

string

5 characters max

shortLabel
optional

Short label

string

12 characters max

stockInfos
optional

Stock informations

ItemStockInfos

stockManaged
optional

boolean

substituteItems
optional

list

unitConversions
optional

UnitConversion list

useBatch
optional

boolean

validityEndDate
required

Validity end date

datetime (ISO-8601)

AAAA-MM-JJTHH:MM:SSZ

Establishment

Name Value Business Rules

code
optional

string

20 characters max

label
optional

string

50 characters max

ItemPlanningInfos

Name Value

internalPurchaseReplenishmentInfos
optional

ItemPlanningInternalPurchaseInfos list

manufacturingReplenishmentInfos
optional

ItemPlanningManufacturingInfos list

purchaseReplenishmentInfos
optional

ItemPlanningPurchaseInfos list

stockInfos
optional

ItemPlanningStockInfos list

ItemStockInfos

Name Value Business Rules

firstUnitCode
optional

string

5 characters max

multiItemBatch
optional

boolean

referenceItemBatchCode
optional

string

secondUnitCode
optional

string

5 characters max

thirdUnitCode
optional

string

5 characters max

ItemQualityInfos

Name Value Business Rules

establishmentCode
optional

string

2 characters max

lockingDuration
optional

double

preservationDuration
optional

double

preservationDurationUnit
optional

string

DAYS or MONTHS

useDuration
optional

double

optimalPreservationDuration
optional

integer

shippingGuaranteedDuration
optional

integer

ImportItemList

Name Value

callback
optional

string

data
optional

Item list

UnitConversion

Name Value Business Rules

constantQuantity
optional

boolean

quantity
optional

double

referenceQuantity
optional

double

referenceUnitCode
optional

string

5 characters max

unitCode
optional

string

5 characters max