站长图库向大家介绍了顺丰同城配送扩展包,laravel扩展包等相关知识,希望对您有所帮助
公司项目需要用到顺丰外卖，所以看了下有没有现成的扩展包可用，但是发现没有，官方也没有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