开放平台

花娃接口说明

基本信息

Path： /newapi/

Method： POST

接口描述：

概述

使用花娃API需要先申请API密钥，包含商户账号 ( api_account ) 和安全校验码 ( keycode ) ，其中商户账号将作为参数包含在每一个请求中发送，而安全校验码负责生成请求串的签名，请妥善保存。

API请求地址

https://open.huawa.com/newapi/action

其中action为具体接口名，例如导入订单接口为 https://open.huawa.com/newapi/import

签名方法

这里介绍API请求中签名 ( sign ) 的生成方法。假设已获得密钥ID和私钥如下 (不含单引号)：

api_account = '6788429550'
keycode = '98561aff7ah38adf04804c41'
例如请求的POST数据如下（不包含sign）请确保去除数据首尾空格，否则导入将会失败：
istimer=0
&delivery_time=2
&songdate=2017-04-01
&receive_name=白百何
&receive_mobile=18910981098
&area_info=四川省 成都市 锦江区
&address=华润二十四城1栋10单元602室
&material=11支红粉玫瑰加满天星点缀
&quantity=1
&order_amount=280
&cb_price=280
&remark=请务必保证花材新鲜
&picurl=http://images.aihuaju.com/1.jpg,http://images.aihuaju.com/2.jpg
&card_description=生日快乐小百合
&send_mobile=13960882688
&invoice_title=
&seller_order=
&api_account=6788429550
&timestamp=1366789919

签名步骤

按参数名进行升序排列：

address=华润二十四城1栋10单元602室
&api_account=6788429550
&area_info=四川省 成都市 锦江区
&card_description=生日快乐小百合
&cb_price=280
&delivery_time=2
&invoice_title=
&istimer=0
&material=11支红粉玫瑰加满天星点缀
&order_amount=280
&picurl=http://i.ahj.cm/g/1/2017/01/1_05369366745071968_418.jpg,http://i.ahj.cm/g/1/2017/01/1_05386771287869773_418.jpg
&quantity=1
&receive_mobile=18910981098
&receive_name=白百何
&remark=请务必保证花材新鲜
&seller_order=
&send_mobile=13960882688
&songdate=2017-04-01
&timestamp=1366789919

重新拼接，得到最终待校验的字符串(注意不能urlencode，值前后不能加空格)：

address=华润二十四城1栋10单元602室&api_account=6788429550&area_info=四川省 成都市 锦江区&card_description=生日快乐小百合&cb_price=280&delivery_time=2&istimer=0&material=11支红粉玫瑰加满天星点缀&order_amount=280&picurl=http://i.ahj.cm/g/1/2017/01/1_05369366745071968_418.jpg,http://i.ahj.cm/g/1/2017/01/1_05386771287869773_418.jpg&quantity=1&receive_mobile=18910981098&receive_name=白百何&remark=请务必保证花材新鲜&send_mobile=13960882688&songdate=2017-04-01&timestamp=1366789919

计算签名

（1）MD5签名方式：
接口新增传参”is_net“，值为1，并且此参数不参与签名
将API密钥的私钥 ( api_account ) 作为key，生成被签名串的 MD5 签名
将签名进行 Base64 编码
将 Base64 编码后的结果进行 URL 编码
将签名得到的值赋给参数”sign”并传递

（2）SHA256签名方式：
将API密钥的私钥 ( api_account ) 作为key，生成被签名串的 HMAC-SHA256 签名
将签名进行 Base64 编码
将 Base64 编码后的结果进行 URL 编码
将签名得到的值赋给参数”sign”并传递

签名代码示例
1). php代码示例

$params = array();
$params['address'] = '华润二十四城1栋10单元602室';
$params['area_info'] = '四川省成都市锦江区';
$params['card_description'] = '生日快乐小百合';
$params['cb_price'] = 280;
$params['delivery_time'] = 2;
ksort($params);
$str = urldecode(http_build_query($params));
$hash = mhash(MHASH_SHA256, $str, $keycode);
$params['sign'] = base64_encode($hash);// base64结果=====>KJvSQRD2Zh/dnzFCtf5tMnaxKQITSnh79lclb2JFnjk=
$url = "https://open.huawa.com/newapi/import";
$data = http_post($url, $params);

2). java代码示例

public static String sign (String secretKey,String parm){
    String data = "address=经济技术开发区滨海一道xxxx号 xxxx有限公司&api_account=5261648792&area_info=四川省 成都市 锦江区&card_description=我要当一棵树，因为一旦种在这个地方，以后它都会永远在那里不会换&delivery_time=1&invoice_title=&is_payment=1&is_self_delivery=1&istimer=0&material=33朵顶级粉玫瑰,搭配黄莺外围点缀而成&order_amount=126&picurl=https://os.huawa.cn/shop/placeorder/07243294457201259.jpg&quantity=1&receive_mobile=18281653256&receive_name=kevin&remark=请准时送达&sales_price=365&send_mobile=18281653226&send_name=test&send_qq=380331131&songdate=2024-08-01 16:30:00&timestamp=1721635005";
    data=parm;
    try {
        Mac mac = Mac.getInstance("HmacSHA256");
        SecretKeySpec secretKeySpec = new SecretKeySpec(secretKey.getBytes(StandardCharsets.UTF_8), "HmacSHA256");
        mac.init(secretKeySpec);
        byte[] rawHmac = mac.doFinal(data.getBytes(StandardCharsets.UTF_8));
        String encryptedString = Base64.getEncoder().encodeToString(rawHmac);
    System.out.println("Encrypted data: " + encryptedString);
    return  encryptedString;
} catch (Exception  e) {
    e.printStackTrace();
}
return "";

}

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	import_huawa	是	import_huawa	必须传入

返回数据

名称	类型	是否必须	默认值	备注	其他信息

开放平台通知接口

数据签名

基本信息

Path： /30/211

Method： POST

接口描述：

通知消息数据签名

概述

数据签名验证可保证数据来源的安全性，建议使用签名对数据进行验证
接收到花娃推送的数据后，可对数据进行签名验证，需要开启api导入，已经生成商户账号api_account 和安全校验码keycode。

签名过程

在已经获取到账户安全校验码的条件下
按字典顺序排序参数,拼接成字符串
在拼接好的字符串后面拼接 &key=安全校验码
MD5加密字符串
将字符串转为大写

签名代码示例(PHP)

    //签名方法
    /**
    * @param array $origin_data 进行签名的数据
    * @param sting $key_code 安全校验码
    */
    function signData(array $origin_data, $key_code = ''){
        //签名步骤一：按字典序排序参数
        ksort($origin_data);
        $string = $this->ToUrlParams($origin_data);
        //签名步骤二：在string后加入KEY
        $string = $string . "&key=" . $key_code;
        //签名步骤三：MD5加密
        $string = md5($string);
        //签名步骤四：所有字符转为大写
        $result = strtoupper($string);
        //   print_r("--------".$result);die;
        return $result;
    }
// 签名组装字符串
function ToUrlParams($origin_data){
    $buff = "";
    foreach ($origin_data as $k => $v) {
        if($k != "sign" && $v != "" && !is_array($v)){
            $buff .= $k . "=" . urlencode($v) . "&";
        }
    }
    $buff = trim($buff, "&");
    return $buff;
}

验签过程代码示例(PHP)

    $postDataArr = json_decode(file_get_contents("php://input"), true);
    $postData = $postDataArr['data'];
    $signOrigin = $postData['sign_data'];  //服务端的签名数据
    unset($postData['sign_data']);  //去掉签名数据
    $key = 'b817f322013d77c8522a81d5c73ffd63'; //安全校验码
    $signString = signData($postData, $key);
    if ($signString != $signOrigin) {
        echo '验签失败';
        file_put_content('a.txt', '签名验证失败===>'. var_export($postData, true) ."\r\n".'原始数据==>' . var_export($postDataArr['data'], true));
        die;
    }
    echo '验签成功';
    file_put_conten('a.txt', '签名成功===>'. $signString);

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

返回数据

名称	类型	是否必须	默认值	备注	其他信息
result	number	非必须

订单api导入订单通知消息

基本信息

Path： /30/21

Method： POST

接口描述：

概述

开通api导入
此通知在订单状态发生改变时，系统通过api导入-通知地址接口向下单方通知订单最新消息。

1.下单方在花娃上第三方订单管理中,店铺管理开通"api导入"功能，系统会生成商户账号api_account 和 安全校验码keycode。
2.输入通知地址接口后，系统会在订单状态发生改变时，向此地址推送消息数据。如填写： http://www.dumain.com 必须保证接口在任何情况下http状态值200。否则无法填写接口名
3.输入的接口地址必须保证在任何情况下都可访问，接收数据方法为POST。若不输入此地址，则不会通知。
4.通知可能会重复，请严格按照文档要求返回数据，避免重复通知。
5.若接口返回的数据错误,通知会在短时间内发起三次，三次后则不再进行通知。

安全校验码验证

开发人员在配置通知接口时，需要保证接口输出{"data":"HW_SUCCESS"} json字符串。

    echo json_encode(array('data'=>'HW_SUCCESS'));exit; // 验证成功后再处理业务逻辑 
    //TODO 接口的业务逻辑

接口说明

适用对象：开通"api导入"的花娃下单方
请求方式：POST,Content-type为 application/json
回调URL：该url 是在开通"api导入"后输入的接口地址，示例:http://www.domain.com/api/get_params

通知参数

{"status":1,"data":{"push_content":"\\u8ba2\\u5355\\uff1a20220601-194007-24375\\uff0c\\u7533\\u8bc9\\u5df2\\u7ecf\\u5b8c\\u6210","api_notify_url":"http:\\/\\/hwtest.tfxk.org\\/index.php?c=cc&a=aa","order_sn":"20220601-194007-24375","order_state":"FINISH_COMPLAINT","order_amount":"50.00","pay_amount":"50.00","seller_order":"","return_refund_info":{"refund_reason":"\\u82b1\\u6750\\u4e0d\\u7b26,\\u6d4b\\u8bd5\\u7533\\u8bc9,\\u8fdb\\u5165\\u552e\\u540e","refund_time":"1654084187","refund_amount":"12.00","seller_refund_time":"1654084211"},"return_complaint_info":{"complain_content":"\\u6d4b\\u8bd5\\u7533\\u8bc9,\\u8fdb\\u5165\\u552e\\u540e","complain_message":"\\u6d4b\\u8bd5\\u7533\\u8bc9,\\u8fdb\\u5165\\u552e\\u540e","complain_subject_content":"\\u82b1\\u6750\\u4e0d\\u7b26","appeal_datetime":"1654084211","complain_handle_datetime":"0","final_handle_datetime":"0","final_handle_message":"","refund_buy_amount":"0.00","refund_seller_amount":"0.00"}}}

公共参数

字段	意义	参数值示例
status	通知状态,发送通知成功	1
data	通知数据	object

data参数详解

字段	意义	参数值示例	是否必须存在
push_content	推送的内容	订单:20220427-111741-05663,已经由花店【陌上花开花铺】开始配送	是
api_notify_url	接收数据的地址	http://www.domain.com/api/get_params	是
order_sn	订单编号	20220427-111741-05663	是
order_amount	订单金额	50.00	是
seller_order	商家订单系统id号	0856652566855	是
order_state	订单状态	PAY_ORDER_SUCCESS	是
return_pay_info	订单支付数据,当订单状态为支付成功时此参数存在	object	否
return_store_info	花店数据,当订单状态为指定给花店、花店接单、花店拒绝接单、花店开始配送、订单送达、完成订单时此参数存在	object	否
return_delivery_info	配送数据,当订单状态为花店开始配送、订单送达、完成订单时此参数存在	object	否
return_refund_info	申请退款数据,当订单状态为申请退款、花店同意退款、花店拒绝退款、发起申诉、申诉完成时时此参数存在	object	否
return_complaint_info	订单申诉数据,当订单状态为订单发起申诉、申诉完成时此参数存在	object	否
return_cancel_info	取消订单数据,当订单取消时此参数存在	object	否
return_bidding_price	花店报价,当有花店报价是此参数存在	object	否

订单状态参数详解 order_state

参数值	意义
PAY_ORDER_SUCCESS	支付订单成功
POINT_STORE_ORDER	指定订单给花店
STORE_REFUSE_ORDER	花店拒接指定单
STORE_ACCEPT_ORDER	花店接单
START_DELIVERY_ORDER	花店开始配送订单
ORDER_ACHIEVE	订单已送达
ORDER_FINISH	订单完成
CANCEL_ORDER	取消订单
APPLY_REFUND	申请退款
STORE_AGREE_REFUND	花店同意同款
STORE_REFUSE_REFUND	花店拒绝退款
APPLY_COMPLAINT	订单发起申诉
FINISH_COMPLAINT	申诉完成
STORE_SEND_IMG	花店上传花图
ORDER_STORE_PRICE	花店报价
STORE_CANCEL_ORDER	花店撤单

订单支付数据详解 return_pay_info

字段	意义	参数值示例
pay_time	支付时间（时间戳）	1563271245

花店数据据详解 return_store_info

字段	意义	参数值示例	是否必须存在
store_name	花店名称	1563271245	是
store_mobile	花店电话	15022236654	是
store_addr_info	花店地址	四川省成都市武侯区泉南大街与顺德路交叉口西行100米路南	是
accept_time	接单时间,当状态值为花店接单时存在	1563271245	否

配送数据详解 return_delivery_info

字段	意义	参数值示例
deliver_type	配送方式,0花店自配送 1三方配送	0

取消订单数据详解 return_cancel_info

字段	意义	参数值示例
cancel_time	取消订单时间戳	1558390672

申请退款数据详解 return_refund_info

字段	意义	参数值示例	是否必须存在
refund_reason	申请退款原因	协商退款	是
refund_time	申请退款时间	1563271245	是
refund_amount	申请退款金额	12.00	是
seller_refund_time	卖家处理退款时间,当订单状态为花店同意退款、花店拒绝退款时，此参数存在	1563271245	否

订单申诉数据详解 return_complaint_info

字段	意义	参数值示例	是否必须存在
complain_content	投诉内容	申请退款金额12.80元	是
complain_message	被投诉商品的问题描述	花材不符,花材不好看	是
complain_subject_content	商家不同意退款	1563271245	是
appeal_datetime	提起申诉时间	1569228676	是
complain_handle_datetime	卖家处理退款时间,当订单状态申诉完成时存在	1563271245	否
final_handle_datetime	最终处理时间,当订单状态申诉完成时存在	1563271245	否
final_handle_message	最终处理意见,当订单状态申诉完成时存在	可以退款	否
refund_buy_amount	返给买家的金额,当订单状态申诉完成时存在	12.80	否
refund_seller_amount	返给卖家金额,当订单状态申诉完成时存在	47.20	否

花店报价数据 return_bidding_price

字段	意义	参数值示例	是否必须存在
price	报价金额	12.80	是
add_time	报价时间	1663660965	是
timeout	报价过期时间	1663700565	是

花店报价列表数据新增(24.6.5) return_order_store_price

字段	意义	参数值示例	是否必须存在
price_id	报价Id	2084902	是
store_name	报价花店名称	星海	是
store_id	报价店铺ID	471762	是
price	报价金额	100.00	是
add_time	报价时间	1717568352	是
status	状态值	0(枚举值 0：报价中 1：已选择此报价 2：报价过期/已取消)	是
timeout	报价过期时间	1663700565	是

回调示例

接收的数据为json字符串. 开发者在接口地址中接收POST参数即可。示例代码(PHP)

file_put_contents('data.log', '接收数据==>' . var_export(file_get_contents("php://input"),true));
//记录日志 数据为json字符串
// 转为数组后的数据示例
array (
  'status' => 1,
  'data' => 
  array (
    'push_content' => '订单：20220601-194007-24375，申诉已经完成',
    'api_notify_url' => 'http://hwtest.tfxk.org/index.php?c=cc&a=aa',
    'order_sn' => '20220601-194007-24375',
    'order_state' => 'FINISH_COMPLAINT',
    'order_amount' => '50.00',
    'pay_amount' => '50.00',
    'seller_order' => '',
    'return_refund_info' => 
    array (
      'refund_reason' => '花材不符,测试申诉,进入售后',
      'refund_time' => '1654084187',
      'refund_amount' => '12.00',
      'seller_refund_time' => '1654084211',
    ),
    'return_complaint_info' => 
    array (
      'complain_content' => '测试申诉,进入售后',
      'complain_message' => '测试申诉,进入售后',
      'complain_subject_content' => '花材不符',
      'appeal_datetime' => '1654084211',
      'complain_handle_datetime' => '0',
      'final_handle_datetime' => '0',
      'final_handle_message' => '',
      'refund_buy_amount' => '0.00',
      'refund_seller_amount' => '0.00',
    ),
  ),
)
// TODO 处理数据逻辑
// TODO 成功直接输出 HW_SUCCESS
echo json_encode(array('data'=>'HW_SUCCESS'));
exit;

通知应答

HTTP状态码为200并且输出{"data":"HW_SUCCESS"}json字符串,则表示下单方接收通知成功。注意:字母必须大写
HTTP状态码不为200或者接口输出除HW_SUCCESS之外的数据都视为失败。

{"data":"HW_SUCCESS"}

花娃一旦接收接口地址返回的为 HW_SUCCESS字符串时，则表示通知成功，否则花娃会连续通知三次，若三次都没有收到此标识，则不再重复通知

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

返回数据

名称	类型	是否必须	默认值	备注	其他信息
result	number	非必须

订单

导入单个订单

基本信息

Path： /newapi/import

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	import_huawa	是	import_huawa

Body

参数名称	参数类型	是否必须	示例	备注
member_name	text	否	漫漫鲜花网	指定花店的会员名，适用于指定花店下单
istimer	text	是	0	是否定时配送，1-是，0-否
delivery_time	text	是	1	配送时段，如果istimer等于0时这个值必填，1:不限时段，2:08-10点，3:10-12点，4:12-14点，5:14-16点，6:16-18点，7:18-20点，8:20-22点，15:上午，16:下午，17:晚上，99:自定义时间
s_time	text	是		配送时间为自定义必须传入参数：自定义配送开始时间

e_time	text	是		配送时间为自定义必须传入参数：自定义配送结束时间
songdate	text	否	2016-12-25 13	配送时间，istimer=1时传入格式YYYY-mm-dd H:i:s，例如2016-12-25 13:45:51 ，istimer=0时传YYYY-mm-dd，例如2016-12-25
receive_name	text	是	杨某	收花人姓名
receive_tel	text	是	028-11111111	收花人座机
receive_mobile	text	是	18511111111	收花人手机
area_info	text	是	四川省成都市武侯区	收花人地区，省市区以空格隔开
address	text	是	交子大道100号	收花人详细地址
material	text	否	11支红粉玫瑰加满天星点缀	鲜花花材
quantity	text	是	1	商品数量

sales_price	text	否	200	销售价。为了方便您能够通过花娃查看您的利润值，并形成您的周、月、季等数据分析报表，以及给您的员工进行利润值排名等，强烈建议您填写真实销售价格。
order_amount	text	否	60	出价，转单价必须大于10元
remark	text	否	请按时送到	订单备注
picurl	text	否	http	图片地址，请使用远程图片路径，以http://开头，只支持jpg和png格式，最大4M
card_description	text	否	祝身体健康	贺卡内容

send_mobile	text	是	18511111111	送花人电话
invoice_title	text	否	公司抬头: XX有限公司公司税号: 915XXX 公司邮箱: 123@163.com	发票抬头；公司邮箱为可选项
seller_order	text	否	A0001	订单在商家自己订单系统中的编号
is_payment	text	是	0	默认0 1支付 0不支付；值为1时订单将直接发布到“等待接单”状态，同时如果有指定花店的会员名（member_name），订单将直接发布到“指定待接收”状态值为0时，订单状态为“待发布” 。说明：当账号余额不足时订单会导入到“待发布”状态.
goods_type	text	是	蛋糕	商品类型，默认：鲜花
examine_status	text	是	0	花图审核：0、不审核 1未提交 2待审核 3成功 4失败
more_goods_data	text	是	urlencode(json_encode(more_goods_data))	多商品信息(string), 其中 goods_image-商品图片 quantity-商品数量 goods_material-商品描述实例（urlencode之前的数据）： [{"goods_image":"http://p0.meituan.net/sgopen/c0604b26011d24d0e67dd4d0382add1a838723.png","quantity":1,"goods_material":"精美贺卡"},{"goods_image":"http://p0.meituan.net/scproduct/adfc28d8166b30463377763e5f17b5a1644247.jpg,http://p0.meituan.net/scproduct/49bbe12f70efdfa1e6abcff9604437db367047.jpg","quantity":1,"goods_material":"33枝粉玫瑰"}]
is_self_delivery	text	否	0	是否自提订单 0-非自提(配送单) 1-自提订单
x_axis	text	否	104.041963	百度地图经度（注：经纬度必须同时传入才会使用，同时必须使用百度地图经纬度，其他地图经纬度会导致定位异常）
y_axis	text	否	30.562876	百度地图纬度（注：经纬度必须同时传入才会使用，同时必须使用百度地图经纬度，其他地图经纬度会导致定位异常）

返回数据

名称	类型	是否必须	备注	其他信息
result	number	非必须
data	object	非必须	item 类型: string
├─ order_id	string	必须	订单id	mock: @string
├─ order_sn	string	必须	订单编号	mock: @string
├─ is_check	number	必须	是否是待发布 1：是 2：不是	mock: 1
├─ order_sta	string	必须	当前订单状态 22 待发布； 40 待接单；50 指定待接收；55 已接收待配送；	mock: @string

查询订单列表

基本信息

Path： /newapi/assign_store_amount_1744356483813

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	orderlist	是	orderlist	必须输入

Body

参数名称	参数类型	是否必须	示例	备注
pagesize	text	否	1	每页数量

curpage	text	否	10	当前查询第几页

order_sn	text	否	20190710-124920-59021,20190710-124920-59022,20190710-124920-59023	订单编号订单号和商户号必须存在一个
seller_order	text	否	A1001,B1002,C1003	商户号订单号和商户号必须存在一个
status	text	否	fail	订单状态，可选：fail下单方主动取消，no_pay待支付，check待发布，refund退款中，cancel已取消，expired已过期，untreated等待接收，wait等待接单，wait_bid竞价单待出价，trading_in配送中，confirm待确认完成，success已完成
receive_name	text	否	杨某	收货人姓名
receive_mobile	text	否	185111111	收货人手机
receive_address	text	否	成都	收货人地址
addtime_start	text	否	2019-05-10	订单创建时间起始
addtime_end	text	否	2019-05-11	订单创建时间终止
deliverytime_start	text	否	2019-05-10	订单配送时间起始
deliverytime_end	text	否	2019-05-11	订单配送时间终止

返回数据

名称	类型	是否必须	备注
result	number	非必须
data	object	非必须	item 类型: string
├─ totalcount	number	必须	订单总数
├─ pagecount	number	必须	页数总数
├─ orderlist	object	必须	订单列表
├─ order_type	string	必须	订单类型，1指定花店，2抢单
├─ order_id	string	必须	订单id，订单唯一标识
├─ order_sn	string	必须	订单编号，订单唯一标识，更直观
├─ member_name	string	必须	接单方会员名
├─ store_id	string	必须	花店id
├─ store_name	string	必须	花店名称
├─ store_mobile	string	必须	花店手机
├─ store_qq	string	必须	花店qq
├─ refund_reason	string	必须	退款原因
├─ refund_amount	string	必须	花店同意退款金额
├─ goods_thumb	string	必须	缩略图
├─ goods_material	string	必须	花材描述
├─ area_info	string	必须	收货人地区信息
├─ province	string	必须	收货人省份
├─ city	string	必须	城市
├─ area	string	必须	区
├─ receive_name	string	必须	收货人姓名
├─ receive_mobile	string	必须	收货人手机
├─ receive_address	string	必须	收货人地址
├─ delivery_date	string	必须	配送日期
├─ order_amount	string	必须	出价金额
├─ status_info	string	必须	订单状态待付款,等待接单,待接收,待接收,花店拒绝,未接单已过期,待自提,已接收,配送中,待确认完成,退款中,不同意退款,退款成功,申诉中,申诉完成,主动取消,待发布,已完成,待回款
├─ riseprice_count	string	必须	请求涨价的花店数量
├─ back_amount	string	必须	货到付款回款金额
├─ istopay	string	必须	是否到付，1是，0否
├─ isconfirm	string	必须	是否待确认收款，1是，0否
├─ isback	string	必须	是否已经回款，1是，0否
├─ pay_state	string	必须	是否已支付，1是，0否
├─ seller_order	string	必须	商户号
├─ send_imgurl	string	必须	图片地址，多张以英文逗号隔开
├─ examine_status	string	必须	花图审核状态 0、不审核 1未提交 2待审核 3成功 4失败
├─ send_imgurl_time	string	必须	实拍图上传时间（时间戳）
├─ examine_expire_time	string	必须	花图审核有效期（时间戳）
├─ refund_state	string	必须	退款状态;1未处理;2不同意;3同意;5系统同意
├─ remark	string	必须	订单备注
├─ card_description	string	必须	贺卡
├─ more_goods_data	string	必须	多商品信息
├─ field_43	string	必须	花材信息
├─ quantity	string	必须	数量
├─ goods_image	string	必须	图片，多个

花图审核

基本信息

Path： /newapi/examine_image

Method： POST

接口描述：

{"result":1,"data":[]}

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	get_black_list	是	get_black_list	必须传入

Body

参数名称	参数类型	是否必须	示例	备注
order_id	text	是	123455	订单号
type	text	是	2	1通过 2不通过
reason_ids	text	是	1,2,3,4	type=2 必传拒绝的原因集合，多个用，分割
remark	text	是	花图太小	type=2 必传拒绝的原因

返回数据

名称	类型	是否必须	备注	其他信息
result	number	非必须
data	string []	非必须	item 类型: string	item 类型: string
├─		非必须

确认订单完成

基本信息

Path： /newapi/order_receive

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是

Body

参数名称	参数类型	是否必须	示例	备注
order_id	text	是	16921787	订单号
password	text	是	11111111	支付密码

返回数据

名称	类型	是否必须	备注	其他信息
result	number	非必须
data	string []	非必须	item 类型: string	item 类型: string
├─		非必须

取消订单

基本信息

Path： /newapi/order_cans

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	cans_order	是	cans_order	必须输入

Body

参数名称	参数类型	是否必须	示例	备注
order_id	text	否	123456	订单id order_id 和 order_sn 必须存在一个
order_sn	text	否	20190710-124920-59021	订单编号 order_id 和 order_sn 必须存在一个
cans_reark	text	是	客户取消	取消原因

返回数据

名称	类型	是否必须	备注	其他信息
result	number	非必须
data	string []	非必须	item 类型: string	item 类型: string
├─		非必须

指定花店

基本信息

Path： /newapi/assign_store

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	assign_store	是	assign_store	必须输入

Body

参数名称	参数类型	是否必须	示例	备注
order_id	text	是	123456	订单id
member_name	text	是	漫漫鲜花网	指定花店会员名

返回数据

名称	类型	是否必须	备注	其他信息
result	number	非必须
data	string []	非必须	item 类型: string	item 类型: string
├─		非必须

指定花店配送（新）

基本信息

Path： /newapi/assign_store_amount

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	assign_store_amount	是	assign_store_amount	必须输入

Body

参数名称	参数类型	是否必须	示例	备注
order_id	text	是	123456	订单id
member_name	text	是	漫漫鲜花网	指定花店会员名
amount	text	是	60	价格
payment_password	text	是	111111	支付密码

返回数据

名称	类型	是否必须	备注	其他信息
result	number	非必须
data	string []	非必须	item 类型: string	item 类型: string
├─		非必须

获取城市列表

基本信息

Path： /newapi/get_city

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	get_city	是	get_city	必须输入

Body

参数名称	参数类型	是否必须	示例	备注
area_id	text	是	0	城市 id, 如果显示所有省，请传 0

返回数据

名称	类型	是否必须	备注
result	number	非必须
data	object	非必须	item 类型: string
├─ area_id	string	必须	城市id
├─ area_name	string	必须	城市名称

追加订单价格

基本信息

Path： /newapi/add_price

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	add_price	是	add_price	必须输入

Body

参数名称	参数类型	是否必须	示例	备注
order_id	text	是	123456	订单id
add_amount	text	是	20	追加金额
payment_password	text	是	1111111	支付密码

返回数据

名称	类型	是否必须	备注	其他信息
result	number	非必须
data	string []	非必须	item 类型: string	item 类型: string
├─		非必须

选择报价花店

基本信息

Path： /newapi/select_price

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	select_price	是	select_price	必须输入

Body

参数名称	参数类型	是否必须	示例	备注
order_id	text	是	123456	订单id
price_id	text	是	11	花店报价id
payment_password	text	是	1111111	支付密码

返回数据

名称	类型	是否必须	备注	其他信息
result	number	非必须
data	string []	非必须	item 类型: string	item 类型: string
├─		非必须

获取订单第三方配送信息

基本信息

Path： /newapi/get_courier_info

Method： POST

接口描述：

{
  "result": "1",
  "data": {
    "de_member_name": "测试骑手",
    "de_member_phone": "15644458895",
    "lng": "16.222111",
    "lat": "106.24444",
    "delivery_no": "6666-99999",
    "platform": "5",
    "status": "3"
  }
}

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	get_courier_info	是	get_courier_info	必须输入

Body

参数名称	参数类型	是否必须	示例	备注
order_id	text	是	123456	订单id

返回数据

名称	类型	是否必须	备注
result	number	非必须
data	object	非必须	item 类型: string
├─ de_member_name	string	必须	骑手名
├─ de_member_phone	string	必须	骑手电话
├─ lng	string	必须	骑手当前位置-经度
├─ lat	string	必须	骑手当前位置-纬度
├─ delivery_no	string	必须	配送订单编号
├─ platform	string	必须	配送平台 shansongv5:闪送,dada:达达,dada:达达,uu:UU跑腿,shunfeng:顺丰,jdwl:京东同城,fengniao:蜂鸟快送,self_distribution:商家自配送
├─ status	string	必须	配送订单状态 1-待接单 2-待取件 3-配送中

花图审核原因列表

基本信息

Path： /newapi/get_examine_reason

Method： POST

接口描述：

{
    "result": 1,
    "data": {
        "花材类": [
            {
                "id": "1",
                "name": "颜色不符"
            },
            {
                "id": "2",
                "name": "数量不符"
            },
            {
                "id": "3",
                "name": "品种不符"
            },
            {
                "id": "4",
                "name": "质量问题"
            }
        ],
        "配花/草": [
            {
                "id": "5",
                "name": "颜色不符"
            },
            {
                "id": "6",
                "name": "数量不符"
            },
            {
                "id": "7",
                "name": "品种不符"
            },
            {
                "id": "8",
                "name": "质量不符"
            }
        ],
        "包装类": [
            {
                "id": "9",
                "name": "材质不符"
            },
            {
                "id": "10",
                "name": "造型不符"
            },
            {
                "id": "11",
                "name": "颜色不符"
            }
        ],
        "附属物品": [
            {
                "id": "12",
                "name": "贺卡遗漏"
            },
            {
                "id": "13",
                "name": "小熊遗漏"
            }
        ],
        "拍摄类": [
            {
                "id": "14",
                "name": "未能展示商品全貌"
            },
            {
                "id": "15",
                "name": "照片模糊不清"
            }
        ]
    }
}

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	get_examine_reason	是	get_examine_reason	必须输入

返回数据

名称	类型	是否必须	备注
result	number	非必须
data	object	非必须	item 类型: string
├─ 花材类	object	非必须	拉黑的会员ID
├─ id	string	必须	原因id
├─ name	string	必须	原因名称
├─ 配花/草	object	必须
├─ id	string	必须	原因id
├─ name	string	必须	原因名称
├─ 包装类	object	必须
├─ id	string	必须	原因id
├─ name	string	必须	原因名称
├─ 附属物品	object	必须
├─ id	string	必须	原因id
├─ name	string	必须	原因名称
├─ 拍摄类	object	必须
├─ id	string	必须	原因id
├─ name	string	必须	原因名称

发布待发布的三方订单到抢单池

基本信息

Path： /newapi/publish_three_order

Method： POST

接口描述：

{
    "result": 1,
    "data": {
         "order_sn": "20250414-154019-41778"
    }
}

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	get_examine_reason	是	get_examine_reason	必须输入

Body

参数名称	参数类型	是否必须	示例	备注
three_order_sn	text	是		三方订单编号
three_order_type	text	是		订单渠道目前仅支持 6-京东到家 7-饿了么零售 44-美团闪购 57-淘鲜达
payment_password	text	是	11111111	支付密码
delivery_date	text	否		收货时间年月日时分秒例如 2019-01-01 12:12:12 没有就默认采用待发布订单时间
order_amount	text	否		转单价，如不传发布订单会默认选用订单价格的50% 最低10元

返回数据

名称	类型	是否必须	默认值	备注	其他信息
result	number	非必须
data	object	非必须		item 类型: string

修改订单

基本信息

Path： /newapi/edit_order

Method： POST

接口描述：

{
    "status": 1,
    "msg": "操作成功，等待接单方审核"
}

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	get_examine_reason	是	get_examine_reason	必须输入

Body

参数名称	参数类型	是否必须	示例	备注
order_id	text	是		订单id
goods_info	text	否	W3siaW1nIjoiIiwiZ29vZHNfbWF0ZXJpYWwiOiIzM+aeneeijuWGsOiTnSIsIm51bSI6MX1d	商品数组数组通过json_encode转成字符串之后，再通过base64_encode加密
remark	text	否		订单备注
delivery_date	text	否		配送时间
delivery_time	text	否		配送时段 1 - 不限时段 2 - 08-10点 3 - 10-12点 4 - 12-14点 5 - 14-16点 6 - 16-18点 7 - 18-20点 8 - 20-22点 9 - 22-24点 15 - 上午 16 - 下午 17 - 晚上 99 - 自定义时段
s_time	text	否		自定义开始时间 delivery_time为99时才有用
e_time	text	否		自定义结束时间 delivery_time为99时才有用
istimer	text	否		是否是定时 0 - 否 1 - 是
area_info	text	否		区域信息如：四川省成都市高新区直辖市请使用：北京市东城区的格式
receive_address	text	否		详细地址
card_description	text	否		贺卡
receive_name	text	否		收货人姓名
receive_mobile	text	否		收货人电话
send_mobile	text	否		订货人电话

返回数据

名称	类型	是否必须	默认值	备注	其他信息
status	number	非必须
msg	string	非必须

店铺

报价花店列表

基本信息

Path： /newapi/select_store_list

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	select_store_list	是	select_store_list	必须输入

Body

参数名称	参数类型	是否必须	示例	备注
order_id	text	是	123456	订单id

返回数据

名称	类型	是否必须	备注
result	number	非必须
data	object	非必须	item 类型: string
├─ price_list	object	非必须
├─ store_qq	string	非必须	店铺qq
├─ store_mobile	string	非必须	店铺电话
├─ area_info	string	非必须	店铺地址
├─ store_name	string	非必须	店铺名称
├─ price_id	string	非必须	报价id
├─ order_id	string	非必须	订单id
├─ price	string	非必须	报价价格
├─ add_time	string	非必须	报价时间
├─ security_deposit	string	非必须	保证金
├─ store_orders	string	非必须	接单量
├─ praise_rate	string	非必须	信誉度
├─ timeout	string	非必须	报价有效时间
├─ last_placeorder_time	string	非必须	最近接单时间
├─ distance	string	非必须	订单到花店的距离（单位公里）
├─ store_sn	string	非必须	花店编号
├─ refund_count	string	非必须	近三月售后量
├─ black_count	string	非必须	被拉黑数

根据店铺名获取店铺会员名

基本信息

Path： /newapi/storename_to_membername

Method： POST

接口描述：

{
    "result": 1,
    "data": {
        "total_num": 1,
        "data": [
            "******"
        ]
    }
}

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	get_courier_info	是	get_courier_info	必须输入

Body

参数名称	参数类型	是否必须	示例	备注
store_name	text	是	店铺1	店铺名称

返回数据

名称	类型	是否必须	备注	其他信息
result	number	非必须
data	object	非必须
├─ total_num	number	非必须	总数量
├─ data	string []	非必须	会员名列表	item 类型: string
├─		非必须

获取拉黑列表

基本信息

Path： /newapi/get_black_list

Method： POST

接口描述：

{
    "result": 1,
    "data": {
        "count": "1",
        "pagecount": 1,
        "list": [
            {
                "member_id": "252046",
                "id": "2277",
                "black_time": "1717654945",
                "member_name": "ces233",
                "member_qq": "1174889265",
                "member_mobile": "13689610664",
                "member_areainfo": "四川省 成都市 锦江区",
                "member_address": "国际金融中心",
                "black_reason": "qweqweqweqw",
                "store_name": "扣扣空间",
                "store_id": "471728"
            }
        ]
    }
}

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	get_black_list	是	get_black_list	必须输入

Body

参数名称	参数类型	是否必须	示例	备注
keyword	text	否	漫漫	关键词搜索
page	text	否	1	页码（默认1）
limit	text	否	10

返回数据

名称	类型	是否必须	备注
result	number	非必须
data	object	非必须	item 类型: string
├─ member_id	string	非必须	拉黑的会员ID
├─ id	string	非必须	拉黑Id
├─ black_time	string	非必须	拉黑时间
├─ member_name	string	非必须	拉黑的会员名
├─ member_qq	string	非必须	拉黑的会员QQ
├─ member_mobile	string	非必须	拉黑的会员手机号
├─ member_areainfo	string	非必须	会员的省市区
├─ member_address	string	非必须	会员的详细地址
├─ black_reason	string	非必须	拉黑原因
├─ store_name	string	非必须	门店名称
├─ store_id	string	非必须	门店id

售后

申请售后

基本信息

Path： /newapi/complain_save_new

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	complain_save_new	是	complain_save_new	必须输入

Body

参数名称	参数类型	是否必须	示例	备注
order_id	text	是	123456	订单id
input_complain_pic	text	是	11	图片凭证，多张以英文逗号隔开
input_complain_content	text	是	8013	原因：8013 - 协商退款　8001 - 漏单　8002 - 误单　8003 - 花材不符　8004 - 质量问题　8005 - 配材不符　8006 - 包装不符　8007 - 虚假操作　8008 - 恶意透露价格　8010 - 恶意骚扰　8011 - 贺卡问题　8012 - 第三方差评
refund	text	是	1	自定义退款金额
input_order_problem	text	是	测试	详细内容
complain_need	text	是	5100	投诉id: 5013 - 退还订单金额30%　5015 - 退还订单金额50%　5018 - 退还订单金额80%　5000 - 全额退款　5005 - 全额退款，赔付订单金额50%　5006 - 全额退款，赔付订单金额60%　5007 - 全额退款，赔付订单金额70%　5008 - 全额退款，赔付订单金额80%　5009 - 全额退款，赔付订单金额90%　5010 - 全额退款，赔付订单金额100%　5100 - 部分退款，自定义金额

返回数据

名称	类型	是否必须	备注	其他信息
result	number	非必须
data	string []	非必须	item 类型: string	item 类型: string
├─		非必须

取消申请

基本信息

Path： /newapi/cancel_refund

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	cancel_refund	是	cancel_refund	必须输入

Body

参数名称	参数类型	是否必须	示例	备注
order_id	text	是	123456	订单id

返回数据

名称	类型	是否必须	备注	其他信息
result	number	非必须
data	string []	非必须	item 类型: string	item 类型: string
├─		非必须

账户

获取花娃账号余额

基本信息

Path： /newapi/get_account_balances

Method： POST

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/x-www-form-urlencoded	是
User-Agent	account_balances	是	account_balances	必须输入

返回数据

名称	类型	是否必须	备注
result	number	非必须
data	object	非必须	item 类型: string
├─ member_id	string	必须	会员id
├─ member_name	string	必须	会员名
├─ member_mobile	string	必须	会员手机
├─ member_email	string	必须	会员邮箱
├─ amount	string	必须	可用余额
├─ freeze	string	必须	冻结金额
├─ deposit	string	必须	保证金

花娃api 接口文档

开放平台

开放平台

花娃接口说明

基本信息

概述

API请求地址

签名方法

签名步骤

请求参数

返回数据

开放平台通知接口

数据签名

基本信息

概述

签名过程

验签过程代码示例(PHP)

请求参数

返回数据

订单api导入订单通知消息

基本信息

概述

接口说明

通知参数

公共参数

data参数详解

订单状态参数详解 order_state

订单支付数据详解 return_pay_info

花店数据据详解 return_store_info

配送数据详解 return_delivery_info

取消订单数据详解 return_cancel_info

申请退款数据详解 return_refund_info

订单申诉数据详解 return_complaint_info

花店报价数据 return_bidding_price

花店报价列表数据新增(24.6.5) return_order_store_price

回调示例

通知应答

请求参数

返回数据

订单

导入单个订单

基本信息

请求参数

返回数据

查询订单列表

基本信息

请求参数

返回数据

花图审核

基本信息

请求参数

返回数据

确认订单完成

基本信息

请求参数

返回数据

取消订单

基本信息

请求参数

返回数据

指定花店

基本信息

请求参数

返回数据

指定花店配送（新）

基本信息

请求参数

返回数据

获取城市列表

基本信息

请求参数

返回数据

追加订单价格

基本信息

请求参数

返回数据

选择报价花店

基本信息

请求参数

返回数据