Khởi chạy, Đóng, Hoàn tất Tích hợp API Điều phối

Last updated: June 19, 2026

Hầu hết các bất thường có thể được ghi nhận thủ công bằng cách khởi chạy một Điều phối mới trong L2L. L2L cung cấp cách tạo, cập nhật và hoàn tất các Điều phối thông qua API nhằm tự động hóa để nâng cao hiệu quả. Dưới đây là một số trường hợp sử dụng khi tự động hóa việc tạo và hoàn tất Điều phối có thể hữu ích:

  • Khởi chạy một Điều phối để thông báo cho kỹ thuật viên khi một Máy phát sinh lỗi cụ thể
  • Khởi chạy một quy trình trong L2L từ một ứng dụng khác, chẳng hạn như QMS
  • Đóng một Điều phối khi điều kiện lỗi không còn hoạt động
  • Sử dụng các thiết bị phần cứng để khởi chạy Điều phối

Khởi chạy một Điều phối

Mục tiêu: Tự động hóa việc tạo một Điều phối để nâng cao hiệu quả và độ chính xác của dữ liệu Điều phối.
Khoảng thời gian đề xuất: Theo yêu cầu
Tổng quan quy trình:

  1. (Tùy chọn) Xác định xem một Điều phối đã được khởi chạy cho Máy bị ảnh hưởng với cùng Loại Điều phối hay chưa. Việc này có thể được sử dụng để ngăn dữ liệu bị trùng lặp. Nếu tìm thấy một Điều phối có cùng Máy và Loại Điều phối, có thể không cần tạo Điều phối mới. 
    GET https://[customer].leading2lean.com/api/1.0/dispatches/?auth=[api key]&site=[site id]&machinecode=[machine code]&dispatchtypecode=[dispatch type code]&open=T&order_by=-reported&limit=1
  2. Tạo một Điều phối mới. Có hai phương thức để tạo một Điều phối:
    1. Thêm. Phương thức này tạo một Điều phối đã hoàn tất và đã đóng. Phương thức này được sử dụng nếu bạn chỉ muốn ghi nhận một sự cố hoặc thời gian ngừng hoạt động mà không cần bất kỳ tương tác nào từ con người. 
      POST https://[customer].leading2lean.com/api/1.0/dispatches/add/?auth=[api key]
      1. Tham số POST: site=[site id]&dispatchtypecode=[dispatch type code]&description=[description]&machinecode=[machine code]&tradecode=[trade code]
      2. Xem tài liệu API chính thức để biết danh sách đầy đủ các Tham số POST.
    2. Mở. Phương thức này được sử dụng để khởi chạy một Điều phối đang mở. Thao tác này giống như khởi chạy một Điều phối bằng biểu mẫu Điều phối mới trong giao diện người dùng.
    3. POST https://[customer].leading2lean.com/api/1.0/dispatches/open/?auth=[api key]
      1. Tham số POST: site=[site id]&dispatchtypecode=[dispatch type code]&description=[description]&machinecode=[machine code]&tradecode=[trade code]
      2. Xem tài liệu API chính thức để biết danh sách đầy đủ các Tham số POST.

Đóng một Điều phối

Mục tiêu: Đóng một Điều phối theo chương trình
Khoảng thời gian đề xuất: Theo yêu cầu
Tổng quan quy trình:

  1. Tra cứu Điều phối để tìm ID Điều phối. Có thể bỏ qua bước này nếu đã biết ID Điều phối. 
    GET https://[customer].leading2lean.com/api/1.0/dispatches/?auth=[api key]&site=[site id]&dispatchnumber=[dispatch number]
  2. Đóng Điều phối 
    POST https://[customer].leading2lean.com/api/1.0/dispatches/close/[dispatch id]/?auth=[api key]

Hoàn tất một Điều phối

Mục tiêu: Hoàn tất một Điều phối theo chương trình
Khoảng thời gian đề xuất: Theo yêu cầu
Tổng quan quy trình:

  1. Tra cứu Điều phối để tìm ID Điều phối. Có thể bỏ qua bước này nếu đã biết ID Điều phối. 
    GET https://[customer].leading2lean.com/api/1.0/dispatches/?auth=[api key]&site=[site id]&dispatchnumber=[dispatch number]
  2. Hoàn tất Điều phối 
    POST https://[customer].leading2lean.com/api/1.0/dispatches/complete/[dispatch id]/?auth=[api key]