> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.boxhero.io/docs/documentation/th/integrations/webhook.md). # เว็บฮุก

*** ## การลงทะเบียน คุณสามารถลงทะเบียน webhook ได้ที่ **`การตั้งค่า`** **>** **`การเชื่อมต่อและ API`** ในทีม BoxHero ของคุณ

## พฤติกรรมการส่งมอบและการลองใหม่ เมื่อเกิดอีเวนต์ BoxHero จะส่งคำขอ HTTP `POST` ไปยังปลายทาง webhook ที่คุณลงทะเบียนไว้ เนื้อหาของคำขอจะมีเพย์โหลด JSON ที่อธิบายอีเวนต์นั้น * หากเซิร์ฟเวอร์ของคุณตอบกลับด้วย **HTTP 200 OK**อีเวนต์นั้นจะถือว่าส่งมอบสำเร็จ * หากเซิร์ฟเวอร์ของคุณตอบกลับด้วย **รหัสสถานะที่ไม่ใช่ 200 ใดๆ**BoxHero จะถือว่าเป็นความล้มเหลวชั่วคราวและจะลองส่งใหม่สูงสุด 3 ครั้ง ## โครงสร้างเพย์โหลดของ Webhook อีเวนต์ webhook ทั้งหมดจะถูกส่งด้วยโครงสร้าง JSON ต่อไปนี้ในเนื้อหาของคำขอ: ```json { "id": "1234", // รหัสเฉพาะของอีเวนต์ "topic": "txs/new", // หัวข้ออีเวนต์ "version": 1, // เวอร์ชันสคีมาของเพย์โหลด "payload": { // ข้อมูลเฉพาะของอีเวนต์ ... }, "created_time": "2025-08-06T09:20:48.623Z" // เวลาที่เกิดอีเวนต์ (ISO 8601) } ``` *** ## ลำดับของอีเวนต์ BoxHero **ไม่** รับประกันลำดับการส่งมอบอีเวนต์ ตัวอย่างเช่น อีเวนต์ `item/new` อาจมาถึงหลังอีเวนต์ `item/delete` สำหรับสินค้าเดียวกัน ฟิลด์ `created_time` ในเพย์โหลดอีเวนต์จะแสดงเวลาที่เกิดอีเวนต์จริง ให้ implement ตรรกะแบบ idempotent และทนต่อการสลับลำดับในตัวจัดการ webhook ของคุณเพื่อจัดการอีเวนต์ได้อย่างเชื่อถือ ## หัวข้ออีเวนต์ {% hint style="info" %} หากคุณต้องการการสนับสนุนสำหรับหัวข้ออีเวนต์เพิ่มเติม โปรดติดต่อ [ฝ่ายสนับสนุน](/docs/documentation/th/resources/contact.md). {% endhint %} ### `txs/new` ทริกเกอร์เมื่อเกิดธุรกรรมสินค้าคงคลัง (รับเข้า / จ่ายออก / ปรับสต็อก / ย้ายสต็อก) {% hint style="warning" %} **หมายเหตุ:** อีเวนต์นี้ *ไม่* ถูกทริกเกอร์สำหรับการปรับที่สร้างผ่านการแก้ไขแบบกลุ่มหรือนำเข้า (เช่น เมื่อเพิ่มหรืออัปเดตสินค้าผ่าน Excel) {% endhint %}

ฟิลด์	จำเป็น	คำอธิบาย	จำเป็นหรือไม่	คำอธิบาย	โหมดทีม
id	true	รหัสเฉพาะของธุรกรรม	true	รหัสเฉพาะของประวัติ	ทั้งหมด
type	true	ประเภทของธุรกรรม (in, out, adjust, move)	true	ประเภทของประวัติ รับเข้า : in จ่ายออก : out ปรับ : adjust ย้าย : move	ทั้งหมด
partner	false	คู่ค้า	false
partner.id	false	รหัสเฉพาะของคู่ค้า	false
partner.name	false	ชื่อคู่ค้า	false
partner.deleted	false	ระบุว่าคู่ค้าถูกลบหรือไม่	false
from_location	false	ตำแหน่งต้นทาง	false
from_location.id	false	รหัสเฉพาะของตำแหน่งต้นทาง	false
from_location.name	false	ชื่อตำแหน่งต้นทาง	false
from_location.deleted	false	ระบุว่าตำแหน่งต้นทางถูกลบหรือไม่	false
to_location	true	ตำแหน่งปลายทาง	false
to_location.id	true	รหัสเฉพาะของตำแหน่งปลายทาง	false
to_location.name	true	ชื่อตำแหน่งปลายทาง	false
to_location.deleted	true	ระบุว่าตำแหน่งปลายทางถูกลบหรือไม่	false
items	true	รายการย่อยในธุรกรรม	true	รายการแยกตามสินค้าที่ประกอบเป็นประวัติ	ทุกโหมด
items.id	true	รหัสเฉพาะของสินค้า	true	รหัสเฉพาะของสินค้า	ทุกโหมด
items.name	true	ชื่อสินค้า	true	ชื่อของสินค้า	ทุกโหมด
items.quantity	true	การเปลี่ยนแปลงสินค้าคงคลังจากการรับเข้า/จ่ายออก/ปรับ/ย้ายสต็อก	true	จำนวนการรับเข้า/จ่ายออก/ปรับ/ย้ายของสินค้ารายการนี้	ทุกโหมด
items.deleted	true	ระบุว่าสินค้าถูกลบหรือไม่	true	ระบุว่าสินค้าถูกลบหรือไม่
items.from_location_new_stock_level	false	ระดับสต็อกที่ตำแหน่งต้นทางหลังธุรกรรม	false
items.to_location_new_stock_level	true	ระดับสต็อกที่ตำแหน่งปลายทางหลังธุรกรรม	false
transaction_time	true	เวลาธุรกรรม (เช่น เวลา รับเข้า/จ่ายออก)	false
created_at	true	เวลาที่สร้างธุรกรรม	false
created_by	true	สมาชิกที่สร้างธุรกรรม	false
created_by.id	true	รหัสเฉพาะของสมาชิก	false
created_by.name	true	ชื่อสมาชิก	false
created_by.deleted	true	ระบุว่าสมาชิกถูกลบหรือไม่	false
count_of_items	true	จำนวนสินค้า	false
total_quantity	true	จำนวนการเปลี่ยนแปลงสินค้าคงคลังทั้งหมด	false
url	true	ที่อยู่ URL สำหรับดูหน้ารายละเอียดธุรกรรม	false
บันทึก	false	หมายเหตุที่เกี่ยวข้องกับธุรกรรม	false

#### ตัวอย่างเพย์โหลดของ Webhook – `รับเข้า` อีเวนต์ ```json { "id": 16160911, "type": "in", "to_location": { "id": 52766, "name": "Warehouse 3", "deleted": false }, "items": [ { "id": 14277699, "name": "belif Cleansing Gel Oil Enriched", "quantity": 2, "deleted": false, "to_location_new_stock_level": 3 }, { "id": 14277698, "name": "belif Aqua Bomb Jelly Cleanser", "quantity": 2, "deleted": false, "to_location_new_stock_level": 5 } ], "transaction_time": "2023-04-25T05:42:27.545Z", "created_at": "2023-08-14T05:14:29.499Z", "created_by": { "id": 201345, "name": "corp", "deleted": false }, "count_of_items": 2, "total_quantity": 4, "url": "https://web.boxhero-app.com/team/149058/mode/0#/tx/16160911" } ``` #### ตัวอย่างเพย์โหลดของ Webhook – `ย้ายสต็อก` อีเวนต์

{
  "id": 3692714,
  "type": "move",
  "from_location": {
    "id": 52765,
    "name": "Warehouse 2",
    "deleted": false
  },
  "to_location": {
    "id": 52766,
    "name": "Warehouse 3",
    "deleted": false
  },
  "items": [
    {
      "id": 14873303,
      "name": "Auto liner 3.5mm",
      "quantity": 1,
      "deleted": false,
      "from_location_new_stock_level": -1,
      "to_location_new_stock_level": 1
    }
  ],
  "transaction_time": "2025-04-25T05:42:27.545Z",
  "created_at": "2025-04-25T05:42:27.545Z",
  "created_by": {
    "id": 176829,
    "name": "Tony Lee",
    "deleted": false
  },
  "count_of_items": 1,
  "total_quantity": 1,
  "url": "https://web.boxhero-app.com/team/150581/mode/2#/ltx/3692714"
}

### `txs/edit` ส่งเมื่อมีการแก้ไขธุรกรรมสินค้าคงคลังที่มีอยู่ (รับเข้า / จ่ายออก / ปรับสต็อก / ย้ายสต็อก) **ถูกแก้ไข**.

ฟิลด์	จำเป็น	คำอธิบาย	จำเป็นหรือไม่	คำอธิบาย	โหมดทีม
id	true	รหัสเฉพาะของธุรกรรม	true	รหัสเฉพาะของประวัติ	ทั้งหมด
type	true	ประเภทของธุรกรรม (in, out, adjust, move)	true	ประเภทของประวัติ รับเข้า : in จ่ายออก : out ปรับ : adjust ย้าย : move	ทั้งหมด
partner	false	คู่ค้า	false
partner.id	false	รหัสเฉพาะของคู่ค้า	false
partner.name	false	ชื่อคู่ค้า	false
partner.deleted	false	ระบุว่าคู่ค้าถูกลบหรือไม่	false
from_location	false	ตำแหน่งต้นทาง	false
from_location.id	false	รหัสเฉพาะของตำแหน่งต้นทาง	false
from_location.name	false	ชื่อตำแหน่งต้นทาง	false
from_location.deleted	false	ระบุว่าตำแหน่งต้นทางถูกลบหรือไม่	false
to_location	true	ตำแหน่งปลายทาง	false
to_location.id	true	รหัสเฉพาะของตำแหน่งปลายทาง	false
to_location.name	true	ชื่อตำแหน่งปลายทาง	false
to_location.deleted	true	ระบุว่าตำแหน่งปลายทางถูกลบหรือไม่	false
items	true	รายการย่อยในธุรกรรม	true	รายการแยกตามสินค้าที่ประกอบเป็นประวัติ	ทุกโหมด
items.id	true	รหัสเฉพาะของสินค้า	true	รหัสเฉพาะของสินค้า	ทุกโหมด
items.name	true	ชื่อสินค้า	true	ชื่อของสินค้า	ทุกโหมด
items.quantity	true	การเปลี่ยนแปลงจำนวนจากธุรกรรม (in/out/adjust/move)	true	จำนวนการรับเข้า/จ่ายออก/ปรับ/ย้ายของสินค้ารายการนี้	ทุกโหมด
items.deleted	true	ระบุว่าสินค้าถูกลบหรือไม่	true	ระบุว่าสินค้าถูกลบหรือไม่
items.from_location_new_stock_level	false	ระดับสต็อกที่ตำแหน่งต้นทางหลังธุรกรรม	false
items.to_location_new_stock_level	true	ระดับสต็อกที่ตำแหน่งปลายทางหลังธุรกรรม	false
transaction_time	true	เวลาธุรกรรม (เช่น เวลา รับเข้า/จ่ายออก)	false
created_at	true	เวลาที่สร้างธุรกรรม	false
created_by	true	สมาชิกที่สร้างธุรกรรม	false
created_by.id	true	รหัสเฉพาะของสมาชิก	false
created_by.name	true	ชื่อสมาชิก	false
created_by.deleted	true	ระบุว่าสมาชิกถูกลบหรือไม่	false
count_of_items	true	จำนวนสินค้า	false
total_quantity	true	จำนวนการเปลี่ยนแปลงสินค้าคงคลังทั้งหมด	false
url	true	ที่อยู่ URL สำหรับดูหน้ารายละเอียดธุรกรรม	false
บันทึก	false	หมายเหตุที่เกี่ยวข้องกับธุรกรรม	false
revision	true	หมายเลขเวอร์ชันปัจจุบันของธุรกรรม เริ่มต้นที่ 1	false

#### ตัวอย่างเพย์โหลดของ Webhook – ธุรกรรมที่แก้ไข `รับเข้า` ธุรกรรม ```json { "id": 16160911, "type": "in", "to_location": { "id": 52766, "name": "Warehouse 3", "deleted": false }, "items": [ { "id": 14277699, "name": "belif Cleansing Gel Oil Enriched", "quantity": 2, "deleted": false, "to_location_new_stock_level": 3 }, { "id": 14277698, "name": "belif Aqua Bomb Jelly Cleanser", "quantity": 2, "deleted": false, "to_location_new_stock_level": 5 } ], "transaction_time": "2023-04-25T05:42:27.545Z", "created_at": "2023-08-14T05:14:29.499Z", "created_by": { "id": 201345, "name": "corp", "deleted": false }, "count_of_items": 2, "total_quantity": 4, "url": "https://web.boxhero-app.com/team/149058/mode/0#/tx/16160911" } ``` #### ตัวอย่างเพย์โหลดของ Webhook – ธุรกรรมที่แก้ไข `ย้ายสต็อก` ธุรกรรม ```json { "id": 3692714, "type": "move", "from_location": { "id": 52765, "name": "Warehouse 2", "deleted": false }, "to_location": { "id": 52766, "name": "Warehouse 3", "deleted": false }, "items": [ { "id": 14873303, "name": "Auto liner 3.5mm", "quantity": 1, "deleted": false, "from_location_new_stock_level": -1, "to_location_new_stock_level": 1 } ], "transaction_time": "2023-04-25T05:42:27.545Z", "created_at": "2023-04-25T05:42:27.545Z", "created_by": { "id": 176829, "name": "Joy Kim", "deleted": false }, "count_of_items": 1, "total_quantity": 1, "url": "https://web.boxhero-app.com/team/150581/mode/2#/ltx/3692714" } ``` ### `txs/delete` ส่งเมื่อธุรกรรมสินค้าคงคลัง **ถูกลบ**. | ฟิลด์ | คำอธิบาย | | -------- | ----------------------------------------------- | | id | รหัสเฉพาะของธุรกรรม | | revision | หมายเลขเวอร์ชันปัจจุบันของธุรกรรม เริ่มต้นที่ 1 | #### ตัวอย่างเพย์โหลดของ Webhook – ธุรกรรมที่ถูกลบ ```json /{ "id": 27036740, "revision": 2 } ``` ### `item/new` ส่งเมื่อมีการเพิ่มสินค้าใหม่ในสินค้าคงคลังของทีม {% hint style="warning" %} **หมายเหตุ**: อีเวนต์นี้ *ไม่* จะถูกทริกเกอร์เมื่อใช้ **`เพิ่มตัวแปรสินค้า`** ฟีเจอร์นี้ หรือเมื่อนำเข้าสินค้าผ่าน **`นำเข้า Excel`**. {% endhint %}

ฟิลด์	คำอธิบาย	จำเป็นหรือไม่	คำอธิบาย	โหมดทีม
id	รหัสสินค้า	true	รหัสเฉพาะของประวัติ	ทั้งหมด
name	ชื่อสินค้า	true	ประเภทของประวัติ รับเข้า : in จ่ายออก : out ปรับ : adjust ย้าย : move	ทั้งหมด
sku	SKU	false
barcode	บาร์โค้ด	false
photo_url	URL รูปภาพ	false
cost	ต้นทุน	false
price	ราคา	false
attrs	คุณลักษณะ	false

#### **ตัวอย่างเพย์โหลด – สินค้าที่สร้างแล้ว** ```json { "id": 26122826, "name": "belif Peat Miracle Revital Cream", "sku": "SKU-YH2361KI", "barcode": "2002074321218", "photo_url": "https://d3l9wd8kivvlqy.cloudfront.net/ap-northeast-2/image-up-ap-northeast-2/30b0cc84-601d-493d-87fd-b7e8b5825601", "cost": "50000", "price": "65000", "attrs": [ { "id": 413101, "name": "Category", "type": "text", "value": "Foundation" }, { "id": 459264, "name": "Expiration date", "type": "date", "value": "2027-08-07" }, { "id": 668272, "name": "Safety Stock", "type": "number", "value": 33 } ] } ``` ### `item/edit` ส่งเมื่อมีการแก้ไขสินค้าที่มีอยู่ {% hint style="warning" %} **หมายเหตุ**: อีเวนต์นี้ *ไม่* ถูกทริกเกอร์ *f*หรือการแก้ไขแบบกลุ่มที่ทำผ่าน **`ศูนย์ข้อมูล`**** > ****`สินค้า`** หรือผ่าน **`นำเข้า Excel`** ฟังก์ชัน. {% endhint %}

ฟิลด์	คำอธิบาย	จำเป็นหรือไม่	คำอธิบาย	โหมดทีม
id	รหัสสินค้า	true	รหัสเฉพาะของประวัติ	ทั้งหมด
name	ชื่อสินค้า	true	ประเภทของประวัติ รับเข้า : in จ่ายออก : out ปรับ : adjust ย้าย : move	ทั้งหมด
sku	SKU	false
barcode	บาร์โค้ด	false
photo_url	URL รูปภาพ	false
cost	ต้นทุน	false
price	ราคา	false
attrs	คุณลักษณะ	false

#### **ตัวอย่างเพย์โหลด – สินค้าที่อัปเดตแล้ว** ```json { "id": 26122826, "name": "belif Peat Miracle Revital Cream", "sku": "SKU-YH2361KI", "barcode": "2002074321218", "photo_url": "https://d3l9wd8kivvlqy.cloudfront.net/ap-northeast-2/image-up-ap-northeast-2/30b0cc84-601d-493d-87fd-b7e8b5825601", "cost": "50000", "price": "65000", "attrs": [ { "id": 413101, "name": "Category", "type": "text", "value": "Foundation" }, { "id": 459264, "name": "Expiration date", "type": "date", "value": "2027-08-07" }, { "id": 668272, "name": "Safety Stock", "type": "number", "value": 33 } ] } ``` ### `item/delete` ส่งเมื่อมีการลบสินค้าออกจากสินค้าคงคลังของทีม {% hint style="warning" %} **หมายเหตุ**: อีเวนต์นี้ *ไม่* ถูกทริกเกอร์สำหรับการลบจำนวนมากที่ทำผ่าน **`ศูนย์ข้อมูล`**** > ****`สินค้า`**. {% endhint %}

ฟิลด์	คำอธิบาย	จำเป็นหรือไม่	คำอธิบาย	โหมดทีม
id	รหัสสินค้า	true	รหัสเฉพาะของประวัติ	ทั้งหมด

#### ตัวอย่างเพย์โหลด **– สินค้าที่ถูกลบ** ```json { "id": 26122826 } ```