Products

• Tạo sản phẩm

POST /apis/v1/merchant/product/create

Lưu ý

+ Sản phẩm cần phải thêm danh mục: all category và store category để chuẩn bị dữ liệu tạo sản phẩm

+ Nếu sản phẩm có Biến thể, thêm ''code'' vào ''spec'' và id hình ảnh biến thể "image_spec_id" vào "addition_image" (dữ liệu lấy từ API Danh sách gợi ý thuộc tính spec/list-suggest). Nếu sản phẩm không có thuộc tính thì để trống.

+ "image_path" là hình ảnh đại diện của sản phẩm hiển thị ở ngoài trang chủ

Headers

Name	Type	Description
pm-mc-code	String	Xem hướng dẫn tại About
pm-mc-token	String	Xem hướng dẫn tại About

Request Body

Name	Type	Description
addition_image.name.default.sort.image_spec_id*	String	Ảnh sản phẩm
type_id	int
cate_id*	int	ID của ngành hàng
g_name*	varchar	Tên sản phẩm
g_jingle	String	Mô tả ngắn của sản phẩm
g_price*	int	Giá bán của sản phẩm
goods_weight*		Trọng lượng sản phẩm
package_weight*		Khối lương bao bì
g_marketprice	int	Giá niêm yết của sản phẩm
g_costprice	int	Giá gốc nhập vào của sản phẩm
spec.code.marketprice.price.goods_weight.package_weight.stock.alarm.sku	String	Thuộc tính của sản phẩm
g_storage*	String	Số lượng sản phẩm
g_alarm	String	Giá trị cảnh báo khi sản phẩm sắp hết hàng (số lương tùy theo người dụng đặt)
image_path*	String	Ảnh đại diện của sản phẩm
goodsvideo_name	String	Tên video sản phẩm
goodsvideo	String	Video sản phẩm
goods_body	String	Mô tả sản phẩm
province_id	String
city_id	String
freight	String	Vận chuyển
g_state	String	Thời gian ra mắt sản phẩm
g_commend	String	Đề xuất sản phẩm nổi bật

200: OK Tạo sản phẩm thành công

{
    "code": "success",
    "message": "Thành công",
    "result":{
        "commonid": 165
    },
    "requestMethod": "" 
}

• Danh sách gợi ý thuộc tính sản phẩm

POST /apis/v1/merchant/product/spec/list-suggest

Headers

Name	Type	Description
pm-mc-code	String	Xem hướng dẫn tại About
pm-mc-token	String	Xem hướng dẫn tại About

Request Body

Name	Type	Description
spec_1	String	Phân loại hàng 1 (bao gồm các thuộc tính)
spec_2	String	Phân loại hàng 2 (bao gồm các thuộc tính)
spec_3	String	Phân loại hàng 3 (bao gồm các thuộc tính)
image_spec_id	String	ID ảnh của sản phẩm biến thể

• Chỉnh sửa sản phẩm

POST /apis/v1/merchant/product/edit

Headers

Name	Type	Description
pm-mc-code	String	Xem hướng dẫn tại About
pm-mc-token	String	Xem hướng dẫn tại About

Request Body

Name	Type	Description
addition_image.parent_spec.name.default.sort.image_spec_id*	String	Ảnh sản phẩm
type_id	String
cate_id*	String	ID của ngành hàng
g_name*	String	Tên sản phẩm
g_jingle	String	Mô tả ngắn của sản phẩm
g_price*	String	Giá bán của sản phẩm
goods_weight*	String	Trọng lượng sản phẩm
package_weight*	String	Khối lương bao bì
g_marketprice	String	Giá niêm yết của sản phẩm
g_costprice	String	Giá gốc nhập vào của sản phẩm
g_storage*	String	Số lượng sản phẩm
spec.code.marketprice.price.goods_weight.package_weight.stock.alarm.sku	String	Thuộc tính của sản phẩm
g_alarm	String	Giá trị cảnh báo khi sản phẩm sắp hết hàng (số lương tùy theo người dụng đặt)
image_path*	String	Ảnh đại diện của sản phẩm
goods_body	String	Mô tả sản phẩm
province_id	String
city_id	String
freight	String	Vận chuyển
g_state	String	Thời gian ra mắt sản phẩm
g_commend	String	Đề xuất sản phẩm nổi bật
commonid*	String	ID chi tiết sản phẩm

200: OK Chỉnh sửa sản phẩm thành công

{
    "code": "success",
    "message": "Thành công",
    "result": "",
    "requestMethod": ""
}

• Danh sách sản phẩm

GET apis/v1/merchant/product/list

Query Parameters

Name	Type	Description
per_page	Text	Số trang

Headers

Name	Type	Description
pm-mc-code	String	Xem hướng dẫn tại About
pm-mc-token	String	Xem hướng dẫn tại About

200: OK

{
"code":200,
"message":"Thành công",
"result":{
    "total": 8377,
    "per_page": 1,
    "current_page": 1,
    "last_page": 8377,
    "data":[
        {
       "goods_commonid": 128,
        "goods_name": "Bánh Pía sầu riêng Sóc Trăng",
        "goods_advword": "Bánh Pía sầu riêng Sóc Trăng - vvhc",
        "gc_id": 781,
        "gc_id_1": 779,
        "gc_id_2": 780,
        "gc_id_3": 781,
        "gc_name": "Thực Phẩm - Đặc Sản >Bánh >Bánh Pía",
        "store_id":1,
        "store_name":"TEst của Nghĩa",
        "spec_name":"N;",
        "spec_value":"N;",
        "type_id":0,
        "goods_attr":"N;",
        "goods_body":"",
        "goods_state":1,
        "goods_stateremark":null,
        "goods_verify":1,
        "goods_verifyremark":null,
        "goods_lock":0,
        "goods_addtime":1506619910,
        "goods_shelftime":0,
        "goods_specname":null,
        "goods_price":199000,
        "goods_marketprice":0,
        "goods_costprice":0,
        "goods_discount":3,
        "goods_serial":"",
        "goods_storage_alarm":0,
        "goods_vat":0,
        "goods_sort":255,
        "goods": [
            {
                "goods_commonid": 128,
                "goods_id": 142,
                "goods_name": "Bánh Pía sầu riêng Sóc Trăng",
                "goods_price": 199000,
                "goods_marketprice": 0,
                "goods_serial": "",
                "goods_storage": 500,
                "goods_weight": "1000",
                "package_weight": 1000
            }
          ]
        }
    ]
},
"requestMethod":""
}

Key	Mô tả
total	Tổng số trang sản phẩm
per_page	Trang
current_page	Trang hiện tại
last_page	Trang vừa xem
goods_commonid	ID chi tiết sản phẩm (trong đó bao gồm các biến thể của sản phẩm)
goods_name	Tên sản phẩm
good_adword	Mô tả ngắn của sản phẩm
gc_id	ID ngành hàng
gc_id_1	ID ngành hàng 1
gc_id_2	ID ngành hàng 2
gc_id_3	ID ngành hàng 3
gc_name	Tên ngành hàng
store_id	ID cửa hàng
store_name	Tên cửa hàng
spec_name	Tên loại hàng
spec_value	Giá trị thuộc tính sản phẩm
type_id	ID Loại sản phẩm
goods_attr	Thuộc tính sản phẩm
goods_body	Mô tả sản phẩm
goods_state	Trạng thái của sản phẩm
goods_stateremark	Sản phẩm bị vi phạm
goods_verify	Xác minh sản phẩm
good_verifyremark	Sản phẩm không được duyệt
goods_lock	Sản phẩm bị dừng bán
goods_addtime	Thời gian tạo sản phẩm
goods_shelftime	Thời gian ra mắt sản phẩm
goods_specname	Tên thuộc tính sản phẩm
goods_price	Giá bán sản phẩm
goods_marketprice	Giá niêm yết sản phẩm
goods_costprice	Giá gốc nhập vào sản phẩm
goods_discount	Giảm giá sản phẩm
goods_serial	Mã của sản phẩm
goods_storage_alarm	Giá trị cảnh báo sản phẩm tồn kho
goods_vat	Thuế VAT của sản phẩm
goods_sort	Thứ tự sản phẩm
goods_storage	Số lượng tồn của sản phẩm
goods_weight	Trọng lượng của sản phẩm
package_weight	Khối lượng bao bì của sản phẩm

• Chi tiết sản phẩm

GET /apis/v1/merchant/product/detail

Query Parameters

Name	Type	Description
goods_id	String	Mã của sản phẩm

Headers

Name	Type	Description
pm-mc-code	String	Xem hướng dẫn tại About
pm-mc-token	String	Xem hướng dẫn tại About

200: OK

{
"code":200,
"message":"Thành công",
"result":{
    "goods_class":{
        "gc_id":70,
        "type_id":1,
        "gc_virtual":1,
        "gctag_name":"Điện thoại di động/nhà điều hành/kỹ thuật số thông minh >Thiết bị thông minh >Đồng hồ thông minh",
        "gctag_value":"Điện thoại di động/nhà điều hành/kỹ thuật số thông minh,Thiết bị thông minh,Đồng hồ thông minh",
        "gc_id_1":1,
        "gc_id_2":3,
        "gc_id_3":70
},

"goods":{
        "goods_commonid":101,
        "goods_name":"Đồng hồ thông minh Ticwatch2 Cuộc gọi Bluetooth Thể thao chống nước Hỗ trợ Vòng đeo tay theo dõi nhịp tim Android Apple Nam",
        "goods_advword":"Theo dõi chuyển động Ghi lại cuộc gọi Bluetooth",
        "gc_id":70,
        "gc_id_1":1,
        "gc_id_2":3,
        "gc_id_3":70,
        "gc_name":"Điện thoại di động/nhà điều hành/kỹ thuật số thông minh >Thiết bị thông minh >Đồng hồ thông minh",
        "store_id":1,
        "store_name":"Super Store",
        "spec_name":{
            "1":"Phong cách",
            "2":"Màu sắc",
            "3":"Kích cỡ"
            },
        "spec_value":"a:1:{i:1;a:2:{i:130;s:8:"Dài tay";i:131;s:10:"Ngắn tay";}}",
        "brand_id":0,
        "brand_name":"",
        "type_id":1,
        "goods_attr":"a:1:{i:1;a:2:{s:4:"name";s:6:"Tuổi";i:0;s:0:"";}}",
        "goods_body":"",
        "goods_state":1,
        "goods_stateremark":null,
        "goods_verify":1,
        "goods_verifyremark":null,
        "goods_lock":0,
        "goods_addtime":1506619910,
        "goods_shelftime":0,
        "goods_specname":null,
        "goods_price":938000,
        "goods_marketprice":1060000,
        "goods_costprice":0,
        "goods_discount":88,
        "goods_serial":"",
        "goods_storage_alarm":0,
        "transport_id":0,
        "transport_title":"",
        "goods_commend":1,
        "goods_freight":0,
        "goods_vat":0,
        "mall_goods_commend":1,
        "mall_goods_sort":255,
        "goods_sort":255,
    
    },
    "sp_value":{
        "i_130|marketprice":1060000,
        "i_130|price":938000,
        "i_130|id":143,
        "i_130|stock":100,
        "i_130|alarm":10,
        "i_130|sku":"D1A",
        "i_130|goods_weight":"3000.000",
        "i_130|package_weight":0,
        "i_131|marketprice":1060000,
        "i_131|price":938000,
        "i_131|id":144,
        "i_131|stock":200,
        "i_131|alarm":20,
        "i_131|sku":"N2B",
        "i_131|goods_weight":"3000.000",
        "i_131|package_weight":0
    },
"requestMethod":""
}

+ Mô tả respones 200:

Key	Mô tả
martketprice	Giá niêm yết sản phẩm
price	Giá bán
id	ID sản phẩm
stock	Số lượng hàng còn để bán
alarm	Giá trị cảnh báo nếu số lượng hàng không còn nhiều (Giá trị do người bán điều chỉnh)
sku	Mã SKU của sản phẩm
goods_weight	Trọng lượng sản phẩm
package_weight	Khối lượng bao bì