跳转到内容
返回官网

淘宝采购单付款消息

一、消息说明

当分销商在淘宝分销平台下单付款后,产生此消息, 供应商可以收到此付款订单, 需要注意的是这里是供应商发货,因此调物流发货接口时需要传人供应商账号对应的sessionkey,tid 需传入供销平台的采购单(即fenxiao_id 分销流水号)。 消息主题topic为:tb_fenxiao_fxorderpaid,推送的消息内容如下:

{
"uuid":"204777475",
"code":0,
"msg":"success",
"topic":"tb_fenxiao_fxorderpaid",
"data":"{\"alipay_no\":\"null\",\"buyer_payment\":\"76.90\",\"created\":\"2022-05-18 09:22:18\",\"distributor_from\":\"taobao\",\"distributor_payment\":\"0.00\",\"distributor_username\":\"苏宁易购官方旗舰店\",\"features\":[{\"attr_key\":\"orderNovice\",\"attr_value\":\"个人\"},{\"attr_key\":\"orderNoviceContent\",\"attr_value\":\"明细\"},{\"attr_key\":\"erpHold\",\"attr_value\":\"0\"},{\"attr_key\":\"sc_itemid\",\"attr_value\":\"s_669843701138\"}],\"fenxiao_id\":58662523595681,\"id\":58662523595681,\"memo\":\"\",\"modified\":\"2022-05-18 09:31:22\",\"pay_type\":\"ALIPAY_CHAIN\",\"post_fee\":\"0.00\",\"receiver\":{\"address\":\"宝都街道新昌路天盛花苑\",\"city\":\"潍坊市\",\"district\":\"昌乐县\",\"mobile_phone\":\"$8HzfojJ1Ky\\/F7SMkU1F8rA==$qcu4c6KTSI0zICv7WAdZlg==$-1$$\",\"name\":\"~0sLYpuvVaR+EdboBjlsjvQ==~CzeD~-1~~\",\"oaid\":\"1EhoZT71v7A9ESnXbt4CtJZJUGKtKtNxCnibxjDtsR8kiczRqkG2MoLPix1bicMCudT7Cxc750\",\"state\":\"山东省\",\"zip\":\"000000\"},\"shipping\":\"SELLER\",\"status\":\"WAIT_BUYER_PAY\",\"sub_purchase_orders\":[{\"auction_id\":670334829992,\"auction_price\":\"92.00\",\"auction_sku_id\":4826905881077,\"bill_fee\":\"76.90\",\"buyer_payment\":\"76.90\",\"created\":\"2022-05-18 09:22:18\",\"discount_fee\":\"0.00\",\"distributor_payment\":\"76.90\",\"fenxiao_id\":58662523595681,\"id\":0,\"item_id\":669457388556,\"num\":1,\"old_sku_properties\":\"颜色分类:波浪枕40*60cm(送针织枕套+透气内套)\",\"order200_status\":\"WAIT_SELLER_SEND_GOODS\",\"price\":\"89.90\",\"promotion_type\":\"0\",\"refund_fee\":\"0.00\",\"sc_item_id\":669843701138,\"sku_id\":4996428367170,\"sku_outer_id\":\"波浪枕40*60cm(送针织枕套+透气内套)\",\"sku_properties\":\"颜色分类:波浪枕40*60cm(送针织枕套+透气内套)\",\"snapshot_url\":\"https:\\/\\/gongxiao.tmall.com\\/product\\/product_snapshot.htm?subOrderId=58662523595681\",\"status\":\"WAIT_BUYER_PAY\",\"tc_adjust_fee\":0,\"tc_discount_fee\":1510,\"tc_order_id\":2637395211006498733,\"tc_preferential_type\":\"优惠\",\"title\":\"囡囡家纺泰国皇家天然乳胶枕头护颈枕颈椎枕枕芯成人橡胶枕记忆枕\",\"total_fee\":\"89.90\"}],\"supplier_flag\":0,\"supplier_from\":\"taobao\",\"supplier_memo\":\"\",\"supplier_username\":\"南京云汇供应商\",\"tc_order_id\":2637395211006498733,\"total_fee\":\"76.90\",\"trade_type\":\"AGENT\"}"
}

说明:

  1. 如果data字段为分销订单数据,如果字段为空,则不会返回相关字段。换句话说,data中的订单字段个数不是固定的,取决 于订单本身的内容。

  2. 对于接收侧,建议使用json反序列化,避免直接对字段取值。

二、订单的完整字段说明

字段类型示例说明
supplier_fromStringvalues: taobao供应商来源网站。 入驻时定义供应商来源的外部系统编码, values: taobao, alibaba
supplier_usernameStringzhangsan供应商昵称(在来源网站的帐号名)
distributor_usernameStringzhangsan分销商昵称(在来源网站的帐号名)。
createdDate2000-01-01 00:00:00采购单创建时间。格式:yyyy-MM-dd HH:mm:ss
alipay_noString200010507220088888888449086137支付宝交易号,在分销商使用担保交易支付时存在。 来源主订单的payOrderId。
total_feeString200.07应付采购单总额(不含邮费,精确到2位小数;单位:元。如:200.07,表示:200元7分 ) 计算公式: SUM(子单采购价 * 子单采购数量 - 子单折扣)+ 主单调整金额 - 主单折扣
post_feeString200.07采购单邮费。(改价后最新邮费,精确到2位小数;单位:元。如:8.07,表示:8元7分 )
distributor_paymentString200.07分销商实付金额。(精确到2位小数;单位:元。如:208.14,表示:208元1角4分 )
snapshot_urlStringwww.vancl.com交易订单快照URL(该字段废弃)
pay_timeDate2000-01-01 00:00:00采购单付款时间。格式:yyyy-MM-dd HH:mm:ss
consign_timeDate2000-01-01 00:00:00采购单物流发货时间。格式:yyyy-MM-dd HH:mm:ss
modifiedDate2000-01-01 00:00:00采购单最后修改时间(包括订单状态变更和订单操作)。格式:yyyy-MM-dd HH:mm:ss
+ receiverTopReceiverDo买家详细信息
— nameStringzhangsan— 收货人全名
— phoneString57188155188固定电话
— mobile_phoneString13812345678移动电话
— addressString文一西路969号收货人的详细地址信息
— districtString余杭区区/县
— cityString杭州市收货人的城市
— zipString310000邮政编码
— stateString浙江省收货人所在省份
— oaidStringxxxx收件人ID (Open Addressee ID),长度在128个字符之内。
supplier_memoString供应商信息描述供应商备注信息。 只有供应商身份查询输出此新信息
fenxiao_idNumber1001分销采购单号(分销流水号)
pay_typeStringALIPAY_SURETY支付方式:ALIPAY_SURETY(支付宝担保交易)、ALIPAY_CHAIN(分账交易)、TRANSFER(线下转账)、PREPAY(预存款)、IMMEDIATELY(即时到账)、CASHGOODS(先款后货)、ACCOUNT_PERIOD(账期支付)
trade_typeStringAGENT交易模式(分销方式):AGENT(代销)、DEALER(经销)、INSTEAD_SALE(代售)、CONSIGNMENT(自营寄售)、PLATFORM_CONSIGNMENT(平台寄售)
distributor_fromStringtaobao建议废弃: 分销商来源网站。 入驻时定义分销商来源的外部系统编码, 目前固定值: taobao
idNumber555废弃:如果是担保交易此值是TP800的交易单号,其他情况是采购单单号
statusStringTRADE_FINISHED(交易成功)采购单交易状态。 可选值: WAIT_BUYER_PAY(等待付款) WAIT_SELLER_SEND_GOODS(已付款,待发货) WAIT_BUYER_CONFIRM_GOODS(已付款,已发货) PAID_FORBID_CONSIGN(已付款,禁止发货 ps:只有大快消行业的才有) TRADE_FINISHED(交易成功) TRADE_CLOSED(交易关闭) WAIT_BUYER_CONFIRM_GOODS_ACOUNTED(已付款(已分账),已发货。只对代销分账支持) PAY_ACOUNTED_GOODS_CONFIRM (已分账发货成功) PAY_WAIT_ACOUNT_GOODS_CONFIRM(已付款,确认收货)
buyer_nickStringzhangsan消费者(买家)nick,供应商查询不会返回买家昵称,分销商查询才会返回。
memoString留言。采购单留言,默认是分销商留言。在代销模式下信息包括消费者(买家)留言和分销商留言信息
tc_order_idNumber157026218599994214消费者主订单ID (经销模式下,不存在该单号)
shippingStringFAST物流配送方式,发货后有此数据。 对应的值:FAST(快速)、EMS、ORDINARY(平邮)、SELLER(卖家包邮)
logistics_company_nameStringEMS物流公司名称
logistics_idString123123运单号
isv_custom_keyString[]isv_custom_keyISV自定义key,通过taobao.fenxiao.order.customfield.update 写入。目前禁用
isv_custom_valueString[]isv_custom_valueISV自定义值,通过taobao.fenxiao.order.customfield.update 写入。目前禁用
end_timeDate2000-01-01 00:00:00交易结束时间。 如果交易成功此时间表示交易成功时间,如果交易关闭,此时间表示交易关闭时间。
supplier_flagNumber1供应商备注旗帜vlaue在1-5之间。 非1-5之间,都采用1作为默认。 1:红色 2:黄色 3:绿色 4:蓝色 5:粉红色 供应商角色查询返回
buyer_paymentString200.07消费者(买家)支付给分销商的主单的实际总金额。 注意买家购买的商品可能不是全部来自同一供货商,所以此金额不代表供应商销售商品消费者的实付款。请同时参考子单上的相关金额。(精确到2位小数;单位:元。如:200.07,表示:200元7分)
+ order_messagesOrderMessages[]采购单留言列表,如果是代销,包含消费者留言。
— message_timeDate2000-01-01 00:00:00留言时间
— message_titleString分销商留言留言标题,例如:分销商留言,供应商留言,买家留言
— message_contentString留言内容留言内容
— pic_urlString1留言时的图片地址
+ sub_purchase_ordersSubOrderDetail[]详细列表子订单的详细信息列表
— item_outer_idStringOUT00001商品商家编码,供应商发布产品是定义的产品编码
— sku_outer_idString5555SKU商家编码,供应商发布产品SKU是定义的编码
— sku_propertiesString颜色:红色SKU属性值。如: 颜色:红色:别名;尺码:L:别名
— snapshot_urlStringwww.vancl.com废弃: 产品快照地址
— createdDate2000-01-01 00:00:00子单创建时间。格式 yyyy-MM-dd HH:mm:ss 。
— statusStringWAIT_BUYER_PAY(等待买家付款)采购单交易状态。 可选值: WAIT_BUYER_PAY(等待付款) WAIT_SELLER_CONFIRM(付款信息待确认,待发货) WAIT_SELLER_SEND_GOODS(已付款,待发货) WAIT_BUYER_CONFIRM_GOODS(已付款,已发货) TRADE_FINISHED(交易成功) TRADE_CLOSED(交易关闭) TRADE_REFUNDING(退款中) TRADE_REFUNDED(已退款) PAID_FORBID_CONSIGN(已付款, 禁止发货(大快消行业)) WAIT_BUYER_CONFIRM_GOODS_ACOUNTED(已付款(已分账),已发货。只对代销分账支持) PAY_ACOUNTED_GOODS_CONFIRM (已分账发货成功) PAY_WAIT_ACOUNT_GOODS_CONFIRM(已付款,确认收货)
— refund_feeString12.23退款金额,单位元。(精确到2位小数;单位:元。如:12.23,表示:12元2角3分)
— idNumber5552建议废弃:只有当担保交易支付时存在,为TP800的订单编号 子采购单id,淘宝交易主键,采购单未付款时为0.(只有支付宝 付款才有这个id,其余付款形式该字段为0)
— fenxiao_idNumber46467999930382子采购单编号
— sku_idNumber555分销产品的SKU ID。 当存在时才会有值,建议使用sku_outer_id,sku_properties这两个值
tc_order_idNumber157026218599994214消费者订单子订单ID(经销模式下不存在该值)
— item_idNumber620019999537分销平台上的产品id
— order_200_statusStringPAID_SEND_GOODS消费者的交易订单状态(代销采购单对应下游200订单状态)。 可选值: WAIT_SELLER_SEND_GOODS(已付款,待发货) WAIT_BUYER_CONFIRM_GOODS(已付款,已发货) TRADE_CLOSED(已退款成功) TRADE_REFUNDING(退款中) TRADE_FINISHED(交易成功) TRADE_CLOSED_BY_TAOBAO(交易关闭)
— auction_priceString100.10分销商店铺中宝贝一口价,消费者看见的宝贝价格。单位元 代销场景下存在,此价格不是实付款的价格。
— numNumber50产品的采购数量。取值范围:大于零的整数
— titleString裙子采购的产品标题。
— priceString50产品的采购价格。(精确到2位小数;单位:元。如:200.07,表示:200元7分)
— total_feeString200.07分销商应付金额。 计算公式:num(采购数量)*price(采购价) - 折扣。(精确到2位小数;单位:元。如:200.07,表示:200元7分)
— distributor_paymentString200.07分销商实付金额。 total_fee(分销商应付金额)+ 改价。(精确到2位小数;单位:元。如:200.07,表示:200元7分)
— buyer_paymentString200.07买家订单上对应的子单零售金额。 计算公式:消费者订单的成交价 * 购买数量 + 调整金额 - 优惠折扣(精确到2位小数;单位:元。如:200.07,表示:200元7分)
— bill_feeString100.10发票应开金额。 子单的消费者实付分摊金额。根据买家实际付款去除邮费后,按各个子单(商品)金额比例进行分摊后的金额,仅供开发票时做票面金额参考。
— sc_item_idNumber100000000后端商品id
— tc_preferential_typeString聚划算商品优惠类型:聚划算、秒杀或其他
— tc_discount_feeNumber1000优惠金额,始终为正数,单位是分,不带小数
— tc_adjust_feeNumber1000商品的卖出金额调整,金额增加时为正数,金额减少时为负数,单位是分,不带小数
— discount_feeString11.11消费者订单优惠金额,始终为正数,单位是分,不带小数
— promotion_typeString1采购子订单优惠活动类型。0=无优惠;1=限时折
++ featuresFeatureDo[]a:b;c:d建议废弃 Feature对象列表目前已有的属性: attr_key为 www,attr_value为1 表示是www子订单; attr_key为 wwwStoreCode,attr_value是www子订单发货的仓库编码; attr_key为 isWt,attr_value为1 表示是网厅子订单; attr_key为wtInfo,attr_value为网厅相关合约信息; attr_key为shipper,attr_value为cn表示菜鸟发货; attr_key为 storeCode,attr_value为仓库信息; attr_key为 erpHold,attr_value为1表示强管控中, attr_value为2表示分单完成;
—— attr_keyString1234属性键
—— attr_valueString2342属性值
— auction_sku_idNumber100消费者购买宝贝SKU ID,不存在时为0。 2015年3月15日之前创建的采购单该字段都是0。
— auction_idNumber100消费者购买宝贝ID,不存在时为0。 2015年4月15日之前创建的采购单该字段都是0。
++ top_memoTopMemoDto子订单留言信息
—— remarkString123子订单备注内容
—— operate_user_nickString123操作者昵称
++ attachmentsTopMemoAttachment[]123附件
—— urlString123附件地址
—— nameString123附件名称
—— old_sku_propertiesString颜色:红色老的SKU属性值。如: 颜色:红色:别名;尺码:L:别名
buyer_taobao_idStringF21121542129F21121542129F2112154加密后的消费者淘宝ID,长度为32
featuresFeatureDo[]123建议废弃 Feature对象列表目前已有的属性: attr_key为 www,attr_value为1 表示是www子订单; attr_key为 wwwStoreCode,attr_value是www子订单发货的仓库编码; attr_key为 isWt,attr_value为1 表示是网厅子订单; attr_key为wtInfo,attr_value为网厅相关合约信息; attr_key为shipper,attr_value为cn表示菜鸟发货; attr_key为 storeCode,attr_value为仓库信息; attr_key为 erpHold,attr_value为1表示强管控中, attr_value为2表示分单完成;
attr_keyString1234属性键
attr_valueString2342属性值
+ logistics_infosErpLogisticsInfo[][架海金梁独有字段,非架海金梁用户请勿关心]子单物流发货信息
– consign_typeStringcn发货类型 CN=菜鸟发货,SC的商家仓发货
– num_iidNumber12222商品数字编号
– sku_idString213商品的最小库存单位Sku的id
– typeString00子订单类型:标示该子交易单来源交易,还是BMS增加的,枚举值(00=交易,10=BMS绑定)
– store_codeString2223如是菜鸟仓,则将菜鸟仓的区域仓code进行填充,如是商家仓发货则填充SC
– need_consign_numNumber5应发数量
– item_codeString323232货品仓储code
– item_idString2323232货品仓储id
– sub_order_idNumber1100070860173581613采购单子单号
– order_idNumber1100070860172581613采购单号
– combine_item_idString558578215712组合商品ID
– combine_item_codeString1021-0组合商品Code
– item_ratioNumber1组合货品比例
– bar_codeStringa223323货品条码
– delivery_cpsStringSTO推荐配送公司编码
alipay_order_noString2020081222001182111436382503支付宝交易号,担保交易使用。
confirm_paid_fee_yuanString22.22已执行确认收货的金额,单位:元
channel_codeNumber200002渠道(市场)编码,例如消费电子的编码为200002
open_buyer_uidString44544541165消费者淘宝id被加密后的唯一标识
delivery_timeString2019-04-12 16:00:00计划出库时间
sign_timeString2019-04-12 16:00:00计划送达时间
asdp_adsString201,202配送服务,201为驿站送货上门服务,202为顺丰配送服务,里面多个值时用英文逗号隔开
delivery_cpsStringSTO推荐配送公司编码