Seller Products
Manage products created and sold by sellers. Includes inventory management, pricing, and visibility controls.
POST
/physical-products/seller-products/Create Seller Product
Create a new product as a seller. Requires Authorization: Bearer <token>.
Request Body
Request
{
"name": "Unisex Premium Cotton Joggers",
"description": "<p>Comfy and breathable joggers.</p>",
"sellingPrice": 2200,
"comparePrice": 2700,
"stock": 25,
"discountCode": "JOGGER10",
"discountPercentage": 18,
"shippingHandler": "Seller",
"deliveryCost": 120,
"categoryId": "ByF-CAT-887A28",
"properties": [
{ "propertyId": "ByF-PRO-8F9156", "value": 32, "propertyNameSnapshot": "waist_size" }
]
}Response
Response (200 OK)
{
"success": true,
"message": "Seller product created successfully",
"data": {
"id": "ByF-SELL-PROD-FA8E6E",
"name": "Unisex Premium Cotton Joggers",
"sellingPrice": 2200,
"stock": 25,
"createdAt": "2025-01-15T10:30:00Z"
}
}GET
/physical-products/seller-products/Get All Seller Products
Retrieve all seller products. Requires Authorization: Bearer <token>.
Response
Response (200 OK)
{
"success": true,
"data": [
{ "id": "ByF-SELL-PROD-FA8E6E", "name": "Unisex Premium Cotton Joggers", "sellingPrice": 2200, "stock": 25, "visibility": "Public" }
]
}GET
/physical-products/seller-products/{referenceId}Get Seller Product
Retrieve a seller product by referenceId. Requires Authorization: Bearer <token>.
Query Parameters
Query Parameters
Path:
referenceId: string (e.g., "ByF-SELL-PROD-FA8E6E")GET
/physical-products/seller-products/myGet My Seller Products
Retrieve all products created by the authenticated seller. Requires Authorization: Bearer <token>.
PATCH
/physical-products/seller-products/{referenceId}Update Seller Product
Update an existing seller product. Requires Authorization: Bearer <token>.
Request Body
Request
{
"name": "Updated Product Name",
"sellingPrice": 2500,
"stock": 30,
"discountPercentage": 20
}PATCH
/physical-products/seller-products/{referenceId}/visibilityUpdate Product Visibility
Change product visibility (Public | Hidden | Private). Requires Authorization: Bearer <token>.
Request Body
Request
{
"visibility": "Hidden"
}DELETE
/physical-products/seller-products/{referenceId}Delete Seller Product
Permanently delete a seller product. Requires Authorization: Bearer <token>.
Response
Response (200 OK)
{
"success": true,
"message": "Seller product deleted successfully"
}POST
/physical-products/seller-products/draftCreate Draft Seller Product
Create a draft seller product. Requires Authorization: Bearer <token>.
Request Body
Request
{
"categoryId": "ByF-CAT-F7B15C",
"metaData": {
"form": "{\"name\":\"Draft Product\",...}"
}
}PATCH
/physical-products/seller-products/draft/{referenceId}Update Draft Seller Product
Update a draft seller product. Requires Authorization: Bearer <token>.
Request Body
Request
{
"categoryId": "ByF-CAT-F7B15C",
"metaData": {
"form": "{\"name\":\"Updated Draft\",...}"
}
}