淘宝开放平台

登录
文档中心 > API类目 > 分销API

分销API

taobao.fenxiao.yph.order.get (一盘货商家单个查询采购单信息)

一盘货商家单个查询采购单信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
user_role_type Number 可选 2 当前查询用户的角色 当不指定时，默认为供应商 供应商：2，分销商：1
purchase_order_id Number 必须 38894321109601 采购单id，单个查询此参数必填

响应参数

名称 类型 示例值 描述
purchase_order PurchaseOrder null 返回的采购单对象
  • └ pay_order_id
  • String
  • null
  • 支付宝交易号
  • └ logistics_id
  • String
  • LP00171160470913-1
  • 运单号
  • └ pay_time
  • Date
  • 2000-01-01 00:00:00
  • 采购单付款时间。格式:yyyy-MM-dd HH:mm:ss
  • └ memo
  • String
  • null
  • 采购单留言，默认是分销商留言。在代销模式下信息包括消费者（买家）留言和分销商留言信息
  • └ buyer_actual_pay_yuan
  • String
  • 0.00
  • 采购单主单买家实付金额，当tc主单只有一个供应商时该字段才有值
  • └ pay_type
  • Number
  • 102
  • 支付方式，枚举：101-支付宝担保交易；102-代销分账；103-即时到账；104-预存款；201-线下转账汇款交易；301-资金账户预存款交易；302-资金账户即时到账交易；303-先款后货；401-账期支付；402-国际分账；403-直营无需支付；404-外币分账；10000-无需支付
  • └ consign_time
  • Date
  • 2000-01-01 00:00:00
  • 发货时间，格式:yyyy-MM-dd HH:mm:ss
  • └ shipping
  • Number
  • 2
  • 配送方式，枚举：1-平邮；2-快递；3-ems；4-虚拟物品
  • └ logistics_company_name
  • String
  • 这是一条物流公司名称
  • 物流公司名称
  • └ alipay_order_no
  • String
  • null
  • 支付宝交易号，担保交易使用。
  • └ distributor_nick
  • String
  • 商家测试帐号86
  • 分销商昵称
  • └ postage_yuan
  • String
  • 0.00
  • 邮费，单位：元
  • └ supplier_memo
  • String
  • null
  • 供应商备注信息。 只有供应商身份查询输出此信息。
  • └ biz_order_id
  • String
  • 38894321109601
  • 采购单编号
  • sub_order_detail_yph_list
  • SubOrderDetail []
  • null
  • 子采购单详情
  • └ refund_fee
  • Number
  • 0
  • 退款金额，单位：分
  • └ buyer_pay_price
  • Number
  • 0
  • 买家实付金额，单位：分
  • └ buy_num
  • Number
  • 1
  • 购买数量
  • └ discount_fee_yuan
  • String
  • 0.00
  • 消费者订单优惠金额，始终为正数，单位是元
  • └ discount_fee
  • Number
  • 0
  • 消费者订单优惠金额，始终为正数，单位是分，不带小数
  • └ sub_tc_order_id
  • Number
  • 909290401055549000
  • 前台子订单id
  • └ sku_property_val
  • String
  • 颜色分类：仅共享
  • sku属性值
  • └ confirm_paid_fee
  • Number
  • 0
  • 确认收货金额，单位：分
  • └ distributor_pay_price_yuan
  • String
  • 0.00
  • 分销商实付金额，单位：元
  • └ bill_fee
  • Number
  • 0
  • 发票应开金额。 子单的消费者实付分摊金额。根据买家实际付款去除邮费后，按各个子单(商品)金额比例进行分摊后的金额，仅供开发票时做票面金额参考。单位：分
  • └ title
  • String
  • 【测试，请不要拍】测试专用，勿动，请自重-多SKU-03
  • 商品标题
  • └ real_auction_id
  • Number
  • 613697976491
  • 消费者购买宝贝ID，不存在时为0。 2015年4月15日之前创建的采购单该字段都是0。
  • └ refund_fee_yuan
  • String
  • 0.00
  • 退款金额，单位：元
  • └ real_auction_sku_id
  • Number
  • 4496911555141
  • 消费者购买宝贝SKU ID，不存在时为0。 2015年3月15日之前创建的采购单该字段都是0。
  • └ sub_order_id
  • Number
  • 0
  • 子采购单id
  • └ price
  • Number
  • 0
  • 单个商品价格
  • └ tc_discount_fee
  • Number
  • 0
  • 优惠金额，始终为正数，单位是分，不带小数
  • └ confirm_paid_fee_yuan
  • String
  • 0.00
  • 确认收货金额，单位：元
  • └ buyer_pay_price_yuan
  • String
  • 0.00
  • 买家实付金额，单位：元
  • └ old_sku_property_val
  • String
  • 颜色分类：仅共享
  • 老的sku属性值
  • └ alipay_order_no
  • String
  • 123131241
  • 支付宝交易号，担保交易使用。
  • └ promotion_type
  • String
  • 0
  • 采购子订单优惠活动类型。0=无优惠；1=限时折
  • └ snap_path
  • String
  • https://gongxiao.tmall.com/product/product_snapshot.htm?subOrderId=38894321109601
  • 图片地址
  • └ distributor_price
  • Number
  • 0
  • 分销商应付金额，单位：分
  • └ sc_item_id
  • Number
  • 613702760269
  • 后端商品id
  • └ fenxiao_id
  • Number
  • 38894321109601
  • 分销采购单号（分销流水号）
  • └ tc_adjust_fee
  • Number
  • 0
  • 商品的卖出金额调整，金额增加时为正数，金额减少时为负数，单位是分，不带小数
  • └ gmt_create
  • Date
  • 2000-01-01 00:00:00
  • 子采购单创建时间
  • └ auction_seller_sku_id
  • Number
  • null
  • sku商家编码
  • └ auction_id
  • Number
  • 613694296654
  • 消费者购买宝贝ID，不存在时为0。 2015年4月15日之前创建的采购单该字段都是0。
  • └ tc_preferential_type
  • String
  • 聚划算
  • 商品优惠类型：聚划算、秒杀或其他
  • └ auction_sku_id
  • Number
  • 4493468966531
  • 产品sku id
  • └ bill_fee_yuan
  • String
  • 100
  • 发票应开金额。 子单的消费者实付分摊金额。根据买家实际付款去除邮费后，按各个子单(商品)金额比例进行分摊后的金额，仅供开发票时做票面金额参考。单位：元
  • └ auction_price
  • String
  • 0.01
  • 分销商店铺中宝贝一口价，消费者看见的宝贝价格。单位元 代销场景下存在，此价格不是实付款的价格。
  • └ price_yuan
  • String
  • 0.00
  • 单个商品价格，单位：元
  • └ order_200_status
  • String
  • TRADE_FINISHED
  • 消费者的交易订单状态（代销采购单对应下游200订单状态）。 可选值： WAIT_SELLER_SEND_GOODS(已付款，待发货) WAIT_BUYER_CONFIRM_GOODS(已付款，已发货) TRADE_CLOSED(已退款成功) TRADE_REFUNDING(退款中) TRADE_FINISHED(交易成功) TRADE_CLOSED_BY_TAOBAO(交易关闭)
  • └ distributor_pay_price
  • Number
  • 0
  • 分销商实付金额，单位：分
  • └ distributor_price_yuan
  • String
  • 0.00
  • 分销商应付金额，单位：元
  • └ status
  • String
  • TRADE_FINISHED
  • 交易状态，枚举：WAIT_BUYER_PAY-等待付款；WAIT_SELLER_CONFIRM-付款信息待确认，待发货；WAIT_SELLER_SEND_GOODS-已付款，待发货；WAIT_BUYER_CONFIRM_GOODS-已付款，已发货；TRADE_FINISHED-交易成功；TRADE_CLOSED-交易关闭
  • └ refund_status_code
  • String
  • RF_STATUS_NO_REFUND
  • 子采购单退款状态，枚举：RF_STATUS_NO_REFUND-没有申请退款；RF_STATUS_REFUNDING-退款中；RF_STATUS_END_REFUND-退款结束，退款成功或者退款关闭都会走到这里
  • └ refund_status
  • Number
  • 9
  • 子采购单退款状态-数字形式，枚举：9-没有申请退款；20-退款中；21-退款结束，退款成功或者退款关闭都会走到这里
  • └ sub_order_status
  • Number
  • 70
  • 子采购单交易状态-数字表示，枚举：10-意向单审核中；20-订单付款前锁定；30-待分货；40-分货中；50-订单等待付款；55-已付款待确认付款操作；60-已付款；70-已提交交货；80-已发货；90-已提交确认收货，但收货未完成；100-交易关闭；110-交易成功
  • └ sub_order_status_code
  • String
  • DELIVERED
  • 子采购单交易状态，枚举：AUDITING-意向单审核中；LOCKED-订单付款前锁定；WAIT_FOR_ALLOCATE_GOODS-待分货；ALLOCATING-分货中；WAIT_FOR_PAY-等待付款；PAID_WAIT_FOR_CONFIRM-已付款待确认付款操作；PAID-已确认付款，可直接发货；DELIVERED-已提交交货；CONSIGNED-已发货；RECEIVING-已提交确认收货，但收货未完成；ORDER_CLOSE-交易关闭；ORDER_SUCCESS-交易成功
  • └ auction_out_id
  • String
  • OUT1100000
  • 商品商家编码，供应商发布产品时定义的产品编码
  • └ secondary_supplier_id
  • Number
  • 1000000000012345
  • 二级供应商id
  • └ tp_create_time_price
  • BigDecimal
  • 9.00
  • tp单创单时间的货品采购单价
  • features
  • FeatureDO []
  • 建议废弃 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_key
  • String
  • 123
  • 属性键
  • └ attr_value
  • String
  • 222
  • 属性值
  • └ auction_out_sku_id
  • String
  • 5555
  • SKU商家编码，供应商发布产品SKU是定义的编码
  • └ gmt_modified
  • Date
  • 2000-01-01 00:00:00
  • 采购单最后更新时间，包括订单状态变更和订单操作。格式:yyyy-MM-dd HH:mm:ss
  • └ total_price
  • Number
  • 0
  • 采购单总额（不含邮费）
  • └ tc_order_id
  • Number
  • 909290401055549000
  • 消费者主订单ID （经销模式下，不存在该单号）
  • └ order_status_code
  • String
  • TRADE_FINISHED
  • 交易状态，枚举：WAIT_BUYER_PAY-等待付款；WAIT_SELLER_CONFIRM-付款信息待确认，待发货；WAIT_SELLER_SEND_GOODS-已付款，待发货；WAIT_BUYER_CONFIRM_GOODS-已付款，已发货；TRADE_FINISHED-交易成功；TRADE_CLOSED-交易关闭
  • └ confirm_paid_fee
  • Number
  • 0
  • 已执行确认收货的金额，单位：分
  • └ supplier_flag
  • Number
  • 1
  • 供应商备注旗帜vlaue在1-5之间。 非1-5之间，都采用1作为默认。 1:红色 2:黄色 3:绿色 4:蓝色 5:粉红色 供应商角色查询返回
  • └ distributor_pay_price_yuan
  • String
  • 0.00
  • 分销商实付金额，单位：元
  • └ supplier_nick
  • String
  • 商家测试帐号42
  • 供应商昵称
  • └ confirm_paid_fee_yuan
  • String
  • 0.00
  • 确认收货金额，单位：元
  • └ trade_type
  • Number
  • 1
  • 交易模式（分销方式）：1-代销；2-经销；5-寄售；6-平台寄售
  • └ channel_code
  • Number
  • 302
  • 渠道市场编码，可批量指定。 当不指定时，按照配置的分销市场生效 渠道编码枚举：1-供销平台（淘宝）；2-供销平台（天猫）；3-供销平台（天猫超市）；5-供销平台（淘乡甜）；110001-供销平台（全球购）；110007-淘分销；200002-消费电子市场；302-猫超一盘货；506-虾选一盘货
  • └ buyer_actual_pay
  • Number
  • 0
  • 采购单主单买家实付金额，当前台主单只有一个供应商时该字段才有值，单位：分
  • └ fenxiao_id
  • Number
  • 38894321109601
  • 分销采购单号（分销流水号）
  • └ gmt_create
  • Date
  • 1585130279000
  • 采购单创建时间
  • └ postage
  • Number
  • 0
  • 邮费，单位：分
  • └ supplier_from_sys
  • Number
  • 1
  • 供应商来源网站，1-淘宝，2-阿里巴巴
  • └ distributor_from_sys
  • String
  • taobao
  • 分销商来源网站
  • └ end_time
  • Date
  • 2000-01-01 00:00:00
  • 订单结束时间
  • └ distributor_pay_price
  • Number
  • 0
  • 分销商实付金额，单位：分
  • └ total_price_yuan
  • String
  • 0.00
  • 采购单总价，单位：元
  • └ order_status
  • Number
  • 6
  • 主采购单交易状态-数字表示，枚举：1-已付款，待发货；2-待确认收款；4-等待买家付款；5-已付款，已发货；6-交易成功；7-交易关闭；8-已付款；
  • └ refund_status
  • Number
  • 9
  • 主采购单退款状态-数字表示，枚举：9-没有过申请退款；10-退款活动中,至少有一个子单在退款中；11-退款结束，即曾经发生过退款且所有退款都完结了
  • └ refund_status_code
  • String
  • ORDER_RF_NO_REFUND
  • 主采购单退款状态，枚举：ORDER_RF_NO_REFUND-没有过申请退款；ORDER_RF_REFUNDING-退款活动中,至少有一个子单在退款中；ORDER_RF_END_REFUND-退款结束，即曾经发生过退款且所有退款都完结了
  • └ logis_type
  • String
  • 菜鸟仓
  • 寄售模式文字（菜鸟仓，商家仓，门店发货）
  • └ logis_type_code
  • Number
  • 0
  • 寄售模式code（0-菜鸟仓，1-商家仓，2-门店发货）
  • dp_buyer_detail
  • DpBuyerDetail
  • 消费者信息（收货人姓名、收货人手机、收货人电话、收货人邮编、收货人省份、收货人详细地址）
  • └ area
  • String
  • 余杭区
  • 地区
  • └ address
  • String
  • 收货地址
  • 收货地址
  • └ mobile_phone
  • String
  • 12345678910
  • 移动电话
  • └ post
  • String
  • 610000
  • 邮编
  • └ city
  • String
  • 杭州市
  • 城市
  • └ phone
  • String
  • 123456
  • 固定电话
  • └ full_name
  • String
  • 收货人全名
  • 收货人全名
  • └ prov
  • String
  • 浙江省
  • 省份
  • └ oaid
  • String
  • xxxxxxx
  • 收件人ID (Open Addressee ID)，长度在128个字符之内。
  • features
  • FeatureDO []
  • 建议废弃 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_key
  • String
  • 123
  • 属性键
  • └ attr_value
  • String
  • 111
  • 属性值
result_code String SYSTEM_EXCEPTION 返回错误码
remark String 系统错误 返回错误信息
opt_time Date 2000-01-01 00:00:00 操作时间

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FenxiaoYphOrderGetRequest req = new FenxiaoYphOrderGetRequest();
req.setUserRoleType(2L);
req.setPurchaseOrderId(38894321109601L);
FenxiaoYphOrderGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
<fenxiao_yph_order_get_response>
    <purchase_order>
        <pay_order_id>null</pay_order_id>
        <logistics_id>LP00171160470913-1</logistics_id>
        <pay_time>2000-01-01 00:00:00</pay_time>
        <memo>null</memo>
        <buyer_actual_pay_yuan>0.00</buyer_actual_pay_yuan>
        <pay_type>102</pay_type>
        <consign_time>2000-01-01 00:00:00</consign_time>
        <shipping>2</shipping>
        <logistics_company_name>这是一条物流公司名称</logistics_company_name>
        <alipay_order_no>null</alipay_order_no>
        <distributor_nick>商家测试帐号86</distributor_nick>
        <postage_yuan>0.00</postage_yuan>
        <supplier_memo>null</supplier_memo>
        <biz_order_id>38894321109601</biz_order_id>
        <sub_order_detail_yph_list>
            <sub_order_detail>
                <refund_fee>0</refund_fee>
                <buyer_pay_price>0</buyer_pay_price>
                <buy_num>1</buy_num>
                <discount_fee_yuan>0.00</discount_fee_yuan>
                <discount_fee>0</discount_fee>
                <sub_tc_order_id>909290401055549000</sub_tc_order_id>
                <sku_property_val>颜色分类：仅共享</sku_property_val>
                <confirm_paid_fee>0</confirm_paid_fee>
                <distributor_pay_price_yuan>0.00</distributor_pay_price_yuan>
                <bill_fee>0</bill_fee>
                <title>【测试，请不要拍】测试专用，勿动，请自重-多SKU-03</title>
                <real_auction_id>613697976491</real_auction_id>
                <refund_fee_yuan>0.00</refund_fee_yuan>
                <real_auction_sku_id>4496911555141</real_auction_sku_id>
                <sub_order_id>0</sub_order_id>
                <price>0</price>
                <tc_discount_fee>0</tc_discount_fee>
                <confirm_paid_fee_yuan>0.00</confirm_paid_fee_yuan>
                <buyer_pay_price_yuan>0.00</buyer_pay_price_yuan>
                <old_sku_property_val>颜色分类：仅共享</old_sku_property_val>
                <alipay_order_no>123131241</alipay_order_no>
                <promotion_type>0</promotion_type>
                <snap_path>https://gongxiao.tmall.com/product/product_snapshot.htm?subOrderId=38894321109601</snap_path>
                <distributor_price>0</distributor_price>
                <sc_item_id>613702760269</sc_item_id>
                <fenxiao_id>38894321109601</fenxiao_id>
                <tc_adjust_fee>0</tc_adjust_fee>
                <gmt_create>2000-01-01 00:00:00</gmt_create>
                <auction_seller_sku_id>null</auction_seller_sku_id>
                <auction_id>613694296654</auction_id>
                <tc_preferential_type>聚划算</tc_preferential_type>
                <auction_sku_id>4493468966531</auction_sku_id>
                <bill_fee_yuan>100</bill_fee_yuan>
                <auction_price>0.01</auction_price>
                <price_yuan>0.00</price_yuan>
                <order_200_status>TRADE_FINISHED</order_200_status>
                <distributor_pay_price>0</distributor_pay_price>
                <distributor_price_yuan>0.00</distributor_price_yuan>
                <status>TRADE_FINISHED</status>
                <refund_status_code>RF_STATUS_NO_REFUND</refund_status_code>
                <refund_status>9</refund_status>
                <sub_order_status>70</sub_order_status>
                <sub_order_status_code>DELIVERED</sub_order_status_code>
                <auction_out_id>OUT1100000</auction_out_id>
                <secondary_supplier_id>1000000000012345</secondary_supplier_id>
                <tp_create_time_price>9.00</tp_create_time_price>
                <features>
                    <feature_d_o>
                        <attr_key>123</attr_key>
                        <attr_value>222</attr_value>
                    </feature_d_o>
                </features>
                <auction_out_sku_id>5555</auction_out_sku_id>
            </sub_order_detail>
        </sub_order_detail_yph_list>
        <gmt_modified>2000-01-01 00:00:00</gmt_modified>
        <total_price>0</total_price>
        <tc_order_id>909290401055549000</tc_order_id>
        <order_status_code>TRADE_FINISHED</order_status_code>
        <confirm_paid_fee>0</confirm_paid_fee>
        <supplier_flag>1</supplier_flag>
        <distributor_pay_price_yuan>0.00</distributor_pay_price_yuan>
        <supplier_nick>商家测试帐号42</supplier_nick>
        <confirm_paid_fee_yuan>0.00</confirm_paid_fee_yuan>
        <trade_type>1</trade_type>
        <channel_code>302</channel_code>
        <buyer_actual_pay>0</buyer_actual_pay>
        <fenxiao_id>38894321109601</fenxiao_id>
        <gmt_create>1585130279000</gmt_create>
        <postage>0</postage>
        <supplier_from_sys>1</supplier_from_sys>
        <distributor_from_sys>taobao</distributor_from_sys>
        <end_time>2000-01-01 00:00:00</end_time>
        <distributor_pay_price>0</distributor_pay_price>
        <total_price_yuan>0.00</total_price_yuan>
        <order_status>6</order_status>
        <refund_status>9</refund_status>
        <refund_status_code>ORDER_RF_NO_REFUND</refund_status_code>
        <logis_type>菜鸟仓</logis_type>
        <logis_type_code>0</logis_type_code>
        <dp_buyer_detail>
            <area>余杭区</area>
            <address>收货地址</address>
            <mobile_phone>12345678910</mobile_phone>
            <post>610000</post>
            <city>杭州市</city>
            <phone>123456</phone>
            <full_name>收货人全名</full_name>
            <prov>浙江省</prov>
            <oaid>xxxxxxx</oaid>
        </dp_buyer_detail>
        <features>
            <feature_d_o>
                <attr_key>123</attr_key>
                <attr_value>111</attr_value>
            </feature_d_o>
        </features>
    </purchase_order>
    <result_code>SYSTEM_EXCEPTION</result_code>
    <remark>系统错误</remark>
    <opt_time>2000-01-01 00:00:00</opt_time>
</fenxiao_yph_order_get_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

API测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部