电子面单接口申请对接说明

最新推荐文章于 2022-04-19 16:15:07 发布
最新推荐文章于 2022-04-19 16:15:07 发布
阅读量3.2k 收藏 1
点赞数


电商后台物流系统，仓管在发货时同步订单的发/收件人信息、货物信息，通过接口直接发送到快递公司并直接打印电子面单。


1.接口地址： API测试地址：http://testapi.kdniao.cc:8081/api/EOrderService

API正式地址：http://api.kdniao.cc/api/EOrderService

2.接口支持的消息接收方式：HTTP POST

3.请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"

4.订单编号（OrderCode）不可重复提交，重复提交系统会返回具体错误代码。

5.请求、返回数据类型：只支持JSON格式

6.接口提供：快递鸟

 

系统级参数定义

参数名称

类型

说明

必须要求

RequestData

String

请求内容需进行URL(utf-8)编码。请求内容JSON格式，须和DataType一致。

必填

EBusinessID

String

商户ID，请在我的服务页面查看。

必填

RequestType

String

请求指令类型：1007

必填

DataSign

String

数据内容签名：把(请求内容(未编码)+AppKey)进行MD5加密，然后Base64编码，最后进行URL(utf-8)编码。详细过程请查看Demo。

必填

DataType

String

请求、返回数据类型：只支持JSON格式

必填

 

（PHP对接源码）

<?php
 
//电商ID
defined('EBusinessID')or define('EBusinessID', '请申请http://www.kdniao.com/ServiceApply.aspx');
//电商加密私钥，注意保管，不要泄漏
defined('AppKey')or define('AppKey', '请申请http://www.kdniao.com/ServiceApply.aspx');
//请求url，接口正式地址：http://api.kdniao.cc/api/Eorderservice
defined('ReqURL')or define('ReqURL', 'http://testapi.kdniao.cc:8081/api/Eorderservice');
 
 
//调用获取物流轨迹
//-------------------------------------------------------------
 
//构造电子面单提交信息
$eorder= [];
$eorder["ShipperCode"]= "SF";
$eorder["OrderCode"]= "PM201604062341";
$eorder["PayType"]= 1;
$eorder["ExpType"]= 1;
 
$sender= [];
$sender["Name"]= "李先生";
$sender["Mobile"]= "18888888888";
$sender["ProvinceName"]= "李先生";
$sender["CityName"]= "深圳市";
$sender["ExpAreaName"]= "福田区";
$sender["Address"]= "赛格广场5401AB";
 
$receiver= [];
$receiver["Name"]= "李先生";
$receiver["Mobile"]= "18888888888";
$receiver["ProvinceName"]= "李先生";
$receiver["CityName"]= "深圳市";
$receiver["ExpAreaName"]= "福田区";
$receiver["Address"]= "赛格广场5401AB";
 
$commodityOne= [];
$commodityOne["GoodsName"]= "其他";
$commodity= [];
$commodity[]= $commodityOne;
 
$eorder["Sender"]= $sender;
$eorder["Receiver"]= $receiver;
$eorder["Commodity"]= $commodity;
 
 
//调用电子面单
$jsonParam= json_encode($eorder, JSON_UNESCAPED_UNICODE);
 
//$jsonParam= JSON($eorder);//兼容php5.2（含）以下
 
echo"电子面单接口提交内容：<br/>".$jsonParam;
$jsonResult= submitEOrder($jsonParam);
echo"<br/><br/>电子面单提交结果:<br/>".$jsonResult;
 
//解析电子面单返回结果
$result= json_decode($jsonResult, true);
echo"<br/><br/>返回码:".$result["ResultCode"];
if($result["ResultCode"]== "100") {
         echo "<br/>是否成功:".$result["Success"];
}
else{
         echo "<br/>电子面单下单失败";
}
//-------------------------------------------------------------
 
 
/**
 * Json方式查询订单物流轨迹
 */
functionsubmitEOrder($requestData){
         $datas = array(
        'EBusinessID' => EBusinessID,
        'RequestType' => '1007',
        'RequestData' =>urlencode($requestData) ,
        'DataType' => '2',
    );
    $datas['DataSign'] = encrypt($requestData,AppKey);
         $result=sendPost(ReqURL, $datas);     
        
         //根据公司业务处理返回的信息......
        
         return $result;
}
 
 
/**
 *  post提交数据
 * @param string $url 请求Url
 * @param array $datas 提交的数据
 * @return url响应返回的html
 */
functionsendPost($url, $datas) {
    $temps = array();
    foreach ($datas as $key => $value) {
        $temps[] = sprintf('%s=%s', $key,$value);                 
    }
    $post_data = implode('&', $temps);
    $url_info = parse_url($url);
         if($url_info['port']=='')
         {
                   $url_info['port']=80;   
         }
         echo $url_info['port'];
    $httpheader = "POST " .$url_info['path'] . " HTTP/1.0\r\n";
    $httpheader.= "Host:" .$url_info['host'] . "\r\n";
    $httpheader.="Content-Type:application/x-www-form-urlencoded\r\n";
    $httpheader.= "Content-Length:" .strlen($post_data) . "\r\n";
    $httpheader.="Connection:close\r\n\r\n";
    $httpheader.= $post_data;
    $fd = fsockopen($url_info['host'],$url_info['port']);
    fwrite($fd, $httpheader);
    $gets = "";
         $headerFlag = true;
         while (!feof($fd)) {
                   if (($header = @fgets($fd))&& ($header == "\r\n" || $header == "\n")) {
                            break;
                   }
         }
    while (!feof($fd)) {
                   $gets.= fread($fd, 128);
    }
    fclose($fd); 
   
    return $gets;
}
 
/**
 * 电商Sign签名生成
 * @param data 内容  
 * @param appkey Appkey
 * @return DataSign签名
 */
functionencrypt($data, $appkey) {
    returnurlencode(base64_encode(md5($data.$appkey)));
}
/**************************************************************
 *
 *  使用特定function对数组中所有元素做处理
 * @param  string  &$array     要处理的字符串
 * @param  string  $function  要执行的函数
 * @return boolean $apply_to_keys_also    是否也应用到key上
 * @access public
 *
 *************************************************************/ 
functionarrayRecursive(&$array, $function, $apply_to_keys_also = false) 
{ 
    static $recursive_counter = 0; 
    if (++$recursive_counter > 1000) { 
        die('possible deep recursionattack'); 
    } 
    foreach ($array as $key => $value){ 
        if (is_array($value)) { 
            arrayRecursive($array[$key],$function, $apply_to_keys_also); 
        } else { 
            $array[$key] =$function($value); 
        } 
  
        if ($apply_to_keys_also &&is_string($key)) { 
            $new_key = $function($key); 
            if ($new_key != $key) { 
                $array[$new_key] =$array[$key]; 
                unset($array[$key]); 
            } 
        } 
    } 
    $recursive_counter--; 
} 
 
 
/**************************************************************
 *
 *  将数组转换为JSON字符串（兼容中文）
 * @param  array   $array     要转换的数组
 * @return string      转换得到的json字符串
 * @access public
 *
 *************************************************************/ 
functionJSON($array) { 
    arrayRecursive($array, 'urlencode',true); 
    $json = json_encode($array); 
    return urldecode($json); 
} 
?>


（C#对接源码）


usingSystem;
usingSystem.Collections.Generic;
usingSystem.IO;
usingSystem.Linq;
usingSystem.Net;
usingSystem.Text;
usingSystem.Web;
 
namespaceKdGoldAPI
{
    public class KdApiEOrderDemo
    {
        //电商ID
        private string EBusinessID = "请申请http://www.kdniao.com/ServiceApply.aspx";
        //电商加密私钥，注意保管，不要泄漏
        private string AppKey = "请申请http://www.kdniao.com/ServiceApply.aspx";
        //请求url, 正式环境地址：http://api.kdniao.cc/api/Eorderservice
        private string ReqURL ="http://testapi.kdniao.cc:8081/api/EOrderService";
 
        /// <summary>
        /// Json方式  电子面单
        /// </summary>
        /// <returns></returns>
        public string orderTracesSubByJson()
        {
            string requestData ="{'OrderCode': '012657700312'," +
                                 "'ShipperCode':'YTO'," +
                                 "'PayType':1," +
                                 "'ExpType':1," +
                                 "'Cost':1.0," +
                                 "'OtherCost':1.0," +
                                 "'Sender':" +
                                  "{"+
                                 "'Company':'LV','Name':'Taylor','Mobile':'15018442396','ProvinceName':'上海','CityName':'上海','ExpAreaName':'青浦区','Address':'明珠路73号'}," +
                                 "'Receiver':" +
                                  "{"+
                                 "'Company':'GCCUI','Name':'Yann','Mobile':'15018442396','ProvinceName':'北京','CityName':'北京','ExpAreaName':'朝阳区','Address':'三里屯街道雅秀大厦'}," +
                                 "'Commodity':" +
                                  "[{" +
                                 "'GoodsName':'鞋子','Goodsquantity':1,'GoodsWeight':1.0}],"+
                                 "'AddService':" +
                                 "[{" +
                                 "'Name':'COD','Value':'1020'}]," +
                                 "'Weight':1.0," +
                                 "'Quantity':1," +
                                 "'Volume':0.0," +
                                 "'Remark':'小心轻放',"+
                                  "'IsReturnPrintTemplate':1}";
 
            Dictionary<string, string>param = new Dictionary<string, string>();
            param.Add("RequestData",HttpUtility.UrlEncode(requestData, Encoding.UTF8));
            param.Add("EBusinessID",EBusinessID);
            param.Add("RequestType","1007");
            string dataSign =encrypt(requestData, AppKey, "UTF-8");
            param.Add("DataSign",HttpUtility.UrlEncode(dataSign, Encoding.UTF8));
            param.Add("DataType","2");
 
            string result = sendPost(ReqURL,param);
 
            //根据公司业务处理返回的信息......
 
            return result;
        }
 
        /// <summary>
        /// Post方式提交数据，返回网页的源代码
        /// </summary>
        /// <param name="url">发送请求的 URL</param>
        /// <param name="param">请求的参数集合</param>
        /// <returns>远程资源的响应结果</returns>
        private string sendPost(string url,Dictionary<string, string> param)
        {
            string result = "";
            StringBuilder postData = newStringBuilder();
            if (param != null &¶m.Count > 0)
            {
                foreach (var p in param)
                {
                    if (postData.Length > 0)
                    {
                       postData.Append("&");
                    }
                    postData.Append(p.Key);
                   postData.Append("=");
                    postData.Append(p.Value);
                }
            }
            byte[] byteData =Encoding.GetEncoding("UTF-8").GetBytes(postData.ToString());
            try
            {
 
                HttpWebRequest request =(HttpWebRequest)WebRequest.Create(url);
                request.ContentType ="application/x-www-form-urlencoded";
                request.Referer = url;
                request.Accept ="*/*";
                request.Timeout = 30 * 1000;
                request.UserAgent ="Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 2.0.50727;.NET CLR 3.0.04506.648; .NET CLR 3.0.4506.2152; .NET CLR 3.5.30729)";
                request.Method ="POST";
                request.ContentLength =byteData.Length;
                Stream stream =request.GetRequestStream();
                stream.Write(byteData, 0,byteData.Length);
                stream.Flush();
                stream.Close();
                HttpWebResponse response =(HttpWebResponse)request.GetResponse();
                Stream backStream =response.GetResponseStream();
                StreamReader sr = newStreamReader(backStream, Encoding.GetEncoding("UTF-8"));
                result = sr.ReadToEnd();
                sr.Close();
                backStream.Close();
                response.Close();
                request.Abort();
            }
            catch (Exception ex)
            {
                result = ex.Message;
            }
            return result;
        }
 
        ///<summary>
        ///电商Sign签名
        ///</summary>
        ///<paramname="content">内容</param>
        ///<paramname="keyValue">Appkey</param>
        ///<paramname="charset">URL编码</param>
        ///<returns>DataSign签名</returns>
        private string encrypt(String content,String keyValue, String charset)
        {
            if (keyValue != null)
            {
                return base64(MD5(content +keyValue, charset), charset);
            }
            return base64(MD5(content,charset), charset);
        }
 
        ///<summary>
        /// 字符串MD5加密
        ///</summary>
        ///<param name="str">要加密的字符串</param>
        ///<paramname="charset">编码方式</param>
        ///<returns>密文</returns>
        private string MD5(string str, stringcharset)
        {
            byte[] buffer =System.Text.Encoding.GetEncoding(charset).GetBytes(str);
            try
            {
               System.Security.Cryptography.MD5CryptoServiceProvider check;
                check = newSystem.Security.Cryptography.MD5CryptoServiceProvider();
                byte[] somme =check.ComputeHash(buffer);
                string ret = "";
                foreach (byte a in somme)
                {
                    if (a < 16)
                        ret += "0" +a.ToString("X");
                    else
                        ret +=a.ToString("X");
                }
                return ret.ToLower();
            }
            catch
            {
                throw;
            }
        }
 
        /// <summary>
        /// base64编码
        /// </summary>
        /// <param name="str">内容</param>
        /// <paramname="charset">编码方式</param>
        /// <returns></returns>
        private string base64(String str,String charset)
        {
            returnConvert.ToBase64String(System.Text.Encoding.GetEncoding(charset).GetBytes(str));
        }
    }
}


kjyiyi
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
中通 圆通 申通 电子面单接口对接
09-09
在IT行业中，快递行业的自动化和数字化是提升效率的关键一环，而电子面单接口的对接则是其中的重要组成部分。本文将详细讲解如何使用Java语言来对接中通、圆通和申通三家快递公司的电子面单接口。 首先，我们需要...
TestFrameWork API接口测试框架
wwg377655460的专栏
11-22 1779
TestFreamWork是Java编写的测试框架 写一些API接口，写好了测试感觉比较麻烦，还要自己写接口文档，就想能不能将测试和接口文档结合一下，就自己写了这个轮子，它可以接口测试，同时根据我们测试的代码生成相应的md格式的文档，还有一些问题，在完善 github地址TestFreamWork 特点: 1. 使用了Java8 lambda表达式 2. 使用get, p
API对接实战
实践求真知
09-26 1万+
目录 一背景 二了解B公司接口的基础约定 三基础域名 四请求及相应格式说明 五确定要对接哪些API 六根据API文档，编写一些基础工具类。 七根据API文档，编写必要的DTO 八针对每个API方法，进行对接 九对接代码结构 十一些对接技巧 一背景 在平时工作中，经常会遇到的一种场景是：A公司要对接B公司的API方法，这时，A公司就要阅读B公司的接口文档，从接口文档中找到自己需要对接的API，并根据接口文档的要求，完成编码工作，最终完成对接工作。 本篇是站在A公...
Java 接入testrail API 接口方法
会飞的小小猪的博客
08-21 1343
一.写在前面 https://blog.csdn.net/u014663877/article/details/99995215 这篇文章介绍了如何通过postman 来给testrail 发送请求的方法。在了解了testrail API的请求方法之后，如何在Java中实现这一请求过程呢？ 二.在Java中连接testrail的方法 连接Java 的方法在testrail API ...
订单类 京东快递电子面单接口的使用开发
KuaiDNiao的博客
04-19 1047
京东快递电子面单接口的使用开发。电子面单接口支持多家快递物流公司单号获取、分拣码返回、面单打印、在线下单发货、通知快递员上门取件等功能，可用于电商平台、自营商城、打单工具、WMS仓储系统、APP等需要发货的场景，可有效提高商家的打印效率，帮助其降低运营成本。
顺丰丰桥面单打印.rar
09-16
顺丰丰桥面单打印接口是顺丰速运提供的一项服务，用于帮助商家或个人实现自动化打印电子面单，提高物流操作效率。在这个名为“顺丰丰桥面单打印.rar”的压缩包中，包含的是一个完整的电子面单打印接口的代码实现，...
拼多多云打印JAVA-SDK包
07-19
2. **电子面单接口调用**：通过SDK，开发者可以方便地调用拼多多提供的API，获取电子面单模板，填充订单信息，并生成可打印的PDF或图片格式的面单。 3. **打印控制**：SDK支持各种打印机型号，包括网络打印机和本地...
C#顺丰接口实例
09-30
5. **电子面单接口**：提供电子面单的申请和打印服务，简化快递流程。 在C#中实现这些接口，我们通常会使用HTTP请求或者SDK。SDK（Software Development Kit）是顺丰提供的预封装好的代码库，它包含了一系列与接口...
快递物流查询接口介绍API接口实现.docx
最新发布
11-15
快递鸟提供的服务包括即时查询接口、订阅接口、在线下单接口和电子面单接口，且这些接口都不收取费用。对于大规模查询需求，它提供了统一的接口模式，支持超过3000次的查询，并且覆盖了常见的国内外快递公司。而快递...
系统接入申请表模板
01-24
多系统集成，接入申请表模板。目前项目实施过程中在用，供参考。
系统发布申请单模版
09-27
系统发布 系统升级 申请单 模版，此次变更涉及到路网轨道资产管理平台系统代码的更新和系统中部分应用模块数据的配置和流程配置。
韵达物流管理系统
12-17
mysql jsp ,实现了，业主注册，业主登录，系统管理员后台登录等功能。 有通知公告栏，物流信息栏，物流收费信息栏，客户信息栏等内容 资料完整，带有数据库文件，运行就有了
电子面单接口Demo工具JAVA版.rar
06-22
电子面单接口Demo工具JAVA版，登录快递鸟获得用户ID和APIKey对应各demo中的EBusinessID、AppKey。
韵达电子面单二维码服务软件
11-07
韵达电子面单打印 支持js web方式调用 很方便 打印电子面单
常用电子面单接口API及对接方式
doufuhua517的博客
11-03 6871
现在电商行业发展很快，很多企业订单量大，手写快递单比较慢，所以开通对接电子面单打印API接口就成了很多企业迫切需要的功能；    目前申请渠道目前有三个，快递公司、菜鸟和快递鸟。前两个对接接口需要一定的资质，后两个对接后可以打印15~20家快递的电子面单，不需要一家家对接     对接以比较简单的快递鸟为例 接口对接流程： 申请电子面单账号-申请API-对接-调试-测试-使用
各种电子面单-Api接口(顺丰、快递鸟、菜鸟)
热门推荐
程序猿开发日志【学习永无止境】
02-28 1万+
术语 对于一般人，电子面单的意思可能并不是很了解；说白了，就是快递员给你打印的快递单的电子版。 专业解释： 电子面单是一种通过热敏纸打印输出纸质物流面单的物流服务。通过热感应显示文字，打印速度比传统针式打印速度提升4~6倍。电子面单以接口形式嵌入到自己的系统、网站上，可以在自己的平台操作打印电子面单。 电子面单样式   对接接口各家对比 快递电
电商ERP如何接入快递鸟电子面单API?
07-19 6984
快递鸟是全球物流接口服务商，为电商 ERP、电商平台、仓储、清关公司提供物流跟踪、电子面单、智选物流、物流金融、在线下单等服务，解决电商的物流管理模块和金融模块。现就对快递鸟电子面单API做基本描述，并提供电子面单接口的对接方式。
圆通快递电子面单接口开发坑
wdd668的专栏
01-06 6946
用了3天左右对接落实圆通快递电子面单，这过程遇到觉得坑的就是签名，用了将近一个下午。 接口地址：http://open.yto.net.cn/OpenPlatform/doc 电子面单创建标准接口： 签名流程： 1.1.3 数据处理 序号 步骤 1 在POST时用“logistics_interface”字段表示要发送
电子面单接口申请对接（返回电子面单模板）
11-25 2604
接口支持的消息接收方式：HTTPPOST 请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8" 请求、返回数据类型：只支持JSON格式 接口提供：快递鸟 （JAVA对接源码） import java.io.BufferedReader; import java.io.IOException; import
快递100企业版电子面单接口全面指南
快递100企业版电子面单接口技术文档详细介绍了企业级的物流管理和自动化解决方案，专为对接中国境内的多家知名快递公司如EMS、顺丰、四通一达以及京东等设计。该文档的核心内容围绕电子面单API展开，旨在简化企业与...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值