大麦家礼品代发API

# 增量订单查询

接口地址： http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-trades-sold-increment-get

请求方式： POST

传参方式： JSON

返回格式： JSON

# 请求头参数

参数 类型 必选 值 示例
Authorization string 是 授权 access_token 1798c6aadec33d1bc2f5b707f1049aefexxxx

# 请求参数

参数 类型 必选 描述
shop_id String 是 店铺 ID
params Object 是 参数
fields String 是 需要返回的字段列表，多个字段用半角逗号分隔，可选值为返回示例中能看到的所有字段。rx_audit_status=0,处方药未审核
startCreated Date 否 查询三个月内交易创建时间开始。格式：yyyy-MM-dd HH:mm:ss
endCreated Date 否 查询交易创建时间结束。格式：yyyy-MM-dd HH:mm:ss
status String 否 交易状态（查看可选值），默认查询所有交易状态的数据，除了默认值外每次只能查询一种状态。
buyerNick String 否 买家昵称
type String 否 交易类型列表，同时查询多种交易类型可用逗号分隔。默认同时查询 guarantee_trade,auto_delivery,ec,cod,step 这 5 种的交易类型的数据；查询所有交易类型的数据，需要设置下面全部可选值。可选值：fixed(一口价)auction(拍卖)guarantee_trade(一口价、拍卖)step(分阶段付款，万人团，阶梯团订单）independent_simple_trade(旺店入门版交易)independent_shop_trade(旺店标准版交易)autoDelivery(自动发货)ec(直冲)cod(货到付款)game_equipment(游戏装备)shopex_trade(ShopEX 交易)netcn_trade(万网交易)external_trade(统一外部交易)instant_trade (即时到账)b2c_cod(大商家货到付款)hotel_trade(酒店类型交易)super_market_trade(商超交易)super_market_cod_trade(商超货到付款交易)taohua(淘花网交易类型）waimai(外卖交易类型）o2o_offlinetrade（O2O 交易）nopaid（即时到帐/趣味猜交易类型）step (万人团) eticket(电子凭证) tmall_i18n（天猫国际）;nopaid （无付款交易）insurance_plus（保险）finance（基金）注：guarantee_trade 是一个组合查询条件，并不是一种交易类型，获取批量或单个订单中不会返回此种类型的订单。pre_auth_type(预授权 0 元购) lazada（获取 lazada 订单类型）
extType String 否 可选值有 ershou(二手市场的订单）,service（商城服务子订单）mark（双十一大促活动异常订单）作为扩展类型筛选只能做单个 ext_type 查询，不能全部查询所有的 ext_type 类型
rateStatus String 否 评价状态，默认查询所有评价状态的数据，除了默认值外每次只能查询一种状态。可选值：RATE_UNBUYER(买家未评)RATE_UNSELLER(卖家未评)RATE_BUYER_UNSELLER(买家已评，卖家未评)RATE_UNBUYER_SELLER(买家未评，卖家已评)RATE_BUYER_SELLER(买家已评，卖家已评)
tag String 否 卖家对交易的自定义分组标签，目前可选值为：time_card（点卡软件代充），fee_card（话费软件代充）
pageNo Number 否 页码。默认值：1，可填整数，通过传入 page_no 来控制获取的页数，总页数 =total_results÷ page_size
pageSize Number 否 每页条数。 默认值：40;最大值：100，可填整数。通过 page_no 和 page_size 组合多次调用实现翻页获取全量数据。
useNasNext Boolean 否 是否启用 has_next 的分页方式，如果指定 是
buyerOpenId String 否 买家的 openId
includeOaid String 否 appkey 未对接 oaid 加密，则忽略该字段。对接 oaid 加密情况下，（收货人 + 手机号 + 座机 + 收货地址 +create）5 个字段组合成 oaid，原始订单上座机为空也满足条件。传 是
edition string 否 版本 默认:1(不传默认为1)
1:1.0,2:2.0

# 请求示例

{
   "shop_id":173926031,
    "params":{
  "fields":"tid,type,status,payment,orders,rx_audit_status",
  "startCreated":"2000-01-01 00:00:00",
  "endCreated":"2000-01-01 23:59:59",
  "status":"ALL_WAIT_PAY",
  "buyerNick":"zhangsan",
  "type":"game_equipment",
  "extType":"service",
  "rateStatus":"RATE_UNBUYER",
  "tag":"time_card",
  "pageNo":1,
  "pageSize":40,
  "useNasNext":true,
  "buyerOpenId":"AAHm******Hpg8bT",
  "includeOaid":true
    }
}

# 请求代码示例

cURL请求代码示例

curl --location --request POST 'http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-trades-sold-increment-get' --header 'Authorization: 1798c6aadec33d1bc2f5b707f1049aefexxxx' --header 'Content-Type: application/json' --data-raw '{
  "fields":"tid,type,status,payment,orders,rx_audit_status",
  "shopId":"123456789",
  "startCreated":"2000-01-01 00:00:00",
  "endCreated":"2000-01-01 23:59:59",
  "status":"ALL_WAIT_PAY",
  "buyerNick":"zhangsan",
  "type":"game_equipment",
  "extType":"service",
  "rateStatus":"RATE_UNBUYER",
  "tag":"time_card",
  "pageNo":1,
  "pageSize":40,
  "useNasNext":true,
  "buyerOpenId":"AAHm******Hpg8bT",
  "includeOaid":true
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-trades-sold-increment-get',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "fields":"tid,type,status,payment,orders,rx_audit_status",
  "shopId":"123456789",
  "startCreated":"2000-01-01 00:00:00",
  "endCreated":"2000-01-01 23:59:59",
  "status":"ALL_WAIT_PAY",
  "buyerNick":"zhangsan",
  "type":"game_equipment",
  "extType":"service",
  "rateStatus":"RATE_UNBUYER",
  "tag":"time_card",
  "pageNo":1,
  "pageSize":40,
  "useNasNext":true,
  "buyerOpenId":"AAHm******Hpg8bT",
  "includeOaid":true
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: 1798c6aadec33d1bc2f5b707f1049aefexxxx',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n  \"fields\":\"tid,type,status,payment,orders,rx_audit_status\",\r\n  \"shopId\":\"123456789\",\r\n  \"startCreated\":\"2000-01-01 00:00:00\",\r\n  \"endCreated\":\"2000-01-01 23:59:59\",\r\n  \"status\":\"ALL_WAIT_PAY\",\r\n  \"buyerNick\":\"zhangsan\",\r\n  \"type\":\"game_equipment\",\r\n  \"extType\":\"service\",\r\n  \"rateStatus\":\"RATE_UNBUYER\",\r\n  \"tag\":\"time_card\",\r\n  \"pageNo\":1,\r\n  \"pageSize\":40,\r\n  \"useNasNext\":true,\r\n  \"buyerOpenId\":\"AAHm******Hpg8bT\",\r\n  \"includeOaid\":true\r\n}");
Request request = new Request.Builder()
  .url("http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-trades-sold-increment-get")
  .method("POST", body)
  .addHeader("Authorization", "1798c6aadec33d1bc2f5b707f1049aefexxxx")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

Python请求代码示例

import requests
import json

url = "http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-trades-sold-increment-get"

payload = json.dumps({
  "fields":"tid,type,status,payment,orders,rx_audit_status",
  "shopId":"123456789",
  "startCreated":"2000-01-01 00:00:00",
  "endCreated":"2000-01-01 23:59:59",
  "status":"ALL_WAIT_PAY",
  "buyerNick":"zhangsan",
  "type":"game_equipment",
  "extType":"service",
  "rateStatus":"RATE_UNBUYER",
  "tag":"time_card",
  "pageNo":1,
  "pageSize":40,
  "useNasNext":true,
  "buyerOpenId":"AAHm******Hpg8bT",
  "includeOaid":true
})
headers = {
  'Authorization': 'd964d7b9c4365a538d9b12661f74****',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

# 响应参数

参数 类型 描述
data object 返回数据
----trade Trade 交易主订单信息
----seller_nick String 卖家昵称
----pic_path String 商品图片绝对途径
----payment String 实付金额。精确到 2 位小数;单位：元。如：200.07，表示：200 元 7 分
----seller_rate Boolean 卖家是否已评价。可选值：true(已评价),false(未评价)
----post_fee String 邮费。精确到 2 位小数;单位：元。如：200.07，表示：200 元 7 分
----receiver_name String 收货人的姓名
----receiver_state String 收货人的所在省份
----receiver_address String 收货人的详细地址
----receiver_zip String 收货人的邮编
----receiver_mobile String 收货人的手机号码
----receiver_phone String 收货人的电话号码
----consign_time Date 卖家发货时间。格式：yyyy-MM-dd HH:mm:ss
----received_payment String 卖家实际收到的支付宝打款金额（由于子订单可以部分确认收货，这个金额会随着子订单的确认收货而不断增加，交易成功后等于买家实付
----promotion_details PromotionDetail[] 优惠详情
----est_con_time String 商家的预计发货时间
----receiver_country String 收货人国籍
----receiver_town String 收货人街道地址
----order_tax_fee String 天猫国际官网直供主订单关税税费
----paid_coupon_fee String 满返红包的金额；如果没有满返红包，则值为 0.00
----shop_pick String 门店自提，总店发货，分店取货的门店自提订单标识
----tid_str String 同 tid
----biz_code String 为 tmall.daogoubao.cloudstore 时表示云店链路
----cloud_store String 值为 1，且 bizCode 不为 tmall.daogoubao.cloudstore 时，为旗舰店订单
----new_presell Boolean 预售单为 true，否则 false (云店订单专用)
----you_xiang Boolean 优享购为 true，否则 false(云店订单专用)
----pay_channel String 默认为 0,0 表示用户主动支付 1 表示系统代扣 2 表示保险赔付
----tid Number 交易编号 (父订单的交易编号)
----num Number 商品购买数量。取值范围：大于零的整数，对于一个 trade 对应多个 order 的时候（一笔主订单，对应多笔子订单），num=0，num 是一个跟商品关联的属性，一笔
----num_iid Number 商品数字编号
----status String 交易状态。可选值： * TRADE_NO_CREATE_PAY(没有创建支付宝交易) * WAIT_BUYER_PAY(等待买家付款) * SELLER_CONSIGNED_PART
----title String 交易标题，以店铺名作为此标题的值。注：taobao.trades.get 接口返回的 Trade 中的 title 是商品名称
----type String 交易类型列表，同时查询多种交易类型可用逗号分隔。默认同时查询 guarantee_trade, auto_D_elivery, ec, cod 的 4 种交易类型的数据 可选
----price String 商品价格。精确到 2 位小数；单位：元。如：200.07，表示：200 元 7 分
----discount_fee String 可以使用 trade.promotion_details 查询系统优惠系统优惠金额（如打折，VIP，满就送等），精确到 2 位小数，单位：元。如：200.07，表
----has_post_fee Boolean 是否包含邮费。与 available_confirm_fee 同时使用。可选值：true(包含),false(不包含)
----total_fee String 商品金额（商品价格乘以数量的总金额）。精确到 2 位小数;单位：元。如：200.07，表示：200 元 7 分
----created Date 交易创建时间。格式：yyyy-MM-dd HH:mm:ss
----pay_time Date 付款时间。格式：yyyy-MM-dd HH:mm:ss。订单的付款时间即为物流订单的创建时间。
----modified Date 交易修改时间(用户对订单的任何修改都会更新此字段)。格式：yyyy-MM-dd HH:mm:ss
----end_time Date 交易结束时间。交易成功时间(更新交易状态为成功的同时更新)/确认收货时间或者交易关闭时间 。格式：yyyy-MM-dd HH:mm:ss
----buyer_message String 买家留言
----buyer_memo String 买家备注（与淘宝网上订单的买家备注对应，只有买家才能查看该字段）
----buyer_flag Number 买家备注旗帜（与淘宝网上订单的买家备注旗帜对应，只有买家才能查看该字段）红、黄、绿、蓝、紫 分别对应 1、2、3、4、5
----seller_memo String 卖家备注（与淘宝网上订单的卖家备注对应，只有卖家才能查看该字段）
----seller_flag Number 卖家备注旗帜（与淘宝网上订单的卖家备注旗帜对应，只有卖家才能查看该字段）红、黄、绿、蓝、紫 分别对应 1、2、3、4、5
----buyerNick String 买家昵称
----trade_attr JSON top 动态字段
----credit_card_fee String 使用信用卡支付金额数
----step_trade_status String 分阶段付款的订单状态（例如万人团订单等），目前有三返回状态 FRONT_NOPAID_FINAL_NOPAID(定金未付尾款未
----step_paid_fee String 分阶段付款的已付金额（万人团订单已付金额）
----mark_desc String 订单出现异常问题的时候，给予用户的描述，没有异常的时候，此值为空
----shipping_type String 创建交易时的物流方式（交易完成前，物流方式有可能改变，但系统里的这个字段一直不变）。可选值：free(卖家包邮),post(平邮),express
----buyer_cod_fee String 买家货到付款服务费。精确到 2 位小数;单位：元。如：12.07，表示：12 元 7 分
----adjust_fee String 卖家手工调整金额，精确到 2 位小数，单位：元。如：200.07，表示：200 元 7 分。来源于订单价格修改，如果有多笔子订单的时候，这个为 0，单笔
----trade_from String 交易内部来源。WAP(手机);HITAO(嗨淘);TOP(TOP 平台);TAOBAO(普通淘宝);JHS(聚划算)一笔订单可能同时有以上多个标记，则以逗号分隔
----service_orders ServiceOrder[] 服务子订单列表
----buyer_rate Boolean 买家是否已评价。可选值：true(已评价),false(未评价)。如买家只评价未打分，此字段仍返回 false
----receiver_city String 收货人的所在城市注：因为国家对于城市和地区的划分的有：省直辖市和省直辖县级行政区（区级别的）划分的，淘宝这边根据这个差异保存在不同字段里面比如：广东广州：广州属于一个直辖市是放在的 receiver_city 的字段里面；而河南济源：济源属于省直辖县级行政区划分，是区级别的，放在了 receiver_district 里面 建议：程序依赖于城市字段做物流等判断的操作，最好加一个判断逻辑：如果返回值里面只有 receiver_district 参数，该参数作为城市
----receiver_district String 收货人的所在地区注：因为国家对于城市和地区的划分的有：省直辖市和省直辖县级行政区（区级别的）划分的，淘宝这边根据这个差异保存在不同字段里面比如：广东广州：广州属于一个直辖市 是放在的 receiver_city 的字段里面；而河南济源：济源属于省直辖县级行政区划分，是区级别的，放在了 receiver_district 里面 建议：程序依赖于城市字段做物流等判断的操作，最好加一个判断逻辑：如果返回值里面只有 receiver_district 参数，该参数作为城市
----service_tags LogisticsTag[] 物流标签
----o2o String 导购宝 =crm
----o2o_guide_id String 导购员 id
----o2o_shopId String 导购员门店 id
----o2o_guide_name String 导购员名称
----o2o_shop_name String 导购门店名称
----o2o_delivery String 导购宝提货方式，inshop：店内提货，online：线上发货
----orders Order[] 订单列表
----trade_ext TradeExt 交易扩展表信息
----eticket_service_addr String 天猫电子凭证家装
----rx_audit_status String 处方药未审核状态
----es_range String 时间段
----es_date String 时间
----os_date String 时间
----os_range String 时间段
----coupon_fee Number 订单中使用红包付款的金额
----o2o_et_order_id String 分阶段交易的特权定金订单 ID
----post_gate_declare Boolean 邮关订单
----cross_bonded_declare Boolean 跨境订单
----omnichannel_param String 全渠道商品通相关字段
----assembly String 组合商品
----top_hold Number TOP 拦截标识，0 不拦截，1 拦截
----omni_attr String 星盘标识字段
----omni_param String 星盘业务字段
----forbid_consign Number 聚划算一起买字段
----identity String 采购订单标识
----team_buy_hold Number 天猫拼团拦截标示
----share_group_hold Number shareGroupHold
----ofp_hold Number 天猫国际拦截
----o2o_step_trade_detail String 组装 O2O 多阶段尾款订单的明细数据 总阶段数，当前阶数，阶段金额（单位：分），支付状态，例如 3_1_100_paid ;
----o2o_step_order_id String 特权定金订单的尾款订单 ID
----o2o_voucher_price String 分阶段订单的特权定金抵扣金额，单位：分
----order_tax_promotion_fee String 天猫国际计税优惠金额
----delay_create_delivery Number 聚划算火拼标记
----toptype Number top 定义订单类型
----service_type String serviceType
----o2o_service_mobile String o2oServiceMobile
----o2o_service_name String o2oServiceName
----o2o_service_state String o2oServiceState
----o2o_service_city String o2oServiceCity
----o2o_service_district String o2oServiceDistrict
----o2o_service_town String o2oServiceTown
----o2o_service_address String o2oServiceAddress
----o2o_step_trade_detail_new String o2oStepTradeDetailNew
----o2o_xiaopiao String o2oXiaopiao
----o2o_contract String o2oContract
----retail_store_code String 新零售门店编码
----retail_out_order_id String 新零售线下订单 id
----recharge_fee String rechargeFee
----platform_subsidy_fee String platformSubsidyFee
----nr_offline String nrOffline
----wtt_param String 网厅订单垂直表信息
----logistics_infos LogisticsInfo[] logisticsInfos
----nr_store_order_id String nrStoreOrderId
----nr_shopId String 门店 ID
----nr_shop_name String 门店名称
----nr_shop_guide_id String 导购员 ID
----nr_shop_guide_name String 导购员名称
----sort_info JSON sortInfo
----sorted Number 1 已排序 2 不排序
----nr_no_handle String 一小时达不处理订单
----buyer_open_uid String 买家 OpenUid
----is_gift Boolean isGift
----donee_nick String doneeNick
----donee_open_uid String doneeUid
----suning_shop_code String suningShopCode
----suning_shop_valid Number suningShopValid
----retail_store_id String retailStoreId
----is_istore Boolean isIstore
----ua String ua
----cutoff_minutes String 截单时间
----es_time String 时效：天
----delivery_time String 发货时间
----collect_time String 揽收时间
----dispatch_time String 派送时间
----sign_time String 签收时间
----delivery_cps String 派送 CP
----linkedmall_ext_info String linkedmall 透传参数
----rt_omni_send_type String 新零售全渠道订单：订单类型，自提订单：pickUp，电商发货：tmall，门店发货（配送、骑手）：storeSend
----rt_omni_store_id String 新零售全渠道订单：发货门店 ID
----rt_omni_outer_store_id String 新零售全渠道订单：商家自有发货门店编码
----tcps_start String 同城预约配送开始时间
----tcps_code String 同城业务类型，com.tmall.dsd:定时送，storeDsd-fn-3-1:淘速达 3 公里蜂鸟配送
----tcps_end String 同城预约配送结束时间
----m_tariff_fee String
----timing_promise String 时效服务身份，如 tmallPromise 代表天猫时效承诺
----promise_service String 时效服务字段，服务字段，会有多个服务值，以英文半角逗号","切割
----oi_range String 苏宁预约安装，用户安装时间段
----oi_date String 苏宁预约安装，用户安装时间
----hold_install String 苏宁预约安装，暂不安装
----outer_partner_member_id String 外部会员 id
----root_cat String 叶子分类
----gifting String 1-gifting 订单
----gifting_takeout String 1-coffee gifting 订单
----app_name String 订单来源
----easy_home_city_type String 居然之家同城站订单类型 deposit：预约到店，direct：直接购买，tail：尾款核销
----nr_deposit_order_id String 同城站关联订单号
----nr_store_code String 摊位 id
----propoint String 使用淘金币的数量，以分为单位，和订单标 propoint 中间那一段一样，没有返回 null
----zqs_order_tag String 1-周期送订单
----txp_freezer_id String 天鲜配冰柜 id
----txp_receive_method String 天鲜配自提方式
----brand_light_shop_store_id String 同城购门店 ID
----brand_light_shop_source String 同城购订单 source
----extend_info String 透出的额外信息
----lm String 收货地址有变更，返回"1"
----ncz_ext_attr String 新康众定制数据
----is_wmly String 标识完美履约订单
----omni_package String 全渠道包裹信息
----expandcard_info ExpandCardInfo 购物金信息输出
----invoice_detail_after_refund String 苹果发票详情
----invoice_detail_pay String 苹果发票详情
----invoice_detail_mid_refund
----expand_card_basic_price String 买卡订单本金
----expand_card_expand_price String 买卡订单权益金
----expand_card_basic_price_used String 用卡订单所用的本金
----expand_card_expand_price_used String 用卡订单所用的权益金
----is_openmall Boolean 是否是 Openmall 订单
----asdp_biz_type String asdp 业务身份
----oaid String (收货人 + 手机号 + 收货地址 +create）4 字段返回值都都不能为空，否则生
----v_logistics_create Boolean 是否是码上收订单
----q_r_pay Boolean 是否是非物流订单
----is_sh_ship Boolean 是否屏蔽发货
----o2o_snatch_status String 抢单状态 0,未处理待分发;1,抢单中;2,已抢单;3,已发货;-1,超时;-2,处理异常;-3,匹配失败;-4,取消抢单;-5,退款取消;-9,逻辑删除
----market String 垂直市场
----et_type String 电子凭证扫码购-扫码支付订单 type
----et_shopId Number 扫码购关联门店
----obs String 门店预约自提订单标
----deduct_money int 消耗点券
status int 状态码，0为成功

# 返回数据

{
  "data": {
                "no_shipping": false,
                "orders": {
                    "order": [
                        {
                            "adjust_fee": "0.00",
                            "buyer_rate": false,
                            "cid": 5000000005,
                            "discount_fee": "0.00",
                            "divide_order_fee": "**.00",
                            "end_time": "2021-04-01 13:08:18",
                            "is_daixiao": false,
                            "num": 1,
                            "num_iid": 1000000000001,
                            "oid": "168*********10386",
                            "payment": "108.00",
                            "pic_path": "https://img.alic*********01MtD9Oh1ySJ*********956577.png",
                            "price": "98.00",
                            "refund_id": "1079*********818603",
                            "refund_status": "SUCCESS",
                            "seller_rate": false,
                            "seller_type": "C",
                            "status": "TR*********ED",
                            "title": "婴幼儿*********湿巾生*********使用包",
                            "total_fee": "***.00"
                        }
                    ]
                },
                "receiver_address": "三墩*********幢2单元",
                "receiver_mobile": "$1Sag+WmXBD*********icUYg2yQ==$1$$",
                "receiver_name": "~jKIpSPC*********~u/nh~1~~",
                "receiver_state": "**省",
                "receiver_zip": "000000",
                "status": "TRADE_CLOSED",
                "type": "fixed"
            },
        "deduct_money": 4
},
  "status": 0
}

# 错误码

状态码(status) 错误信息 解决方案
132 请求格式必须为JSON 修改请求参数格式为json
422 参数列表不合法，在err中会给出提示 根据提示做相应修改
200 认证失败 请确保请求头里的Authorization存在或者未过期
422 查询条件(修改时间)跨度不能超过一天 只能查询 3 个月内并且跨度为一天的修改过的数据
422 buyerNick 无效 请检查 buyerNick是否正确
422 限流 避开限流

← 1-8_淘宝-评论列表查询 →