[Important] Shopee will launch the Seller Advance Shipping in Thailand

Dear Developers,

Shopee will launch the Seller Advance Shipping (Advance Fulfillment) program in Thailand.

This program supports sellers to ship out parcels in advance to Shopee designated, and the system will prioritize using those advance stock to fulfill directly when buyers place orders to achieve shorter delivery time.

Shopee Article: https://seller.shopee.co.th/edu/article/26486

Rollout Schedule:

• Jan 12: Initial launch to some selected* sellers who are currently not using OpenAPI
• Feb 1: Onwards to all selected* sellers

*This is an exclusive opportunity for selected sellers invited by their Shopee KAM or notified through our official email and app channels

The specific updates are:

On seller center, there are 2 new fulfillment types: 1) Advance bookings, which are generated by Shopee system automatically, and require sellers to prepare and ship out those parcels per normal orders to Shopee designated address; 2) Advance orders, which are matched automatically with the ready advance stock, such stock will be delivered to buyer directly, and do not require sellers to ship out again.

1. New API Integration

Advance bookings have a new set of API, while parameters are similar to existing order APIs.

Use following APIs to retrieve booking list & details, support sellers to arrange shipment, track parcel status and booking match status.

Bookings have 2 important status fields, booking_status and match_status, and definition is listed below:

2. New Field Integration

1. v2.order.get_order_detail API has 2 new fields, advance_package and booking_sn, to indicate whether this order is an advance order

When buyer places order, system will immediately know if it is an advance order (advance_package = true/false). If it is true, “Arrange Shipment” button on the seller center will be greyed out to disable sellers from arranging shipment/printing AWB.

Once the system matches a particular booking to this order (usually 15 mins later), this order status will be updated to “shipped“ automatically and receives the corresponding booking_sn.

Note: Before shipment is auto arranged and receives a corresponding booking_sn, it is possible that an advance order is changed back to a normal order, and requires sellers to ship out directly (The deducted sellable_advance_stock will be released and the seller_stock will be deducted). In very rare cases, a normal order can be changed to an advance order, it usually happens within 1s after buyer places an order and is caused by system lagging, however in such situation, while advance_package = false, system will return error if ship_booking API is trigger to avoid double shipment issue; the order will be confirmed as Advance order only after the system returns the booking_sn. After that, the advance_package field and booking_sn will not be changed, the order status will be shipped.

2. v2.order.get_order_list API has a new booking_sn field, to return the corresponding advance booking_sn of an advance order

3. v2.product.get_item_base_info and v2.product.get_model_list APIs have 2 new fields, sellable_advance_stock and in_transit_advance_stock

- sellable_advance_stock refers to Advance Fulfillment stock that Seller has shipped out and is available to be used to fulfill an order

- in_transit_advance_stock refers to Advance Fulfillment stock that seller has arranged shipment or has shipped out, and is still in transit and unavailable to be used to fulfill an order

Note: Both fields are read-only, auto updated based on parcel status (e.g. shipped); seller should still use actual on-hand stock when updating seller stock, no manual logic adjustment is required

เรียน นักพัฒนา (TH Developers)

Shopee มีความยินดีที่จะประกาศเปิดตัวโปรแกรม Seller Advance Shipping ในประเทศไทย ซึ่งเป็นโปรแกรมที่สนับสนุนให้ผู้ขายสามารถส่งพัสดุออกไปล่วงหน้ายังจุดที่ Shopee กำหนด โดยระบบจะจัดลำดับความสำคัญในการใช้สต็อกล่วงหน้านี้เพื่อจัดส่งให้ผู้ซื้อโดยตรงทันทีที่มีคำสั่งซื้อ เพื่อเป้าหมายในการลดระยะเวลาการจัดส่งสินค้าให้สั้นลงและเพิ่มความพึงพอใจแก่ผู้ซื้อ

รายละเอียดเพิ่มเติม (Shopee Article): https://seller.shopee.co.th/edu/article/26486

กำหนดการเริ่มใช้งาน (Rollout Dates):

• 12 มกราคม: เริ่มเปิดใช้งานช่วงแรกสำหรับผู้ขายบางกลุ่มที่ได้รับเลือก* ซึ่งปัจจุบันยังไม่ได้ใช้งาน OpenAPI
• 1 กุมภาพันธ์ เป็นต้นไป: เปิดใช้งานสำหรับผู้ขายที่ได้รับเลือกทั้งหมด

*หมายเหตุ : เงื่อนไขการเข้าร่วม: โปรแกรมนี้เป็นสิทธิพิเศษ เฉพาะผู้ขายที่ได้รับคำเชิญจาก Shopee KAM หรือได้รับแจ้งเตือนผ่านช่องทางอีเมลและแอปพลิเคชันอย่างเป็นทางการเท่านั้น

รายละเอียดการอัปเดตมีดังนี้: บน Seller Center จะมีประเภทการจัดการคำสั่งซื้อ (Fulfillment types) ใหม่ 2 ประเภท:

1.Advance bookings: สร้างโดยระบบ Shopee อัตโนมัติ ผู้ขายต้องเตรียมพัสดุและจัดส่งไปยังที่อยู่ที่ Shopee กำหนด (ดำเนินการเหมือนออเดอร์ปกติ)

2.Advance orders: คำสั่งซื้อที่ระบบจับคู่กับสต็อกล่วงหน้าที่ส่งไปแล้วโดยอัตโนมัติ สินค้าจะถูกจัดส่งถึงผู้ซื้อโดยตรง โดยที่ผู้ขายไม่ต้องดำเนินการจัดส่งซ้ำ (รายละเอียดเพิ่มเติม)

หมายเหตุสำหรับการนำไปใช้:

• Advance bookings: คือขาที่ผู้ขาย "ส่งของไปเติม" ที่คลัง/จุดพักของ Shopee
• Advance orders: คือขาที่ "ลูกค้าสั่งซื้อ" แล้วระบบดึงของที่ส่งไปรอไว้แล้วมาส่งให้ลูกค้าทันที

1. การเชื่อมต่อ API ใหม่ (New API Integration)

Advance bookings จะมีชุด API ใหม่ ซึ่งมี Parameter คล้ายคลึงกับ API ของคำสั่งซื้อที่มีอยู่เดิม โดยสามารถใช้ API ต่อไปนี้ในการดึงรายการ/รายละเอียด, จัดเตรียมการส่ง, ติดตามสถานะพัสดุ และสถานะการจับคู่ (Match status):

Booking จะมีฟิลด์สถานะที่สำคัญ 2 ฟิลด์ ได้แก่ booking_status และ match_status โดยมีคำจำกัดความดังต่อไปนี้:

2. การเชื่อมต่อฟิลด์ใหม่ (New Field Integration)

1. API v2.order.get_order_detail มีการเพิ่มฟิลด์ใหม่ 2 ฟิลด์ คือ advance_package และ booking_sn เพื่อระบุว่าคำสั่งซื้อนั้นเป็น "คำสั่งซื้อล่วงหน้า" หรือไม่

• การตรวจสอบสถานะ: เมื่อมีการสั่งซื้อเข้ามา ระบบจะระบุทันทีว่าเป็นคำสั่งซื้อล่วงหน้าหรือไม่ผ่านฟิลด์ advance_package (true = เป็น / false = ไม่เป็น)
• การควบคุมบนหน้าจอ: หากเป็นคำสั่งซื้อล่วงหน้า (advance_package = true) ปุ่ม "Arrange Shipment" (จัดเตรียมพัสดุ) บน Seller Center จะกลายเป็นสีเทา เพื่อป้องกันไม่ให้ผู้ขายกดจัดส่งเองหรือพิมพ์ใบปะหน้าพัสดุ (AWB) ซ้ำซ้อน
• การอัปเดตอัตโนมัติ: เมื่อระบบจับคู่รายการจอง (Booking) เข้ากับคำสั่งซื้อนั้นสำเร็จ (โดยปกติจะใช้เวลาประมาณ 15 นาที) สถานะคำสั่งซื้อจะเปลี่ยนเป็น "Shipped" (ส่งแล้ว) โดยอัตโนมัติ และจะได้รับหมายเลข booking_sn เพื่อใช้อ้างอิง

หมายเหตุสำคัญ (Note):

• กรณีเปลี่ยนจากคำสั่งซื้อล่วงหน้าเป็นปกติ: ก่อนที่ระบบจะจัดส่งอัตโนมัติและออกหมายเลข booking_sn มีโอกาสที่คำสั่งซื้อล่วงหน้าจะ "ถูกเปลี่ยนกลับ" เป็นคำสั่งซื้อปกติ ซึ่งกรณีนี้ ผู้ขายต้องเป็นคนจัดส่งเองโดยตรง (ระบบจะคืนสต็อก sellable_advance_stock และไปหักสต็อกปกติของร้านค้าแทน)

• กรณีคำสั่งซื้อปกติเปลี่ยนเป็นล่วงหน้า (พบน้อยมาก): อาจเกิดขึ้นภายใน 1 วินาทีหลังสั่งซื้อเนื่องจากความล่าช้าของระบบ (System lagging) ในกรณีนี้แม้ค่า advance_package จะแสดงเป็น false แต่หากผู้ขายเรียกใช้ API ship_order ระบบจะส่งค่า Error กลับมาเพื่อป้องกันการจัดส่งซ้ำซ้อน

• การยืนยันสถานะสุดท้าย: คำสั่งซื้อจะถือว่าเป็นคำสั่งซื้อล่วงหน้า (Advance Order) โดยสมบูรณ์ก็ต่อเมื่อระบบส่งค่า booking_sn กลับมาให้เท่านั้น หลังจากนั้นฟิลด์ advance_package และ booking_sn จะไม่มีการเปลี่ยนแปลงอีก และสถานะจะคงอยู่ที่ "Shipped"

2. API v2.order.get_order_list เพิ่มฟิลด์ใหม่ booking_sn

• เพื่อส่งคืนค่าหมายเลขการจอง (Booking Serial Number) ที่สอดคล้องกับคำสั่งซื้อล่วงหน้า (Advance Order) นั้นๆ

3. API v2.product.get_item_base_info และ v2.product.get_model_list เพิ่มฟิลด์ใหม่ 2 ฟิลด์ เกี่ยวกับสต็อก:

• sellable_advance_stock (สต็อกล่วงหน้าที่พร้อมขาย): หมายถึง สต็อกในโครงการ Advance Fulfillment ที่ผู้ขายส่งออกไปแล้ว และพร้อมที่จะถูกนำไปใช้จัดการคำสั่งซื้อของลูกค้าได้ทันที
• in_transit_advance_stock (สต็อกล่วงหน้าที่อยู่ระหว่างขนส่ง): หมายถึง สต็อกที่ผู้ขายกดจัดการส่งออกไปแล้ว หรือกำลังอยู่ระหว่างการขนส่งไปยังจุดหมาย แต่ยังไม่พร้อมที่จะถูกนำไปใช้จัดการคำสั่งซื้อ

หมายเหตุ: * ทั้งสองฟิลด์นี้เป็นแบบ อ่านอย่างเดียว (Read-only) โดยระบบจะอัปเดตค่าให้อัตโนมัติตามสถานะพัสดุ (เช่น เมื่อมีการกดส่งของ)

ผู้ขายยังคงต้องใช้ สต็อกจริงที่อยู่ที่ร้าน (On-hand stock) ในการอัปเดตสต็อกของผู้ขาย (seller_stock) ตามปกติ โดยไม่จำเป็นต้องปรับเปลี่ยนตรรกะ (logic) การจัดการสต็อกด้วยตนเองแต่อย่างใด