Vì sao parser EDI có thể đưa cho agent logistics một dòng thời gian sai
Trước khi nối TMS vào agent, cần nắm năm bản tin X12 hay gặp nhất và vì sao segment G62 đổi nghĩa giữa chúng.
Tóm tắt nhanh
- Trong 214, giờ của trạng thái nằm ở AT7. G62 không được dùng để báo giờ đó, còn G62 ở header của 204 lại là hạn chót phải phản hồi.
- 997 chỉ cho biết bản tin qua được kiểm tra kỹ thuật. Tender được nhận hay bị từ chối thì phải xem ở 990.
- Không bao giờ sinh 997 để trả lời một 997. Khi test, phải có ca tender bị từ chối và quay về điều phối.
Thử hình dung tuần đầu bạn làm việc tại một công ty logistics. Khách muốn có một agent trả lời được câu “lô hàng này đang ở đâu, có trễ không”.
Đội IT mở cho bạn một thư mục toàn file text, mỗi dòng bắt đầu bằng hai, ba chữ cái viết hoa và các trường ngăn cách bằng ký hiệu. TMS của họ không có REST API nào, chỉ có EDI X12.
Trong tình huống như vậy, model không phải chỗ khó. Chỗ khó là đọc đúng bản tin, vì cùng một segment mang nghĩa khác nhau tùy bản tin chứa nó. Nếu parser đọc sai, agent vẫn trả lời rất tự tin, chỉ là trả lời sai.
Bài này đi qua năm loại bản tin bạn sẽ gặp nhiều nhất, một cái bẫy cụ thể trong parser và các ca test mà khách sẽ dựa vào để đánh giá bạn.
Một lô hàng tạo ra những bản tin nào?
Với hàng đường bộ nguyên xe, mọi thứ bắt đầu bằng 204. Đây là bản tin mà chủ hàng hoặc một bên liên quan dùng để chào (tender) lô hàng cho nhà vận tải full-truckload. Bên trong có B2 chứa dữ liệu cơ bản của lô hàng, S5 cho từng điểm dừng, N1 cho các bên liên quan và L11 cho số tham chiếu.
Nhà vận tải trả lời bằng 990: nhận hoặc từ chối lô hàng. Khi xe đã chạy, họ gửi 214 để báo trạng thái lô hàng cho chủ hàng, người nhận và đại lý. Segment mở đầu B10 mang các số định danh như số tham chiếu lô hàng. AT7 là phần lõi, chứa mã trạng thái, lý do, thời điểm của trạng thái và lịch hẹn.
Hàng đường biển dùng 315 để báo các sự kiện của lô hàng. Bạn sẽ đọc N9 cho tham chiếu, Q2 cho tàu và ngày vận chuyển, R4 cho cảng, SG cho trạng thái.
Còn 997 là bản xác nhận chức năng, gửi lại để trả lời một bản tin hoặc một nhóm bản tin: bên nhận báo đã nhận được, và bản tin được chấp nhận, chấp nhận kèm lỗi hay bị từ chối.
| Bản tin | Ai gửi, để làm gì | Segment cần đọc trước | Hệ thống AI dùng vào việc gì |
|---|---|---|---|
| 204 | Chủ hàng chào lô hàng cho nhà vận tải | B2, S5, N1, L11, G62 (hạn phản hồi) | Kế hoạch: các điểm dừng, các bên, hạn phải trả lời |
| 990 | Nhà vận tải nhận hoặc từ chối | Gắn với đúng phiên bản 204 | Biết lô hàng đã có xe hay phải gán lại |
| 214 | Nhà vận tải báo trạng thái đường bộ | B10, AT7 | Dòng thời gian sự kiện để dự báo trễ |
| 315 | Báo sự kiện đường biển | N9, Q2, R4, SG | Tàu, cảng, trạng thái lô hàng |
| 997 | Bên nhận xác nhận kỹ thuật | AK5, AK9 | Sức khỏe đường truyền, không phải nghiệp vụ |
Cái bẫy G62: segment đổi nghĩa theo bản tin
Trong hướng dẫn 214 của TrueCommerce có một quy định ngắn: G62 không được dùng để báo ngày giờ của trạng thái lô hàng. Giờ đó nằm trong AT7. Trong khi đó, với 204, G62 ở phần header lại mang hạn chót phải phản hồi tender.
Giả sử một kỹ sư vội vàng viết hàm “tìm ngày giờ” chạy chung cho mọi bản tin bằng cách quét G62. Với 204, hàm đó lấy hạn chót phản hồi rồi ghi nó thành một sự kiện của lô hàng.
Với 214, nó bỏ qua AT7 là nơi chứa giờ thật. Agent của bạn sẽ dựa vào những mốc giờ không phải sự kiện để nói “lô hàng trễ 6 tiếng”.
Vì vậy parser phải định tuyến theo loại bản tin trước, rồi mới đọc segment. Bản phác thảo Python dưới đây cố ý không ghi số thứ tự của từng trường. Vị trí trường lấy từ implementation guide của từng đối tác, không đoán.
def parse_segments(raw, seg_term="~", elem_sep="*"):
# dấu phân cách đặt theo tài liệu của đối tác, đừng mặc định
return [s.strip().split(elem_sep) for s in raw.split(seg_term) if s.strip()]
def first(segs, tag):
return next((s for s in segs if s[0] == tag), None)
# tx_type: đọc từ phần tử đầu tiên sau tên segment ST, ví dụ first(segs, "ST")[1] == "214"
# field_map: bảng tra bạn tự lập từ implementation guide; pick(seg, tên) trả về phần tử ở vị trí đã ghi
def to_records(tx_type, segs, field_map):
if tx_type == "214":
return {
"shipment_ref": field_map.pick(first(segs, "B10"), "shipment_ref"),
# giờ sự kiện CHỈ lấy từ AT7, không lấy từ G62
"events": [field_map.pick(s, "status") for s in segs if s[0] == "AT7"],
}
if tx_type == "204":
return {
"stops": [s for s in segs if s[0] == "S5"],
# G62 ở header của 204 = hạn chót phải phản hồi tender
"respond_by": field_map.pick(first(segs, "G62"), "datetime"),
}
if tx_type == "997":
return {"ack": True} # chỉ ghi nhận, không trả lời lại
raise ValueError(f"chưa hỗ trợ {tx_type}")
Cách làm này buộc bạn trả lời câu “bản tin này là gì” trước câu “trường này là gì”. Khi khách thêm 315 cho mảng đường biển, bạn chỉ cần thêm một nhánh đọc N9, Q2, R4, SG mà không động vào logic của 214.
997 báo “đã nhận”, không báo “đồng ý”
Lỗi thứ hai thường đến muộn hơn, khi hệ thống đã chạy vài tuần. Trong 997, AK5 báo kết quả của từng transaction set kèm lỗi nếu có, còn AK9 báo kết quả của cả functional group và số transaction set. Thấy toàn trạng thái chấp nhận, người ta dễ nghĩ mọi lô hàng đều ổn.
Thực ra 997 hay 999 chỉ cho biết bản tin qua được kiểm tra kỹ thuật. Một 204 có thể nhận về 997 chấp nhận, rồi sau đó nhận 990 từ chối. Kết quả nghiệp vụ phải theo dõi riêng, bằng 990 hoặc bằng báo cáo đối soát.
Thêm một điều nữa: 990 gắn với từng phiên bản của 204. Nếu khách sửa tender hai lần, hệ thống phải ghép lời chấp nhận với đúng bản tender. Tender bị từ chối phải quay về điều phối để gán lại, không được nằm im ở trạng thái “đã gửi”.
Chiều ngược lại cũng cần một quy tắc cứng. Chuẩn X12 quy định 997 không được xác nhận lại, để tránh vòng lặp xác nhận của xác nhận. Nếu pipeline AI của bạn tự sinh bản tin, hãy viết test chứng minh nó không bao giờ trả 997 cho một 997.
Bốn bước khi nối EDI của khách
Bước đầu tiên tại khách là xin implementation guide của từng đối tác, không phải xin quyền truy cập database. Lập một bảng tra: loại bản tin, segment, trường, ý nghĩa nghiệp vụ. Mang bảng đó ngồi với người điều phối một buổi, vì họ biết mã trạng thái nào thực sự được dùng.
Bước thứ hai, xây parser định tuyến theo loại bản tin như trên và lưu bản tin gốc cạnh bản ghi đã chuẩn hóa. Khi agent trả lời sai, bạn cần truy được về đúng dòng AT7 hay SG đã sinh ra câu trả lời đó.
Bước thứ ba, tách hai bảng trạng thái: một cho 997 (đường truyền có khỏe không), một cho 204/990/214 (lô hàng đang ra sao). Hệ thống AI chỉ đọc bảng thứ hai. Bảng thứ nhất dành cho cảnh báo vận hành.
Bước cuối là bộ test. Hướng dẫn kiểm thử 990 của Stacksync yêu cầu thử một tender bị từ chối và xác nhận nó quay về điều phối để gán lại. Đây là ca test nên viết đầu tiên: nếu ca này sai, lô hàng bị từ chối sẽ nằm im mà không ai gán xe khác.
Những lỗi khiến khách mất niềm tin
Các lỗi thường gặp đều quen thuộc: lấy giờ sự kiện từ G62 trong 214, coi 997 chấp nhận là tender đã được nhận, ghép 990 với bản 204 cũ, quên ca từ chối, và để pipeline trả lời 997 bằng một 997. Không lỗi nào cần kiến thức AI để sửa. Tất cả đều cần đọc tài liệu kỹ và viết test sớm.
Về nghề nghiệp, khi đọc tin tuyển FDE hay solutions engineer trong mảng logistics, để ý các chữ “EDI”, “X12”, “TMS”. Thấy chúng, hãy hỏi thẳng trong buổi phỏng vấn phần tích hợp chiếm bao nhiêu thời gian của vai trò.
Trong CV, đừng chỉ viết “có kinh nghiệm EDI”. Hãy viết cụ thể bạn đã nối luồng 204/990/214, đối soát 997 tách khỏi kết quả nghiệp vụ, và có bộ test cho tender bị từ chối.
Một agent dự báo trễ chỉ tốt khi dòng thời gian nó nhận vào là đúng. Với khách logistics, việc đó bắt đầu từ chỗ lấy giờ sự kiện ở AT7, không phải ở G62.
Bài này có hữu ích không?
Cảm ơn bạn đã góp ý!
7 nguồn
- Product: X12 EDI (TrueCommerce: X12 214 Transportation Carrier Shipment Status Message)
- EDI 214 Transportation Carrier Shipment Status Message (Stedi X12 004010)
- EDI 204 Motor Carrier Load Tender (Stedi X12 004050)
- EDI 990 Response to a Load Tender (Stedi X12 004050)
- Stacksync: XPO Logistics Freight Inc, EDI 990
- EDI 997 Functional Acknowledgment (Stedi X12 004010)
- EDI 315 Status Details (Ocean) (Stedi X12 003060)