dsc.order.goods.insert.post (插入订单商品信息API)

插入订单商品信息API,获取订单商品相关信息。

公共参数

请求地址:
环境 HTTP请求地址 HTTPS请求地址
正式环境 http://www.xxx.com/api.php https://www.xxx.com/api.php
公共请求参数:
名称 类型 是否必须 描述
method String API接口名称
app_key String API接口AppKey

请求参数

名称 类型 是否必须 示例值 更多限制 描述
data array 必须 array('goods_number'=>'3', 'market_price' => 213.5, 'goods_price' => '206.00') 转为JSON或XML 更新参数
format type 必须 json json或xml 接口类型

响应参数

名称 类型 示例值 描述
rec_id Number 订单商品ID
order_id Number 订单ID
goods_id Number 商品ID
goods_name String 商品名称
goods_sn String 商品货号
product_id Number 商品货品ID
goods_number Number 商品数量
market_price float 11.6 商品市场价
goods_price float 9.4 商品价格
goods_attr String 商品属性值(如:颜色:蓝色 尺码:XL )
send_number Number 发货数量
is_real Number 是否是实物,0,否;1,是
extension_code String 通过活动购买的商品的代号,预售;presale, 超值礼包;package_buy, 秒杀;seckill,正常普通产品该处为空
parent_id Number 父商品id,取值于dsc_cart的parent_id;如果有该值则是值多代表的物品的配件
is_gift Number 是否参加优惠活动,0,否;其他,取值于dsc_cart 的is_gift,跟其一样,是参加的优惠活动的id
model_attr Number 商品属性模式
goods_attr_id String 商品属性ID(如:960,963)
ru_id Number 商家ID
warehouse_id Number 仓库ID
area_id Number 仓库地区ID
freight Number 商品运费方式(0:默认地区方式;1:固定运费;2:运费模板)
tid Number 商品运费模板ID
shipping_fee float 商品固定运费金额

请求示例

  • PHP(json格式)
  • PHP(xml格式)
$url="http(s)://www.xxx.com/api.php?app_key=A788F457-1A7D-4CC7-ABA0-BFE212BCCD9A&method=dsc.order.goods.insert.post&format=json"
$Http = new Http();
 
$data=array(
'order_id' => '35',
'goods_id' => '450',
'user_id' => '0',
'goods_name' => '海俪恩 新款偏光太阳眼镜 男款时尚潮流墨镜 防紫外线太阳镜驾驶镜 男 N6273 方框75蓝紫色',
'goods_sn' => 'ECS000450',
'goods_number' => '2',
'market_price' => '295.20',
'shop_price' => '246.00'
)
 
$data = json_encode($data); // 对变量进行 JSON 编码
$argument=array(
'data' => $data
)
 
$Http->doPost($url, $argument);
$url="http(s)://www.xxx.com/api.php?app_key=A788F457-1A7D-4CC7-ABA0-BFE212BCCD9A&method=dsc.order.goods.insert.post&format=xml"
$Http = new Http();
 
$data = '<?xml version="1.0" encoding="utf-8"?>
<dsc>
<order_id>35</order_id>
<goods_id>450</goods_id>
<goods_name>海俪恩 新款偏光太阳眼镜 男款时尚潮流墨镜 防紫外线太阳镜驾驶镜 男 N6273 方框75蓝紫色</goods_name>
<goods_sn>ECS000450</goods_sn>
<goods_number>2</goods_number>
<market_price>295.20</market_price>
<goods_price>246.00</goods_price>
</dsc>';
 
$data = htmlspecialchars($data); // 将特殊字符转换为 HTML 实体
$argument = array(
'data' => $data
);
 
$Http->doPost($url, $argument);
  • PHP

异常示例

  • XML
  • JSON
<dsc>
<result>success</result>
<error>0</error>
<msg>数据提交成功</msg>
</dsc>
{
"result": "success",
"error": 0,
"msg": "数据提交成功",
}

错误码解释

错误码 错误描述 解决方案
error 返回值

0:数据提交成功

1:数据提交失败,参数不存在

2:存在不可传参的参数

3:已存在相同数据,无法添加

4:关键参数不存在或值为空

返回
顶部