Nông sản Bưu điện Open API
  • 🧑‍🔧Merchant
    • About
    • Products
    • Image Product
    • Order
    • Categories
    • Area
    • User
Powered by GitBook
On this page
  1. Merchant

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

{
    "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

{
    "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
Description

per_page

Phân trang

update_time

Thời gian chỉnh sửa sản phẩm lần cuối (TIMESTAMP)

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

{
"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,
        "goodscommon_image_url": "http://buudienvn.test/uploads/home/store/goods/1/20170921/1_2017092120144795113.jpg",
        "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,
                "goods_image_url": "http://buudienvn.test/uploads/home/store/goods/1/20170921/1_2017092120144795113.jpg"
            }
          ]
        }
    ]
},
"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 ( 0: Không hiển thị; 1: Hiển thị; 10: Bị cấm bán)

goods_stateremark

Nguyên nhân sản phẩm bị cấm bán

goods_verify

Xác minh sản phẩm ( 1: Đã duyệt; 0: Không được duyệt; 10: Chờ duyệt )

good_verifyremark

Nguyên nhân sản phẩm không được duyệt

goods_lock

Sản phẩm bị khóa ( 0: Không khóa; 1: Đã bị khóa)

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

goodscommon_image_url

URL ảnh chung của sản phẩm

goods_image_url

URL ảnh chi tiết từng sản phẩm ( bao gôm cả các biến thể)

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

{
"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
     },
     "list_goods_image": [
            {
                "goodsimage_id": 738,
                "goods_commonid": 252,
                "store_id": 1,
                "color_id": 0,
                "goodsimage_url": "alioss_1_2023122509220253191.png",
                "goodsimage_sort": 0,
                "goodsimage_isdefault": 1,
                "image_path": "http://buudienvn.test/uploads/home/common/default_image.png"
            },
            {
                "goodsimage_id": 739,
                "goods_commonid": 252,
                "store_id": 1,
                "color_id": 0,
                "goodsimage_url": "alioss_1_2023122509212240812.png",
                "goodsimage_sort": 0,
                "goodsimage_isdefault": 0,
                "image_path": "http://buudienvn.test/uploads/home/common/default_image.png"
            },
            {
                "goodsimage_id": 740,
                "goods_commonid": 252,
                "store_id": 1,
                "color_id": 0,
                "goodsimage_url": "alioss_1_2023122509223638993.png",
                "goodsimage_sort": 0,
                "goodsimage_isdefault": 0,
                "image_path": "http://buudienvn.test/uploads/home/common/default_image.png"
            }
        ]
    },
"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ì

list_goods_image

Danh sách ảnh sp

goodsimage_id

ID ảnh sản phẩm

goods_commonid

ID sản phẩm

goodsimage_isdefault

Có phải ảnh mặc định không? ( 0: Không; 1: Có)

image_path

URL ảnh sản phẩm

Last updated 1 month ago

🧑‍🔧