Skip to main content

Create product item

Creates a new product item.

Path Parameters
productId string REQUIRED

The id of the product to create an item on.

Query Parameters
productIdType int32

Possible values: [0, 1, 2, 3]

The type of product id supplied.
0 = Internal. Internal product id set by Geins.
Eg: 10001.
1 = ArticleNumber. Article number set by customer.
Eg: ABC123.
2 = MarketPrefixedInternal. Internal product id set by Geins, prefixed with market.
Eg: SE10001.
3 = MarketPrefixedArticleNumber. Article number set by customer, prefixed with market.
Eg: SEABC123.

Request Body REQUIRED

The product item to create.

ItemId int32

Id of the product item.

ArticleNumber string

The article number for the product item.

Name string

The name of the product item.

Shelf string

The shelf name where the product item can be found.

Weight int32

The weight of the item in grams (g).

Length int32

The length of the item in millimeters (mm).

Width int32

The width of the item in millimeters (mm).

Height int32

The height of the item in millimeters (mm).

Gtin string

The GTIN number for the item.
Also known as EAN, UCC or UPS number.

Active boolean

The current state of the item.

ExternalId string

External Id of the product item.

DateIncoming date-time

The date the item will be in stock again.

Responses
200

The created product item.

Schema OPTIONAL
Resource object OPTIONAL

A product item belonging to a product.

ItemId int32 OPTIONAL

The product item id.

ArticleNumber string OPTIONAL

The article number for the product item.

ProductId int32 OPTIONAL

The id of the product that the item belongs to.

Name string OPTIONAL

The name of the product item.

Shelf string OPTIONAL

The shelf name where the product item can be found.

Weight int32 OPTIONAL

The weight of the item in grams (g).

Length int32 OPTIONAL

The length of the item in millimeters (mm).

Width int32 OPTIONAL

The width of the item in millimeters (mm).

Height int32 OPTIONAL

The height of the item in millimeters (mm).

Gtin string OPTIONAL

The GTIN number for the item.
Also known as EAN, UCC or UPS number.

DateCreated date-time OPTIONAL

The date the item was created.

DateUpdated date-time OPTIONAL

The date the item was last updated.

DateIncoming date-time OPTIONAL

The date the item will be in stock again.

Active boolean OPTIONAL

The current state of the item.

ExternalId string OPTIONAL

External Id of the product item.

Stock object OPTIONAL

A stock value for a product item

ItemId int32 OPTIONAL

A value to uniquely identity a single product item.

Stock int32 OPTIONAL

The physical stock value.

StockOversellable int32 OPTIONAL

The oversellable stock value.

StockStatic int32 OPTIONAL

The static stock value.

StockSellable int32 OPTIONAL

The sellable stock value.

ShippingFees object[] OPTIONAL

The lowest shipping fees for each market and country for the product item.

Market int32 OPTIONAL

The market that the shipping fee is applicable on.

Country string OPTIONAL

The country that the shipping fee is applicable in.

Service string OPTIONAL

The shipping service with the current fee.

ServiceId int32 OPTIONAL

The shipping service id with the current fee.

Fee double OPTIONAL

The shipping fee.

Message string OPTIONAL

A status message for the action taken.

Details string[] OPTIONAL

Any validation messages for the data on the current action.

400

Bad request.

Schema OPTIONAL
Message string OPTIONAL

A status message for the action taken.

Details string[] OPTIONAL

Any validation messages for the data on the current action.