stockin.data.process

1. ข้อมูลพื้นฐาน

รายการ	คำอธิบาย
ชื่อ API ภาษาไทย	คืนค่าการรับเข้าคลังสินค้าสำเร็จรูป (ยกเลิกการรับเข้าคลัง)
ชื่อ API ภาษาอังกฤษ	Work Order Stock-In Data Process (Cancel)
รหัส CROSS API	`stockin.data.process`
บริการ ESB ที่เกี่ยวข้อง	`/cancelStockIn` (ทั่วไป) หรือ `/outsourcingProcess` (TRANSORDERTYPE=59)
ทิศทางการเรียก	MES → ERP
เวลาที่เรียก	1. เมื่อ MES ยกเลิกการออกจากสถานี 2. เมื่อมีปัญหาคุณภาพต้องส่งกลับไปทำใหม่
เงื่อนไขทริกเกอร์	TL011/TL012 ไม่ว่าง
สถานการณ์ทางธุรกิจหลัก	ยกเลิกการรับเข้าคลังที่เสร็จสิ้นแล้ว ERP ต้องคืนค่าการหักสต็อกและยกเลิกเอกสารรับเข้าคลังเดิม
รูปแบบ Request	JSON (Content-Type: application/json)
ซิงโครนัส/อะซิงโครนัส	เรียกแบบซิงโครนัส
การควบคุมธุรกรรม	ต้องการ
หมายเหตุ	ก่อนยกเลิกต้องตรวจสอบว่า TL011/TL012 มีค่าหรือไม่ ถ้ามีค่าถึงจะเรียก ERP

การตัดสินประเภทการยกเลิก

TRANSORDERTYPE	บริการ ESB	คำอธิบาย
59	outsourcingProcess	ยกเลิกใบรับสินค้าจ้างผลิต
อื่นๆ	cancelStockIn	ยกเลิกใบรับเข้าคลังทั่วไป

พารามิเตอร์ source_type (สำหรับจ้างผลิตเท่านั้น)

source_type	คำอธิบาย	สถานการณ์ใช้งาน
0	คืนค่าการส่งออก	ยกเลิกการออกจากสถานี (ส่งออกจ้างผลิต)
1	คืนค่าการรับกลับ	ยกเลิกการเข้าสถานี (รับกลับจ้างผลิต)
2	คืนค่าการคืนสินค้า	ยกเลิกการคืนสินค้า

2. กระบวนการทางธุรกิจ

ตำแหน่งโค้ด

การตัดสินยกเลิก: GeneralUpdater.java:1571-1605
ตรวจสอบ TL011/TL012: GeneralUpdater.java:1571
ตัดสิน TRANSORDERTYPE: GeneralUpdater.java:1577

API ที่เกี่ยวข้อง
การยกเลิกใบรับเข้าคลังใช้คู่กับการสร้างใบรับเข้าคลัง (stockin.data.create)
เมื่อยกเลิกต้องใช้ TB001/TB002 ที่ ERP ส่งกลับมาหลังจากสร้างสำเร็จ (เก็บใน TL011/TL012)

3. ข้อกำหนด Request

รูปแบบการส่ง: JSON
Content-Type: application/json

3.1 ยกเลิกใบรับเข้าคลังทั่วไป (cancelStockIn)

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย	แหล่งข้อมูล MES
companyID	string	Y	รหัสบริษัท	COMPANYID
userId	string	Y	ผู้ดำเนินการ	ผู้ล็อกอินปัจจุบัน
stock_in_no	string	Y	เลขที่ใบรับเข้าคลัง (ประเภท-เลขที่)	TL011 + "-" + TL012

3.2 ยกเลิกใบรับสินค้าจ้างผลิต (outsourcingProcess)

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย	แหล่งข้อมูล MES
companyID	string	Y	รหัสบริษัท	COMPANYID
userId	string	Y	ผู้ดำเนินการ	ผู้ล็อกอินปัจจุบัน
outsource_no	string	Y	เลขที่ใบจ้างผลิต (ประเภท-เลขที่)	TL011 + "-" + TL012
source_type	string	Y	ประเภทการคืนค่า (0/1/2)	"0" (คืนค่าการส่งออก)

คำอธิบายแหล่งที่มาของฟิลด์

stock_in_no / outsource_no = SFT_TRANSORDER_LINE.TL011 + "-" + SFT_TRANSORDER_LINE.TL012

TL011/TL012 ถูกเขียนจาก TB001/TB002 ที่ ERP ส่งกลับมาหลังจาก stockin.data.create สำเร็จ

4. ข้อกำหนด Response

ฟิลด์	ประเภท	คำอธิบาย
code	int	200=สำเร็จ, อื่นๆ=ล้มเหลว
msg	string	ข้อความผลการประมวลผล

พฤติกรรมเมื่อสำเร็จ

ยกเลิก/คืนค่าใบรับเข้าคลัง ERP
คืนค่าจำนวนสต็อก (หักสต็อกสินค้าสำเร็จรูป)
ยกเลิกบันทึกการออกจากสถานี MES

5. กฎการตรวจสอบ

#	รายการตรวจสอบ	กฎ	ตำแหน่งโปรแกรม
1	TL011 ไม่ว่าง	ต้องมีประเภทเอกสาร ERP	GeneralUpdater.java:1571
2	TL012 ไม่ว่าง	ต้องมีเลขที่เอกสาร ERP	GeneralUpdater.java:1571
3	การเชื่อมต่อ ERP	SFTConfig.isHasERP() = true	GeneralUpdater.java:1575
4	ตัดสิน TRANSORDERTYPE	59=outsourcingProcess, อื่นๆ=cancelStockIn	GeneralUpdater.java:1582
5	เอกสารต้นฉบับมีอยู่	เอกสารฝั่ง ERP ต้องมีอยู่	ตรวจสอบฝั่ง ERP
6	สถานะเอกสารอนุญาตให้ยกเลิก	ยังไม่ผ่านรายการถึงจะคืนค่าได้	ตรวจสอบฝั่ง ERP

สำคัญ: เมื่อ TL011/TL012 ว่างจะไม่เรียก ERP
ในลอจิกโปรแกรม จะเรียก API ยกเลิกก็ต่อเมื่อ TL011 และ TL012 ทั้งคู่ไม่ว่างเท่านั้น
ถ้าว่าง การยกเลิกออกจากสถานีจะดำเนินการเฉพาะฝั่ง MES ฝั่ง ERP ไม่ได้รับผลกระทบ

6. รหัสข้อผิดพลาด

รหัส	ข้อความ	คำอธิบาย
E101	ไม่มีใบรับเข้าคลัง	ไม่พบเอกสารที่ตรงกับ stock_in_no
E102	ใบรับเข้าคลังผ่านรายการแล้ว	ใบรับเข้าคลังผ่านรายการแล้ว ไม่สามารถคืนค่าได้
E103	ใบรับเข้าคลังถูกอ้างอิงแล้ว	มีใบขายหรือใบโอนที่ตามมา
E104	สต็อกไม่เพียงพอ	สต็อกจะติดลบหลังยกเลิก
E999	ข้อผิดพลาดของระบบ	Timeout, การเชื่อมต่อผิดปกติ

7. ตัวอย่าง JSON

Request - ยกเลิกใบรับเข้าคลังทั่วไป

{
  "companyID": "COMP01",
  "userId": "EMP001",
  "stock_in_no": "5101-20260319001"
}

Request - ยกเลิกใบรับสินค้าจ้างผลิต

{
  "companyID": "COMP01",
  "userId": "EMP001",
  "outsource_no": "5902-20260319001",
  "source_type": "0"   // 0=คืนค่าการส่งออก
}

Response (สำเร็จ)

{
  "code": 200,
  "msg": "ยกเลิกใบรับเข้าคลังสำเร็จ"
}

Response (ล้มเหลว)

{
  "code": 500,
  "msg": "ใบรับเข้าคลังผ่านรายการแล้ว ไม่สามารถยกเลิกได้"
}

8. คำอธิบายความเสี่ยง Race Condition

ปัญหาที่ทราบ: TL011/TL012 ว่างเมื่อยกเลิกออกจากสถานี

เมื่อผู้ใช้ยกเลิกออกจากสถานีก่อนที่ ERP จะตอบกลับ เนื่องจาก TL011/TL012 ยังไม่ถูกเขียนกลับ API ยกเลิกจะไม่ถูกเรียก
สิ่งนี้จะทำให้ข้อมูล MES และ ERP ไม่สอดคล้องกัน

ตัวอย่างไทม์ไลน์

สาเหตุของปัญหา

// GeneralUpdater.java:1571
if(!SftTransorderLine.getTl011().equals("") && !SftTransorderLine.getTl012().equals("")){
    // จะเรียก API ยกเลิกก็ต่อเมื่อ TL011/TL012 ไม่ว่างเท่านั้น
    // ถ้ายกเลิกก่อน ERP ตอบกลับ if นี้จะเป็น false ข้ามการเรียก ERP
}

คำแนะนำในการจัดการ

วิธีการ	คำอธิบาย	ผลกระทบ
จัดการทันที	ยกเลิกใบรับเข้าคลังนั้นที่ ERP ด้วยตนเอง	ต้องมีคนดำเนินการ
กลไกรอ	รอ ERP ตอบกลับเสร็จก่อนอนุญาตให้ยกเลิก	ต้องแก้ไขโปรแกรม
กลไก Lock	ห้ามยกเลิกขณะออกจากสถานีกำลังดำเนินการ	ต้องแก้ไขโปรแกรม
เปรียบเทียบเป็นระยะ	ตารางเวลาเปรียบเทียบสถานะเอกสาร MES และ ERP	ต้องเพิ่มฟีเจอร์ใหม่

กรณีศึกษาอ้างอิง
ดูรายละเอียดใน CLAUDE.md บันทึกวันที่ 2026-03-12 "การวิเคราะห์ปัญหา outsourcingProcess ไม่ถูกเรียกเมื่อยกเลิกออกจากสถานี 0000675600"

คืนค่าการรับเข้าคลังสินค้าสำเร็จรูป (ยกเลิก)