拼多多订单打单接口免申请审核流程接入（拼多多开放平台接入）

柔光的暖阳◎ 2024-03-26 23:07 46阅读 0赞

## pdd.erp.order.sync ##

### erp打单信息同步 ###

更新时间：2021-04-13 23:04:54

¥免费API必须用户授权

erp打单信息同步

#### 公共参数 ####

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>必须</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>key</td> 
   <td>String</td> 
   <td>是</td> 
   <td>调用key（<a href="https://o0b.cn/jennif" rel="nofollow" title="注册获取APIkey">注册获取APIkey</a>）</td> 
  </tr> 
  <tr> 
   <td>secret</td> 
   <td>String</td> 
   <td>是</td> 
   <td>调用密钥</td> 
  </tr> 
  <tr> 
   <td>api_name</td> 
   <td>String</td> 
   <td>是</td> 
   <td>API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]</td> 
  </tr> 
  <tr> 
   <td>cache</td> 
   <td>String</td> 
   <td>否</td> 
   <td>[yes,no]默认yes，将调用缓存的数据，速度比较快</td> 
  </tr> 
  <tr> 
   <td>result_type</td> 
   <td>String</td> 
   <td>否</td> 
   <td>[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读</td> 
  </tr> 
  <tr> 
   <td>lang</td> 
   <td>String</td> 
   <td>否</td> 
   <td>[cn,en,ru]翻译语言，默认cn简体中文</td> 
  </tr> 
  <tr> 
   <td>version</td> 
   <td>String</td> 
   <td>否</td> 
   <td>API版本</td> 
  </tr> 
 </tbody> 
</table>

#### 请求参数说明 ####

点击收起

<table> 
 <thead> 
  <tr> 
   <th>参数接口</th> 
   <th>参数类型</th> 
   <th>是否必填</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>logistics_id</td> 
   <td>LONG</td> 
   <td>必填</td> 
   <td>物流公司编码</td> 
  </tr> 
  <tr> 
   <td>order_sn</td> 
   <td>STRING</td> 
   <td>必填</td> 
   <td>订单号</td> 
  </tr> 
  <tr> 
   <td>order_state</td> 
   <td>INTEGER</td> 
   <td>必填</td> 
   <td>订单状态：1-已打单</td> 
  </tr> 
  <tr> 
   <td>waybill_no</td> 
   <td>STRING</td> 
   <td>必填</td> 
   <td>运单号</td> 
  </tr> 
 </tbody> 
</table>

#### 返回参数说明 ####

点击收起

<table> 
 <thead> 
  <tr> 
   <th>参数接口</th> 
   <th>参数类型</th> 
   <th>例子</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>error_code</td> 
   <td>LONG</td> 
   <td></td> 
   <td>错误代码</td> 
  </tr> 
  <tr> 
   <td>error_msg</td> 
   <td>STRING</td> 
   <td></td> 
   <td>错误参数</td> 
  </tr> 
  <tr> 
   <td>result</td> 
   <td>BOOLEAN</td> 
   <td></td> 
   <td>是否有结果</td> 
  </tr> 
  <tr> 
   <td>success</td> 
   <td>BOOLEAN</td> 
   <td></td> 
   <td>是否成功</td> 
  </tr> 
 </tbody> 
</table>

#### 请求示例 ####

点击收起

JAVA

CURL

package com.pdd.pop.sdk.http.demo;

import com.pdd.pop.sdk.common.util.JsonUtil;

import com.pdd.pop.sdk.http.api.pop.request.PddErpOrderSyncRequest;

import com.pdd.pop.sdk.http.api.pop.response.PddErpOrderSyncResponse;

import com.pdd.pop.sdk.http.PopClient;

import com.pdd.pop.sdk.http.PopHttpClient;

public class PopClientDemo {

public static void main(String[] args) throws Exception {

String clientId = "your clientId";

String clientSecret = "your clientSecret";

String accessToken = "your accessToken";

PopClient client = new PopHttpClient(clientId, clientSecret);

PddErpOrderSyncRequest request = new PddErpOrderSyncRequest();

request.setLogisticsId(0L);

request.setOrderSn("str");

request.setOrderState(0);

request.setWaybillNo("str");

PddErpOrderSyncResponse response = client.syncInvoke(request, accessToken);

System.out.println(JsonUtil.transferToJson(response));

}

#### 响应示例 ####

点击收起

{

"error_code": 0,

"error_msg": "str",

"result": false,

"success": false

}

#### 异常示例 ####

点击收起

JSON

XML

{

"error_response": {

"error_msg": "公共参数错误:type",

"sub_msg": "",

"sub_code": null,

"error_code": 10001,

"request_id": "15440104776643887"

}

#### 相关权限包 ####

点击收起

<table> 
 <thead> 
  <tr> 
   <th>拥有此接口的权限包</th> 
   <th>可获得/可申请此权限包的应用类型</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>订单信息查询权限包</td> 
   <td>打单、进销存、虚拟商家后台系统、企业ERP、商家后台系统、订单处理、电子凭证商家后台系统、跨境企业ERP报关版</td> 
  </tr> 
 </tbody> 
</table>

#### 返回错误码说明 ####

点击收起

<table> 
 <thead> 
  <tr> 
   <th>主错误码</th> 
   <th>主错误描述</th> 
   <th>子错误码</th> 
   <th>子错误描述</th> 
   <th>解决办法</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>10000</td> 
   <td>参数错误</td> 
   <td>10000</td> 
   <td>参数错误</td> 
   <td>参数值有误，按照文档要求填写请求参数</td> 
  </tr> 
  <tr> 
   <td>10001</td> 
   <td>公共参数错误</td> 
   <td>10001</td> 
   <td>公共参数错误</td> 
   <td>请检查请求的公共参数</td> 
  </tr> 
  <tr> 
   <td>10016</td> 
   <td>client下线或者clientId不正确</td> 
   <td>10016</td> 
   <td>client下线或者clientId不正确</td> 
   <td>请核查您的client_id是否正确</td> 
  </tr> 
  <tr> 
   <td>10017</td> 
   <td>type不正确</td> 
   <td>10017</td> 
   <td>type不正确</td> 
   <td>检查type是否正确</td> 
  </tr> 
  <tr> 
   <td>10018</td> 
   <td>target_client_id下线或者target_client_id不正确</td> 
   <td>10018</td> 
   <td>target_client_id下线或者target_client_id不正确</td> 
   <td>检查target_client_id 是否正确</td> 
  </tr> 
  <tr> 
   <td>10019</td> 
   <td>access_token已过期</td> 
   <td>10019</td> 
   <td>access_token已过期</td> 
   <td>刷新access_token或者重新授权再次获取access_token</td> 
  </tr> 
  <tr> 
   <td>20004</td> 
   <td>签名sign校验失败</td> 
   <td>20004</td> 
   <td>签名sign校验失败</td> 
   <td>请按照接入指南第三部分指导，生成签名</td> 
  </tr> 
  <tr> 
   <td>20005</td> 
   <td>ip无权访问接口，请加入ip白名单</td> 
   <td>20005</td> 
   <td>ip无权访问接口，请加入ip白名单</td> 
   <td>把ip白名单加入白名单</td> 
  </tr> 
  <tr> 
   <td>20031</td> 
   <td>用户没有授权访问此接口</td> 
   <td>20031</td> 
   <td>用户没有授权访问此接口</td> 
   <td>您创建的应用中不包含此接口，请查看API文档，了解相关权限包</td> 
  </tr> 
  <tr> 
   <td>20032</td> 
   <td>access_token或client_id错误</td> 
   <td>20032</td> 
   <td>access_token或client_id错误</td> 
   <td>检查access_token或client_id</td> 
  </tr> 
  <tr> 
   <td>20034</td> 
   <td>接口处于下线状态</td> 
   <td>20034</td> 
   <td>接口处于下线状态</td> 
   <td>检查接口状态</td> 
  </tr> 
  <tr> 
   <td>20035</td> 
   <td>接口不属于当前网关</td> 
   <td>20035</td> 
   <td>接口不属于当前网关</td> 
   <td>判断调用网关url 是否正确</td> 
  </tr> 
  <tr> 
   <td>21001</td> 
   <td>请求参数错误</td> 
   <td>21001</td> 
   <td>请求参数错误</td> 
   <td>业务参数输入错误</td> 
  </tr> 
  <tr> 
   <td>21002</td> 
   <td>请求参数不能为空</td> 
   <td>21002</td> 
   <td>请求参数不能为空</td> 
   <td>检查业务参数必填是否已填</td> 
  </tr> 
  <tr> 
   <td>30000</td> 
   <td>没有调用此target接口权限</td> 
   <td>30000</td> 
   <td>没有调用此target接口权限</td> 
   <td>检查是否获得调用此target接口权限</td> 
  </tr> 
  <tr> 
   <td>30001</td> 
   <td>client_id和partner_id不匹配</td> 
   <td>30001</td> 
   <td>client_id和partner_id不匹配</td> 
   <td>检查partner_id是否正确</td> 
  </tr> 
  <tr> 
   <td>50000</td> 
   <td>系统内部错误</td> 
   <td>50000</td> 
   <td>系统内部错误</td> 
   <td>系统内部错误，请加群联系相关负责人</td> 
  </tr> 
  <tr> 
   <td>50002</td> 
   <td>业务系统内部异常</td> 
   <td>50002</td> 
   <td>业务系统内部异常</td> 
   <td>请加群联系相关负责人</td> 
  </tr> 
  <tr> 
   <td>52001</td> 
   <td>网关业务服务错误</td> 
   <td>52001</td> 
   <td>网关业务服务错误</td> 
   <td>联系技术支持解决</td> 
  </tr> 
  <tr> 
   <td>52002</td> 
   <td>网关系统内部异常</td> 
   <td>52002</td> 
   <td>网关系统内部异常</td> 
   <td>联系技术支持解决</td> 
  </tr> 
  <tr> 
   <td>52004</td> 
   <td>请求body 太大</td> 
   <td>52004</td> 
   <td>请求body 太大</td> 
   <td>检查请求体是否过大</td> 
  </tr> 
  <tr> 
   <td>52101</td> 
   <td>当前接口被限流，请稍后重试</td> 
   <td>52101</td> 
   <td>当前接口被限流，请稍后重试</td> 
   <td>当前接口被限流，请稍后重试</td> 
  </tr> 
  <tr> 
   <td>52102</td> 
   <td>当前接口暂时不可用，请稍后重试</td> 
   <td>52102</td> 
   <td>当前接口暂时不可用，请稍后重试</td> 
   <td>当前接口被降级，请稍后重试</td> 
  </tr> 
  <tr> 
   <td>52103</td> 
   <td>服务暂时不可用，请稍后重试</td> 
   <td>52103</td> 
   <td>服务暂时不可用，请稍后重试</td> 
   <td>当前接口被降级，请稍后重试</td> 
  </tr> 
  <tr> 
   <td>70031</td> 
   <td>调用过于频繁，请调整调用频率</td> 
   <td>70031</td> 
   <td>调用过于频繁，请调整调用频率</td> 
   <td>调用过于频繁，请调整调用频率</td> 
  </tr> 
  <tr> 
   <td>70032</td> 
   <td>当前请求被禁止调用</td> 
   <td>70032</td> 
   <td>当前请求被禁止调用</td> 
   <td>当前请求被禁止调用</td> 
  </tr> 
  <tr> 
   <td>70033</td> 
   <td>当前接口因系统维护，暂时下线，请稍后再试！</td> 
   <td>70033</td> 
   <td>当前接口因系统维护，暂时下线，请稍后再试！</td> 
   <td>当前接口因系统维护，暂时下线，请稍后再试！</td> 
  </tr> 
  <tr> 
   <td>70034</td> 
   <td>当前用户或应用存在风险，禁止调用！</td> 
   <td>70034</td> 
   <td>当前用户或应用存在风险，禁止调用！</td> 
   <td>当前用户或应用存在风险，禁止调用！</td> 
  </tr> 
  <tr> 
   <td>70035</td> 
   <td>当前用户或应用存在风险，禁止调用。请联系ddjb@pinduoduo.com</td> 
   <td>70035</td> 
   <td>当前用户或应用存在风险，禁止调用。请联系ddjb@pinduoduo.com</td> 
   <td>当前用户或应用存在风险，禁止调用。请联系ddjb@pinduoduo.com</td> 
  </tr> 
  <tr> 
   <td>70036</td> 
   <td>应用处于测试状态，调用次数被限制</td> 
   <td>70036</td> 
   <td>应用处于测试状态，调用次数被限制</td> 
   <td>应用处于测试状态，调用次数达到上限被限制</td> 
  </tr> 
  <tr> 
   <td>50001</td> 
   <td>业务服务错误</td> 
   <td></td> 
   <td></td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

#### 限流规则 ####

点击收起

接口总限流频次：39000次/10秒