简要描述

  • 调用接口添加订单

接口版本

版本号 制定人 制定日期 修订日期
V 1.0 xxxx-xx-xx

请求URL:

请求方式：

  • POST

请求头：

参数名 是否必须 类型 说明
Content-Type 是 string 请求类型： multipart/form-data

请求参数:

参数名 是否必须 类型 说明
access_token 是 string 获取到的授权码access_token
company_name 是 string 公司名称
unified_social_credit_code 是 string 本公司社会统一信用代码
company_address 是 string 公司注册地址
customer_name 是 string 客户（雇主）称呼
customer_phone 是 string 客户（雇主）联系电话
employees[0][employee_name] 是 string 服务人员姓名
employees[0][employee_id_card] 是 string 服务人员身份证号码
employees[0][employee_phone] 是 string 服务人员手机号码
self_numbering 是 string 订单自编号，请保证在自有系统唯一
order_amount 是 string 订单成交金额
order_status 是 string 订单状态:1-意向、2-成单、3-完成、4-作废、5-续约
service_ltems 是 string 服务项目 （查看服务类型定义：http://api.020gzjx.com/server_view ）
service_times 是 string 服务次数
service_content 否 string 服务内容描述
service_store 否 string 服务门店
creation_time 否 string 服务签订时间戳，不填系统默为接口调用时间
remarks 否 string 备注
start_time 否 string 服务开始时间
end_time 否 string 服务结束时间

说明：当一个订单有多个家政员时，使用employee[数字][字段名]，如：

  1. 第一个家政员信息
  2. employees[0][employee_name] 
  3. employees[0][employee_id_card]  
  4. employees[0][employee_phone] 
  6. 第二个家政员信息
  7. employees[1][employee_name] 
  8. employees[1][employee_id_card]  
  9. employees[1][employee_phone]

返回示例:

正确时返回一:

  1. {
  2.     "code": 200,
  3.     "msg": "订单添加成功",
  4.     "data": {
  5.         "status": "success",
  6.         "time": 1559297160,
  7.         "耗时": 0.27800000000000002
  8.     }
  9. }

说明：当返回此结果时说明订单添加成功，time为添加入库时间戳。

错误返回一:

  1. {
  2.     "code": 400,
  3.     "msg": "您的订单已存在，修改订单请调用相应接口！",
  4.     "data": {
  5.         "status": "error",
  6.         "time": "1559297160",
  7.         "耗时": 0.068000000000000005
  8.     }
  9. }

说明：当返回此结果时说明订单已存在，time为订单创建时间戳。

错误返回二:

  1. {
  2.     "code": 400,
  3.     "msg": "社会统一信用代码为“9144510030404327XX8x”的公司不存在，请先维护公司信息！",
  4.     "data": []
  5. }

说明：当返回此结果时说明您要创建订单的公司不存在，请先参考“公司管理”—>“添加公司”进行管理。