抖店查询保单详情

抖店查询保单详情

一、接口名称

• 接口名称：抖店查询保单详情
• 接口地址：https://kf.fw199.com/gateway/dd/order/policy
• 请求方式：POST
• Content-Type：application/x-www-form-urlencoded

查询订单关联的保险保单详情（运费险、过敏险、绿植险、开箱无忧、食安保等）。

二、请求参数

公共参数

业务参数

ins_product_id 枚举

request_data 结构

三、请求示例代码（Java）

@Test
public void ddOrderPolicy() throws Exception {

    String apiUrl = "https://kf.fw199.com/gateway/dd/order/policy";
    String sellerNick = "158458425";

    Map<String, String> data = new HashMap<>();
    data.put("appid", Config.AppId);
    data.put("timestamp", String.valueOf(System.currentTimeMillis() / 1000));
    data.put("seller_nick", sellerNick);
    data.put("sysid", "208");
    data.put("order_id", "6948037538568410302");
    data.put("ins_product_id", "returnfreight2020v1");
    data.put("sign", Utils.Sign(data, Config.AppSecret));

    String result = doHttpRequest(apiUrl, data);
    System.out.println("result:" + result);
}

四、返回结果

说明：

• HTTP 状态码始终为 200，业务成败看 JSON 中的 code
• 最外层 code 为 0 表示蜂巢调用成功；非 0 为失败，message 含失败原因

4.1 成功示例

{
    "code": 0,
    "message": "ok",
    "data": {
        "claimInfoList": [],
        "policyInfo": {
            "amount": 600,
            "appealStatus": 0,
            "claimStatus": 0,
            "goodsInfoList": [
                {
                    "categoryId": "1000003462-1000003466-1000007437",
                    "count": 1,
                    "name": "【央选力荐】小竹然防晒霜身体乳清爽不油腻防水汗50倍防紫外线正品",
                    "productId": 3835791120709845500,
                    "showPageUrl": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/png_m_998fd74fbe818b41399692a793860467_sx_3958241_www2048-2048"
                }
            ],
            "insEnsuredTimeBegin": "",
            "insEnsuredTimeEnd": "",
            "insHotline": "",
            "insPolicyNo": "10202608301351223050062649135",
            "isAllowAppeal": false,
            "merchantPremium": 58,
            "payerType": 2,
            "platformPremium": 0,
            "premium": 58,
            "refusedMsg": "",
            "status": 1,
            "userPremium": 0
        }
    },
    "trace_id": "8300496d-8ffa-404f-a6ad-ade318cb1ce9"
}

具体字段以抖店官方返回为准，无保单或未投保时 data 可能为空或字段不全。

4.2 data 字段说明

policy_info（保单详情）

goods_info_list[] 字段说明

claim_info_list[]（理赔列表）