Xử lý ngoại lệ
Huỷ phiên, từ chối lịch, không thu được và các trường hợp cần lưu ý.
Phần này tập hợp những tình huống không đi theo luồng thông thường, kèm hậu quả cụ thể để tránh nhầm lẫn khi vận hành.
Huỷ phiên thu gom
Chỉ huỷ được phiên ở trạng thái đã tạo nhưng chưa bắt đầu.
Bốn lý do, ghi nguyên văn theo hệ thống:
- Người thu gom không thể thực hiện
- Thay đổi kế hoạch thu gom
- Tạo trùng phiên
- Khác
Nếu chọn Khác, bắt buộc nhập ghi chú, tối đa 500 ký tự. Hệ thống báo Nhập lý do hủy phiên nếu để trống.
Hậu quả
- Mọi đơn trong phiên trở về Đã xác nhận lịch và được giải phóng khỏi phiên.
- Phiên được đánh dấu đã huỷ và giữ lại lý do cùng thời điểm huỷ.
- Hệ thống ghi một thông báo nội bộ: Đã hủy phiên thu gom, kèm nội dung
Phiên <mã>: <lý do>. Các đơn đang chờ xếp phiên.
Huỷ phiên không gửi thông báo cho khách
Theo đặc tả nghiệp vụ, việc sửa hoặc huỷ phiên chỉ ghi nhật ký và thông báo nội bộ; hệ thống không gửi thông báo mới cho khách và không báo khách rằng đơn đã bị huỷ. Nếu việc huỷ ảnh hưởng tới lịch của khách, hãy liên hệ trực tiếp.
Từ chối lịch hẹn
Dùng khi YeChai không thể nhận lịch. Sáu lý do có sẵn:
Ngoài khu vực phục vụ · Khung giờ đã kín lịch · Khối lượng quá nhỏ · Không liên lạc được khách · Địa chỉ không rõ ràng · Lý do khác
Khách nhận thông báo Lịch thu gom chưa thể thực hiện kèm lý do và có thể đặt lịch khác.
Xem chi tiết ở Vận hành đặt lịch.
Khách huỷ lịch
Khách huỷ được khi đơn chưa vào phiên. Năm lý do phía khách (không bắt buộc):
Muốn đổi lịch · Đã bán chỗ khác · Đặt nhầm · Không còn phế liệu · Lý do khác
Nếu khách không chọn lý do, hệ thống ghi nhận Khách hủy.
Khách huỷ khi đơn đã vào phiên
Hệ thống trả 409 ORDER_IN_SESSION với thông báo Đơn đã được xếp vào phiên thu
gom, không thể hủy. Đã thông báo yêu cầu hủy cho Admin. Đơn vẫn nằm trong
phiên, và nội bộ nhận một thông báo Khách yêu cầu hủy nhưng đơn đã được xếp
phiên để xử lý thủ công.
Đơn không thu được
Khi người thu gom đến nhưng không lấy được phế liệu:
- Đánh dấu Không thu được cho đơn đó trong phiên.
- Khối lượng của đơn bị loại khỏi tổng của phiên.
- Lý do là tuỳ chọn, tối đa 1000 ký tự.
- Đơn hiển thị với nhãn Không thu được nhưng vẫn giữ trạng thái gốc trong hệ thống.
- Có thể bỏ đánh dấu nếu cần nhập lại. Khi đơn đang đánh dấu không thu được, hệ thống chặn nhập phiếu: Đơn không thu được – bỏ đánh dấu nếu cần nhập lại.
Khi cả phiên đều không thu được
Nếu mọi đơn trong phiên đều bị đánh dấu không thu được, phiên kết thúc ở trạng thái hoàn thành nhưng:
- Không tạo phiếu kiểm tra.
- Không phát hành hoá đơn.
- Nội bộ nhận thông báo Phiên không thu được.
Nhập phiếu sai điều kiện
Ba trường hợp chặn nhập phiếu:
| Tình huống | Thông báo |
|---|---|
| Đơn không thuộc phiên | Đơn không thuộc phiên. |
| Đơn đang đánh dấu không thu được | Đơn không thu được – bỏ đánh dấu nếu cần nhập lại. |
| Khách chưa xác nhận hoàn thành | Chưa thể nhập phiếu: khách chưa xác nhận hoàn thành đơn. |
Nhập phiếu phụ thuộc vào khách
Nếu khách chưa xác nhận hoàn thành, bạn không nhập được phiếu. Hãy nhắc khách xác nhận trong ứng dụng, hoặc đánh dấu không thu được nếu thực tế không lấy được phế liệu.
Sửa phiên
Một số ràng buộc cần nhớ:
- Phiên phải có ít nhất một đơn.
- Không lấy được đơn đang thuộc phiên khác.
- Đổi ngày hoặc khung giờ của phiên không tự đổi lịch hẹn của khách.
- Phiên đang thu gom thì không thêm được đơn.
- Thêm đơn vào phiên sẽ kiểm tra lại khoảng cách và tải trọng.