简要描述

  • 调用接口添加订单

接口版本

版本号 制定人 制定日期 修订日期
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.jzchengxin.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]
  5. 第二个家政员信息
  6. employees[1][employee_name]
  7. employees[1][employee_id_card]
  8. 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. }

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