功能描述

全量导入卖家的政策数据；卖家需要按协议定义实现相应接口；淘宝每周一、四凌晨（此时间商户是可配置的，但是配置的时间只能是1~2次）去调用卖家按协议实现的接口；一次返回全量数据的压缩包；淘宝将清除之前导入的平台数据；以这次全量数据为准。

全量更新淘宝与卖家交互细节

(1）卖家需要在每周一、周四凌晨四点钟之前（此时间商户是可配置的，但是配置的时间只能是1~2次）准备好全量政策的压缩文件(不能大于7M)，淘宝会准时获取。

(2） 获取文件重试机制

a. 没获取到全量政策的压缩文件
b. 文件的格式无法解析
c. 网络超时（15秒）
以上3点，淘宝都视为获取全量压缩文件失败，失败后淘宝会立即重新尝试获取，重试次数为3次，如果都失败，淘宝将退出本次全量更新，并短信通知卖家相关人员。

(3）压缩文件格式
a. 政策信息要以json文本格式描述（详见下面的FullGetPolicyResult示例）
b. 将json文本信息按zip流格式输出文件
c. 全量政策中的以下属性必须保证顺序且位于最前端：

{
    "success": true, 
    "errorCode": "", 
    "errorMessage": "", 
    "lastModifiedTime": "2013-12-17 14:30:07", 
    "lastOuterId": "", 
    "delTime": "2013-12-18 18:20:00", 
    "delOuterId": ""
}

(4) 全量政策调用流程：

输入参数

• FullGetPolicyRequest

示例：

<?xml version="1.0" encoding="utf-8"?>

<FullGetPolicyRequest> 
  <username>username</username>  
  <password>e10adc3949ba59abbe56e057f20f883e</password>  
  <requestId>1390553382240_63119_202000</requestId> 
</FullGetPolicyRequest>

返回结果

• FullGetPolicyResult

• PolicyDO

• PolicySegmentDO

• PolicyPriceDO

示例：

{
    "success": true, 
    "errorCode": "", 
    "errorMessage": "", 
    "lastModifiedTime": "2013-12-17 14:30:07", 
    "lastOuterId": "", 
    "delTime": "2013-12-18 18:20:00", 
    "delOuterId": "", 
    "policyDOs": [
        {
            "airline": "8L", 
            "arrAirport": "NKG", 
            "contentEI": "", 
            "depAirport": "FOC", 
            "earliestIssueDays": -1, 
            "excludeArrAirports": "", 
            "excludeDepAirports": "", 
            "invoiceType": 1, 
            "isChange": false, 
            "isIssue": false, 
            "isRefund": false, 
            "isSupportCodeShare": false, 
            "isUpgrade": false, 
            "lastestIssueDays": -1, 
            "maxStayTime": 0, 
            "minStayTime": 0, 
            "needSwitchPNR": true, 
            "outerId": "yufa1", 
            "prices": [
                {
                    "price": "", 
                    "retentionMoney": 0, 
                    "retentionPoint": 0.77, 
                    "supportAgents": ""
                }
            ], 
            "refundBaseType": 0, 
            "refundPriceInfo": "", 
            "refundTime": "{'1':'00:00-23:59','2':'00:00-23:59','3':'00:00-23:59','4':'00:00-23:59','5':'00:00-23:59','6':'00:00-23:59','7':'00:00-23:59'}", 
            "refundType": 0, 
            "saleEndDate": "2014-11-30", 
            "saleStartDate": "2013-10-17", 
            "tuigaiqianInfo": "如果是私有运价政策（带有价格），必须传退改签。如果公布运价（不带有价格）不填， 淘宝根据旅行有效期、航空公司、舱位匹配FD退改签", 
            "segments": [
                {
                    "cabinList": "P,A,D,F,C,Z,J,W,Y,B,H,M1,H1,K,K1,L,M,L1,Q,Q1,G,V", 
                    "depTimeRanges": "", 
                    "excludeFlightNos": "", 
                    "includeFlightNos": "", 
                    "operationTime": "1234567", 
                    "segmentNum": "00", 
                    "travelEndDate": "2014-11-30", 
                    "travelStartDate": "2013-10-17"
                }
            ], 
            "timestamp": 1387800319218, 
            "supplierId": "", 
            "supplierOfficeId": "KMG236", 
            "tripType": 0, 
            "workTime": "{'1':'00:00-23:59','2':'00:00-23:59','3':'00:00-23:59','4':'00:00-23:59','5':'00:00-23:59','6':'00:00-23:59','7':'00:00-23:59'}"
        }, 
        {
            "airline": "SC", 
            "arrAirport": "SHA", 
            "contentEI": "", 
            "depAirport": "SYX", 
            "earliestIssueDays": -1, 
            "excludeArrAirports": "", 
            "excludeDepAirports": "", 
            "invoiceType": 1, 
            "isChange": false, 
            "isIssue": false, 
            "isRefund": false, 
            "isSupportCodeShare": false, 
            "isUpgrade": false, 
            "lastestIssueDays": -1, 
            "maxStayTime": 0, 
            "minStayTime": 0, 
            "needSwitchPNR": true, 
            "outerId": "yufa2", 
            "prices": [
                {
                    "price": "", 
                    "retentionMoney": 0, 
                    "retentionPoint": 0.77, 
                    "supportAgents": ""
                }
            ], 
            "refundBaseType": 0, 
            "refundPriceInfo": "", 
            "refundTime": "{'1':'00:00-23:59','2':'00:00-23:59','3':'00:00-23:59','4':'00:00-23:59','5':'00:00-23:59','6':'00:00-23:59','7':'00:00-23:59'}", 
            "refundType": 0, 
            "saleEndDate": "2014-11-30", 
            "saleStartDate": "2013-10-17", 
            "tuigaiqianInfo": "如果是私有运价政策（带有价格），必须传退改签。如果公布运价（不带有价格）不填， 淘宝根据旅行有效期、航空公司、舱位匹配FD退改签", 
            "segments": [
                {
                    "cabinList": "P,A,D,F,C,Z,J,W,Y,B,H,M1,H1,K,K1,L,M,L1,Q,Q1,G,V", 
                    "depTimeRanges": "", 
                    "excludeFlightNos": "", 
                    "includeFlightNos": "", 
                    "operationTime": "1234567", 
                    "segmentNum": "00", 
                    "travelEndDate": "2014-11-30", 
                    "travelStartDate": "2013-10-17"
                }
            ], 
            "timestamp": 1387800319218, 
            "supplierId": "", 
            "supplierOfficeId": "KMG236", 
            "tripType": 0, 
            "workTime": "{'1':'00:00-23:59','2':'00:00-23:59','3':'00:00-23:59','4':'00:00-23:59','5':'00:00-23:59','6':'00:00-23:59','7':'00:00-23:59'}"
        }
    ]
}

• 错误定义

ErrorCode	错误说明	备注
-200	政策压缩文件不存在

FAQ