diff --git a/app/Http/Controllers/Manager/OrdersController.php b/app/Http/Controllers/Manager/OrdersController.php index 133bc53..3e986dd 100644 --- a/app/Http/Controllers/Manager/OrdersController.php +++ b/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 + * } + * ) + * ) + * } * ) * ) */