02-finance-http.rst
35 KB
财务进度服务http接口
销售合同
增加销售合同
Verb: POSTPath: /api/v1/financial/contractHeader: (Content-Type: application/json)Request Body：
{ "constract_unid":"2018-079", #合同unid "salesperson_unid":"xxxx", #销售员unid "project_unid":"xxxx", #项目unid "customer_unid":"xxxx", #客户unid "province":"河北省", #项目所在地的省份 "city":"沧州市", #项目所在地的市区 "county":"献县", #项目所在地的县或区 "guarantee_period":"6/12/.../60", #质保周期,月份,步长为6 "sign_date":"2018/3/9", #签订时间 "product_line_type":"xxxx", #产品线类型,(安防、交通、客流、维保) "contract_state":"xxxx", #合同状态,(已完成、待发货，施工中，项目暂停) "contract_type":"xxxx", #合同性质,(供货，施工，集成，维保) "contract_amount":"140000.00", #合同金额,小数点保留两位 "deduct_amount":"5000.00", #折扣金额,小数点保留两位 "contract_amount_note":"xxxx", #合同金额备注,文本 "stop_amount":"xxxx", #暂停金额,小数点保留两位 "reback_note":"xxxx", #累计回款额备注,文本 "exemptions_amount":"xxxx", #豁免金额,小数点保留两位 "contract_remain_note":"xxxx", #合同余额备注 "is_archive":"xxxx", #是否归档 "bad_amount":"xxxx", #坏账金额,小数点保留两位 "bad_amount_note":"xxxx", #坏账金额备注 "confirm_income_amount":"xxxx", #确定收入金额,小数点保留两位 "amount_state_unid":"xxxx", #帐款状态，通过code服务进行查询 "start_guarantee_date":"xxxx", #维保服务期开始时间 "end_guarantee_date":"xxxx", #维保服务期结束时间 "mainten_start_point":"xxxx", #质保期开始节点 "mainten_start_date":"xxxx", #质保期开始时间 "contract_note":"xxxx", #合同备注 "appendix_unid":"xxxx", #合同附件(若有附件上传该字段) }Response Body：
{ "ecode":"200", #新增成功返回码 "enote":"OK" #返回说明 }
查询具体合同详情
Verb: GETPath: /api/v1/financial/contract/{contract_unid}Header: (Content-Type: application/json)Request Body：无
Response Body：
{ "salesperson_unid":"1234", #销售员unid "salesperson_name":"吴旭", #销售员名称 "project_unid":"12321", #项目unid "project_name":"金源时代客流项目", #项目名称 "customer_unid":"1234", #客户unid "customer_name":"北京金源时代购物中心有限公司", #客户名称 "province":"河北省", #项目所在地的省份 "city":"沧州市", #项目所在地的市区 "county":"献县", #项目所在地的县或区 "guarantee_period":"6/12/.../60", #质保周期,月份,步长为6 "sign_date":"2018/3/9", #签订时间 "product_line_type":"xxxx", #产品线类型,(安防、交通、客流、维保) "contract_state":"xxxx", #合同状态,(已完成、待发货，施工中，项目暂停) "contract_type":"xxxx", #合同性质,(供货，施工，集成，维保) "contract_amount":"140000.00", #合同金额,小数点保留两位 "deduct_amount":"5000.00", #折扣金额,小数点保留两位 "total_reback_amount":"xxxx", #累计回款额 "contract_amount_note":"xxxx", #合同金额备注,文本 "stop_amount":"xxxx", #暂停金额,小数点保留两位 "reback_note":"xxxx", #累计回款额备注,文本 "contract_remain":"xxxx", #合同余额 "exemptions_amount":"xxxx", #豁免金额,小数点保留两位 "contract_remain_note":"xxxx", #合同余额备注 "is_archive":"xxxx", #是否归档 "bad_amount":"xxxx", #坏账金额,小数点保留两位 "bad_amount_note":"xxxx", #坏账金额备注 "total_receive_amount":"xxxx", #累计应收款,小数点保留两位 "total_amount_remain":"xxxx", #应收账款余额 "over_days":"xxxx", #逾期天数 "confirm_income_amount":"xxxx", #确定收入金额,小数点保留两位 "amount_state_unid":"xxxx", #帐款状态 "start_guarantee_date":"xxxx", #维保服务期开始时间 "end_guarantee_date":"xxxx", #维保服务期结束时间 "mainten_start_point":"xxxx", #质保期开始节点 "mainten_start_date":"xxxx", #质保期开始时间 "mainten_end_date":"xxxx", #质保期结束时间 "contract_note":"xxxx", #合同备注 "appendix_url":"xxxx", #合同url }
修改销售合同
Verb: PUTPath: /api/v1/financial/contract/{constract_unid}Header: (Content-Type: application/json)Request Body：
{ "salesperson_unid":"xxxx", #销售员unid "project_unid":"xxxx", #项目unid "customer_unid":"xxxx", #客户unid "province":"河北省", #项目所在地的省份 "city":"沧州市", #项目所在地的市区 "county":"献县", #项目所在地的县或区 "guarantee_period":"6/12/.../60", #质保周期,月份,步长为6 "sign_date":"2018/3/9", #签订时间 "product_line_type":"xxxx", #产品线类型,(安防、交通、客流、维保) "contract_state":"xxxx", #合同状态,(已完成、待发货，施工中，项目暂停) "contract_type":"xxxx", #合同类型,(供货，施工，集成，维保) "contract_amount":"140000.00", #合同金额,小数点保留两位 "deduct_amount":"5000.00", #折扣金额,小数点保留两位 "contract_amount_note":"xxxx", #合同金额备注,文本 "stop_amount":"xxxx", #暂停金额,小数点保留两位 "reback_note":"xxxx", #累计回款额备注,文本 "exemptions_amount":"xxxx", #豁免金额,小数点保留两位 "contract_remain_note":"xxxx", #合同余额备注 "is_archive":"xxxx", #是否归档 "bad_amount":"xxxx", #坏账金额,小数点保留两位 "bad_amount_note":"xxxx", #坏账金额备注 "confirm_income_amount":"xxxx", #确定收入金额,小数点保留两位 "amount_state_unid":"xxxx", #帐款状态 "start_guarantee_date":"xxxx", #维保服务期开始时间 "end_guarantee_date":"xxxx", #维保服务期结束时间 "mainten_start_point":"xxxx", #质保期开始节点 "mainten_start_date":"xxxx", #质保期开始时间 "contract_note":"xxxx", #合同备注 "appendix_unid":"xxxx", #合同附件unid }Response Body：
{ "ecode":"200", #修改成功返回码 "enote":"OK" #返回说明 }
删除销售合同
Verb: DELETEPath: /api/v1/financial/contract/{contract_unid}Header: (Content-Type: application/json)Request Body：无
Response Body：
{ "ecode":"200", #删除成功返回码 "enote":"OK" #返回说明 }
销售合同付款约定
增加销售合同付款约定信息
Verb: POSTPath: /api/v1/financial/contract/{constract_unid}/paymentHeader: (Content-Type: application/json)Request Body：
{ "list_payment_data": #付款约定信息表 [ { "payment_progress":"xxxx", #付款进度（1,2,3,4） "payment_type":"xxxx", #付款类型，通过code服务进行选择 "days":"xxxx", #天数 "payment_propority":"xxxx", #付款比例 }, ...... ] }Response Body：
{ "ecode":"200", #新增成功返回码 "enote":"OK" #返回说明 }
查询具体合同付款约定信息
Verb: GETPath: /api/v1/financial/contract/{constract_unid}/paymentHeader: (Content-Type: application/json)Request Body：无
Response Body：
{ "list_payment_data": #付款约定列表 [ { "payment_unid":"xxxx", #付款unid "payment_progress":"xxxx", #付款进度 "days":"xxxx", #天数 "payment_date":"xxxx", #本期应付款日期 "payment_amount":"xxxx", #本期应付金额 "payment_propority":"xxxx", #付款比例 "payment_requirement":"xxxx", #付款条件 }, ...... ] }
修改销售合同付款约定信息
Verb: PUTPath: /api/v1/financial/contract/{constract_unid}/paymentHeader: (Content-Type: application/json)Request Body：
{ "list_payment_data": #付款约定列表 [ { "payment_unid":"xxxx", #付款unid "payment_progress":"xxxx", #付款进度 "days":"xxxx", #天数 "payment_propority":"xxxx", #付款比例 "payment_requirement":"xxxx", #付款条件 }, ...... ] }Response Body：
{ "ecode":"200", #修改成功返回码 "enote":"OK" #返回说明 }
删除销售合同付款约定信息
Verb: DELETEPath: /api/v1/financial/contract/{contract_unid}/paymentHeader: (Content-Type: application/json)Request Body：
{ "payment_unids": #付款unid数组 [ "payment_unid":"xxxx", #付款unid ...... ] }Response Body：
{ "ecode":"200", #删除成功返回码 "enote":"OK" #返回说明 }
销售合同回款
增加销售合同回款信息
Verb: POSTPath: /api/v1/financial/contract/{constract_unid}/rebackHeader: (Content-Type: application/json)Request Body：
Response Body：
{ "list_reback_data": #合同回款信息表 [ { "reback_progress ":"xxxx", #回款进度 "reback_date":"xxxx", #回款时间 "actual_reback_amount":"xxxx", #实际回款数额 "reback_note":"xxxx", #回款备注 }, ...... ] }Response Body：
{ "ecode":"200", #新增成功返回码 "enote":"OK" #返回说明 }
查询具体合同回款信息
Verb: GETPath: /api/v1/financial/contract/{constract_unid}/rebackHeader: (Content-Type: application/json)Request Body：无
Response Body：{ "list_reback_data": #回款信息列表 [ { "reback_unid":"xxxx", #回款unid "reback_progress":"xxxx", #回款进度 "reback_date":"xxxx", #回款时间 "reback_propority":"xxxx", #回款比例 "actual_reback_amount":"xxxx", #实际回款数额 "reback_note":"xxxx", #回款备注 }, ...... ] }
修改销售合同回款信息
Verb: PUTPath: /api/v1/financial/contract/{constract_unid}/rebackHeader: (Content-Type: application/json)Request Body：
{ "list_reback_data": #回款信息列表 [ { "reback_unid":"xxxx", #回款unid "reback_progress":"xxxx", #回款进度 "reback_date":"xxxx", #回款时间 "actual_reback_amount":"xxxx", #实际回款数额 "reback_note ":"xxxx", #回款备注 }, ...... ] }Response Body：
{ "ecode":"200", #修改成功返回码 "enote":"OK" #返回说明 }
删除销售合同回款信息
Verb: DELETEPath: /api/v1/financial/contract/{contract_unid}/rebackHeader: (Content-Type: application/json)Request Body：
{ "reback_unids": #回款unid数组 [ "reback_unid":"xxxx", #回款unid ...... ] }Response Body：
{ "ecode":"200", #删除成功返回码 "enote":"OK" #返回说明 }
销售合同开票
增加销售合同开票信息
Verb: POSTPath: /api/v1/financial/contract/{constract_unid}/receiptHeader: (Content-Type: application/json)Request Body：
{ "list_receipt_data": #合同发票信息表 [ { "receipt_progress":"xxxx", #开票进度 "receipt_amount":"xxxx", #开票金额 "oa_flow_id":"xxxx", #oa流水号 "receipt_note":"xxxx", #发票备注 }, ...... ] }Response Body：
{ "ecode":"200", #新增成功返回码 "enote":"OK" #返回说明 }
查询具体合同开票信息
Verb: GETPath: /api/v1/financial/contract/{constract_unid}/receiptHeader: (Content-Type: application/json)Request Body：无
Response Body：{ "list_receipt_data": #开票信息列表 [ { "receipt_unid":"xxxx", #发票unid "receipt_progress":"xxxx", #开票次数 "oa_flow_id ":"xxxx", #oa流水号 "receipt_amount":"xxxx", #开票金额 "total_receipt_amount":"xxxx", #累计开票金额 "receipt_propority":"xxxx", #开票比例 "receipt_note":"xxxx", #开票备注 "create_date":"xxxx", #开票时间 }, ...... ] }
修改销售合同开票信息
Verb: PUTPath: /api/v1/financial/contract/{constract_unid}/receiptHeader: (Content-Type: application/json)Request Body：
{ "list_receipt_data": #合同发票信息表 [ { "receipt_unid":"xxxx", #发票unid "receipt_progress":"xxxx", #开票进度 "receipt_amount":"xxxx", #开票金额 "oa_flow_id":"xxxx", #oa流水号 "receipt_note":"xxxx", #发票备注 }, ...... ] }Response Body：
{ "ecode":"200", #修改成功返回码 "enote":"OK" #返回说明 }
删除销售合同开票信息
Verb: DELETEPath: /api/v1/financial/contract/{contract_unid}/receiptHeader: (Content-Type: application/json)Request Body：
{ "receipt_unids": #发票unid数组 [ "receipt_unid":"xxxx", #发票unid ...... ] }Response Body：
{ "ecode":"200", #删除成功返回码 "enote":"OK" #返回说明 }
销售合同发货
增加销售合同发货信息
Verb: POSTPath: /api/v1/financial/contract/{constract_unid}/deliverHeader: (Content-Type: application/json)Request Body：
{ "list_deliver_data": #合同发货信息表 [ { "deliver_goods_date":"xxxx", #发货时间 "goods_check_date":"xxxx", #到货验收时间 "goods_sign_appendix":"xxxx", #到货签收单附件 "appendix_unid":"xxxx", #合同附件(若有附件上传该字段 }, ...... ] }Response Body：
{ "ecode":"200", #增加成功返回码 "enote":"OK" #返回说明 }
查询具体合同发货信息
Verb: GETPath: /api/v1/financial/contract/{constract_unid}/deliverHeader: (Content-Type: application/json)Request Body：无
Response Body：{ "list_deliver_data": #发货信息列表 [ { "deliver_unid":"xxxx", #发货unid "deliver_goods_date":"xxxx", #发货时间 "goods_check_date ":"xxxx", #到货验收时间 "appendix_unid":"xxxx", #附件id }, ...... ] }
修改销售合同发货信息
Verb: PUTPath: /api/v1/financial/contract/{constract_unid}/deliverHeader: (Content-Type: application/json)Request Body：
{ "list_deliver_data": #合同发货信息表 [ { "deliver_unid":"xxxx", #发货unid "deliver_goods_date":"xxxx", #发货时间 "goods_check_date":"xxxx", #到货验收时间 "goods_sign_appendix":"xxxx", #到货签收单附件 "appendix_unid":"xxxx", #合同附件(若有附件上传该字段必传 }, ...... ] }Response Body：
{ "ecode":"200", #修改成功返回码 "enote":"OK" #返回说明 }
删除销售合同发货信息
Verb: DELETEPath: /api/v1/financial/contract/{contract_unid}/deliverHeader: (Content-Type: application/json)Request Body：
{ "deliver_unids": #发货unid数组 [ "deliver_unid":"xxxx", #发货unid ...... ] }Response Body：
{ "ecode":"200", #删除成功返回码 "enote":"OK" #返回说明 }
销售合同工程验收
增加销售合同工程验收信息
Verb: POSTPath: /api/v1/financial/contract/{constract_unid}/checkHeader: (Content-Type: application/json)Request Body：
{ "list_check_data": [ { "check_type":"xxxx", #验收类型(1为初验、2为终验 "check_date":"xxxx", #验收时间 "check_note":"xxxx" #验收备注 "appendix_unids":["1234","5678",...] #附件列表 } ] }Response Body：
{ "ecode":"200", #增加成功返回码 "enote":"OK" #返回说明 }
查询具体合同工程验收信息
Verb: GETPath: /api/v1/financial/contract/{constract_unid}/checkHeader: (Content-Type: application/json)Request Body：无
Response Body：{ "list_check_data": #工程验收信息列表 [ { "check_unid":"xxxx", #工程id "check_type":"xxxx", #验收类型 "check_date":"xxxx", #验收时间 "check_note":"xxxx", #验收备注 "appendix_list": #附件列表集合 [ { "appendix_unid":"1234", #附件unid "appendix_url":"http://xxxx.pdf" #附件url } ... ] }, ...... ] }
修改销售合同工程验收信息
Verb: PUTPath: /api/v1/financial/contract/{constract_unid}/checkHeader: (Content-Type: application/json)Request Body：
{ "list_check_data": #工程验收信息表 [ { "check_unid":"xxxx", #工程验收unid "check_type":"xxxx", #验收类型(1为初验、2为终验) "first_check_date":"xxxx", #验收时间 "check_note":"xxxx" #验收备注 "appendix_unids":["1234","5678",...] #附件列表 } ] }Response Body：
{ "ecode":"200", #修改成功返回码 "enote":"OK" #返回说明 }
删除销售合同工程验收信息
Verb: DELETEPath: /api/v1/financial/contract/{contract_unid}/checkHeader: (Content-Type: application/json)Request Body：
{ "check_unids": #验收unid数组 [ "check_unid":"xxxx", #验收unid ...... ] }Response Body：
{ "ecode":"200", #删除成功返回码 "enote":"OK" #返回说明 }
查询合同列表
Verb: GETPath: /api/v1/financial/contractHeader: (Content-Type: application/json)Request Body：
{ "salesperson_name__like":"吴旭", #销售员 "project_name__like":"金源时代客流项目", #项目名称 "customer_name__like":"北京金源时代购物中心有限公司", #客户名称 "province":"河北省", #项目所在省 "city":"沧州市", #项目所在市 "county":"献县", #项目所在县（区） "guarantee_period":"xxxx", #质保周期 "year":"2018", #所属年份 "month":"3", #所属月份 "product_line_type":"xxxx", #产品线类型(安防、交通、客流、维保) "contract_state":"xxxx", #合同状态(已完成、待发货，施工中，项目暂停) "contract_type":"xxxx", #合同性质(供货，施工，集成，维保) "is_end_check":"xxxx", #是否终验 "is_archive":"xxxx", #合同是否归档 "confirm_income_amount":"xxxx", #确定收入金额 "amount_state_unid":"xxxx", #账款状态 "start_date":"xxxx", #签订时间，设置开始时间 "end_date":"xxxx", #结束时间，设置结束时间 "amount_point":"xxxx", #设置金额查询节点 "overdays_point":"xxxx", #设置逾期天数查询节点 "leave_amount_point":"xxxx", #设置应收账款余额查询节点 "offset":"xxxx", #起始位置 "limit":"xxxx" #每页显示的数量 }Response Body：
{ "total_number":"xxxx", #总的数据量 "list_size":"xxxx", #本次返回的列表数量 "offset":"xxxx", #本次返回的起始索引 "list_data": #数据列表 [ "contract_code":"2019-079", #合同编号 "product_line_type":"xxxx", #产品线类型(安防、交通、客流、维保) "sign_date":"xxxx", #签订日期 "salesperson_name":"xxxx", #销售员名称 "province":"河北省", #所在省份 "city":"沧州市", #所在市 "county":"献县", #所在县（区） "customer_name":"北京金源时代购物中心有限公司", #客户名称 "project_name":"金源时代客流项目", #项目名称 "contract_amount":"xxxx", #合同金额 "stop_amount":"xxxx", #暂停金额 "bad_amount":"xxxx", #坏账金额 "exemptions_amount":"xxxx", #豁免金额 "deduct_amount":"xxxx", #抵扣金额 "total_reback_amount":"xxxx", #累计已收款 "contract_remain":"xxxx", #合同余额 "account_state_unid":"xxxx", #账款状态 "total_receive_amount":"xxxx", #累计应收 "total_amount_remain":"xxxx", #应收账款余额 "over_days":"xxxx", #逾期天数 "advance_payment_amount":"xxxx", #预付款金额 "advance_payment_date":"xxxx", #预付款到期日 "arrival_amount":"xxxx", #到货款金额 "deliver_goods_date":"xxxx", #发货时间 "arrival_amount_date":"xxxx", #到货款到期日 "check_amount":"xxxx", #验收款金额 "check_date":"xxxx", #验收日期 "check_amount_date":"xxxx", #验收款到期日 "mainten_amount":"xxxx", #质保金额 "mainten_end_date":"xxxx", #质保期结束时间 "check_note":"xxxx", #合同备注 ], ...... }
导出表格
Verb: GETPath: /api/v1/financial/contract/exportHeader: (Content-Type: application/json)Request Body：
{ "salesperson_name__like":"吴旭", #销售员 "project_name__like":"金源时代客流项目", #项目名称 "customer_name__like":"北京金源时代购物中心有限公司", #客户名称 "province":"河北省", #项目所在省 "city":"沧州市", #项目所在市 "area":"献县", #项目所在县（区） "guarantee_period":"xxxx", #质保周期 "year":"2018", #所属年份 "month":"3", #所属月份 "product_line_type":"xxxx", #产品线类型(安防、交通、客流、维保) "contract_state":"xxxx", #合同状态(已完成、待发货，施工中，项目暂停) "contract_nature":"xxxx", #合同性质(供货，施工，集成，维保) "is_end_check":"xxxx", #是否终验 "is_archive":"xxxx", #合同是否归档 "confirm_income_amount":"xxxx", #确定收入金额 "amount_state_unid":"xxxx", #账款状态 "start_date":"xxxx", #签订时间，设置开始时间 "end_date":"xxxx", #结束时间，设置结束时间 "amount_point":"xxxx", #设置金额查询节点 "overdays_point":"xxxx", #设置逾期天数查询节点 "leave_amount_point":"xxxx" #设置应收账款余额查询节点 }Response Body：无
查询合同编号
Verb: GETPath: /api/v1/financial/contract/codeHeader: (Content-Type: application/json)Request Body：无
Request Body：
{ "contract_unids":["xxxx","xxxx",...] #合同编号 }
查询顾客表
Verb: GETPath: /api/v1/financial/contract/customerHeader: (Content-Type: application/json)Request Body：无
Request Body：
{ "customer_list": #顾客列表集合 [ { "customer_unid":"xxxx", #顾客id "customer_name":"xxxx" #顾客名称 } ... ] }
查询项目表
Verb: GETPath: /api/v1/financial/contract/projectHeader: (Content-Type: application/json)Request Body：无
Request Body：
{ "project_list": #项目列表集合 [ { "customer_unid":"xxxx", #项目id "customer_name":"xxxx" #项目名称 } ... ] }