fix(t231): expose freight preflight errors

backend-api/internal/transport/webui/handler.go

@@ -411,12 +411,7 @@ func (h *Handler) CreateFreightImport(ctx *gin.Context) {
 	)
 	if err != nil {
 		token, _ := csrfToken(ctx)
-		message := "同步任务创建失败，请稍后使用相同提交标识重试。"
-		code := ""
-		if errors.Is(err, ErrOCRServiceInvalid) {
-			message = "OCR 服务无效，请检查本机 OCR 服务和 CMROUBAO_OCR_API_URL 后重试。"
-			code = "OCR_SERVICE_INVALID"
-		}
+		code, title, message := freightImportError(err)
 		h.render(ctx, serviceErrorStatus(err), "freight-import", freightImportPage{
 			Page: pageView{
 				Title:          "导入 ERP 货运",
@@ -430,12 +425,30 @@ func (h *Handler) CreateFreightImport(ctx *gin.Context) {
 			IdempotencyKey: key,
 			Error:          message,
 			ErrorCode:      code,
+			ErrorTitle:     title,
 		})
 		return
 	}
 	ctx.Redirect(http.StatusSeeOther, "/freight/import?sync="+pathEscape(run.ID))
 }
 
+func freightImportError(err error) (string, string, string) {
+	switch {
+	case errors.Is(err, ErrOCRServiceInvalid):
+		return "OCR_SERVICE_INVALID", "OCR 服务无效", "OCR 服务无效，请检查本机 OCR 服务和 CMROUBAO_OCR_API_URL 后重试。"
+	case errors.Is(err, ErrERPNotConfigured):
+		return "ERP_NOT_CONFIGURED", "ERP 凭证未配置", "ERP 账号或密码未配置，请检查 backend-api/.env 后重试。"
+	case errors.Is(err, ErrERPLoginRejected):
+		return "ERP_LOGIN_REJECTED", "ERP 登录被拒绝", "请检查 ERP 账号密码及 OCR 识别结果后重试。"
+	case errors.Is(err, ErrERPProtocol):
+		return "ERP_RESPONSE_INVALID", "ERP 响应无效", "ERP 返回格式无法确认，请稍后重试。"
+	case errors.Is(err, ErrERPUnavailable):
+		return "ERP_UNAVAILABLE", "ERP 暂时不可用", "ERP 服务暂时不可用，请稍后使用相同提交标识重试。"
+	default:
+		return "", "", "同步任务创建失败，请稍后使用相同提交标识重试。"
+	}
+}
+
 func (h *Handler) FreightDetail(ctx *gin.Context) {
 	service := h.service.(FreightService)
 	detail, err := service.GetFreightOrder(
@@ -1230,6 +1243,12 @@ func serviceErrorStatus(err error) int {
 		return http.StatusUnprocessableEntity
 	case errors.Is(err, ErrOCRServiceInvalid):
 		return http.StatusServiceUnavailable
+	case errors.Is(err, ErrERPNotConfigured), errors.Is(err, ErrERPLoginRejected):
+		return http.StatusUnprocessableEntity
+	case errors.Is(err, ErrERPProtocol):
+		return http.StatusBadGateway
+	case errors.Is(err, ErrERPUnavailable):
+		return http.StatusServiceUnavailable
 	case errors.Is(err, ErrConflict):
 		return http.StatusConflict
 	case errors.Is(err, context.DeadlineExceeded):
@@ -1303,6 +1322,7 @@ type freightImportPage struct {
 	IdempotencyKey string
 	Error          string
 	ErrorCode      string
+	ErrorTitle     string
 	Sync           *FreightSync
 	Watermark      *FreightWatermark
 }