Cập nhật thông tin đơn nhập - xuất từ vận hành
PUT/v1/tms/order-requests/:shownCode
Cập nhật từng phần một đơn nhập - xuất ở trạng thái NEW hoặc CONFIRMED.
Ngoài username, body phải chứa ít nhất một field cần thay đổi.
Field không được phép cập nhật:
| Field cấm | Lý do |
|---|---|
shown_code, type | Định danh và loại dịch vụ cố định khi tạo |
route, zone | Tuyến không đổi qua API cập nhật |
expenses, workflow | Không thuộc phạm vi partial update |
shipping_schedule.services | Không thuộc contract GOM khuyến nghị |
Quy tắc details:
- Chỉ nhận đúng một phần tử và cập nhật dòng detail liên kết đầu tiên
của đơn nhập - xuất (và đơn kế hoạch nếu có); không tìm theo
container_number. - Không thêm hoặc xóa container. Nếu đơn chưa có dòng detail liên kết → 400.
Quy tắc khác:
materialsvàmerchandise_typesđược thay thế bằng danh sách gửi lên.- Đơn thực tế (ACTUAL) ở trạng thái
COMPLETEDhoặcCANCELEDkhông được cập nhật. inventory_checknhậnCó/Không; nếu gửi boolean thì được chuẩn hóa thànhCó/Không.
Request
Responses
- 200
- 400
- 404
- 422
HTTP 200: thành công (body status 200) hoặc lỗi xác thực trong body (status 401).
Body không hợp lệ hoặc đơn không ở điều kiện cho phép cập nhật
Không tìm thấy đơn nhập - xuất theo số lệnh
User không tồn tại hoặc trạng thái đơn nhập - xuất không cho phép cập nhật