淘宝开放平台

登录
文档中心 > API类目 > 淘宝定制行业API

淘宝定制行业API

qimen.taobao.industry.dajian.rp.issue.pickup (下发上门或改约信息)

淘宝大件行业退货退款下发上门取件或上门事件改约信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
bizActionTypeCode String 必须 identify 业务动作：identify鉴定｜pickup取件 ｜identifyModify鉴定改约改地址 ｜pickupModify取件改约
doorDate String 可选 2024-03-01 上门日期。yyyy-MM-dd
receiverName String 可选 收件人姓名 收件人姓名
parentTradeId Number 必须 3456 正向交易主订单号
receiverProvince String 可选 江苏省 收货人所在省
receiverCity String 可选 南京市 收货人所在市
operateRole String 必须 1 操作角色。1消费者 | 2商家
receiverAddress String 可选 龙鑫小区 收件人详细地址地址
outItemCode String 可选 外部商品编码 外部商品编码
receiverDivisionId Number 可选 310107017 收件人最小区划（标准地址库ID）
refundCollaborativeCode String 必须 123 行业逆向取退协同单号
receiverDistrict String 可选 江宁区 收货人所在区
extendFields ExtendFields 可选 拓展字段
  • └ orderSellerId
  • String
  • 必须
  • 卖家ID
  • 拓展字段值
  • └ orderSellerNick
  • String
  • 必须
  • 卖家昵称
  • 拓展字段值
  • └ modifyAddress
  • String
  • 必须
  • 1
  • 地址修改。1:消费者修改地址
  • └ refundFee
  • String
  • 可选
  • 1
  • 退款金额(含退平台补贴金额)
  • └ refundReason
  • String
  • 可选
  • 补差价
  • 退款原因
  • └ createOrderType
  • String
  • 可选
  • 超时 | 判罚
  • 创单类型
  • └ triggerSource
  • String
  • 可选
  • timeout
  • 触发源(枚举值，timeout（"系统超时"）、xiaoer（"小二"）、daemon（"系统"）、buyer（"买家"）....)
  • └ refundElapsedTimeCategory
  • String
  • 可选
  • LESS_THAN_7_DAYS
  • 逆向申请历时类别
doorSlice String 可选 day 上门时间片。day:9:00-21:00|
receiverPhone String 可选 13277778888 收件人电话
operatorId String 必须 10086 操作人id。消费者id | 商家id
refundId Number 必须 123 逆向交易订单号
tradeId Number 必须 1234 正向交易子订单号
skuId String 可选 73849573 skuId
receiverTown String 可选 麒麟街道 收件人所在街道
itemId Number 必须 10023 商品ID
itemName String 必须 空调 商品名称
source String 必须 TAOBAO 来源。TAOBAO｜TMALL

响应参数

名称 类型 示例值 描述
success Boolean true 是否成功.true|false
errorCode String PARAM_INVALID 失败编码
errorMsg String 请求参数无效 失败原因

请求示例

{"bizActionTypeCode":"identify","doorDate":"2024-03-01","receiverName":"收件人姓名","parentTradeId":3456,"receiverProvince":"江苏省","source":"TAOBAO","receiverCity":"南京市","operateRole":"1","receiverAddress":"龙鑫小区","outItemCode":"外部商品编码","itemId":10023,"receiverDivisionId":310107017,"itemName":"空调","receiverPhone":"13277778888","refundCollaborativeCode":"123","receiverDistrict":"江宁区","extendFields":{"orderSellerId":"卖家ID","refundFee":"1","modifyAddress":"1","refundReason":"补差价","orderSellerNick":"卖家昵称","createOrderType":"超时 | 判罚","triggerSource":"timeout","refundElapsedTimeCategory":"LESS_THAN_7_DAYS"},"doorSlice":"day","operatorId":"10086","refundId":123,"tradeId":1234,"skuId":"73849573","receiverTown":"麒麟街道"}

响应示例

{
    "success":true,
    "errorCode":"PARAM_INVALID",
    "errorMsg":"请求参数无效"
}

验签示例

{"success":"false","errorCode":"sign-check-failure","errorMsg":"Illegal request"}

错误码解释

错误码 错误描述 解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问
返回
顶部