开发指南
API
官网
API 2.0
API 2.0 > 4.1 订单查询 > 4.1.3 获取售后订单列表

4.1.3 获取售后订单列表

开启令牌和权限后可调用。签名方式请查看开发指南
场景描述：根据该接口查询线上、线下售后订单。
零售 餐饮

请求地址

请求方式 版本信息 请求地址
POST V2 http://openapi.zvcms.com/api/v2

公共参数

参数 参数类型 是否必填 默认值 描述
OpenId string 是 密钥Id
GrantCode string 是 授权code
Token string 是 签名，参考《数字签名sign》
Timestamp string 是 当前时间戳
Nonce string 是 随机正整数
Action string 是 order.after-list 接口方法
Params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
page int 否 1 当前页数
page_size int 否 20 每页显示数
order_no string 否 订单编号
refund_no string 否 退款单编号
refund_type int 否 退款类型 1- 退款 2- 申请售后 3- 商家主动退款
refund_status int 否 退款状态 1：等待商家处理 2：退款成功 3：退款关闭 4：已拒绝
refund_mode int 否 退款方式
begin_time TimeStamp 否 申请开始时间
end_time TimeStamp 否 申请结束时间
sale_channel int 否 销售渠道

响应参数

参数 参数类型 描述
status bool 成功或失败
code int 成功/错误编码
message string 成功/错误描述
data array
 ├current_page int 当前页
 ├per_page int 每页显示数
 ├last_page int 最后一页
 ├total int 总条数
 ├saleChannel array
  ├1 array 销售渠道 [ "1": "网店", "2": "门店"]
  ├2 array 销售渠道[ "1": "网店", "2": "门店"]
 ├refundType array 退款类型[1": "退款", "2": "申请售后", "3": "商家主动退款"]
 ├refundMode array 退款方式[ "1": "仅退款", "2": "退货退款"]
 ├refundStatus array 退款状态【 "1": "等待商家处理", "2": "退款成功", "3": "买家撤销申请", "4": "商家拒绝"】
 ├reta_list array
  ├0 array
   ├id int 退款单ID
   ├refund_no string 退款编号
   ├order_no string 订单编号
   ├order_id int 订单ID
   ├user_id int 用户ID
   ├type int 退款类型
   ├mode int 退款方式
   ├amount int 第三方退款
   ├wallet_amount int 余额退款金额
   ├status int 退款状态
   ├reason string 退款原因
   ├note string 退款说明
   ├images string 图片
   ├dispose_idea string 处理意见或拒绝原因
   ├created_at DateTime 申请时间
   ├complete_at DateTime 完成时间
   ├remark string 备注
   ├goods_name string 商品名
   ├receiving_info array
    ├id int 收货地址ID
    ├accept_name string 收货人姓名
    ├mobile string 收货人电话
   ├status_text string 状态文本
   ├refund_type string 退款类型
   ├refund_mode string 退款方式
   ├order_amount Money(元) 订单金额
   ├refund_amount Money(元) 退款金额
   ├user array
    ├id int 用户ID
    ├nickname string 用户昵称

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "order.after-list",
    "Params": {
        "page": "",
        "page_size": "",
        "order_no": "",
        "refund_no": "",
        "refund_type": "",
        "refund_status": "",
        "refund_mode": "",
        "begin_time": "",
        "end_time": "",
        "sale_channel": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "current_page": "",
        "per_page": "",
        "last_page": "",
        "total": "",
        "saleChannel": {
            "1": "网店",
            "2": "门店"
        },
        "refundType": "",
        "refundMode": "",
        "refundStatus": "",
        "reta_list": [
            {
                "id": "",
                "refund_no": "",
                "order_no": "",
                "order_id": "",
                "user_id": "",
                "type": "",
                "mode": "",
                "amount": "",
                "wallet_amount": "",
                "status": "",
                "reason": "",
                "note": "",
                "images": "",
                "dispose_idea": "",
                "created_at": "",
                "complete_at": "",
                "remark": "",
                "goods_name": "",
                "receiving_info": {
                    "id": "",
                    "accept_name": "",
                    "mobile": ""
                },
                "status_text": "",
                "refund_type": "",
                "refund_mode": "",
                "order_amount": "",
                "refund_amount": "",
                "user": {
                    "id": "",
                    "nickname": ""
                }
            }
        ]
    }
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

请求地址

请求方式 版本信息 请求地址
POST V2 http://openapi.zvcms.com/api/v2

公共参数

参数 参数类型 是否必填 默认值 描述
OpenId string 是 密钥Id
GrantCode string 是 授权code
Token string 是 签名，参考《数字签名sign》
Timestamp string 是 当前时间戳
Nonce string 是 随机正整数
Action string 是 order.after-list 接口方法
Params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
page int 否 1 当前页数
order_no string 否 订单编号
refund_no string 否 退款单编号
begin_time TimeStamp 否 申请开始时间
end_time TimeStamp 否 申请结束时间
status int 否 退款状态 ： 1: "退款中", 2: "退款成功", 3: "退款关闭"
time int 否 1- 今天 7- 近7天 30- 近30天

响应参数

参数 参数类型 描述
status bool 成功或失败
code int 成功/错误编码
message string 成功/错误描述
data array
 ├current_page int 当前页
 ├per_page int 每页显示数
 ├last_page int 最后一页
 ├total int 总条数
 ├cy_list array
  ├0 array
   ├id int 退款订单id
   ├type int 退款类型 1 是退款 2 是退货
   ├refund_no string 退款编号
   ├order_no string 订单号
   ├order_id int 订单id
   ├user_id int 用户ID
   ├wallet_amount Money(元) 退款余额
   ├amount Money(元) 退款金额
   ├admin_id int 管理员id
   ├status int 退款状态， 0：申请退款，待处理 100：退款成功 101：卖家拒绝退款 102：买家取消 150: 退款中(已请求退款接口, 等待退款通知中) 201：卖家已经同意退款，等待买家退货 202：买家已经退货，等待卖家确认收货 203：同意退款，退款接口处理失败 103：退款关闭
   ├reason int 申请退款原因 退款退货原因表对应id
   ├note int 说明
   ├has_image int 是否有图 0- 否 1- 是
   ├images string 图片
   ├dispose_idea string 处理意见
   ├created_at int 申请时间
   ├updated_at int 处理时间
   ├express_name string 快递公司名称
   ├express_no string 快递单号
   ├express_at int 发货时间
   ├receive_at int 收货时间
   ├deal_at int 同意/拒绝处理时间
   ├closed_at int 没有收到货订单关闭时间
   ├express_id int 快递公司id
   ├is_received int 是否收货 0-否 1-是
   ├task_status int 执行定时任务状态1-可执行 0-不执行
   ├task_exec_times int 定时任务执行次数，针对调用退款接口
   ├day_sort int 排号： 退单排号-R开头+数字
   ├task_exec_at int 最近一次执行时间
   ├deny_reason int 拒绝理由
   ├is_active_refund int 是否主动退款: 0 被动退款(用户发起) 1主动退款(商家发起)
   ├koubei_reason string 口碑拒绝退款理由
   ├multi_store_name string 门店名称
   ├order_status_text int 订单聚合状态 文字 1 -'待支付， 2 -待接单，3 -待发货，4 -已发货--待收货，5-已取消，6-已作废， 7 -'已完成，8-已关闭，9 -退款中，10-待取单，11 -待取消，12-已备餐，13-待制作
   ├order_amount Money(元) 订单总金额
   ├pay_amount Money(元) 订单应付金额
   ├freight Money(元) 订单运费
   ├pack_cost Money(元) 订单打包费
   ├is_alone int 订单是否独立收款,0不是,1是
   ├minus_amount Money(元) 订单优惠总金额
   ├status_text int 退款单 状态 文字 0 -等待卖家确认，100 -退款成功， 101-卖家拒绝退款，102 -买家取消，103 -退款关闭，150-退款中， 退款中(已请求退款接口, 等待退款通知中， 201-卖家已经同意退款，等待买家退货，202-买家已经退货，等待卖家确认收货，203 -同意退款，退款接口处理失败
   ├type_text int 退款状态 文字 1 => '仅退款', 2 => '退货\退款'
   ├created_time string 退款单创建时间
   ├goods_name array
    ├0 array 商品名称
   ├receivable_amount Money(元) 实付金额
   ├order array
    ├id int 对应订单表id
    ├store_id int 商家ID
    ├order_no string 订单号
    ├user_id int 提交订单用户ID
    ├typeCate int 1 堂食 2 打包 3 外卖 4 自助买单 5储值订单 6预约订单 7口碑付款码 8卡券包 9 协议扣费 10礼品卡订单
    ├people_number int 就餐人数
    ├table_number int 桌号
    ├addr_id int 收货地址ID
    ├order_type int 订单类型： 1堂食， 2打包， 3外卖 4 自助买单
    ├payment_id int 用户支付方式ID,当为0时表示货到付款
    ├use_platform_payment int 使用平台支付
    ├sort_num int 排号： 外卖排号-W开头+数字 堂食排号-T开头+数字 预约买单-Y开头+数字 自助买单-Z开头+数字
    ├status int 订单状态 1生成订单, 2支付订单, 3取消订单(客户触发), 4作废订单(管理员触发), 5完成订单, 6已关闭
    ├pay_status int 支付状态 0：未支付; 1：已支付;
    ├send_status int 配送状态 0：未发送, 1：已发送, 2：部分发送
    ├receive_status int 订单接收状态 0-未接单 1-已接单
    ├total_amount Money(元) 订单总金额
    ├minus_amount Money(元) 优惠总金额
    ├cost_amount Money(元) 成本金额
    ├amount Money(元) 应付金额
    ├tax Money(元) 税金
    ├freight Money(元) 运费
    ├trade_no string 支付平台交易号
    ├refund_status Int 申请退款
    ├is_promptly Int 是否立即送出 0-否 1-是
    ├send_time Int 派送时间
    ├postscript string 用户附言
    ├├ Int 发票 0 -无 1-有
    ├invoice_title string 发票title
    ├invoice_tax_code Int 增值税税号
    ├refund Int 退款数量
    ├express_id Int 物流公司id
    ├express_no string 运单号
    ├spreader_id Int 推荐人id
    ├income Money(元) 推广员佣金
    ├income2 Money(元) 邀请人佣金
    ├created_at int 单时间
    ├updated_at int 更新时间
    ├receive_at int 接单时间
    ├payed_at int 付款时间
    ├sent_at int 发货时间
    ├completed_at int 订单完成时间
    ├ comment_status int 评论状态 0- 无 1-有
    ├comment_at int 评价时间
    ├gift_id int 是否赠品订单 0-否 1-是
    ├valid_period int 商品有效期
    ├effective_type int 电子凭证生效时间
    ├effective_delay_hours int 多少小时后生效
    ├item_validity_start int 有效期开始时间
    ├item_validity_end int 有效期结束时间
    ├verify_code string 同意核销券码
    ├express_type int 物流类型 1-快递/物流 0-自行配送
    ├pay_platform string 支付平台（wap...）
    ├pay_type string 支付类型（service-order, order, mini-order）
    ├card_minus Money(元) 会员折扣
    ├remark string 备注
    ├pack_cost Money(元) 打包费
    ├tableware_price Money(元) 餐具费
    ├pay_user_id int 支付用户ID
    ├mutil_user int 是否多人点餐0-否 1-是 2-拼单点餐
    ├express string 配送快递 0-自送
    ├multi_store_id int 多门店ID
    ├receipt int 是否打印 0-未打印 1-打印
    ├source int 订单来源：1-微信小程序，2-支付宝口碑,3-支付宝小程序 4- 美团 5- 饿了么 6- 支付宝插件 7- 支付宝H5 8- 收银机
    ├pay_model int 结账模式 1-先结算 2-先吃饭
    ├reserve_takeout_time string 外卖预订单时间
    ├only_coupon int 是否只享受 优惠券优惠(不与其他优惠共享): 0 共享 1只享受优惠券
    ├reward_amount Money(元) 满减优惠, 减免价
    ├coupon_amount Money(元) 优惠券优惠, 减免价
    ├card_bonus_points itn 会员卡 赠送的积分
    ├card_coupon_ids itn 是否独立收款,0不是,1是
    ├card_discount string 会员卡 享受的折扣
    ├is_alone int 否独立收款,0不是,1是
    ├use_wallet itn 是否使用钱包支付 0- 未使用 1-使用
    ├wallet_amount Money(元) 钱包使用金额
    ├out_order_no string 外部订单号
    ├change_amount Money(元) 找零金额
    ├third_trade_no string 第三方支付订单编号
    ├is_give int 是否赠送商品 0 不是 1是
    ├give_amount Money(元) 必选商品优惠的价格
    ├delete_type int 删除订单发起方 0- 未删除 1- 用户删除 2- 商家删除 3- 均删除
    ├invoice_status int 是否已开发票 0- 否 1- 是
    ├linkman_phone string 联系人手机号
    ├gift_card_amount Money(元) 礼品卡优惠, 减免价
    ├support_back_amount string 助力返现金额
    ├state int 订单聚合状态 1 => '待支付', 2 => '待接单', 3 => '待发货', 4 => '待收货',// 已发货 5 => '已取消', 6 => '已作废', 7 => '已完成', 8 => '已关闭', 9 => '退款中', 10 => '待取单', 11 => '待取消', 12 => '已备餐', 13 => '待制作',
    ├user_name string 用户名
    ├pay_user_name string 付款用户名
    ├receivable_amount Money(元) 实付金额
    ├mobile string 手机号码
   ├order_goods array
    ├0 array
     ├id int 订单商品id

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "order.after-list",
    "Params": {
        "page": "",
        "order_no": "",
        "refund_no": "",
        "begin_time": "",
        "end_time": "",
        "status": "1",
        "time": "30"
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "current_page": "",
        "per_page": "",
        "last_page": "",
        "total": "",
        "cy_list": [
            {
                "id": "123",
                "type": "1",
                "refund_no": "",
                "order_no": "",
                "order_id": "",
                "user_id": "",
                "wallet_amount": "28.010",
                "amount": "0.000",
                "admin_id": "",
                "status": "100",
                "reason": "1",
                "note": "",
                "has_image": "1",
                "images": "https:\/\/img-shop.qmimg.cn\/s10155\/2018\/09\/27\/69f837fc546f1a16f7.png",
                "dispose_idea": "",
                "created_at": "",
                "updated_at": "",
                "express_name": "",
                "express_no": "",
                "express_at": "",
                "receive_at": "",
                "deal_at": "",
                "closed_at": "",
                "express_id": "",
                "is_received": "1",
                "task_status": "",
                "task_exec_times": "",
                "day_sort": "",
                "task_exec_at": "",
                "deny_reason": "",
                "is_active_refund": "",
                "koubei_reason": "",
                "multi_store_name": "",
                "order_status_text": "",
                "order_amount": "",
                "pay_amount": "",
                "freight": "",
                "pack_cost": "",
                "is_alone": "",
                "minus_amount": "",
                "status_text": "",
                "type_text": "",
                "created_time": "",
                "goods_name": [
                    ""
                ],
                "receivable_amount": "",
                "order": {
                    "id": "12",
                    "store_id": "",
                    "order_no": "",
                    "user_id": "",
                    "typeCate": "",
                    "people_number": "",
                    "table_number": "",
                    "addr_id": "",
                    "order_type": "",
                    "payment_id": "",
                    "use_platform_payment": "",
                    "sort_num": "",
                    "status": "",
                    "pay_status": "",
                    "send_status": "",
                    "receive_status": "",
                    "total_amount": "",
                    "minus_amount": "",
                    "cost_amount": "",
                    "amount": "",
                    "tax": "",
                    "freight": "",
                    "trade_no": "",
                    "refund_status": "1",
                    "is_promptly": "0",
                    "send_time": "",
                    "postscript": "",
                    "├ ": "发票 0 -无 1-有",
                    "invoice_title": "发票title",
                    "invoice_tax_code": "",
                    "refund": "",
                    "express_id": "",
                    "express_no": "",
                    "spreader_id": "推荐人id",
                    "income": "",
                    "income2": "",
                    "created_at": "",
                    "updated_at": "",
                    "receive_at": "",
                    "payed_at": "",
                    "sent_at": "",
                    "completed_at": "",
                    " comment_status": "",
                    "comment_at": "",
                    "gift_id": "",
                    "valid_period": "",
                    "effective_type": "",
                    "effective_delay_hours": "",
                    "item_validity_start": "",
                    "item_validity_end": "",
                    "verify_code": "",
                    "express_type": "",
                    "pay_platform": "",
                    "pay_type": "",
                    "card_minus": "",
                    "remark": "",
                    "pack_cost": "",
                    "tableware_price": "",
                    "pay_user_id": "",
                    "mutil_user": "",
                    "express": "",
                    "multi_store_id": "",
                    "receipt": "",
                    "source": "",
                    "pay_model": "",
                    "reserve_takeout_time": "",
                    "only_coupon": "",
                    "reward_amount": "",
                    "coupon_amount": "",
                    "card_bonus_points": "",
                    "card_coupon_ids": "",
                    "card_discount": "",
                    "is_alone": "",
                    "use_wallet": "",
                    "wallet_amount": "",
                    "out_order_no": "",
                    "change_amount": "",
                    "third_trade_no": "",
                    "is_give": "",
                    "give_amount": "",
                    "delete_type": "",
                    "invoice_status": "",
                    "linkman_phone": "",
                    "gift_card_amount": "",
                    "support_back_amount": "",
                    "state": "",
                    "user_name": "",
                    "pay_user_name": "",
                    "receivable_amount": "",
                    "mobile": ""
                },
                "order_goods": [
                    {
                        "id": "订单商品id"
                    }
                ]
            }
        ]
    }
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

免费升级

营销功能、插件持续每月更新开发升级

免费专业培训

每月建站、微信营销、电商等互联网增值培训

7×24小时服务支持

400电话、QQ、微信、在线等多渠道售后支持

 

安徽智迈科技股份有限公司 版权所有 Copyright 2009-2018 皖公网安备 34019202000074号 增值电信业务经营许可证：皖B2-20170075