Create Bulk Products

POST

/app/{storeid}/stock/createBulk

Stock Inventory Basic Functions

Creates multiple products in bulk and adds them to the inventory of the provided store location.

Request

Path Params

storeid

string

required

ID of the store where the bulk products will be added

Header Params

sessiontoken

string

required

Session token for authentication

Body Params application/json

Bulk product details to be added to the inventory

invoiceNo

string

optional

Invoice number of the supply invoice

Example:

#1234567890

supplierNo

string

optional

The ID of the supplier, which can be extracted from supplier record

Example:

SUP123

supplyDate

string <date-time>

optional

Date of supply

products

array[object (SimpleProduct) {18}]

required

List of products supplied

productCategory

string

required

The category of the product.

Example:

Electronics

subcategory

string

optional

The subcategory of the product.

Example:

Smartphones

itemDescription

string

required

A detailed description of the product.

Example:

Latest model smartphone with 128GB storage

quantity

number <double>

optional

The available quantity of the product in stock.

Example:

100

costPrice

number <double>

optional

The cost price of the product.

Example:

500

sellingPrice

number <double>

required

The selling price of the product.

Example:

700

bulkPrice

number <double>

optional

The price of the product when purchased in bulk.

Example:

600

qtyPerBulk

number <double>

optional

The quantity per bulk unit.

Example:

barcode

string

optional

The barcode of the product.

Example:

123456789012

productBrand

string

optional

The brand of the product.

Example:

BrandX

color

string

optional

The color of the product.

Example:

Black

size

string

optional

The size of the product.

Example:

Large

expireDate

string <date-time>

optional

The expiration date of the product. Note: Expire date must be in the future for the sumbit to work

memberPrice

number <double>

optional

The price of the product for members.

Example:

650

supplierNo

string

optional

The supplier number associated with the product.

Example:

SUP12345

storeId

string

optional

The ID of the store where the product is located.

Example:

STORE001

productType

string

required

The type of the product. Possible values: raw_material, whole_item, service.

Example:

whole_item

photoData

array[string <byte>]

optional

The binary array representing the picture of an item

Example

{
    "invoiceNo": "#1234567890",
    "supplierNo": "SUP123",
    "supplyDate": "2019-08-24T14:15:22Z",
    "products": [
        {
            "productCategory": "Electronics",
            "subcategory": "Smartphones",
            "itemDescription": "Latest model smartphone with 128GB storage",
            "quantity": 100,
            "costPrice": 500,
            "sellingPrice": 700,
            "bulkPrice": 600,
            "qtyPerBulk": 10,
            "barcode": "123456789012",
            "productBrand": "BrandX",
            "color": "Black",
            "size": "Large",
            "expireDate": "2019-08-24T14:15:22Z",
            "memberPrice": 650,
            "supplierNo": "SUP12345",
            "storeId": "STORE001",
            "productType": "whole_item",
            "photoData": [
                "string"
            ]
        }
    ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://gateway.storeharmony.com/cloudapi/app//stock/createBulk' \
--header 'sessiontoken;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "invoiceNo": "#1234567890",
    "supplierNo": "SUP123",
    "supplyDate": "2019-08-24T14:15:22Z",
    "products": [
        {
            "productCategory": "Electronics",
            "subcategory": "Smartphones",
            "itemDescription": "Latest model smartphone with 128GB storage",
            "quantity": 100,
            "costPrice": 500,
            "sellingPrice": 700,
            "bulkPrice": 600,
            "qtyPerBulk": 10,
            "barcode": "123456789012",
            "productBrand": "BrandX",
            "color": "Black",
            "size": "Large",
            "expireDate": "2019-08-24T14:15:22Z",
            "memberPrice": 650,
            "supplierNo": "SUP12345",
            "storeId": "STORE001",
            "productType": "whole_item",
            "photoData": [
                "string"
            ]
        }
    ]
}'

Responses

🟢201Created

application/json

Bulk products successfully created and added to the store inventory.

Body

string

optional

Example

"string"

🟠400Bad Request

🟠404Record Not Found

🔴500Server Error

Modified at 2025-03-27 14:31:04

createBulkStoreCategory

Create Product with Variants