taobao.fenxiao.yph.orders.get (批量查询一盘货采购单信息)

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
trade_types Number 可选 1 查询的经营模式,当不指定时,默认查询代销订单 代销:1 经销:2 寄售(自营寄售):5 平台寄售:6
page_size Number 必须 50 每页条数。(每页条数不超过50条)
page_num Number 可选 1 页号,不填则默认为1
user_role_type Number 可选 2 当前查询用户的角色 当不指定时,默认为供应商 供应商:2,分销商:1
begin_time Date 必须 2000-01-01 00:00:00 采购单最后更新时间-起始时间,格式 yyyy-MM-dd HH:mm:ss 支持到秒的查询。时间跨度必须在0-7天。
end_time Date 必须 2000-01-01 00:00:00 采购单最后更新时间-结束时间,格式 yyyy-MM-dd HH:mm:ss 支持到秒的查询。时间跨度必须在0-7天。
channel_codes Number 可选 302 渠道市场编码,可批量指定。 当不指定时,按照配置的分销市场生效 渠道编码枚举:1-供销平台(淘宝);2-供销平台(天猫);3-供销平台(天猫超市);5-供销平台(淘乡甜);110001-供销平台(全球购);110007-淘分销;200002-消费电子市场;302-猫超一盘货;506-虾选一盘货
order_status Number 可选 1 主采购单交易状态-数字表示,枚举:1-已付款,待发货;2-待确认收款;4-等待买家付款;5-已付款,已发货;6-交易成功;7-交易关闭;8-已付款;
refund_status Number 可选 9 主采购单退款状态-数字表示,枚举:9-没有过申请退款;10-退款活动中,至少有一个子单在退款中;11-退款结束,即曾经发生过退款且所有退款都完结了

响应参数

名称 类型 示例值 描述
purchase_orders OrderList [] null 采购单及子采购单信息
  • └ alipay_no
  • String
  • null
  • 支付宝交易号,在分销商使用担保交易支付时存在。 来源主订单的payOrderId。
  • └ logistics_id
  • String
  • LP00167730231064-1
  • 运单号
  • └ pay_time
  • Date
  • 2000-01-01 00:00:00
  • 采购单付款时间。格式:yyyy-MM-dd HH:mm:ss
  • └ memo
  • String
  • 这是一条采购单留言
  • 采购单留言
  • └ buyer_actual_pay_yuan
  • String
  • 0.00
  • 采购单主单买家实付金额,当前台订单只有一个供应商时该字段有值。单位:元。
  • └ pay_type
  • Number
  • 10000
  • 支付方式,枚举: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
  • 这是一家物流公司
  • 物流公司
  • └ distributor_nick
  • String
  • 商家测试帐号86
  • 分销商昵称
  • └ postage_yuan
  • String
  • 0.00
  • 采购单邮费
  • └ supplier_memo
  • String
  • 供应商备注
  • 供应商备注信息。 只有供应商身份查询输出此新信息
  • └ biz_order_id
  • String
  • 38913818274736
  • 采购单编号
  • sub_order_detail_yph_list
  • SubOrderList []
  • null
  • 子采购单详情
  • └ refund_fee
  • Number
  • 0
  • 退款金额,单位:分
  • └ buyer_pay_price
  • String
  • 1.00
  • 买家实付金额,单位:元
  • └ buy_num
  • Number
  • 1
  • 购买数量
  • └ discount_fee_yuan
  • String
  • 0.00
  • 优惠活动折扣金额,单位:元
  • └ discount_fee
  • Number
  • 0
  • 优惠活动折扣金额,单位:分
  • └ sub_tc_order_id
  • Number
  • 911465155210793700
  • 子订单的前台订单号
  • └ sku_property_val
  • String
  • 颜色分类:仅共享
  • 商品sku属性值
  • └ confirm_paid_fee
  • Number
  • 0
  • 确认收货金额,单位:分
  • └ distributor_pay_price_yuan
  • String
  • 0.00
  • 分销商实付金额,单位:元
  • └ bill_fee
  • Number
  • 10
  • 发票应开金额。 子单的消费者实付分摊金额。根据买家实际付款去除邮费后,按各个子单(商品)金额比例进行分摊后的金额,仅供开发票时做票面金额参考。
  • └ title
  • String
  • 【测试,请不要拍】至清测试专用,勿动,请自重-多SKU-03
  • 商品标题
  • └ real_auction_id
  • Number
  • 613697976491
  • 消费者购买宝贝ID,不存在时为0。 2015年4月15日之前创建的采购单该字段都是0。
  • └ refund_fee_yuan
  • String
  • 0.00
  • 退款金额,单位:元。(精确到2位小数;单位:元。如:12.23,表示:12元2角3分)
  • └ real_auction_sku_id
  • Number
  • 4496911555141
  • 消费者购买宝贝SKU ID,不存在时为0。 2015年3月15日之前创建的采购单该字段都是0。
  • └ sub_order_id
  • Number
  • 0
  • 采购单子单号
  • └ price
  • Number
  • 0
  • 单个商品价格,单位:分
  • └ tc_discount_fee
  • Number
  • 0
  • 优惠金额,始终为正数,单位是分,不带小数
  • └ confirm_paid_fee_yuan
  • String
  • 0.00
  • 已执行确认收货的金额,单位:元
  • └ buyer_pay_price_yuan
  • String
  • 1.00
  • 买家实付金额,单位:元
  • └ promotion_type
  • String
  • 0
  • 优惠活动类型 0-无优惠 1-限时折
  • └ distributor_price
  • Number
  • 0
  • 分销商应付金额,单位:分
  • └ sc_item_id
  • Number
  • 613702760269
  • 后端商品id
  • └ fenxiao_id
  • Number
  • 38913818274736
  • 分销采购单号(分销流水号)
  • └ tc_adjust_fee
  • Number
  • 0
  • 商品的卖出金额调整,金额增加时为正数,金额减少时为负数,单位是分,不带小数
  • └ gmt_create
  • Date
  • 2000-01-01 00:00:00
  • 创单时间
  • └ auction_id
  • Number
  • 613694296654
  • 消费者购买宝贝ID,不存在时为0。 2015年4月15日之前创建的采购单该字段都是0。
  • └ tc_preferential_type
  • String
  • 聚划算
  • 商品优惠类型:聚划算、秒杀或其他
  • └ auction_sku_id
  • Number
  • 4493468966531
  • 消费者购买宝贝SKU ID,不存在时为0。 2015年3月15日之前创建的采购单该字段都是0
  • └ bill_fee_yuan
  • String
  • 1.00
  • 发票应开金额,单位:元。子单的消费者实付分摊金额。根据买家实际付款去除邮费后,按各个子单(商品)金额比例进行分摊后的金额,仅供开发票时做票面金额参考。
  • └ auction_price
  • String
  • 0.01
  • 分销商店铺中宝贝一口价,消费者看见的宝贝价格。单位:元。 代销场景下存在,此价格不是实付款的价格。
  • └ price_yuan
  • String
  • 0.00
  • 产品的采购价格。(精确到2位小数;单位:元。如:200.07,表示:200元7分)
  • └ 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
  • 分销商应付金额,单位:元
  • └ 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-交易成功
  • └ sub_order_status
  • Number
  • 70
  • 子采购单交易状态-数字表示,枚举:10-意向单审核中;20-订单付款前锁定;30-待分货;40-分货中;50-订单等待付款;55-已付款待确认付款操作;60-已付款;70-已提交交货;80-已发货;90-已提交确认收货,但收货未完成;100-交易关闭;110-交易成功
  • └ refund_status
  • Number
  • 9
  • 子采购单退款状态-数字形式,枚举:9-没有申请退款;20-退款中;21-退款结束,退款成功或者退款关闭都会走到这里
  • └ refund_status_code
  • String
  • RF_STATUS_NO_REFUND
  • 子采购单退款状态,枚举:RF_STATUS_NO_REFUND-没有申请退款;RF_STATUS_REFUNDING-退款中;RF_STATUS_END_REFUND-退款结束,退款成功或者退款关闭都会走到这里
  • └ auction_out_id
  • String
  • OUT100000
  • 子采购单商品商家编码,供应商发布产品时定义的产品编码
  • └ 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
  • 111
  • 属性键
  • └ 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
  • 911465155210793700
  • 消费者主订单ID (经销模式下,不存在该单号)
  • └ order_status
  • Number
  • 6
  • 主采购单交易状态-数字表示,枚举:1-已付款,待发货;2-待确认收款;4-等待买家付款;5-已付款,已发货;6-交易成功;7-交易关闭;8-已付款;
  • └ confirm_paid_fee
  • Number
  • 0
  • 确认收货金额,单位:分
  • └ 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
  • 38913818274736
  • 分销采购单号(分销流水号)
  • └ gmt_create
  • Date
  • 2000-01-01 00:00:00
  • 采购单创建时间
  • └ postage
  • Number
  • 0
  • 采购单邮费,单位:分
  • └ supplier_from_sys
  • Number
  • 1
  • 供应商来源网站。 入驻时定义供应商来源的外部系统编码, values: taobao, alibaba
  • └ distributor_from_sys
  • String
  • taobao
  • 分销商来源网站
  • └ end_time
  • Date
  • 2000-01-01 00:00:00
  • 交易成功的时间,分销商确认收货/付款的时间。格式:yyyy-MM-dd HH:mm:ss
  • └ distributor_pay_price
  • Number
  • 0
  • 分销商实付金额,单位:分
  • └ total_price_yuan
  • String
  • 0.00
  • 采购单总额(不含邮费),单位:元
  • └ order_status_code
  • String
  • TRADE_FINISHED
  • 主采购单交易状态,枚举:WAIT_SELLER_SEND_GOODS-已付款,待发货;WAIT_SELLER_CONFIRM_PAY-待确认收款;TRADE_REFUNDING-退款中;WAIT_BUYER_PAY-等待买家付款;WAIT_BUYER_CONFIRM_GOODS-已付款,已发货;TRADE_FINISHED-交易成功了;TRADE_CLOSED-交易关闭;TRADE_FOR_PAY-已付款;TRADE_REFUNDED-已退款
  • └ 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
  • xxxxx
  • 收件人ID (Open Addressee ID),长度在128个字符之内。
  • └ tp_create_time
  • String
  • 1645414654000
  • 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
  • 111
  • 属性值
remark String 这是一条返回给前端的错误信息 错误说明
total_count Number 25 采购单查询总数
opt_time Date 2000-01-01 00:00:00 接口操作时间
result_code String SYSTEM_ERROR 接口返回错误码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FenxiaoYphOrdersGetRequest req = new FenxiaoYphOrdersGetRequest();
req.setTradeTypes(1L);
req.setPageSize(50L);
req.setPageNum(1L);
req.setUserRoleType(2L);
req.setBeginTime(StringUtils.parseDateTime("2000-01-01 00:00:00"));
req.setEndTime(StringUtils.parseDateTime("2000-01-01 00:00:00"));
req.setChannelCodes(302L);
req.setOrderStatus(1L);
req.setRefundStatus(9L);
FenxiaoYphOrdersGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<fenxiao_yph_orders_get_response>
    <purchase_orders>
        <order_list>
            <alipay_no>null</alipay_no>
            <logistics_id>LP00167730231064-1</logistics_id>
            <pay_time>2000-01-01 00:00:00</pay_time>
            <memo>这是一条采购单留言</memo>
            <buyer_actual_pay_yuan>0.00</buyer_actual_pay_yuan>
            <pay_type>10000</pay_type>
            <consign_time>2000-01-01 00:00:00</consign_time>
            <shipping>2</shipping>
            <logistics_company_name>这是一家物流公司</logistics_company_name>
            <distributor_nick>商家测试帐号86</distributor_nick>
            <postage_yuan>0.00</postage_yuan>
            <supplier_memo>供应商备注</supplier_memo>
            <biz_order_id>38913818274736</biz_order_id>
            <sub_order_detail_yph_list>
                <sub_order_list>
                    <refund_fee>0</refund_fee>
                    <buyer_pay_price>1.00</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>911465155210793700</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>10</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>1.00</buyer_pay_price_yuan>
                    <promotion_type>0</promotion_type>
                    <distributor_price>0</distributor_price>
                    <sc_item_id>613702760269</sc_item_id>
                    <fenxiao_id>38913818274736</fenxiao_id>
                    <tc_adjust_fee>0</tc_adjust_fee>
                    <gmt_create>2000-01-01 00:00:00</gmt_create>
                    <auction_id>613694296654</auction_id>
                    <tc_preferential_type>聚划算</tc_preferential_type>
                    <auction_sku_id>4493468966531</auction_sku_id>
                    <bill_fee_yuan>1.00</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>
                    <sub_order_status_code>DELIVERED</sub_order_status_code>
                    <sub_order_status>70</sub_order_status>
                    <refund_status>9</refund_status>
                    <refund_status_code>RF_STATUS_NO_REFUND</refund_status_code>
                    <auction_out_id>OUT100000</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>111</attr_key>
                            <attr_value>222</attr_value>
                        </feature_d_o>
                    </features>
                    <auction_out_sku_id>5555</auction_out_sku_id>
                </sub_order_list>
            </sub_order_detail_yph_list>
            <gmt_modified>2000-01-01 00:00:00</gmt_modified>
            <total_price>0</total_price>
            <tc_order_id>911465155210793700</tc_order_id>
            <order_status>6</order_status>
            <confirm_paid_fee>0</confirm_paid_fee>
            <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>38913818274736</fenxiao_id>
            <gmt_create>2000-01-01 00:00:00</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_code>TRADE_FINISHED</order_status_code>
            <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>xxxxx</oaid>
            </dp_buyer_detail>
            <tp_create_time>1645414654000</tp_create_time>
            <features>
                <feature_d_o>
                    <attr_key>123</attr_key>
                    <attr_value>111</attr_value>
                </feature_d_o>
            </features>
        </order_list>
    </purchase_orders>
    <remark>这是一条返回给前端的错误信息</remark>
    <total_count>25</total_count>
    <opt_time>2000-01-01 00:00:00</opt_time>
    <result_code>SYSTEM_ERROR</result_code>
</fenxiao_yph_orders_get_response>

异常示例

  • XML示例
  • JSON示例
<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

FAQ

返回
顶部