> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.bentoweb.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# การแจ้งจัดส่ง Shopee โดยรูปแบบ Pickup/Dropoff


1. ข้อมูลที่ต้องใช้สำหรับการแจ้งจัดส่ง ดูได้ใน 
[GET /order/order-full/{order_id}](https://app.swaggerhub.com/apis/SemanticTouch/BentoWebOrderAPI/1.0.0-oas3#/Order/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

* ใช้สำหรับดึงค่าที่อยู่ที่ตั้งค่าเป็น Pickup Address ของร้านค้า

## 2. วิธีการแจ้งจัดส่ง

### 2.1 Endpoint สำหรับ Save Shipping

```
POST https://order.bentoweb.com/api/order/save-shipping
```

### 2.2.1 Parameter ที่ต้องใช้ (Pickup)

```
{
  "shipping_datetime": "2024-04-01 18:00:00",
  "shipping_method": "{shippingKey}",
  "order_id": "{orderId}",
  "store_id": "{storeId}",
  "shipping_type": "pickup",
  "address_id": "{addressId}"
}
```

### 2.2.2 Parameter ที่ต้องใช้ (Drop-off)

```
{
  "shipping_datetime": "2024-04-01 18:00:00",
  "shipping_method": "{shippingKey}",
  "order_id": "{orderId}",
  "store_id": "{storeId}",
  "shipping_type": "dropoff"
```

### 2.3 คำอธิบาย Parameter

* `shipping_datetime`: วันที่และเวลาที่กำหนดให้จัดส่ง
    
* `shipping_method`: คีย์ของช่องทางการขนส่ง (ใช้ค่าจาก `orderfull` ใน key `shipping_method` เช่น `sstp:{ตัวเลข}`)
    
* `order_id`: รหัสคำสั่งซื้อ
    
* `store_id`: รหัสร้านค้า
    
* `shipping_type`: ต้องระบุเป็น `pickup` สำหรับการรับสินค้าแบบ Pickup
    
* `address_id`: รหัสที่อยู่สำหรับการรับสินค้า
    
* `pickup_time_id` (ถ้ามี): รหัสเวลารับสินค้า หากไม่ระบุ ระบบจะเลือกเวลาที่เร็วที่สุด

## 3. หมายเหตุ

* หาก `pickup_time_id` ไม่ถูกระบุ ระบบจะเลือกเวลารับสินค้าที่เร็วที่สุดโดยอัตโนมัติ
    
* `shipping_method` ต้องใช้ค่าจากข้อมูล `orderfull` เพื่อให้ตรงกับการขนส่งของ Shopee
    
* `address_id` ควรใช้ค่าจาก `shopee_address_select` เพื่อให้แน่ใจว่าเป็นที่อยู่ที่ถูกต้อง
    
* ข้อมูลในข้อ 1.1 และ 1.2 จะแสดงได้ ต่อเมื่อต้องเป็นออเดอร์ที่ยังไม่ได้แจ้งจัดส่ง และไม่ใช่ Seller Owned Fleet (จัดส่งโดยขนส่งตัวเอง)

ตัวอย่าง JSON ใน Order Full

```
{
  "status": 1,
  "data": {
    "order": {
      "order_id": 987654321,
      "shipping_method": "sstp:123456",
      ...
      "order_shopee": [
        {
          "id": 1144029,
          ...
        }
      ],
      "is_sof": false,
      "shopee_shipping": {
        "info_needed": {
          "dropoff": [],
          "pickup": [
            "address_id",
            "pickup_time_id"
          ]
        },
        "dropoff": [],
        "pickup": {
          "address_list": [
            {
              "address_id": 123456789,
              "region": "TH",
              "...
              "address_flag": [
                {
                  "flag": "default",
                  "color": "badge-info"
                },
                {
                  "flag": "pickup",
                  "color": "badge-danger"
                }
              ],
              "time_slot_list": [
                {
                  "date": 1743152400,
                  "pickup_time_id": "1743152400",
                  "date_string": "Fri 28-03-2025 16:00"
                }
              ]
            },
            {
              "address_id": 321654987,
              "region": "TH",
              ...
              "address_flag": [
                {
                  "flag": "return",
                  "color": "badge-warning"
                }
              ],
              "time_slot_list": [
                {
                  "date": 1743152400,
                  "pickup_time_id": "1743152400",
                  "date_string": "Fri 28-03-2025 16:00"
                }
              ]
            }
          ]
        },
        "dropoff_info_need": []
      },
      "shopee_address_select": 123456789,
      ...
    }
  }
}
```