ตัวอย่าง Call API Postman
Bentoweb OAuth https://www.getpostman.com/collections/66d686d5a184d68dbcfc ให้ระบุ Client ID, Client Secret ที่ใช้ และ Email, Password ที่ใช้ในร้านที่ต้องการเชื่อมต่อข้อมูล เมื่อทำการ Request ข้อมูล จะได้กลับมาเป็น accesstoken ให้นำส่วนนี้ไปใช้งานต่อ ค่า expiresin เป็นระยะเวลาอายุของ accesstoken หน่วยเป็นวินาทีผู้อ่านไม่กี่คนสถานะของออเดอร์ในระบบ
สถานะของออเดอร์ในระบบ (Order Status) ตารางแสดงความหมายของ orderstatusid ในแต่ละขั้นตอน 1. สถานะทั่วไป (General)ผู้อ่านไม่กี่คนProduct Attribute API
Postman Example https://www.getpostman.com/collections/7edce68fd8879d90c2ee ให้นำ Link import เข้า Postman คลิกที่เมนู Collection ที่ Import เข้ามาแล้วเลือก Edit (https://storage.crisp.chat/users/helpdesk/website/14e70c59ผู้อ่านไม่กี่คนการคำนวนท้ายบิล Marketplace
Shopee วิธีคำนวนรายได้ของร้าน (ยอดที่ Shopee ชำระกลับเข้ามา) อัพเดทเมื่อ 8 ตุลาคม 2567 โดยข้อมูลจะอยู่ใน API Order เส้น /order/order-full/ orderid Field shopeeapitransaction escrowamount = originalcostofgoodssold-originalshopeediscount+sellerreturnrefund+ shopeediscount- voucherfromseller- sellercoincashback+ buyerpaidshippingfee- actualshippingfee+ shopeeshippingrebate+ shippingfeediscountfrom3pl- reverseshippingfee+ rsfsellerprotectionfeeclaimaผู้อ่านไม่กี่คนรายละเอียดค่า order_from
📖 orderfrom orderfrom ใช้ระบุแหล่งที่มาของออเดอร์ (Order Source) เพื่อให้ทราบว่าออเดอร์ถูกสร้างจากช่องทางใด เหมาะสำหรับทีม Support ในการตรวจสอบ และสำหรับทีมพัฒนา (Dev) ในการทำงานกับ API 📋 รายการช่องทาง (Order Source ID 0–24) 0: N/A 1: Web 2: Mobile 3: FB 4: Android 5: iOS 6: Web POS 7: BentoDash 8: Mobile POS 9: Tablet POS 10: OpenAPI 11: FastCheckout 12: Lazada 13: Shopee Import 14: Lazada Import 15: CartBuilder 16: Shopee 17: Arislab Import 18: Deeple Import 19: Bentoweb Import 2ผู้อ่านไม่กี่คนE-Marketplace - Save shipping API (Seller own fleet)
Endpoint: POST /order/saveshipping 📌 ข้อมูลเพิ่มเติมสำหรับการจัดส่งผ่าน E-Marketplace ✅ สำหรับ Seller Own Fleet (ใช้ในกรณีที่ร้านค้าจัดส่งเอง) Shopeeผู้อ่านไม่กี่คนตัวอย่าง Callback Webhook (Order, Product, Variant)
เมื่อมีการ Subscribe Webhook กับทางระบบ เมื่อมีการเปลี่ยนแปลงของข้อมูล ระบบจะทำการส่งข้อมูลที่อัพเดทไปยังปลายทางที่ได้ลงทะเบียนไว้ ด้านล่างคือตัวอย่างข้อมูลที่ส่งไป เป็นในรูปแบบ JSON Product - add / update / deleteผู้อ่านไม่กี่คนคู่มือการใช้งาน Webhook In Cancel (ระบบแจ้งเตือนคำขอยกเลิกจากผู้ซื้อ)
เอกสารฉบับนี้อธิบายวิธีการใช้งานและความสำคัญของ Webhook In Cancel สำหรับนักพัฒนาที่เชื่อมต่อกับระบบ BentoWeb เพื่อจัดการคำสั่งซื้อจาก Marketplace (Shopee, Lazada, TikTok Shop) 1. Webhook In Cancel คืออะไร? ปกติแล้วเวลาลูกค้ากดยกเลิกคำสั่งซื้อ จะมี 2 กรณี: ยกเลิกสำเร็จทันที (Instant Cancel): กรณีที่ร้านยังไม่ได้กดเตรียมส่งของ (Arrange Shipment) -สถานะออเดอร์จะเปลี่ยนเป็น CANCELLED เลย ขอยกเลิก (Cancellation Request): กรณีที่ร้านกดเตรียมส่งของไปแล้ว หรือมีเลขพัสดุแล้ว ลูผู้อ่านไม่กี่คนตัวอย่างข้อมูล Order full จาก Platform ต่างๆ
Shopeeผู้อ่านไม่กี่คน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 accesstoken // access token ที่ได้รับจากการ authenticate Body ตัวอย่างผู้อ่านไม่กี่คนขั้นตอนการทำ Cart API
สร้าง Cart ด้วย Endpoint /cart-api กรณีสร้างในรูปแบบออกด้วย POS ให้ส่ง ispos เป็น 1 ด้วย เพิ่มสินค้าลง Cart ด้วย Endpoint /cart-api/product สร้างลูกค้า Guest ด้วย Endpoint /guest และ Guest Addreผู้อ่านไม่กี่คนการแจ้งจัดส่ง Shopee โดยรูปแบบ Pickup/Dropoff
ข้อมูลที่ต้องใช้สำหรับการแจ้งจัดส่ง ดูได้ใน GET /order/order-full/ orderid Shopee (orderfrom = 16) 1.1 shopeeshipping (Pickup) addressid: รหัสที่อยู่ของร้านค้า ใช้เป็นที่อยู่สำหรับการรับสินค้า pickuptimeid: รหัสเวลาที่ต้องการให้พนักงานมารับของ หากไม่ระบุ ระบบจะเลือกเวลาที่เร็วที่สุดให้ 1.2 shopeeaddressselect ใช้สำหรับดึงค่าที่อยู่ที่ตั้งคผู้อ่านไม่กี่คนขั้นตอนการสร้าง Product ประเภท Attribute (Type 3)
ใช้ API เพื่อสร้าง Product โดย ระบุ type มีค่าเป็น 3 Sandbox https://app.swaggerhub.com/apis/SemanticTouch/BentoSandboxProduct/1.0.0-oas3/Products/postproduct Production https://app.swaggerhub.com/apis/SemanticTouch/BentowebProduct/1.0.0-oas3/Products/postproduct Data ตัวอย่าง: ทำการ Init attribute Sandbox https://app.swaggerhub.com/apis/SemanticTouch/BentoSandboxProduct/1.ผู้อ่านไม่กี่คนตัวอย่างข้อมูล Callback bulk save shipping
เมื่อลงทะเบียน Webhook saveshipping - bulk หลังจากการ Request แจ้งจัดส่งทีละหลายออเดอร์จาก Endpoint /order/save-shipping-bulk จะมีข้อมูลส่งไป URL ที่ลงทะเบียน ตัวอย่างข้อมูลมีดังนี้ status - 1 คือแจ้งจัดส่งสำเร็จ, 0 ไม่สำเร็จผู้อ่านไม่กี่คนการแจ้งจัดส่ง TiktokShop โดยรูปแบบ Pickup/Dropoff
TikTok Shop (orderfrom = 22) วิธีการแจ้งจัดส่ง 1. Endpoint สำหรับ Save Shipping 2.1 Parameter ที่ต้องใช้ (Drop-off) 2.2 Parameter ที่ต้องใช้ (Pickup)ผู้อ่านไม่กี่คนการแจ้งจัดส่ง Lazada โดยรูปแบบ Dropoff
Lazada (orderfrom = 12) วิธีการแจ้งจัดส่ง 1. Endpoint สำหรับ Save Shipping 2. Parameter ที่ต้องใช้ (Drop-off) Lazada ไม่มีการจัดส่งประเภท Pickupผู้อ่านไม่กี่คนการตรวจสอบ Signature ของ BentoWeb Webhook ด้วย HMAC-SHA256
🔐 การตรวจสอบ Signature ของ BentoWeb Webhook ด้วย HMAC-SHA256 เมื่อคุณรับ Webhook จาก BentoWeb ระบบจะส่งข้อมูลมาพร้อมกับ Signature เพื่อให้คุณสามารถตรวจสอบความถูกต้องของข้อมูล และป้องกันการปลอมแปลงได้ 📬 ข้อมูลที่คุณจะได้รับจาก Webhook Body: JSON Payload Header: Authorization: Signature สำหรับตรวจสอบ 🔑 หลักการสร้าง Signature Signature ถูกสร้างจาก: โดย clientid คือรหัสประจำระบบของคุณ jsonผู้อ่านไม่กี่คนวิธีปรับสถานะ payment ของ order ที่เป็นการโอนเงิน (transfer)
กรณีที่ลูกค้าไม่ได้อัพโหลดสลิปหรือแจ้งการโอนเงินเข้ามา จะมีขั้นตอนตามนี้นะครับ กรณีที่ payment เป็น transfer ต้องมีรายชื่อธนาคารในร้านเราก่อน ให้ดึงได้ที่ https://open-api.bentoweb.com/bentoweb-api-prod//Banks/getbankstoresstoreid ต้องมี list id ธนาคาร ดึงได้ที่ https://open-api.bentoweb.com/bentoweb-api-prod//Banks/getbank ให้เราทำการแนบสลิปโดยใช้ endpoint นี้ https://open-api.bentoweb.com/bentoweb-order-prod//Order/postordersubmitattachtransferslip โดยใส่ข้อมูลให้ครบผู้อ่านไม่กี่คนคู่มือการใช้งาน 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/ productvariantid โครงสร้างข้อมูล (JSON Structure) ในการส่งข้อมูล ให้เพิ่ม Field wholesalerange และ maxwholesalerangeprice เข้าไปใน Payload: JSONผู้อ่านไม่กี่คนPHP Example การดึงข้อมูล Product List [Get method]
การดึงข้อมูลรายการสินค้า (Get Product List) 1. PHP Request Code PHPผู้อ่านไม่กี่คนPHP Example การขอ access token เพื่อใช้ยิง API
การเชื่อมต่อ BentoWeb API (OAuth 2.0) ตัวอย่าง PHP Code สำหรับการขอ Access Token เพื่อเริ่มใช้งาน API 1. การขอ Access Token (Authentication) PHPเป็นที่นิยมวิธีการทดสอบยิงโดยใช้ Swagger
วิธีการทดสอบยิงโดยใช้ Swagger คลิกปุ่ม Authorize username คือ อีเมล์ที่ใช้ login เข้าระบบหลังบ้าน password คือ รหัสผ่านที่ใช้ login เข้าระบบหลังบ้าน clientid คือ หมายเลข Client ในการเชื่อมต่อ API ที่ได้รับมา clientsecret คือ รหัสของ Client ที่ได้รับมาผู้อ่านบางคน