up

app/Http/Controllers/Manager/OrdersController.php

@@ -733,14 +733,47 @@ class OrdersController extends CommonController
      * @OA\POST(
      *     path="/manager/checkout-order-items/{order_id}",
      *     summary="V2-中途结算（即只依次结算子订单，并不结束订单，只需余额刚好）",
-     *     description="中途结算",
+     *     description="交互流程如下：初次请求带上just_check参数，将返回to_recharge_total值；如果to_recharge_total大于0表示需要充值，充值完成之后，去除just_check参数再次提交；如果to_recharge_total <= 0，直接去除just_check参数再次提交",
      *     @OA\Parameter(name="token", in="query", @OA\Schema(type="string"), required=true, description="token"),
      *     @OA\Parameter(name="order_id", in="path", @OA\Schema(type="integer"), required=true, description="订单id"),
      *     @OA\Parameter(name="to_date", in="query", @OA\Schema(type="date"), required=true, description="结算到的日子")
      *     @OA\Parameter(name="just_check", in="query", @OA\Schema(type="boolean"), required=false, description="是否只是check一下要多少钱")
      *     @OA\Response(
      *      response="200",
-     *      description="中途结算"
+     *      description="中途结算",
+     *      content={
+     *             @OA\MediaType(
+     *                 mediaType="application/json",
+     *                 @OA\Schema(
+     *                     @OA\Property(
+     *                         property="errorcode",
+     *                         type="integer",
+     *                         description="错误码；仅在发生错误时发送"
+     *                     ),
+     *                     @OA\Property(
+     *                         property="errormsg",
+     *                         type="string",
+     *                         description="返回消息；有errorcode时为错误内容，无errorcode时为提示内容"
+     *                     ),
+     *                     @OA\Property(
+     *                         property="to_recharge_total",
+     *                         type="decimal",
+     *                         description=""
+     *                     ),
+     *                      @OA\Property(
+     *                         property="updated_items",
+     *                         type="integer",
+     *                         description="结算的子订单总数；仅在成功的情况下发送"
+     *                     ),
+     *                     example={
+     *                         "errorcode": "30003",
+     *                         "errormsg": "截止到中途结算日，没有需要结算的子订单，如需预充值请发起收款操作",
+     *                         "to_recharge_total": 990,
+     *                         "checkout_items": 10
+     *                     }
+     *                 )
+     *             )
+     *         }
      *     )
      * )
      */