淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	更多限制	描述
valid_end	String	可选	2021-03-16		服务截止日期
okki_refund_id	String	可选	2022040115130100014350		小满退款单号
ali_cgs	String	可选	1954931178		阿里globalId
okki_client_id	String	可选	27720		小满clientId
action	Number	可选	2		操作类型
id	String	可选	T2012018473772142		阿里退款单号
refund_list	RefundList []	可选		最大列表长度：999999	退款列表
└ ali_order_no String 可选 P2107134353201627 阿里订单号 └ original_refund_amount String 可选 1000.0 原始退款金额 └ invoice_loss String 可选 100.0 丢票扣费 └ refund_amount String 可选 900.0 退款金额 └ invoice_msg String 可选已开票发票信息 └ ali_order_product_id String 可选 P2107134353201627_1 阿里订单行号 └ ali_service_loss String 可选 100.0 违约金金额 └ ali_cost_loss String 可选 100.0 制作费金额
service_loss_flag	String	可选	1		是否豁免违约金0豁免1计算
cost_loss_flag	String	可选	1		是否豁免制作费0豁免1计算

名称	类型	示例值	描述
data	Data		退款信息数据
└ valid_end String 2021-03-16 服务截止日期 └ okki_refund_id String 2022040115130100014350 小满退款单号 └ ali_cgs String 4084256955 阿里gid └ okki_client_id String 39305 小满客户id └ action Number 1 操作类型 refund_list RefundList [] 退款相关订单 └ ali_order_no String P2107134353201627 订单号 └ ali_order_product_id String P2107134353201627_1 订单行号 └ original_refund_amount String 1000.00 退款金额 └ invoice_loss String 100.00 开票信息 └ refund_amount String 900.00 原始退款金额 └ invoice_msg String 已开票丢票扣费 └ ali_service_loss String 100.00 违约金金额 └ ali_cost_loss String 100.00 制作费金额 └ id String T2012018473772142 阿里退款单号 └ content String 您好，您的这笔订单发票已... 退款提示内容 └ cost_loss_flag String 1 是否豁免制作费0豁免1计算 └ service_loss_flag String 1 是否豁免违约金0豁免1计算
error_desc	String	success	错误信息
success	Boolean	true	是否成功
now	String	2021-06-28 16:34:23	时间戳
resp_code	Number	0	响应编码（成功0）
biz_id	String	2021-06-28 16:38:32.565	小满业务id

{"valid_end":"2021-03-16","okki_refund_id":"2022040115130100014350","ali_cgs":"1954931178","service_loss_flag":"1","okki_client_id":"27720","action":2,"id":"T2012018473772142","refund_list":[{"ali_service_loss":"100.0","ali_order_no":"P2107134353201627","original_refund_amount":"1000.0","invoice_loss":"100.0","refund_amount":"900.0","invoice_msg":"已开票","ali_order_product_id":"P2107134353201627_1","ali_cost_loss":"100.0"}],"cost_loss_flag":"1"}

{
    "data":{
        "valid_end":"2021-03-16",
        "okki_refund_id":"2022040115130100014350",
        "ali_cgs":"4084256955",
        "okki_client_id":"39305",
        "action":1,
        "refund_list":[
            {
                    "ali_order_no":"P2107134353201627",
                    "ali_order_product_id":"P2107134353201627_1",
                    "original_refund_amount":"1000.00",
                    "invoice_loss":"100.00",
                    "refund_amount":"900.00",
                    "invoice_msg":"已开票",
                    "ali_service_loss":"100.00",
                    "ali_cost_loss":"100.00"
            }
        ],
        "id":"T2012018473772142",
        "content":"您好，您的这笔订单发票已...",
        "cost_loss_flag":"1",
        "service_loss_flag":"1"
    },
    "error_desc":"success",
    "success":true,
    "now":"2021-06-28 16:34:23",
    "resp_code":0,
    "biz_id":"2021-06-28 16:38:32.565"
}

{"success":"false","error_desc":"Illegal request","resp_code":"sign-check-failure"}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

CRM猎户座前台

qimen.alibaba.okki.refund.content.get (查询小满侧退款信息)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ