Add Product

Description: Creates a new product with detailed attributes, descriptions, images, and associations like categories and branches. Fields like sku, type, and descriptions are typically required to define the product. Create a new product with attributes, images, and multilingual descriptions.

Headers

Key	Value	Description	Type
`apikey`	`5f28583f26a1a`	API key for authentication; contact support to obtain. `Required`	`string`
`secure-business-key`	`4765066450c0bd66325.48403130`	Business-specific key; contact support for valid values. `Required`	`string`
`apiconnection`	`appmobile`	Connection type; contact support to obtain. `Required`	`string`
`userToken`	`Required`	User token from authentication API. `Required` (Get user token from `https://testaccounts.vodoerp.com/api/login` or `https://accounts.vodoerp.com/api/login`)	`string`
`lang`	`ar`	Language preference: `ar` for `Required`, `en` for English.	`string`

Body or Form Data

Key	Value	Description	Type
`sku`	`otherTour`	Unique product identifier. `Required`	`string`
`type`	`tour`	Product type (e.g., service, tour). `Required`	`string`
`status`	`0`	Product status (1 or 0).	`string`
`show_in_mobile`	`0`	Visibility on mobile (1 or 0).	`string`
`supplier_chain`	`0`	Supplier chain status (1 or 0).	`string`
`alias`	`tourtour`	Product alias. `Required`	`string`
`supplier_id`	`ssvgdsvscsdfjn`	Supplier ID.	`string`
`kind`	`0`	Product kind (0=Single, 1=Build, 2=Group, 3=Coupon). `Required`	`string`
`sort`	(empty)	Sort order.	`string`
`coupon_qty`	(empty)	Coupon quantity.	`string`
`product_url`	`http://example.com/product`	Product URL.	`string`
`image`	`http://127.0.0.1:8000/data/37/lfm/code 2.png`	Product image URL.	`string`
`brand_id`	`55`	Brand ID. (Get from api request `{{APP_URL}}/api/v1/ecomm_brands`)	`string`
`category_id[0]`	`85`	First category ID. `Required` (Get from api request `{{APP_URL}}/api/v1/ecomm_categories`)	`string`
`descriptions[0][lang]`	`en`	Language for first description (e.g., en). `Required`	`string`
`descriptions[0][keyword]`	`keyword_en`	Keyword for first description.	`string`
`descriptions[0][name]`	`tour Name In Test 4g`	Name for first description. `Required`	`string`
`descriptions[0][description]`	`tour Description EN`	Description for first description.	`string`
`descriptions[0][content]`	`tour Content EN`	Content for first description.	`string`
`descriptions[1][lang]`	`ar`	Language for second description (e.g., ar). `Required`	`string`
`descriptions[1][keyword]`	`اسم الرحلة في الاختبار 4g`	Keyword for second description. `Required`	`string`
`descriptions[1][name]`	`اسم الرحلة في الاختبار 4g`	Name for second description. `Required`	`string`
`descriptions[1][description]`	`اسم الرحلة في الاختبار 4g`	Description for second description.	`string`
`descriptions[1][content]`	`اسم الرحلة في الاختبار 4g`	Content for second description.	`string`
`images[0][image]`	`https://www.simplilearn.com/ice9/free_resources_article_thumb/what_is_image_Processing.jpg`	First image URL.	`string`
`images[1][image]`	`code 2.png`	Second image URL.	`string`
`presents[0][gift]`	`3`	First gift ID.	`string`
`presents[0][qty]`	`1`	Quantity for first gift.	`string`
`presents[1][gift]`	`4`	Second gift ID.	`string`
`presents[1][qty]`	`2`	Quantity for second gift.	`string`
`units[0][main_unit_id]`	`60`	Main unit ID.	`string`
`units[0][child_unit_id]`	`583`	Child unit ID.	`string`
`units[0][child_unit_qty]`	`24`	Child unit quantity.	`string`
`builds[0][productBuild]`	`20899`	Product build ID.	`string`
`builds[0][productBuildQty]`	`10`	Product build quantity.	`string`
`builds[0][productBuildType]`	`related`	Product build type.	`string`
`builds[0][productUnitId]`	`21200`	Product unit ID.	`string`
`productsGroup[0][product_id]`	`1`	First grouped product ID. (Get from api request `{{APP_URL}}/api/v1/ecomm_products`)	`string`
`productsGroup[1][product_id]`	`2`	Second grouped product ID. (Get from api request `{{APP_URL}}/api/v1/ecomm_products`)	`string`
`branch_id[0]`	`11`	First branch ID. (Get from api request `{{APP_URL}}/api/`)	`string`
`branch_id[1]`	`22`	Second branch ID. (Get from api request `{{APP_URL}}/api/`)	`string`

Response

{
  "status": true,
  "message": ""
}

curl --location -g --request POST 'https://www.testecommerce.vodoerp.com/api/v1/ecomm_products' \ --header 'apikey: 5f28583f26a1a' \ --header 'secure-business-key: 4765066450c0bd66325.48403130' \ --header 'apiconnection: appmobile' \ --header 'userToken: 608332884df20420fde73c5404143c8574c093c2e27249b1067ff9281ec7dcf2' \ --header 'Accept-Language: ar' \ --form 'sku="otherTour"' \ --form 'type="2"' \ --form 'status="0"' \ --form 'show_in_mobile="0"' \ --form 'supplier_chain="0"' \ --form 'alias="tourtour"' \ --form 'supplier_id="ssvgdsvscsdfjn"' \ --form 'kind="1"' \ --form 'sort=""' \ --form 'coupon_qty=""' \ --form 'promotion_img=""' \ --form 'product_url="http://example.com/product"' \ --form 'image="http://127.0.0.1:8000/data/37/lfm/code 2.png"' \ --form 'brand_id="55"' \ --form 'category_id[0]="85"' \ --form 'category_id[1]="85"' \ --form 'descriptions[0][lang]="en"' \ --form 'descriptions[0][keyword]="keyword_en"' \ --form 'descriptions[0][name]="tour Name In Test 4g"' \ --form 'descriptions[0][description]="tour Description EN"' \ --form 'descriptions[0][content]="tour Content EN"' \ --form 'descriptions[1][lang]="ar"' \ --form 'descriptions[1][keyword]="اسم الرحلة في الاختبار 4g"' \ --form 'descriptions[1][name]="اسم الرحلة في الاختبار 4g"' \ --form 'descriptions[1][description]="اسم الرحلة في الاختبار 4g"' \ --form 'descriptions[1][content]="اسم الرحلة في الاختبار 4g"' \ --form 'images[0][image]="https://www.simplilearn.com/ice9/free_resources_article_thumb/what_is_image_Processing.jpg"' \ --form 'images[1][image]="code 2.png"' \ --form 'presents[0][gift]="3"' \ --form 'presents[0][qty]="1"' \ --form 'presents[1][gift]="4"' \ --form 'presents[1][qty]="2"' \ --form 'units[0][main_unit_id]="60"' \ --form 'units[0][child_unit_id]="583"' \ --form 'units[0][child_unit_qty]="24"' \ --form 'builds[0][productBuild]="20899"' \ --form 'builds[0][productBuildQty]="10"' \ --form 'builds[0][productBuildType]="related"' \ --form 'builds[0][productUnitId]="21200"' \ --form 'builds[0][productAttributeId][]=""' \ --form 'productsGroup[0][product_id]="1"' \ --form 'productsGroup[1][product_id]="2"' \ --form 'branch_id[0]="11"' \ --form 'branch_id[1]="22"' \ --form 'build_type="meal"' \ --form 'meal_start_time=""' \ --form 'meal_end_time=""'

{"status":false,"message":{"brand_id":["لم يتم العثور على الماركة المحددة."],"category_id.0":["لم يتم العثور على الفئة المحددة."],"category_id.1":["لم يتم العثور على الفئة المحددة."],"units.0.child_unit_id":["الوحدة الفرعية غير موجودة في هذه الوحدة الرئيسية."]}}

Request

Header Params

apikey

string

required

You must contact support to get the apikey.

Example:

5f28583f26a1a

secure-business-key

string

required

You must contact support to get the secure-business-key like: 728106399db2b289783.89154521
4765066450c0bd66325.48403130
2680667168f2f8a68f6.12561200

Example:

4765066450c0bd66325.48403130

apiconnection

string

required

You must contact support to get the apiconnection.

Example:

appmobile

userToken

string

required

Get user token from
https://testaccounts.vodoerp.com/api/login
or
https://accounts.vodoerp.com/api/login

Example:

608332884df20420fde73c5404143c8574c093c2e27249b1067ff9281ec7dcf2

Accept-Language

string

required

ar => Arabic or en => English

Example:

Body Params multipart/form-data

sku

string

required

Example:

otherTour

type

string

required

get the product type id from: https://vodoerp.apidog.io/display-product-type-15235707e0

Example:

status

string

required

1 or 0

Example:

show_in_mobile

string

required

1 or 0

Example:

supplier_chain

string

required

1 or 0

Example:

alias

string

required

Example:

tourtour

supplier_id

string

required

Example:

ssvgdsvscsdfjn

kind

string

required

get the kind id of the product from: https://vodoerp.apidog.io/display-product-kind-15235708e0

Example:

sort

string

required

coupon_qty

string

required

promotion_img

string

optional

https://www.simplilearn.com/ice9/free_resources_article_thumb/what_is_image_Processing.jpg

product_url

string

required

Example:

http://example.com/product

image

string

optional

Example:

http://127.0.0.1:8000/data/37/lfm/code 2.png

brand_id

string

optional

Example:

category_id[0]

string

required

Example:

category_id[1]

string

optional

Example:

descriptions[0][lang]

string

required

Example:

descriptions[0][keyword]

string

required

Example:

keyword_en

descriptions[0][name]

string

required

Example:

tour Name In Test 4g

descriptions[0][description]

string

required

Example:

tour Description EN

descriptions[0][content]

string

required

Example:

tour Content EN

descriptions[1][lang]

string

required

Example:

descriptions[1][keyword]

string

required

Example:

اسم الرحلة في الاختبار 4g

descriptions[1][name]

string

required

Example:

اسم الرحلة في الاختبار 4g

descriptions[1][description]

string

required

Example:

اسم الرحلة في الاختبار 4g

descriptions[1][content]

string

required

Example:

اسم الرحلة في الاختبار 4g

images[0][image]

string

required

Example:

https://www.simplilearn.com/ice9/free_resources_article_thumb/what_is_image_Processing.jpg

images[1][image]

string

required

Example:

code 2.png

presents[0][gift]

string

optional

Example:

presents[0][qty]

string

optional

Example:

presents[1][gift]

string

optional

Example:

presents[1][qty]

string

optional

Example:

units[0][main_unit_id]

string

required

Example:

units[0][child_unit_id]

string

required

Example:

583

units[0][child_unit_qty]

string

required

Example:

builds[0][productBuild]

string

optional

Example:

20899

builds[0][productBuildQty]

string

optional

Example:

builds[0][productBuildType]

string

optional

Example:

builds[0][productUnitId]

string

optional

Example:

21200

builds[0][productAttributeId][]

string

optional

productsGroup[0][product_id]

string

optional

Example:

productsGroup[1][product_id]

string

optional

Example:

branch_id[0]

string

required

Example:

branch_id[1]

string

required

Example:

build_type

string

optional

product,meal

Example:

meal

meal_start_time

string

optional

H:i

meal_end_time

string

optional

H:i

Response#

Request

Responses

Response