分享一个顺丰同城配送的扩展包并在laravel中使用

2022-05-15 0 583

公司项目需要用到顺丰外卖,所以看了下有没有现成的扩展包可用,但是发现没有,官方也没有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视频教程

收藏 (0) 打赏

感谢您的支持,我会继续努力的!

打开微信/支付宝扫一扫,即可进行扫码打赏哦,分享从这里开始,精彩与您同在
点赞 (0)

【声明:根据2013年1月30日《计算机软件保护条例》2次修订第17条规定: 为了学习和研究软件内含的设计思想和原理,通过安装、显示、传输或者存 储软件等方式使用软件的,可以不经软件著作权人许可,不向其支付报酬! 鉴于此,也希望大家按此说明研究软件!】
本站所有源码尽量保证原汁原味,如有特殊情况会作出声明及标注,网站资源不做任何二次加密(原版加密除外,不影响程序使用的不会做解密处理),方便您更好的学习参考。 在您的能力范围内,为了大环境的良性发展,请尽可能的选择正版资源。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。

即刻码站__国内靠谱的站长资源下载平台 php教程 分享一个顺丰同城配送的扩展包并在laravel中使用 https://www.jike1995.com/37106.html

常见问题
  • 本站所有资源版权均属于原作者所有,这里所提供资源均只能用于参考学习用,请勿直接商用。若由于商用引起版权纠纷,一切责任均由使用
查看详情
  • 最常见的情况是下载不完整: 可对比下载完压缩包的与网盘上的容量,若小于网盘提示的容量则是这个原因。这是浏览器下载的bug,建议用百度
查看详情

相关文章

发表评论
暂无评论
官方客服团队

为您解决烦忧 - 24小时在线 专业服务