公司项目需要用到顺丰外卖,所以看了下有没有现成的扩展包可用,但是发现没有,官方也没有SDK,所以自己写了一个包,省了不少工作量。
安装
$ composer require ycstar/sfopenic -vvv
配置
在使用本扩展之前,你需要去顺丰同城开放平台注册账号,然后申请开发者ID,获取相应的配置
使用
use Ycstar\Sfopenic\Sfopenic; $config = [ 'host' => 'xxxxxxxxxxxx', 'dev_id' => 'xxxxxxxxxxxx', 'dev_key' => 'xxxxxxxxxxxx' ]; $sfopenic = new Sfopenic($config);
预创建订单
$data = [ 'shop_id' => 'xxxxxxxxxxxx', 'user_address' => "北京市海淀区学清嘉创大厦A座15层", 'user_lng' => '116.352569', 'user_lat' => '40.014838', 'weight' => 100, 'product_type' => 1, 'pay_type' => 1, 'is_appoint' => 0, 'is_insured' => 0, 'is_person_direct' => 0 ]; $res = $sfopenic->preCreateOrder($data);
创建订单
$array = [ 'shop_id' => 'xxxxxxxxxxxx', 'shop_order_id' => 'xxxxxxxxxxxx', 'order_source' => 'xx', 'pay_type' => 1, 'order_time' => time(), 'is_appoint' => 0, 'is_insured' => 0, 'is_person_direct' => 0, 'version' => 17, 'order_sequence' => 'xx', 'remark' => 'xx' ]; $receive =[ 'user_name' => "xx", 'user_phone' => "xxxxxxxxxx", 'user_address' => "北京市海淀区学清嘉创大厦A座15层", 'user_lng' => '116.352569', 'user_lat' => '40.014838', ]; $order_detail = [ 'total_price' => 1,//总金额 'product_type' => 1, //物品类型 1:送餐 8:饮品 'weight_gram' => 100,//物品重量 'product_num' => 3,//物品个数 'product_type_num' => 1,//物品种类个数 ]; $product_detail[]=[ 'product_name'=>'xxx',//物品名称 'product_num' => 1,//物品数量 ]; $order_detail['product_detail'] = $product_detail; $array['order_detail'] = $order_detail; $array['receive'] = $receive; $res = $sfopenic->createOrder($data);
取消订单
$data = [ 'order_id' => 'xxxxxxxxxxxx', 'order_type' => 1 //1、顺丰订单号 2、商家订单号 'shop_id' => 0, //order_type=2时必传shop_id与shop_type 'shop_type' => 1, //1、顺丰店铺ID 2、接入方店铺ID 'cancel_code' => 313, //不填时默认cancel_code=313,cancel_reason=商家发起取消 'cancel_reason' => '' ]; $res = $sfopenic->cancelOrder($data);
预取消订单
$data = [ 'order_id' => 'xxxxxxxxxxxx', 'order_type' => 1 //1、顺丰订单号 2、商家订单号 'shop_id' => 0, //order_type=2时必传shop_id与shop_type 'shop_type' => 1, //1、顺丰店铺ID 2、接入方店铺ID 'cancel_reason' => '' ]; $res = $sfopenic->preCancelOrder($data);
订单加小费
$data = [ 'order_id' => 'xxxxxxxxxxxx', 'order_type' => 1 //1、顺丰订单号 2、商家订单号 'shop_id' => 0, 'shop_type' => 1, //1、顺丰店铺ID 2、接入方店铺ID 'gratuity_fee' => 0 ]; $res = $sfopenic->addOrderGratuityFee($data);
获取订单加小费信息
$data = [ 'order_id' => 'xxxxxxxxxxxx', 'order_type' => 1 //1、顺丰订单号 2、商家订单号 'shop_id' => 0, 'shop_type' => 1, //1、顺丰店铺ID 2、接入方店铺ID ]; $res = $sfopenic->getOrderGratuityFee($data);
订单状态流查询
$data = [ 'order_id' => 'xxxxxxxxxxxx', 'order_type' => 1 //1、顺丰订单号 2、商家订单号 'shop_id' => 0, //order_type=2时必传shop_id与shop_type 'shop_type' => 1, //1、顺丰店铺ID 2、接入方店铺ID ]; $res = $sfopenic->listOrderFeed($data);
订单实时信息查询
$data = [ 'order_id' => 'xxxxxxxxxxxx', 'order_type' => 1 //1、顺丰订单号 2、商家订单号 'shop_id' => 0, //order_type=2时必传shop_id与shop_type 'shop_type' => 1, //1、顺丰店铺ID 2、接入方店铺ID ]; $res = $sfopenic->getOrderStatus($data);
催单
$data = [ 'order_id' => 'xxxxxxxxxxxx', 'order_type' => 1 //1、顺丰订单号 2、商家订单号 'shop_id' => 0, //order_type=2时必传shop_id与shop_type 'shop_type' => 1, //1、顺丰店铺ID 2、接入方店铺ID ]; $res = $sfopenic->reminderOrder($data);
改单
$data = [ 'order_id' => 'xxxxxxxxxxxx', 'order_type' => 1 //1、顺丰订单号 2、商家订单号 'shop_id' => 0, 'shop_type' => 1, //1、顺丰店铺ID 2、接入方店铺ID 'user_name'=> '', 'user_phone'=> '', 'user_address'=> '', 'lbs_type'=> 2, //1:百度坐标,2:高德坐标(默认值为2,下面的经纬度依赖这个坐标系,不传默认高德) 'user_lng'=> '', //传入用户地址经纬度顺丰侧则不根据用户地址解析 'user_lat'=> '', ]; $res = $sfopenic->changeOrder($data);
获取配送员实时坐标接口
$data = [ 'order_id' => 'xxxxxxxxxxxx', 'order_type' => 1 //1、顺丰订单号 2、商家订单号 'shop_id' => 0, //order_type=2时必传shop_id与shop_type 'shop_type' => 1, //1、顺丰店铺ID 2、接入方店铺ID ]; $res = $sfopenic->riderLatestPosition($data);
获取配送员轨迹H5
$data = [ 'order_id' => 'xxxxxxxxxxxx', 'order_type' => 1 //1、顺丰订单号 2、商家订单号 'shop_id' => 0, //order_type=2时必传shop_id与shop_type 'shop_type' => 1, //1、顺丰店铺ID 2、接入方店铺ID ]; $res = $sfopenic->riderViewV2($data);
订单回调详情
$data = [ 'order_id' => 'xxxxxxxxxxxx', 'order_type' => 1 //1、顺丰订单号 2、商家订单号 'shop_id' => 0, 'shop_type' => 1, //1、顺丰店铺ID 2、接入方店铺ID ]; $res = $sfopenic->getCallbackInfo($data);
获取回调数据及回复内容
$data = $sfopenic->getNotify(); . . . return $sfopenic->getNotifySuccessReply();
在laravel中使用
在 Laravel 中使用也是同样的安装方式,【推荐:《laravel教程》】
使用下面的命令来导出配置文件
php artisan vendor:publish --tag="ycstar-sfopenic"
配置写在 config/sfopenic.php 中:
return [ 'host' => env('SF_OPENIC_HOST'), 'dev_id' => env('SF_OPENIC_DEV_ID'), 'dev_key' => env('SF_OPENIC_DEV_KEY') ];
然后在 .env 中配置 SF_OPENIC_HOST, SF_OPENIC_DEV_ID, SF_OPENIC_DEV_KEY:
SF_OPENIC_HOST = xxxxxxxxxxxx SF_OPENIC_DEV_ID = xxxxxxxxxxxx SF_OPENIC_DEV_KEY = xxxxxxxxxxxx
可以用两种方式来获取 Ycstar\Sfopenic\Sfopenic 实例:
- 方法参数注入
. . . public function preCreateOrder(Sfopenic $sfopenic) { $res = $sfopenic->preCreateOrder($data); } . . .
- 服务名访问
. . . public function preCreateOrder() { $res = app('sfopenic')->preCreateOrder($data); } . . .
以上就是分享一个顺丰同城配送的扩展包并在laravel中使用的详细内容,更多请关注亿码酷站其它相关文章!
分享一个顺丰同城配送的扩展包并在laravel中使用
—–文章转载自PHP中文网如有侵权请联系ymkuzhan@126.com删除
转载请注明来源:分享一个顺丰同城配送的扩展包并在laravel中使用
本文永久链接地址:https://www.ymkuzhan.com/38001.html
本文永久链接地址:https://www.ymkuzhan.com/38001.html
下载声明:
本站资源如无特殊说明默认解压密码为www.ymkuzhan.com建议使用WinRAR解压; 本站资源来源于用户分享、互换、购买以及网络收集等渠道,本站不提供任何技术服务及有偿服务,资源仅提供给大家学习研究请勿作它用。 赞助本站仅为维持服务器日常运行并非购买程序及源码费用因此不提供任何技术支持,如果你喜欢该程序,请购买正版! 版权声明:
下载本站资源学习研究的默认同意本站【版权声明】若本站提供的资源侵犯到你的权益,请提交版权证明文件至邮箱ymkuzhan#126.com(将#替换为@)站长将会在三个工作日内为您删除。 免责声明:
您好,本站所有资源(包括但不限于:源码、素材、工具、字体、图像、模板等)均为用户分享、互换、购买以及网络收集而来,并未取得原始权利人授权,因此禁止一切商用行为,仅可用于个人研究学习使用。请务必于下载后24小时内彻底删除,一切因下载人使用所引起的法律相关责任,包括但不限于:侵权,索赔,法律责任,刑事责任等相关责任,全部由下载人/使用人,全部承担。以上说明,一经发布视为您已全部阅读,理解、同意以上内容,如对以上内容持有异议,请勿下载,谢谢配合!支持正版,人人有责,如不慎对您的合法权益构成侵犯,请联系我们对相应内容进行删除,谢谢!