【顺丰快递管家】通用接口文档


1.原因代码表

<table> <thead> <tr> <th style="text-align: center;">原因代码</th> <th style="text-align: center;">描述</th> <th style="text-align: center;">分类</th> </tr> </thead> <tbody> <tr> <td style="text-align: center;"><strong>4***</strong></td> <td style="text-align: center;"><strong>4开头的原因代码归属“系统校验”的分类</strong></td> </tr> <tr> <td style="text-align: center;">4001</td> <td style="text-align: center;">系统发生数据错误或运行时异常</td> <td style="text-align: center;">系统校验</td> </tr> <tr> <td style="text-align: center;">4002</td> <td style="text-align: center;">报文解析错误</td> <td style="text-align: center;">系统校验</td> </tr> <tr> <td style="text-align: center;"><strong>61**</strong></td> <td style="text-align: center;"><strong>61开头的原因代码归属“缺少必要参数”的分类</strong></td> </tr> <tr> <td style="text-align: center;">6101</td> <td style="text-align: center;">必填项为空</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6102</td> <td style="text-align: center;">寄件方公司名称(j_company)为空</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6103</td> <td style="text-align: center;">寄件方联系人(j_contact)为空</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6106</td> <td style="text-align: center;">寄件方详细地址(j_address)为空</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6107</td> <td style="text-align: center;">到件方公司名称(d_company)为空</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6108</td> <td style="text-align: center;">到件方联系人(d_contact)为空</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6111</td> <td style="text-align: center;">到件方详细地址(d_address)为空,下单失败</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6114</td> <td style="text-align: center;">客户订单号(orderid)为空,筛单失败</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6117</td> <td style="text-align: center;">到件方详细地址(d_address)为空,筛单失败</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6118</td> <td style="text-align: center;">客户订单号(orderid)为空,下单失败</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6119</td> <td style="text-align: center;">到件方联系电话(d_tel)为空</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6120</td> <td style="text-align: center;">快件产品类别(express_type)为空</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6121</td> <td style="text-align: center;">寄件方联系电话(j_tel)为空</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6122</td> <td style="text-align: center;">筛单类别(filter_type)不合法</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6123</td> <td style="text-align: center;">顺丰运单号(mailno)为空</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6124</td> <td style="text-align: center;">付款方式(pay_method)为空</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6125</td> <td style="text-align: center;">Order/Cargo元素必填项为空</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6126</td> <td style="text-align: center;">顺丰月结卡号(custid)不合法</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6127</td> <td style="text-align: center;">增值服务名(Order/AddedService元素的name)为空</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6128</td> <td style="text-align: center;">增值服务名(Order/AddedService元素的name)不合法</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6129</td> <td style="text-align: center;">付款方式(pay_method)不合法</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6130</td> <td style="text-align: center;">订单货物总体积(volume)不合法</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6131</td> <td style="text-align: center;">客户订单操作标识(dealtype)不合法</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6132</td> <td style="text-align: center;">路由查询类别(method_type)不合法</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6133</td> <td style="text-align: center;">查询号类别(tracking_type)不合法</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6134</td> <td style="text-align: center;">请求XML报文不合法,筛单失败</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6135</td> <td style="text-align: center;">请求XML报文不合法,下单失败</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6136</td> <td style="text-align: center;">请求XML报文不合法,订单确认/取消失败</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6137</td> <td style="text-align: center;">请求XML报文不合法,路由查询失败</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6138</td> <td style="text-align: center;">代收货款金额(Order/AddedService元素的value)不合法</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6139</td> <td style="text-align: center;">代收货款金额(Order/AddedService元素的value)不合法,不能小于0</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6140</td> <td style="text-align: center;">代收货款卡号(Order/AddedService元素的value1)为空</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6141</td> <td style="text-align: center;">代收货款卡号(Order/AddedService元素的value1)不合法,未配置代收货款上限</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6142</td> <td style="text-align: center;">代收货款金额(Order/AddedService元素的value)不合法,超过代收货款上限</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;">6150</td> <td style="text-align: center;">客户订单号(orderid)不存在</td> <td style="text-align: center;">缺少必要参数</td> </tr> <tr> <td style="text-align: center;"><strong>8***</strong></td> <td style="text-align: center;"><strong>8开头的原因代码归属“功能校验”的分类</strong></td> </tr> <tr> <td style="text-align: center;">8000</td> <td style="text-align: center;">报文参数不合法</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8001</td> <td style="text-align: center;">IP未授权</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8002</td> <td style="text-align: center;">未授权使用此接口</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8003</td> <td style="text-align: center;">批量交易超上限(OrderFilter元素)</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8004</td> <td style="text-align: center;">批量交易超上限(查询号tracking_number)</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8005</td> <td style="text-align: center;">接口调用次数超上限</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8009</td> <td style="text-align: center;">客户订单不可以收派,确认订单失败</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8010</td> <td style="text-align: center;">客户订单未筛单,确认订单失败</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8011</td> <td style="text-align: center;">接入编码与顺丰运单号(mailno)不匹配</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8012</td> <td style="text-align: center;">接入编码与客户订单号(orderid)不匹配</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8013</td> <td style="text-align: center;">查询号(tracking_number)为空,路由查询失败</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8014</td> <td style="text-align: center;">校验码错误</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8015</td> <td style="text-align: center;">顺丰母运单号(main_mailno)为空,子单号申请失败</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8016</td> <td style="text-align: center;">客户运单号(orderid)已存在</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8017</td> <td style="text-align: center;">客户订单号(orderid)与顺丰运单号(mailno)不匹配</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8018</td> <td style="text-align: center;">未获取到客户订单信息</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8019</td> <td style="text-align: center;">客户订单号(orderid)已确认</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8020</td> <td style="text-align: center;">不存在该客户订单号(orderid)跟顺丰运单号(mailno)的绑定关系</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8021</td> <td style="text-align: center;">接入编码为空</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8023</td> <td style="text-align: center;">服务名称为空</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8024</td> <td style="text-align: center;">此客户订单号不存在对应的顺丰运单号,确认/取消失败</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8025</td> <td style="text-align: center;">未传入服务名称或服务名称不合法</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8026</td> <td style="text-align: center;">接入编码不存在</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8027</td> <td style="text-align: center;">业务模板不存在</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8028</td> <td style="text-align: center;">业务模板配置/属性未设置</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8029</td> <td style="text-align: center;">默认业务模板未配置</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8030</td> <td style="text-align: center;">业务模板不在生效日期范围内</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8031</td> <td style="text-align: center;">数据错误,未找到业务模板</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8032</td> <td style="text-align: center;">数据错误,未找到业务模板配置</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8033</td> <td style="text-align: center;">数据错误,未找到业务模板属性</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8034</td> <td style="text-align: center;">人工筛单结果推送已注册</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8035</td> <td style="text-align: center;">顺丰运单号为空,客户订单自动确认失败</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8036</td> <td style="text-align: center;">顺丰运单号为空,路由推送注册失败</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8037</td> <td style="text-align: center;">客户订单号已取消</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8039</td> <td style="text-align: center;">业务类型(business_type)不合法,时效查询失败</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8040</td> <td style="text-align: center;">原寄地区域代码(code)无法获取,时效查询失败</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8041</td> <td style="text-align: center;">目的地区域代码(code)无法获取,时效查询失败</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8042</td> <td style="text-align: center;">寄件时间(consigned_time)不合法</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8066</td> <td style="text-align: center;">新增加的包裹数(parcel_quantity)不合法,子单号申请失败</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8067</td> <td style="text-align: center;">新增加的包裹数(parcel_quantity)超上限,子单号申请失败</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8068</td> <td style="text-align: center;">顺丰运单号已经生成清单,子单号申请失败</td> <td style="text-align: center;">功能校验</td> </tr> <tr> <td style="text-align: center;">8069</td> <td style="text-align: center;">客户订单不可以收派,子单号申请失败</td> <td style="text-align: center;">功能校验</td> </tr> </tbody> </table>

页面列表

ITEM_HTML