文档中心 > API类目 > ICBU-交易

alibaba.seller.order.get (订单查询接口)

国际站订单查询接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
e_trade_id String 必须 xxxxxxxx 订单号
data_select String 可选 draft_role 数据选择器都参数英文,分隔
statusAction,draft_role,snapshot_product
language String 可选 en_US或zh_CN 多语言

响应参数

名称 类型 示例值 描述
value TradeEcologyOrder order 订单(order info)
  • buyer
  • BuyerParticipant
  • buyer
  • 买家信息(buyer info)
  • └ country
  • String
  • US
  • 国家(buyer's country name)
  • └ full_name
  • String
  • jack ma
  • 全名(buyer's full name)
  • └ e_account_id
  • String
  • fsfds3124
  • 加密accountId
  • └ immutable_eid
  • String
  • sdfbgfewvdcs
  • 同一买家账号不变的加密id
  • create_date
  • DateVo
  • 2018-10-10 00:00:00
  • the create date of order
  • └ timestamp
  • Number
  • 123456789
  • timestamp
  • └ format_date
  • String
  • MMM. d, yyyy, HH:mm:ss z.
  • 格式化后的时间(平台会按PDT或PST格式化) (Formatted time by PDT or PST )
  • └ export_service_type
  • String
  • onetouch_service
  • 出口方式(一达通出口onetouch_service,非一达通出口self_run_service), export Service (export by onetouch called onetouch_service, export by not onetouch called self_run_service)
  • inspection_service_amount
  • Price
  • inspection_service_amount
  • 验货费(inspection service amount object)
  • └ amount
  • String
  • 123.00
  • 金额(amount)
  • └ currency
  • String
  • USD
  • 币种(currency)
  • order_products
  • TradeEcologyOrderProduct []
  • order_products
  • 产品信息(product info List Object)
  • └ name
  • String
  • test
  • 产品名称(the name of product)
  • └ product_image
  • String
  • //fsfffs.jpg
  • 产品图片(the image url of product)
  • └ quantity
  • String
  • 12.0000
  • 产品数量(the quantity of product)
  • sku_attributes
  • SkuAttribute []
  • sku_attributes
  • sku信息列表(the sku attribute List)
  • └ key
  • String
  • color
  • sku属性名称(attribute key)
  • └ value
  • String
  • red
  • sku属性值(attribute value)
  • └ sku_id
  • String
  • 33
  • sku编号(the id of sku)
  • └ unit
  • String
  • piece
  • 产品单位(the unit of product)
  • unit_price
  • Price
  • unit_price
  • 产品单价(the unit price of product )
  • └ amount
  • String
  • 12.0000
  • 产品单价金额(amount)
  • └ currency
  • String
  • USD
  • 币种(currency)
  • └ product_id
  • String
  • 123423
  • 商品id(the Id of product)
  • └ sku_code
  • String
  • T14234
  • 用户自定义skucode(Seller's custom sku code )
  • └ model_number
  • String
  • RS3434
  • 型号(model number)
  • └ id
  • String
  • dadadadada
  • 唯一主键
  • product_total_amount
  • Price
  • product_total_amount
  • 产品总价(the total amount of product)
  • └ amount
  • String
  • 12.00
  • 金额(amount)
  • └ currency
  • String
  • USD
  • 币种(currency)
  • └ remark
  • String
  • hello
  • 订单备注(order remark)
  • seller
  • SellerParticipant
  • seller
  • 卖家信息(seller info)
  • └ full_name
  • String
  • test lee
  • 全名(the full name of seller)
  • └ login_id
  • String
  • xxx
  • 登录账号(the login id of seller)
  • └ is_admin
  • Boolean
  • true
  • 是否是主账号
  • └ email
  • String
  • 12343@test.com
  • 卖家邮箱
  • └ e_account_id
  • String
  • fsfs312
  • 加密accountId
  • └ immutable_eid
  • String
  • fsdfssdfsfs
  • 同一卖家账号不变的加密id
  • shipment_fee
  • Price
  • shipment_fee
  • 运费(the fee of shipment)
  • └ amount
  • String
  • 1
  • 金额(amount)
  • └ currency
  • String
  • USD
  • 币种(currency)
  • └ shipment_method
  • String
  • air
  • 运输方式 the shipment method( 空运 air, 海运 sea, 快递express, 陆运land, 邮政小包 postal, 空运到港 air_to_port, 空运到门 air_to_door, 海运到港 sea_to_port, 海运到门 sea_to_door)
  • shipping_address
  • Address
  • shipping_address
  • 收货地址(the shipping address )
  • └ address
  • String
  • xx
  • 具体地址(Detailed address)
  • └ alternate_address
  • String
  • xx
  • 备用地址(Alternate address)
  • └ city
  • String
  • xx
  • 城市(city)
  • └ contact_person
  • String
  • xx
  • 联系人(Contact name)
  • └ country
  • String
  • xx
  • 国家(country)
  • fax
  • Phone
  • fax
  • 传真(the fax )
  • └ area
  • String
  • xx
  • 区号(area)
  • └ country
  • String
  • xx
  • 国家 (country)
  • └ number
  • String
  • xx
  • 号码(fax number)
  • mobile
  • Phone
  • mobile
  • 移动电话(mobile)
  • └ area
  • String
  • xx
  • 区号(area)
  • └ country
  • String
  • xx
  • 国家(country)
  • └ number
  • String
  • xx
  • 号码(mobile number)
  • └ port
  • String
  • 1233
  • 港口(port)
  • └ province
  • String
  • xx
  • 省份地址(province)
  • telephone
  • Phone
  • telephone
  • 电话(telephone)
  • └ area
  • String
  • xx
  • 区号(area)
  • └ country
  • String
  • xx
  • 国家(country)
  • └ number
  • String
  • 1233
  • 号码(telephone number)
  • └ zip
  • String
  • 3000015
  • 邮编(zip)
  • └ country_code
  • String
  • xxx
  • 国家code
  • └ port_code
  • String
  • xxx
  • 港口code
  • └ province_code
  • String
  • xxx
  • 省份编号
  • └ city_code
  • String
  • xxx
  • cityCode
  • total_amount
  • Price
  • total
  • 订单总价(the total amount oforder )
  • └ amount
  • String
  • 2345.00
  • 金额(amount)
  • └ currency
  • String
  • USD
  • 币种(currency)
  • └ trade_id
  • String
  • 12345
  • 订单号(Clear text order number)
  • └ trade_status
  • String
  • trade_success
  • 订单状态:
    to_be_audited:待审核
    unpay:待付预付款(wait buyer to pay),
    paying:买家支付中,主要是包含验证的过程(buyer has payed but need to verify)
    paid:买家支付完成(Buyer payment success),
    relating:关联中(buyer use TT , seller relate the amount),
    captured:请款完成,到这步就代表资金会到账(The payment is completed, and at this step, the funds will arrive.),
    undeliver:待卖家发货(Waiting for seller to ship),
    delivering:发货中(Seller shipping),
    wait_confirm_receipt:待确认收货(Waiting for the buyer to confirm the receipt),
    intention_processing:意向订单,待起草订单(Waiting for the seller to draft an order),
    trade_close:交易关闭,取消(Trading closed),
    trade_success:交易成功,完成(Order completed),
    wait_confirm_modify:待确认修改合同(Waiting for the buyer to confirm the modification of the contract),
    trade_unavailable: 交易不可用(trade unavailable) ,
    charge_back:拒付(charge back),
    frozen:冻结中(frozen)
    1.ERP 如何判断订单能否发货?
    取 undeliver ,此状态下订单肯定是已经支付成功了的。
    2.unpay状态下 如果判断订单需要支付 预付款还是尾款?
    通过 pay_step来判断。
    3.ERP 如果做订单拦截?
    需要拦截的情况 主要有 买家发起退款 和信用卡拒付,分别对应 frozen 和 charge_back。退款结束后,订单状态可能会处于 trade_close 和 也有可能买家是部分退款,然后订单恢复退款前的状态。 信用卡拒付后,订单状态肯定是 trade_close
  • └ contract_version
  • String
  • 12345432
  • 合同版本号
  • status_action
  • StatusAction
  • {}
  • 实时状态 和 action
  • actions
  • Action []
  • {}
  • 行动点
  • └ value
  • String
  • http://xxxxxxx
  • └ name
  • String
  • view_payment_link
  • 名字:
    view_payment_link: 查看支付链接
  • └ render_name
  • String
  • 查看支付链接
  • 渲染后的文案
  • └ status
  • String
  • trade_success
  • 参考 trade_status 字段注释
  • shipment_insurance_fee
  • Price
  • {}
  • 物流保险费
  • └ currency
  • String
  • USD
  • 币种
  • └ amount
  • String
  • 1100
  • 金额
  • └ trade_term
  • String
  • FOB
  • 贸易术语
  • shipment_date
  • ShipmentDate
  • {}
  • 合同约定的发货时间,不是实际的发货时间
  • └ type
  • String
  • relative
  • 相对预付款relative,相对尾款 relative_balance,绝对时间absolute 如果type=relative 或 relative_balance, 则取 duration 的值,它是一个相对值。 如果type=absolute, 则取 date 的值,他是商家指定的一个具体时间
  • └ duration
  • Number
  • 2
  • 时间间隔 天
  • date
  • DateVo
  • {}
  • 绝对时间
  • └ format_date
  • String
  • MMM. d, yyyy, HH:mm:ss z.
  • 格式化后的时间
  • └ timestamp
  • Number
  • 213453
  • 时间戳
  • advance_amount
  • Price
  • {}
  • 预付款
  • └ currency
  • String
  • USD
  • 币种
  • └ amount
  • String
  • 2343
  • 金额
  • balance_amount
  • Price
  • {}
  • 尾款
  • └ currency
  • String
  • USD
  • 币种
  • └ amount
  • String
  • 2343
  • 金额
  • └ fulfillment_channel
  • String
  • TAD
  • 履约通道
  • └ list_remark
  • String
  • xxx
  • 列表上的备注
  • carrier
  • Carrier
  • {}
  • 承运商
  • └ code
  • String
  • FEDEX
  • code 是 粗粒度的
  • └ name
  • String
  • Express FedEx IP(WTD)
  • 名称,不一定能和订单详情匹配
  • └ pay_step
  • String
  • ADVANCE
  • 支付阶段 :预付款ADVANCE, 尾款BALANCE,FULL 全款(就预付款等于全款的意思,尾款为0的那种订单)
    trade_status =unpay ,pay_step=ADVANCE 代表预付款 未支付
    trade_status =unpay , pay_step=FULL 代表全款 未支付
  • adjust_amount
  • Price
  • {}
  • 调整价
  • └ currency
  • String
  • USD
  • 币种
  • └ amount
  • String
  • 10.00
  • 金额
  • discount_amount
  • Price
  • {}
  • 折扣金额(非负值)
  • └ currency
  • String
  • USD
  • 币种
  • └ amount
  • String
  • 15.00
  • 币种
  • └ biz_code
  • String
  • 1020203和1020206,属于RFP类
  • 业务身份
  • └ channel_refer_id
  • String
  • 12345
  • 开放场景来源id
  • └ draft_role
  • String
  • seller 或 buyer
  • 订单起草角色 seller 或 buyer
  • └ item_status
  • String
  • normal / delete
  • normal,//正常使用中 delete; //列表中删除
  • └ source
  • String
  • 42432
  • 订单来源
  • └ dropshipping
  • Boolean
  • true
  • true 是,false 不是
  • └ semi_manage
  • Boolean
  • true
  • true 半托管订单,false费半托管订单

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaSellerOrderGetRequest req = new AlibabaSellerOrderGetRequest();
req.setETradeId("xxxxxxxx");
req.setDataSelect("draft_role");
req.setLanguage("en_US或zh_CN");
AlibabaSellerOrderGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_seller_order_get_response>
    <value>
        <buyer>
            <country>US</country>
            <full_name>jack ma</full_name>
            <e_account_id>fsfds3124</e_account_id>
            <immutable_eid>sdfbgfewvdcs</immutable_eid>
        </buyer>
        <create_date>
            <timestamp>123456789</timestamp>
            <format_date>MMM. d, yyyy, HH:mm:ss z.</format_date>
        </create_date>
        <export_service_type>onetouch_service</export_service_type>
        <inspection_service_amount>
            <amount>123.00</amount>
            <currency>USD</currency>
        </inspection_service_amount>
        <order_products>
            <trade_ecology_order_product>
                <name>test</name>
                <product_image>//fsfffs.jpg</product_image>
                <quantity>12.0000</quantity>
                <sku_attributes>
                    <sku_attribute>
                        <key>color</key>
                        <value>red</value>
                    </sku_attribute>
                </sku_attributes>
                <sku_id>33</sku_id>
                <unit>piece</unit>
                <unit_price>
                    <amount>12.0000</amount>
                    <currency>USD</currency>
                </unit_price>
                <product_id>123423</product_id>
                <sku_code>T14234</sku_code>
                <model_number>RS3434</model_number>
                <id>dadadadada</id>
            </trade_ecology_order_product>
        </order_products>
        <product_total_amount>
            <amount>12.00</amount>
            <currency>USD</currency>
        </product_total_amount>
        <remark>hello</remark>
        <seller>
            <full_name>test lee</full_name>
            <login_id>xxx</login_id>
            <is_admin>true</is_admin>
            <email>12343@test.com</email>
            <e_account_id>fsfs312</e_account_id>
            <immutable_eid>fsdfssdfsfs</immutable_eid>
        </seller>
        <shipment_fee>
            <amount>1</amount>
            <currency>USD</currency>
        </shipment_fee>
        <shipment_method>air</shipment_method>
        <shipping_address>
            <address>xx</address>
            <alternate_address>xx</alternate_address>
            <city>xx</city>
            <contact_person>xx</contact_person>
            <country>xx</country>
            <fax>
                <area>xx</area>
                <country>xx</country>
                <number>xx</number>
            </fax>
            <mobile>
                <area>xx</area>
                <country>xx</country>
                <number>xx</number>
            </mobile>
            <port>1233</port>
            <province>xx</province>
            <telephone>
                <area>xx</area>
                <country>xx</country>
                <number>1233</number>
            </telephone>
            <zip>3000015</zip>
            <country_code>xxx</country_code>
            <port_code>xxx</port_code>
            <province_code>xxx</province_code>
            <city_code>xxx</city_code>
        </shipping_address>
        <total_amount>
            <amount>2345.00</amount>
            <currency>USD</currency>
        </total_amount>
        <trade_id>12345</trade_id>
        <trade_status>trade_success</trade_status>
        <contract_version>12345432</contract_version>
        <status_action>
            <actions>
                <action>
                    <value>http://xxxxxxx</value>
                    <name>view_payment_link</name>
                    <render_name>查看支付链接</render_name>
                </action>
            </actions>
            <status>trade_success</status>
        </status_action>
        <shipment_insurance_fee>
            <currency>USD</currency>
            <amount>1100</amount>
        </shipment_insurance_fee>
        <trade_term>FOB</trade_term>
        <shipment_date>
            <type>relative</type>
            <duration>2</duration>
            <date>
                <format_date>MMM. d, yyyy, HH:mm:ss z.</format_date>
                <timestamp>213453</timestamp>
            </date>
        </shipment_date>
        <advance_amount>
            <currency>USD</currency>
            <amount>2343</amount>
        </advance_amount>
        <balance_amount>
            <currency>USD</currency>
            <amount>2343</amount>
        </balance_amount>
        <fulfillment_channel>TAD</fulfillment_channel>
        <list_remark>xxx</list_remark>
        <carrier>
            <code>FEDEX</code>
            <name>Express FedEx IP(WTD)</name>
        </carrier>
        <pay_step>ADVANCE</pay_step>
        <adjust_amount>
            <currency>USD</currency>
            <amount>10.00</amount>
        </adjust_amount>
        <discount_amount>
            <currency>USD</currency>
            <amount>15.00</amount>
        </discount_amount>
        <biz_code>1020203和1020206,属于RFP类</biz_code>
        <channel_refer_id>12345</channel_refer_id>
        <draft_role>seller 或 buyer</draft_role>
        <item_status>normal / delete</item_status>
        <source>42432</source>
        <dropshipping>true</dropshipping>
        <semi_manage>true</semi_manage>
    </value>
</alibaba_seller_order_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

返回
顶部