大麦家礼品代发API

# 创建订单

接口地址： http://www.damaijia168.com/vv/external/v1/order_create_encryption

请求方式： POST

传参方式： JSON

返回格式： JSON

# 请求头参数

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

# 请求参数

参数 类型 必选 描述
shop_id int 是 店铺ID
product_id int 是 礼品ID
site_order_consignee_id int 否 自定义包裹id(不填写统默认返回自定义包裹id)
platform_order_sn string 是 第三方平台订单号：淘、猫、京、拼等平台订单编号通过erp订单接口获取
source string 是 来源 taobao:淘宝 tmall：天猫 jd：京东 pdd：拼多多 albb：阿里巴巴 ks：快手小店 dyxd：抖音小店 other:其他
is_deliver string 否 自动发货//1自动发货 0不自动发货 默认类型1（出单后自动将运单号推送电商发货接口），不传或则无效数据系统默认1，类型0（出单成功后，不再推送电商发货接口）
consigners array 否 发货人信息
—consigner string 否 发货人
—mobile string 否 手机号
—province string 否 省份
—city string 否 市
—district string 否 区
—address string 否 具体地址

# 请求示例


{
    "shop_id": "22312313",
    "product_id": "1007",
    "platform_order_sn": "211129-52221313129",
    "source": "pdd"
    
}

# 请求代码示例

cURL请求代码示例

curl --location --request POST 'http://www.damaijia168.com/vv/external/v1/order_create_encryption' \
--header 'Authorization: 4b6486d8e5b7b854e8602675c87f2aeb' \
--header 'Content-Type: application/json' \
--data-raw '{
    "shop_id": "2221312",
    "product_id": "1007",
    "platform_order_sn": "211129-52231231231",
    "source": "pdd"
   
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://www.damaijia168.com/vv/external/v1/order_create_encryption',
  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 =>'{
    "shop_id": "22312312",
    "product_id": "1007",
    "platform_order_sn": "211129-522312312319",
    "source": "pdd"
    
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: 4b6486d8e5b7b854e8602675c87f2aeb',
    '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    \"shop_id\": \"228897764\",\r\n    \"product_id\": \"1007\",\r\n    \"platform_order_sn\": \"211129-522977299413429\",\r\n    \"source\": \"pdd\"\r\n}");
Request request = new Request.Builder()
  .url("http://www.damaijia168.com/vv/external/v1/order_create_encryption")
  .method("POST", body)
  .addHeader("Authorization", "4b6486d8e5b7b854e8602675c87f2aeb")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

# 响应参数

参数 类型 描述
data object 执行任务
order_id int 订单id
order_sn string 订单编号
consignees array 收货人信息
–site_order_consignee_id int 自定义包裹id
–forbidden_zone string 禁发区名
–msg_code string 错误码， 2000 成功 2001 发货地已禁发
–msg string 返回信息
-amount int 消耗点券(点券)
status int 状态码，0为成功

# 返回数据

 {
     "data": {
       "order_id": 360,
       "order_sn": "2021020411023208680132",
       "consignees": [
         {
            "site_order_consignee_id": "88888111",
            "forbidden_zone": "北京/北京市",
            "msg_code": 2001,
            "msg": "该地区已禁发"
          }
       ]
    },
    "status": 0
  }

# 错误码(更多错误码请进入获取token页面查看公共错误码)

状态码(status)） 错误说明
132 请求格式必须为JSON
422 参数列表不合法，在err中会给出提示
200 认证失败
209 账户余额不足
217 创建订单失败
234 site_order_id已存在
232 商品信息异常,请联系客服
233 商品发货地异常,请联系客服
226 商品已下架
228 当前商品暂不支持该发货平台
235 商品发货地已禁发
状态码(msg_code) 错误说明
2000 成功
2001 发货地已禁发
2003 该商品暂不支持该发货平台
2004 该订单不存在
2010 未知错误
2011 店铺未授权
2012 店铺未订购该软件
2013 该商品信息不存在

← 1-6_订单查询 →