POSProductsList V2

Description: Retrieves an enhanced list of products for a specific POS terminal identified by its pos_id (e.g., 25). This is a versioned improvement (V2) over the original POSProductsList, potentially offering additional features or optimized performance. Requires authentication headers (apikey, apiconnection, secure-business-key). The request body, submitted as form data, supports filtering by keyword, category, and pagination. Returns a paginated JSON array of products with details like ID, name, price, and stock, possibly with enhanced fields compared to V1. Retrieve an enhanced list of products for a specific POS terminal.

Headers

Key	Value	Description	Type	Required
`apikey`	`5f28583f26a1a`	API key for authentication; contact support to obtain.	`string`	Yes
`apiconnection`	`appmobile`	Connection type; contact support to obtain.	`string`	Yes
`secure-business-key`	`140356399db2b2c32f0.25237063`	Business-specific key; contact support for valid values.	`string`	Yes

Body or Form Data

Key	Value	Description	Type	Required
`keyword`	`وا`	Filters products by search term (e.g., "wa" in Arabic).	`string`	No
`pos_id`	`25`	ID of the POS terminal.	`string`	Yes
`per_page`	`10`	Number of products per page.	`string`	No
`list`	(empty)	Returns all products without pagination if present.	`string`	No
`page`	`1`	Specifies the page number.	`string`	No
`category_id`	`6`	Filters products by category ID.	`string`	No
`get_subcategories_products`	(empty)	Includes products from subcategories if present.	`string`	No

curl --location --request POST 'https://www.testecommerce.vodoerp.com/api/v1/pos/pos_products_list_v2' \ --header 'apikey: 5f28583f26a1a' \ --header 'apiconnection: appmobile' \ --header 'secure-business-key: 140356399db2b2c32f0.25237063' \ --form 'keyword="وا"' \ --form 'pos_id="25"' \ --form 'per_page="10"' \ --form 'list=""' \ --form 'page="1"' \ --form 'category_id="6"' \ --form 'get_subcategories_products=""'

Request

Header Params

apikey

string

required

You must contact support to get the apikey.

Example:

5f28583f26a1a

apiconnection

string

required

You must contact support to get the apiconnection.

Example:

appmobile

secure-business-key

string

required

You must contact support to get the secure-business-key like: 4765066450c0bd66325.48403130
728106399db2b289783.89154521
2680667168f2f8a68f6.12561200
140356399db2b2c32f0.25237063
96701678e330f31f768.22400604
14807664478836358b0.31329842

Example:

140356399db2b2c32f0.25237063

Body Params multipart/form-data

keyword

string

required

Search by keyword

Example:

وا

pos_id

string

required

Search by pos

Example:

per_page

string

required

Display the required number on one page

Example:

list

string

required

Show all data without pagination

page

string

required

The page number you want to go to

Example:

category_id

string

required

Search by category

Example:

get_subcategories_products

string

required

Dispaly subcategories_products in response

POSProductsList V2

Request

Responses