ตัวอย่าง Call API Postman
Bentoweb OAuth https://www.getpostman.com/collections/66d686d5a184d68dbcfc ให้ระบุ Client ID, Client Secret ที่ใช้ และ Email, Password ที่ใช้ในร้านที่ต้องการเชื่อมต่อข้อมูลผู้อ่านไม่กี่คนสถานะของออเดอร์ในระบบ
สถานะของออเดอร์ในระบบ (Order Status) ตารางแสดงความหมายของ order_status_id ในแต่ละขั้นตอน 1. สถานะทั่วไป (General) ID ชื่อสถานะ หมายเหตุ 0 ไม่มีการยกเลิกอัตโนมัติ 1 รอการชำระเงิน 2 รอตรวจสอบการชำระเงิน 3 ชำระเงินแล้ว / รอการจัดส่ง 4 ยกเลิกการสั่งซื้อ 5 รอการคืนเงิน (ยังไม่เปิดใช้งาน) 6 คืนเงินแล้ว / ยกเลิกการสั่งซื้อ (ยังไม่เปิดใช้งาน) 7 จัดส่งสินค้าแล้วผู้อ่านไม่กี่คนProduct Attribute API
Postman Example https://www.getpostman.com/collections/7edce68fd8879d90c2ee ให้นำ Link import เข้า Postman  อัพเดทเมื่อ 8 ตุลาคม 2567 โดยข้อมูลจะอยู่ใน API Order เส้น /order/order-full/{order_id} Field shopee_api_transaction escrow_amount = original_cost_of_goods_sold-original_shopee_discount+seller_return_refund+ shopee_discount- voucher_from_seller- seller_coin_cash_back+ buyer_paid_shipping_fee- actual_shipping_fee+ shopee_shipping_rebate+ shipping_fee_discount_from_3pl- reverse_shipping_fee+ rsf_seller_protection_fee_claim_aผู้อ่านไม่กี่คนรายละเอียดค่า order_from
📖 order_from order_from ใช้ระบุแหล่งที่มาของออเดอร์ (Order Source) เพื่อให้ทราบว่าออเดอร์ถูกสร้างจากช่องทางใด เหมาะสำหรับทีม Support ในการตรวจสอบ และสำหรับทีมพัฒนา (Dev) ในการทำงานกับ API 📋 รายการช่องทาง (Order Source ID 0–24) BentoWeb Channel Reference Channel ID Channel Name หมวดหมู่ สถานะปัจจุบัน คำอธิบาย 0 N/A Own Channel Active N/A | 1 | Web | Own Channel | Active | หน้าร้านออนไลน์ของผู้ขายบน BentoWeb ที่ลูกค้าเข้าถึงผ่านเว็บเบราวผู้อ่านไม่กี่คนE-Marketplace - Save shipping API (Seller own fleet)
Endpoint: POST /order/save_shipping 📌 ข้อมูลเพิ่มเติมสำหรับการจัดส่งผ่าน E-Marketplace ✅ สำหรับ Seller Own Fleet (ใช้ในกรณีที่ร้านค้าจัดส่งเอง) Shopee { "shipping_datetime": "2024-04-01 18:00:00", // วันที่และเวลาจัดส่ง "shipping_type": "non_integrated", // ประเภทการจัดส่ง (สำหรับกรณีไม่ได้ใช้ระบบขนส่งที่เชื่อมต่อ) "shipping_ems": "{trackNo}",ผู้อ่านไม่กี่คนคู่มือการใช้งาน Webhook In Cancel (ระบบแจ้งเตือนคำขอยกเลิกจากผู้ซื้อ)
เอกสารฉบับนี้อธิบายวิธีการใช้งานและความสำคัญของ Webhook In Cancel สำหรับนักพัฒนาที่เชื่อมต่อกับระบบ BentoWeb เพื่อจัดการคำสั่งซื้อจาก Marketplace (Shopee, Lazada, TikTok Shop) 1. Webhook In Cancel คืออะไร? ปกติแล้วเวลาลูกค้ากดยกเลิกคำสั่งซื้อ จะมี 2 กรณี: ยกเลิกสำเร็จทันที (Instant Cancel): กรณีที่ร้านยังไม่ได้กดเตรียมส่งของ (Arrange Shipment) -> สถานะออเดอร์จะเปลี่ยนเป็น CANCELLED เลย ขอยกเลิก (Cancellation Request): กรณีที่ร้านกดเตรียมส่งของไปแล้ว หรือมีเลขพัสดุแล้ว ลูผู้อ่านไม่กี่คนตัวอย่าง Callback Webhook (Order, Product, Variant)
เมื่อมีการ Subscribe Webhook กับทางระบบ เมื่อมีการเปลี่ยนแปลงของข้อมูล ระบบจะทำการส่งข้อมูลที่อัพเดทไปยังปลายทางที่ได้ลงทะเบียนไว้ ด้านล่างคือตัวอย่างข้อมูลที่ส่งไป เป็นในรูปแบบ JSON Product - add / update / delete { "product_id": 53717, "store_id": 5442, "type": 1, "name": "Product 22", "description": "", "prepend_description_id": null, "append_description_id": null, "meta_keyword": "", "meta_description": "", "seo_url": "seo-22", "short_url": "", "price":ผู้อ่านไม่กี่คนการแจ้งจัดส่ง Shopee โดยรูปแบบ Pickup/Dropoff
ข้อมูลที่ต้องใช้สำหรับการแจ้งจัดส่ง ดูได้ใน GET /order/order-full/{order_id} Shopee (order_from = 16) 1.1 shopee_shipping (Pickup) address_id: รหัสที่อยู่ของร้านค้า ใช้เป็นที่อยู่สำหรับการรับสินค้า pickup_time_id: รหัสเวลาที่ต้องการให้พนักงานมารับของ หากไม่ระบุ ระบบจะเลือกเวลาที่เร็วที่สุดให้ 1.2 shopee_address_select ใช้สำหรับดึงค่าที่อยู่ที่ตั้งคผู้อ่านไม่กี่คนขั้นตอนการทำ Cart API
สร้าง Cart ด้วย Endpoint /cart-api กรณีสร้างในรูปแบบออกด้วย POS ให้ส่ง is_pos เป็น 1 ด้วย เพิ่มสินค้าลง Cart ด้วย Endpoint /cart-api/product สร้างลูกค้า Guest ด้วย Endpoint /guest และ Guest Addreผู้อ่านไม่กี่คนตัวอย่างข้อมูล Order full จาก Platform ต่างๆ
Shopee { "status": 1, "data": { "order": { "order_id": 9268940, "date_created": "****-10-15 08:2****", "date_modified": "****-10-15 15:1****", "date_cancelled": "****1-11-30 00:0****", "receipt_datetime": "****-10-15 08:2****", "ref_code": "****wy6g73c****", "langs": "****", "store_id": 47805, "fb_store_id": 0, "customer_id": 0, "discount_id"ผู้อ่านไม่กี่คนExample เพิ่มสินค้าและตัวเลือกสินค้า
ตัวอย่างการเพิ่มสินค้าและตัวเลือกสินค้าครั้งแรก Sandbox Method: POST URL: http://queue.bento-sandbox.com/api/product Production Method: POST URL: http://queue.bento-sandbox.com/api/product Header: Authorization: Bearer {access_token} // access token ที่ได้รับจากการ authenticate Body ตัวอย่าง { "images": [ "**image_url**" ], "name": "มาม่าโจ๊กคัพรสไข่เค็ม แพ็ค 3", "active": 1, "price": 50.00, "store_id":**store_id** "variant": [ {ผู้อ่านไม่กี่คนการแจ้งจัดส่ง TiktokShop โดยรูปแบบ Pickup/Dropoff
TikTok Shop (order_from = 22) วิธีการแจ้งจัดส่ง 1. Endpoint สำหรับ Save Shipping POST https://order.bentoweb.com/api/order/save-shipping 2.1 Parameter ที่ต้องใช้ (Drop-off) { "order_id": "123456789", "store_id": "999", "shipping_method": "J&T Express", "shipping_datetime": "2025-07-16 19:00:00", "pick_up_type": "DROP_OFF" } 2.2 Parameter ที่ต้องใช้ (Pickup) { "order_id": "123456789", "store_id": "999", "shipping_method": "J&Tผู้อ่านไม่กี่คนขั้นตอนการสร้าง Product ประเภท Attribute (Type 3)
ใช้ API เพื่อสร้าง Product โดย ระบุ type มีค่าเป็น 3 Sandbox https://app.swaggerhub.com/apis/SemanticTouch/BentoSandboxProduct/1.0.0-oas3#/Products/post_product Production https://app.swaggerhub.com/apis/SemanticTouch/BentowebProduct/1.0.0-oas3#/Products/post_product Data ตัวอย่าง: { "name": "Product name", "active": 0, "price": 30, "store_id":{store_id}, "type": 3 } ทำการ Init attribute Sandbox https://app.swaggerhub.com/apis/SemanticTouch/BentoSandboxProduct/1.ผู้อ่านไม่กี่คนการแจ้งจัดส่ง Lazada โดยรูปแบบ Dropoff
Lazada (order_from = 12) วิธีการแจ้งจัดส่ง 1. Endpoint สำหรับ Save Shipping POST https://order.bentoweb.com/api/order/save-shipping 2. Parameter ที่ต้องใช้ (Drop-off) { "shipping_datetime": "2025-07-16 10:49:26", "shipping_method": "sstp:1111", "order_id": "123456789", "store_id": "1234" } ** Lazada ไม่มีการจัดส่งประเภท Pickup **ผู้อ่านไม่กี่คนตัวอย่างข้อมูล Callback bulk save shipping
เมื่อลงทะเบียน Webhook save_shipping - bulk หลังจากการ Request แจ้งจัดส่งทีละหลายออเดอร์จาก Endpoint /order/save-shipping-bulk จะมีข้อมูลส่งไป URL ที่ลงทะเบียน ตัวอย่างข้อมูลมีดังนี้ { "status": 1, "data": { "message": "Edited", "update_shipping_info": false, "order_list": [ "432646" ] } } status - 1 คือแจ้งจัดส่งสำเร็จ, 0 ไม่สำเร็จผู้อ่านไม่กี่คนการตรวจสอบ Signature ของ BentoWeb Webhook ด้วย HMAC-SHA256
🔐 การตรวจสอบ Signature ของ BentoWeb Webhook ด้วย HMAC-SHA256 เมื่อคุณรับ Webhook จาก BentoWeb ระบบจะส่งข้อมูลมาพร้อมกับ Signature เพื่อให้คุณสามารถตรวจสอบความถูกต้องของข้อมูล และป้องกันการปลอมแปลงได้ 📬 ข้อมูลที่คุณจะได้รับจาก Webhook Body: JSON Payload Header: Authorization: Signature สำหรับตรวจสอบ 🔑 หลักการสร้าง Signature Signature ถูกสร้างจาก: HMAC_SHA256(client_id + json_payload, client_secret) โดย client_id คือรหัสประจำระบบของคุณ `json_ผู้อ่านไม่กี่คนวิธีปรับสถานะ payment ของ order ที่เป็นการโอนเงิน (transfer)
กรณีที่ลูกค้าไม่ได้อัพโหลดสลิปหรือแจ้งการโอนเงินเข้ามา จะมีขั้นตอนตามนี้นะครับ กรณีที่ payment เป็น transfer ต้องมีรายชื่อธนาคารในร้านเราก่อน ให้ดึงได้ที่ https://open-api.bentoweb.com/bentoweb-api-prod/#/Banks/get_bank_stores__store_id_ ต้องมี list id ธนาคาร ดึงได้ที่ https://open-api.bentoweb.com/bentoweb-api-prod/#/Banks/get_bank ให้เราทำการแนบสลิปโดยใช้ endpoint นี้ https://open-api.bentoweb.com/bentoweb-order-prod/#/Order/post_order_submit_attach_transfer_slip โดยใส่ข้อมูลให้ครบผู้อ่านไม่กี่คนคู่มือการใช้งาน API ปรับสต๊อกสินค้า (Stock Rebalance)
คู่มือการใช้งาน API ปรับสต็อกสินค้า (Stock Rebalance) ระบบ Stock Rebalance ช่วยให้การจัดการสต็อกสินค้าเชื่อมต่อไปยัง Marketplace ต่างๆ (Shopee, Lazada, TikTok Shop, Line Shopping, Makro Pro, Shopify) เป็นเรื่องง่าย โดยแบ่งการทำงานออกเป็น 2 โหมดหลักคือ Manual และ Auto เอกสารนี้จะอธิบายวิธีการใช้งาน API สำหรับตรวจสอบสถานะ และการอัปเดตสต็อกในแต่ละโหมด 1. การตรวจสอบ Mode ปัจจุบันของสินค้า ก่อนทำการอัปเดตสต็อก สามารถตรวจสอบได้ว่าสินค้านั้นๆ (Product Variant) กำลังทำงานอยู่ในโหมดใด **APIผู้อ่านไม่กี่คนวิธีกำหนดราคา Wholesale ผ่าน API
การกำหนดราคาขายส่ง (Wholesale Pricing) ผ่าน API สามารถตั้งค่าราคาขายส่งได้ผ่าน 3 Endpoints ดังนี้: 1. สร้างสินค้าใหม่ (Create Product) POST /product 2. สร้างตัวเลือกสินค้าใหม่ (Create Variant) POST /product-variant 3. แก้ไขตัวเลือกสินค้า (Update Variant) PUT /product-variant/{product_variant_id} โครงสร้างข้อมูล (JSON Structure) ในการส่งข้อมูล ให้เพิ่ม Field wholesale_range และ max_wholesale_range_price เข้าไปใน Payload: JSON { "has_wholesale": 1, "wผู้อ่านไม่กี่คนPHP Example การดึงข้อมูล Product List [Get method]
การดึงข้อมูลรายการสินค้า (Get Product List) 1. PHP Request Code PHP <?php $accessToken = '[Access Token]'; $storeId = [Store ID]; $params = [ 'store_id' => $storeId, // 'page' => 1, // (Optional) หน้าที่ต้องการดึงข้อมูล // 'limit' => 20, // (Optional) จำนวนรายการต่อหน้า ]; $url = "https://queue.bentoweb.com/api/productlist?" . http_build_query($params); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_HTTPHEADER, [ผู้อ่านไม่กี่คนPHP Example การขอ access token เพื่อใช้ยิง API
การเชื่อมต่อ BentoWeb API (OAuth 2.0) ตัวอย่าง PHP Code สำหรับการขอ Access Token เพื่อเริ่มใช้งาน API 1. การขอ Access Token (Authentication) PHP <?php // การตั้งค่าเริ่มต้น $clientId = '[หมายเลข Client]'; $clientSecret = 'xxxxxxxxxx'; $username = 'xxxxxxx@email.com'; $password = 'xxxxxxx'; // URL สำหรับยิง API (เลือกใช้ตาม Environment) $apiUrl = "https://login.bentoweb.com/oauth/token"; // $apiUrl = "https://login.bento-sandbox.com/oauth/token"; // สำหรับ Sandเป็นที่นิยมวิธีการทดสอบยิงโดยใช้ Swagger
วิธีการทดสอบยิงโดยใช้ Swagger คลิกปุ่ม Authorize || ใส่ข้อมูลการเชื่อมต่อ username คือ อีเมล์ที่ใช้ login เข้าระบบหลังบ้าน password คือ รหัสผ่านที่ใช้ login เข้าระบบหลังบ้าน client_id คือ หมายเลข Client ในการเชื่อมต่อ API ที่ได้รับมา client_secret คือ รหัสของ Client ที่ได้รับมา ![ผู้อ่านไม่กี่คน