API Lấy chi tiết sản phẩm, đã bao gồm thuộc tính và ngành hàng
Changed history
Description |
Date |
Author |
---|---|---|
add field variant_attribute_hash |
|
|
add 2 field trong is_using_standard : bool gói tiêu chuẩn is_using_eco : bool gói bưu kiện |
|
|
Add field installments |
|
Tham số: Tùy vào nhu cầu cần lấy, Shop có thể cung cấp Id hoặc Sku để lấy sản phẩm. Trong trường hợp cung cấp cả 2, Sendo sẽ ưu tiên lấy thông tin theo id
Parameter |
Mô tả |
Ví dụ |
---|---|---|
id |
id của sản phẩm |
int, example: 1403349 |
sku |
mã sản phẩm |
string, example: sp123456 |
Field:
Ghi chú viết tắt:
sp → sản phẩm
sản phẩm đơn: sản phẩm không có cấu hình giá thuộc tính
variant: sản phẩm con
boolean: dạng true/false yes/no
Tên field |
Tên diễn giải |
kiểu dữ liệu |
Dùng trong tạo/ cập nhật sản phẩm |
bắt buộc |
Mô tả |
||
---|---|---|---|---|---|---|---|
|
Id sản phẩm |
int |
Có |
Có |
Truyền >0 để cập nhật, 0 để tạo 1 sản phẩm mới |
||
|
Tên sản phẩm |
text |
Có |
Có |
|
||
|
Mã sản phẩm |
text |
Có |
Có |
Unique không trùng đối với 1 shop |
||
|
Giá gốc sản phẩm |
decimal |
Có |
Có |
|
||
|
Trạng thái còn hàng |
boolean |
Có |
Có |
Còn hàng/ hết hàng, khi tạo và cập nhật nếu "stock_quantity" <=0 thì field này phải có value false (hết hàng) |
||
|
Tồn kho |
int |
Có |
Có |
Tồn kho của sp đơn |
||
|
Mô tả |
text |
Có |
Có |
Input dạng html raw text không vượt quá 20 hình (<img> tag), min 100 , max 100.000 ký tự |
||
|
Mã ngành hàng cấp 4 |
int |
Có |
Có |
Mã ngành hàng cuối của sp |
||
|
Trạng thái sp |
int |
Không |
Không |
product_status: List of enums - Danh sách các enum sử dụng trên sản phẩm. |
||
|
Từ khóa |
text |
Có |
Không |
|
||
|
Các thông tin về SEO |
object |
Không |
Không |
|
||
|
Link sp trên sendo.vn |
string |
Không |
Không |
Hệ thống tự sinh ra, không cho thay đổi |
||
|
Sp liên quan |
array |
Không |
Không |
|
||
|
Từ khóa SEO |
text |
Có |
Không |
|
||
|
Tiêu đề SEO |
text |
Có |
Không |
|
||
|
Mô tả SEO |
text |
Có |
Không |
|
||
|
Điểm SEO |
decimal |
Không |
Không |
|
||
|
Hình sp |
text |
Không |
Không |
Không cho đổi avatar sau khi lưu,field Picture được sử dụng để tạo và update |
||
|
Tên ngành hàng cấp 4 |
text |
Không |
Không |
|
||
|
Giá khuyến mãi |
decimal |
Không |
Không |
Không còn sử dụng |
||
|
Id thương hiệu |
int |
Có |
|
Bắt buộc > 0 đổi với shopmall, shop thường không sử dụng |
||
|
Tên thương hiệu |
text |
Không |
Không |
|
||
|
Người cập nhật cuối |
text |
Không |
Không |
có thể là shop cập nhật, người hậu kiểm, job cron |
||
|
Ngày cập nhật |
int64 |
Không |
Không |
|
||
|
Ngày tạo |
int64 |
Không |
Không |
|
||
|
Đường dẫn ngành hàng |
text |
Không |
Không |
|
||
|
Link dẫn tới video của sp |
string[] |
Có |
Không |
|
||
|
Chiều cao |
decimal |
Có |
Có |
Hợp lệ khi Khối lượng có giá trị học hoặc "dài, rộng, cao" có giá trị |
||
|
Chiều dài |
decimal |
Có |
||||
|
Chiều rộng |
decimal |
Có |
||||
|
Khối lượng |
decimal |
Có |
||||
|
Đơn vị |
int |
Có |
Có |
Ví dụ: 1 → Cái |
||
|
Ảnh đại diện sản phẩm |
object |
Có |
Có |
picture_url: link url hình ảnh |
||
|
Danh sách hình của sp |
Array |
Có |
Có |
picture_url: link url hình ảnh |
||
|
danh sách file chứng từ sp |
Array |
Không |
Không |
Shop mall bắt buộc có field này
|
||
|
danh sách thuộc tính sp |
Array |
Có |
Có |
Xem mô tả: Attributes |
||
|
Ngày bắt đầu khuyến mãi |
int64 |
Có |
Không |
|
||
|
Ngày kết thúc khuyến mãi |
int64 |
Có |
Không |
|
||
|
Cấu hình vận chuyển |
object |
có |
|
|
||
|
Danh sách sp con |
array |
Có |
|
Xem mô tả: Variants |
||
|
Sản phẩm cấu hình |
boolean |
Có |
Có |
Nếu false → sp không có sp con, variants không bắt buộc. YES → phải có variants |
||
|
Sp có đang bị lỗi ngành hàng thuộc tính |
boolean |
Có |
Có |
True nếu sp từng bị đổi ngành hàng dẫn đến thuộc tính không hiển thị được trên ban.sendo.vn |
||
|
Giá khuyến mãi |
decimal |
Có |
Không |
|
||
|
thông tin Loại sản phẩm |
|
Có |
Có |
|
||
|
Loại hình sản phẩm của ngành hàng |
Array |
Có |
Không |
|||
|
Tham gia FlashSale |
boolean |
Không |
Không |
|
||
|
Trạng thái sự kiện |
int |
Không |
Không |
|
||
|
Có thể cập nhật trạng thái sản phẩm |
boolean |
Không |
Không |
True: được phép cập nhật sp, False: không được phép cập nhật sp |
||
|
Cấu hình trả góp |
Array |
Có |
Không |
[3, 6] => 3 tháng, 6 tháng |
Variants:
Tên field |
Tên diễn giải |
Kiểu dữ liệu |
Dùng trong cập nhật/ Tạo |
Bắt buộc |
Mô tả |
|
---|---|---|---|---|---|---|
|
thuộc tính đã chọn của sp con |
array |
Có |
Có |
Xem mô tả: Attributes |
|
|
có đang khuyến mãi hay không |
boolean |
không |
không |
|
|
|
mã sản phẩm con |
text |
Có |
Có |
không được trùng trong 1 sản phẩm |
|
|
Giá |
decimal |
Có |
Có |
|
|
|
Giá khuyến mãi |
decimal |
Có |
không |
|
|
|
Tồn kho |
int |
Có |
Không |
|
|
|
Tham gia FlashSale |
boolean |
Không |
Không |
|
|
|
Trạng thái sự kiện |
int |
Không |
Không |
|
|
|
Ngày bắt đầu khuyến mãi |
int64 |
Có |
Không |
|
|
|
Ngày kết thức khuyến mãi |
int64 |
Có |
Không |
|
|
|
|
string |
Không |
Không |
|
Attributes:
Tên field |
Tên diễn giải |
kiểu dữ liệu |
Dùng trong Tạo/ Cập nhật |
Bắt buộc |
Mô tả |
||
---|---|---|---|---|---|---|---|
|
Id thuộc tính |
int |
Có |
Có |
|
||
|
Loại thuộc tính |
int |
Không |
Không |
|
||
|
Tên Thuộc tính |
text |
Có |
Không |
|
||
|
Thuộc tính có bắt buộc hay không |
boolean |
Không |
Không |
|
||
|
Mã thuộc tính |
text |
Có |
Không |
|
||
|
giá trị thuộc tính |
array |
Có |
Có |
|
||
|
Có phải thuộc tinh user tự tạo ngoài hệ thống hay không |
boolean |
Có |
Có |
tối đa 3 thuộc tính (isCheckout+ isCustom) |
||
|
có phải thuộc tính màu sắc hay không |
boolean |
Không |
Không |
|
||
|
Cấu hình bắt buộc phải chọn |
boolean |
Có |
Có |
Hệ thống tự sinh ra, không cho thay đổi |
Code Snippet request By ID
Sample Request
curl -X GET \ 'https://open.sendo.vn/api/partner/product?id=16673758 \ -H 'Authorization: bearer your_access_token' \ |
Code Snippet request By SKU
Sample Request
curl -X GET \ 'https://open.sendo.vn/api/partner/product?sku=nambuchobe \ -H 'Authorization: bearer your_access_token' \ |
Code Snippet request By both (Priority for id)
Sample Request
curl -X GET \ 'https://open.sendo.vn/api/partner/product?id=16673758&sku=nambuchobe \ -H 'Authorization: bearer your_access_token' \ |
Code Snippet response
Example
{ "result": { "id": 16673758, "name": "num bu cho con", "sku": "numbuchobe", "price": 80000.0, "weight": 10.0, "stock_availability": false, "stock_quantity": 0, "description": "<p><strong>Lorem Ipsum</strong> is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum.<span></span></p>", "cat_4_id": 1297, "status": 2, "tags": "num vu cho be tap bu binh,dam cho con bu,ao cho con bu,vay cho con bu,do cho con bu", "updated_date_timestamp": 1590830538.0, "created_date_timestamp": 1584963481.0, "seo":"{\"score\":\"\\",\"seo_description\":\"\",\"seo_keyword\":\"\",\"seo_title\":\"\"}", "link": "http://test.sendo.vn/num-bu-cho-con-16673758.html", "relateds": [], "seo_keyword": null, "seo_title": null, "seo_description": null, "seo_score": 0, "image": "http://mtest.scdn.vn/img1/2020/3_23/wPtf5OgjHdZqB8RsJicvqGCdf7kGYVWb.jpg", "category_4_name": "Đầm đôi mẹ & bé gái", "brand_id": 0, "brand_name": null, "updated_user": "salesorderupdatequantity", "url_path": "me-va-be/thoi-trang-gia-dinh-set-trang-phuc/dam-doi", "video_links": null, "height": 0.0, "length": 0.0, "width": 0.0, "unit_id": 1, "avatar": { "picture_url": "http://mtest.scdn.vn/img1/2020/3_23/wPtf5OgjHdZqB8RsJicvqGCdf7kGYVWb.jpg" }, "pictures": [ { "picture_url": "http://mtest.scdn.vn/img1/2020/3_23/wPtf5OgjHdZqB8RsJicvqGCdf7kGYVWb.jpg" } ], "certificate_file": [], "attributes": [ { "attribute_id": 284, "attribute_type": 1, "attribute_name": "Màu sắc", "attribute_is_required": true, "attribute_code": "mau_sac", "attribute_is_custom": false, "attribute_is_checkout": true, "attribute_is_image": true, "attribute_values": [ { "id": 602, "value": "Nâu", "attribute_img": null, "is_selected": false, "is_custom": false }, { "id": 603, "value": "Vàng", "attribute_img": null, "is_selected": true, "is_custom": false }, .................. ] }, { "attribute_id": 333, "attribute_type": 3, "attribute_name": "Xuất xứ", "attribute_is_required": true, "attribute_code": "xuat_xu", "attribute_is_custom": false, "attribute_is_checkout": false, "attribute_is_image": false, "attribute_values": [ { "id": 1418, "value": "Mỹ", "attribute_img": null, "is_selected": false, "is_custom": false }, { "id": 1419, "value": "Nhật Bản", "attribute_img": null, "is_selected": true, "is_custom": false }, ....... ] } ], "special_price": 80000.0, "promotion_from_date_timestamp": null, "promotion_to_date_timestamp": null, "is_promotion": false, "extended_shipping_package": { "is_using_instant": false, "is_using_in_day": true, "is_self_shipping": false }, "variants": [ { "variant_attributes": [ { "attribute_id": 284, "attribute_code": "mau_sac", "option_id": 603 } ], "variant_is_promotion": 0, "variant_sku": "Vàng", "variant_price": 80000.0, "variant_special_price": 50000.0, "variant_quantity": 0, "variant_promotion_start_date_timestamp": 1584896400.0, "variant_promotion_end_date_timestamp": 1592067599.0, "variant_is_flash_sales": null, "variant_campaign_status": null } ], "is_config_variant": true, "is_invalid_variant": false, "voucher": { "product_type": 1, "start_date": null, "end_date": null, "is_check_date": null }, "product_category_types": [ 1 ], "is_flash_sales": false, "campaign_status": null, "can_edit": true, "installments": [ 3, 6 ] }, "success": true, "error": null, "status_code": 200 } |