stockin.data.process

1. Thong tin co ban

Muc	Mo ta
Ten API tieng Trung	Hoan nguyen nhap kho hoan thanh lenh san xuat (Huy nhap kho)
Ten API tieng Anh	Work Order Stock-In Data Process (Cancel)
CROSS API Code	`stockin.data.process`
Dich vu ESB tuong ung	`/cancelStockIn` (chung) hoac `/outsourcingProcess` (TRANSORDERTYPE=59)
Huong goi	MES → ERP
Thoi diem goi	1. Khi MES thuc hien huy xuat tram 2. Khi can tra ve lam lai do loi chat luong
Dieu kien kich hoat	TL011/TL012 khong rong
Tinh huong nghiep vu chinh	Huy thao tac nhap kho da hoan thanh, ERP can hoan nguyen giam tru ton kho va huy chung tu nhap kho goc
Dinh dang Request	JSON (Content-Type: application/json)
Dong bo/Bat dong bo	Goi dong bo
Kiem soat giao dich	Can thiet
Ghi chu	Truoc khi huy can kiem tra TL011/TL012 co gia tri khong, co gia tri moi goi ERP

Phan loai huy

TRANSORDERTYPE	Dich vu ESB	Mo ta
59	outsourcingProcess	Huy phieu nhap hang gia cong
Khac	cancelStockIn	Huy phieu nhap kho chung

Tham so source_type (danh rieng cho gia cong ngoai)

source_type	Mo ta	Tinh huong su dung
0	Hoan nguyen xuat hang	Huy xuat tram (gui gia cong)
1	Hoan nguyen nhan hang	Huy vao tram (nhan gia cong)
2	Hoan nguyen tra hang	Huy tra hang

2. Quy trinh nghiep vu

Tuong ung ma nguon

Phan loai huy: GeneralUpdater.java:1571-1605
Kiem tra TL011/TL012: GeneralUpdater.java:1571
Phan loai TRANSORDERTYPE: GeneralUpdater.java:1577

API lien quan
Huy phieu nhap kho va tao phieu nhap kho (stockin.data.create) duoc su dung di kem.
Khi huy can su dung TB001/TB002 ma ERP tra ve sau khi tao thanh cong (luu trong TL011/TL012).

3. Quy cach Request

Dinh dang truyen tai: JSON
Content-Type: application/json

3.1 Huy phieu nhap kho chung (cancelStockIn)

Truong	Kieu	Bat buoc	Mo ta	Nguon MES
companyID	string	Y	Ma cong ty	COMPANYID
userId	string	Y	Nguoi thao tac	Nguoi dang nhap hien tai
stock_in_no	string	Y	So phieu nhap kho (loai-so)	TL011 + "-" + TL012

3.2 Huy phieu nhap hang gia cong (outsourcingProcess)

Truong	Kieu	Bat buoc	Mo ta	Nguon MES
companyID	string	Y	Ma cong ty	COMPANYID
userId	string	Y	Nguoi thao tac	Nguoi dang nhap hien tai
outsource_no	string	Y	So don gia cong (loai-so)	TL011 + "-" + TL012
source_type	string	Y	Loai hoan nguyen (0/1/2)	"0" (Hoan nguyen xuat hang)

Giai thich nguon truong

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

TL011/TL012 duoc ghi vao tu TB001/TB002 ma ERP tra ve sau khi stockin.data.create thanh cong.

4. Quy cach Response

Truong	Kieu	Mo ta
code	int	200=Thanh cong, khac=That bai
msg	string	Thong bao ket qua xu ly

Hanh vi khi thanh cong

Phieu nhap kho ERP bi vo hieu/hoan nguyen
Hoan nguyen so luong ton kho (giam ton thanh pham)
Huy ban ghi xuat tram MES

5. Quy tac kiem tra

#	Muc kiem tra	Quy tac	Vi tri chuong trinh
1	TL011 khong rong	Phai co loai ERP	GeneralUpdater.java:1571
2	TL012 khong rong	Phai co so ERP	GeneralUpdater.java:1571
3	Ket noi ERP	SFTConfig.isHasERP() = true	GeneralUpdater.java:1575
4	Phan loai TRANSORDERTYPE	59=outsourcingProcess, khac=cancelStockIn	GeneralUpdater.java:1582
5	Chung tu goc ton tai	Chung tu phia ERP phai ton tai	Kiem tra phia ERP
6	Trang thai chung tu cho phep huy	Chua hach toan moi co the hoan nguyen	Kiem tra phia ERP

Quan trong: Khi TL011/TL012 rong se khong goi ERP
Trong logic chuong trinh, chi khi ca TL011 va TL012 deu khong rong moi goi API huy.
Neu rong, hanh dong huy xuat tram chi thuc hien o phia MES, phia ERP khong bi anh huong.

6. Ma loi

Ma	Thong bao	Mo ta
E101	Phieu nhap kho khong ton tai	Chung tu tuong ung stock_in_no khong ton tai
E102	Phieu nhap kho da hach toan	Phieu nhap kho da hoan thanh hach toan, khong the hoan nguyen
E103	Phieu nhap kho da duoc su dung	Co don ban hang hoac don dieu chuyen tiep theo
E104	Ton kho khong du	Sau khi huy ton kho se am
E999	Loi he thong	Timeout, loi ket noi

7. Vi du JSON

Request - Huy phieu nhap kho chung

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

Request - Huy phieu nhap hang gia cong

{
  "companyID": "COMP01",
  "userId": "EMP001",
  "outsource_no": "5902-20260319001",
  "source_type": "0"   // 0=Hoan nguyen xuat hang
}

Response (Thanh cong)

{
  "code": 200,
  "msg": "Huy phieu nhap kho thanh cong"
}

Response (That bai)

{
  "code": 500,
  "msg": "Phieu nhap kho da hach toan, khong the huy"
}

8. Giai thich rui ro Race Condition

Van de da biet: TL011/TL012 rong khi huy xuat tram

Khi nguoi dung huy xuat tram truoc khi ERP tra ve, do TL011/TL012 chua duoc ghi lai, API huy se khong duoc goi.
Dieu nay dan den du lieu MES va ERP khong nhat quan.

Vi du dong thoi gian

Nguyen nhan van de

// GeneralUpdater.java:1571
if(!SftTransorderLine.getTl011().equals("") && !SftTransorderLine.getTl012().equals("")){
    // Chi khi TL011/TL012 khong rong moi goi API huy
    // Neu huy truoc khi ERP tra ve, if nay la false, bo qua goi ERP
}

De xuat xu ly

Phuong an	Mo ta	Anh huong
Xu ly ngay	Vo hieu phieu nhap kho do tren ERP thu cong	Can can thiep thu cong
Co che cho	Cho ERP tra ve hoan thanh khi huy xuat tram	Can sua chuong trinh
Co che khoa	Cam thao tac huy khi dang xuat tram	Can sua chuong trinh
So sanh dinh ky	Len lich so sanh trang thai chung tu MES va ERP	Can them chuc nang moi

Hoan nguyen nhap kho hoan thanh lenh san xuat (Huy)