02-finance-http.rst
37 KB
财务进度服务http接口
销售合同
增加销售合同
Verb: POSTPath: /api/v1/financial/contractsHeader: (Content-Type: application/json)Request Body：
{ "contract_unid":"2018-079", #合同unid "salesperson_unid":"1235", #销售员unid "project_unid":"1000", #项目unid "customer_unid":"1000", #客户unid "province":"1234", #项目所在地的省份，通过code服务进行查询 "city":"1234", #项目所在地的市区，通过code服务进行查询 "county":"1234", #项目所在地的县或区，通过code服务进行查询 "guarantee_period":6, #质保周期,月份,步长为6（目前取值范围：6~60） "sign_date":"2018-03-09", #签订时间 "product_line_type":"1", #产品线类型,(安防、交通、客流、维保) "contract_state":"2", #合同状态,(已完成、待发货，施工中，项目暂停) "contract_type":"3", #合同性质,(供货，施工，集成，维保) "contract_amount":140000.00, #合同金额,小数点保留两位 "deduct_amount":5000.00, #折扣金额,小数点保留两位 "contract_amount_note":"xxxx", #合同金额备注,文本 "stop_amount":200.00, #暂停金额,小数点保留两位 "reback_note":"xxxx", #累计回款额备注,文本 "exemptions_amount":100.00, #豁免金额,小数点保留两位 "contract_remain_note":"xxxx", #合同余额备注 "is_archive":false, #是否归档 "bad_amount":5000.00, #坏账金额,小数点保留两位 "bad_amount_note":"xxxx", #坏账金额备注 "confirm_income_amount":144000.00, #确定收入金额,小数点保留两位 "amount_state_unid":"3", #帐款状态，通过code服务进行查询 "start_guarantee_date":"2018-02-03", #维保服务期开始时间 "end_guarantee_date":"2018-06-09", #维保服务期结束时间 "mainten_start_point":"3", #质保期开始节点(签订时间，到货验收时间，项目终验时间) "contract_note":"xxxx", #合同备注 "appendix_unids":[xxxx,xxxx,...] #合同附件(若有附件上传该字段) }Response Body：
{ "ecode":"200", #新增成功返回码 "enote":"OK" #返回说明 }
查询具体合同详情
Verb: GETPath: /api/v1/financial/contracts/{$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":"1010", #项目所在地的省份 "city":"2350", #项目所在地的市区 "county":"2120", #项目所在地的县或区 "guarantee_period":6, #质保周期,月份,步长为6 "sign_date":"2018-03-09", #签订时间 "product_line_type":"2", #产品线类型,(安防、交通、客流、维保) "contract_state":"2", #合同状态,(已完成、待发货，施工中，项目暂停) "contract_type":"5", #合同性质,(供货，施工，集成，维保) "contract_amount":140000.00, #合同金额,小数点保留两位 "deduct_amount":5000.00, #折扣金额,小数点保留两位 "total_reback_amount":50000.00, #累计回款额 "contract_amount_note":"xxxx", #合同金额备注,文本 "stop_amount":6000.00, #暂停金额,小数点保留两位 "reback_note":"xxxx", #累计回款额备注,文本 "contract_remain":3000.00, #合同余额 "exemptions_amount":400.00, #豁免金额,小数点保留两位 "contract_remain_note":"xxxx", #合同余额备注 "is_archive":false, #是否归档 "bad_amount":15500.00, #坏账金额,小数点保留两位 "bad_amount_note":"xxxx", #坏账金额备注 "total_receive_amount":800.00, #累计应收款,小数点保留两位 "total_amount_remain":6000.00, #应收账款余额 "over_days":176, #逾期天数 "confirm_income_amount":130000.00, #确定收入金额,小数点保留两位 "amount_state_unid":"3", #帐款状态 "start_guarantee_date":"2018-03-09", #维保服务期开始时间 "end_guarantee_date":"2018-06-09", #维保服务期结束时间 "mainten_start_point":"3", #质保期开始节点 "mainten_start_date":"2018-02-03", #质保期开始时间 "mainten_end_date":"2018-06-09", #质保期结束时间 "payment_data":[ #付款约定 { "payment_unid":xxxx, #付款unid "payment_progress":2, #付款进度 "payment_type":"3", #付款类型 "days":200, #天数 "payment_date":2018-03-02, #本期应付款日期 "payment_amount":1400.00, #本期应付金额 "payment_propority":0.30, #付款比例 "payment_requirement":"xxxx" #付款条件 }, ... }, "is_delete":xxxx, #true or false ,判断合同删除与否的标志 "contract_note":"xxxx", #合同备注 "appendix_urls":["http://xxxx.pdf","xxxx",...] " #合同附件url地址(有的话返回) }
修改销售合同
Verb: PUTPath: /api/v1/financial/contracts/{$contract_unid}Header: (Content-Type: application/json)Request Body：
{ "salesperson_unid":"1234", #销售员unid "project_unid":"1232", #项目unid "customer_unid":"1234", #客户unid "province":"1000", #项目所在地的省份 "city":"1234", #项目所在地的市区 "county":"1253", #项目所在地的县或区 "guarantee_period":6, #质保周期,月份,步长为6 "sign_date":"2018-03-09", #签订时间 "product_line_type":"3", #产品线类型,(安防、交通、客流、维保) "contract_state":"2", #合同状态,(已完成、待发货，施工中，项目暂停) "contract_type":"2", #合同类型,(供货，施工，集成，维保) "contract_amount":140000.00, #合同金额,小数点保留两位 "deduct_amount":5000.00, #折扣金额,小数点保留两位 "contract_amount_note":"xxxx", #合同金额备注,文本 "stop_amount":1500.00, #暂停金额,小数点保留两位 "reback_note":"xxxx", #累计回款额备注,文本 "exemptions_amount":1500.00, #豁免金额,小数点保留两位 "contract_remain_note":"xxxx", #合同余额备注 "is_archive":false, #是否归档 "bad_amount":120000.00, #坏账金额,小数点保留两位 "bad_amount_note":"xxxx", #坏账金额备注 "confirm_income_amount":1400.00, #确定收入金额,小数点保留两位 "amount_state_unid":"2", #帐款状态 "start_guarantee_date":"2018-03-02", #维保服务期开始时间 "end_guarantee_date":"2018-03-02", #维保服务期结束时间 "mainten_start_point":"2", #质保期开始节点 "mainten_start_date":"2018-03-02", #质保期开始时间 "contract_note":"2018-06-02", #合同备注 "appendix_unids":[xxxx,xxxx,...] #合同附件(若有附件上传该字段) }Response Body：
{ "ecode":"200", #修改成功返回码 "enote":"OK" #返回说明 }
删除销售合同
Verb: DELETEPath: /api/v1/financial/contracts/{$contract_unid}Header: (Content-Type: application/json)Request Body：无
Response Body：
{ "ecode":"200", #删除成功返回码 "enote":"OK" #返回说明 }
查询合同列表
Verb: GETPath: /api/v1/financial/contractsHeader: (Content-Type: application/json)Request Body：
{ "salesperson_name__like":"吴旭", #销售员 "project_name__like":"金源时代客流项目", #项目名称 "customer_name__like":"北京金源时代购物中心有限公司", #客户名称 "province":"1232", #项目所在省 "city":"1000", #项目所在市 "county":"1256", #项目所在县（区） "guarantee_period":7, #质保周期(单位是月) "year":"2018", #所属年份 "month":"3", #所属月份 "product_line_type":"3", #产品线类型(安防、交通、客流、维保) "contract_state":"2", #合同状态(已完成、待发货，施工中，项目暂停) "contract_type":"2", #合同性质(供货，施工，集成，维保) "acceptanc_type":"2", #验收类型(1为初验,2为终验) "is_archive":false, #合同是否归档 "confirm_income_amount":1400.00, #确定收入金额 "amount_state_unid":"3", #账款状态 "start_date":"2018-03-02", #签订时间，设置开始时间 "end_date":"2018-06-09" #结束时间，设置结束时间 "amount_point":140000.00, #设置金额查询节点 "overdays_point":176, #设置逾期天数查询节点 "leave_amount_point":11200.00, #设置应收账款余额查询节点 "offset":45, #起始位置 "limit":25 #每页显示的数量 }Response Body：
{ "total_number":1000, #总的数据量 "list_size":50, #本次返回的列表数量 "offset":70, #本次返回的起始索引 "list_data": #数据列表 [ { "contract_code":"2019-079", #合同编号 "product_line_type":"3", #产品线类型(安防、交通、客流、维保) "sign_date":"2018-02-03", #签订日期 "salesperson_name":"1000", #销售员名称 "province":"1000", #所在省份 "city":"1234", #所在市 "county":"1000", #所在县（区） "customer_name":"北京金源时代购物中心有限公司", #客户名称 "project_name":"金源时代客流项目", #项目名称 "contract_amount":140000.00, #合同金额 "stop_amount":5000.00, #暂停金额 "bad_amount":4000.00, #坏账金额 "exemptions_amount":5000.00, #豁免金额 "deduct_amount":7000.00, #抵扣金额 "total_reback_amount":600.00, #累计已收款 "contract_remain":8000.00, #合同余额 "account_state_unid":"3", #账款状态 "total_receive_amount":15000.00, #累计应收 "total_amount_remain":8000.00, #应收账款余额 "over_days":176, #逾期天数 "payment_data":[ #付款约定 { "payment_unid":xxxx, #付款unid "payment_progress":2, #付款进度 "payment_type":"3", #付款类型 "days":198, #天数 "payment_date":"2018-03-02", #本期应付款日期 "payment_amount":"2018-06-07", #本期应付金额 "payment_propority":0.30, #付款比例 "payment_requirement":"xxxx" #付款条件 }, ... ], "contract_note":"xxxx" #合同备注 }, ... ] }
导出表格
Verb: GETPath: /api/v1/financial/contracts/exportHeader: (Content-Type: application/json)Request Body：
{ "salesperson_name__like":"吴旭", #销售员 "project_name__like":"金源时代客流项目", #项目名称 "customer_name__like":"北京金源时代购物中心有限公司", #客户名称 "province":"1000", #项目所在省 "city":"1245", #项目所在市 "area":"5623", #项目所在县（区） "guarantee_period":24, #质保周期 "year":"2018", #所属年份 "month":"3", #所属月份 "product_line_type":"3", #产品线类型(安防、交通、客流、维保) "contract_state":"2", #合同状态(已完成、待发货，施工中，项目暂停) "contract_type":"3", #合同性质(供货，施工，集成，维保) "is_end_check":true, #是否终验 "is_archive":false, #合同是否归档 "confirm_income_amount":14000.00, #确定收入金额 "amount_state_unid":"3", #账款状态 "start_date":"2018-03-02", #签订时间，设置开始时间 "end_date":"2018-06-09", #结束时间，设置结束时间 "amount_point":14000.00, #设置金额查询节点 "overdays_point":176, #设置逾期天数查询节点 "leave_amount_point":1400.00 #设置应收账款余额查询节点 }Response Body：无
销售合同付款约定
增加销售合同付款约定信息
Verb: POSTPath: /api/v1/financial/contracts/{$contract_unid}/paymentsHeader: (Content-Type: application/json)Request Body：
{ "list_payment_data": #付款约定信息表 [ { "payment_progress":2, #付款进度（1,2,3,4） "payment_type":"3", #付款类型，通过code服务进行选择 "days":45, #天数 "payment_propority":0.30, #付款比例 "payment_requirement":"" #付款条件 }, ... ] }Response Body：
{ "ecode":"200", #新增成功返回码 "enote":"OK" #返回说明 }
查询具体合同付款约定信息
Verb: GETPath: /api/v1/financial/contracts/{$contract_unid}/paymentsHeader: (Content-Type: application/json)Request Body：无
Response Body：
{ "list_payment_data": #付款约定列表 [ { "payment_unid":xxxx, #付款unid "payment_progress":1, #付款进度 "payment_type":"2", #付款类型 "days":23, #天数 "payment_date":"2018-03-02", #本期应付款日期 "payment_amount":14000.00, #本期应付金额 "payment_propority":0.30, #付款比例 "payment_requirement":"xxxx", #付款条件 }, ... ] }
修改销售合同付款约定信息
Verb: PUTPath: /api/v1/financial/contracts/{$contract_unid}/paymentsHeader: (Content-Type: application/json)Request Body：
{ "list_payment_data": #付款约定列表 [ { "payment_unid":xxxx, #付款unid "payment_progress":2, #付款进度 "payment_type":"3", #付款类型 "days":30, #天数 "payment_propority":0.30, #付款比例 "payment_requirement":"xxxx" #付款条件 }, ... ] }Response Body：
{ "ecode":"200", #修改成功返回码 "enote":"OK" #返回说明 }
删除销售合同付款约定信息
Verb: DELETEPath: /api/v1/financial/contracts/{$contract_unid}/paymentsHeader: (Content-Type: application/json)Request Body：
{ "payment_unids": #付款unid数组 [ xxxx, #付款unid ... ] }Response Body：
{ "ecode":"200", #删除成功返回码 "enote":"OK" #返回说明 }
销售合同回款
增加销售合同回款信息
Verb: POSTPath: /api/v1/financial/contracts/{$contract_unid}/rebacksHeader: (Content-Type: application/json)Request Body：
Response Body：
{ "list_reback_data": #合同回款信息表 [ { "reback_progress ":1, #回款进度 "reback_date":"2018-06-03", #回款时间 "actual_reback_amount":14000.00, #实际回款数额 "reback_note":"xxxx", #回款备注 }, ... ] }Response Body：
{ "ecode":"200", #新增成功返回码 "enote":"OK" #返回说明 }
查询具体合同回款信息
Verb: GETPath: /api/v1/financial/contracts/{$contract_unid}/rebacksHeader: (Content-Type: application/json)Request Body：无
Response Body：{ "list_reback_data": #回款信息列表 [ { "reback_unid":xxxx, #回款unid "reback_progress":2, #回款进度 "reback_date":"2018-03-02", #回款时间 "reback_propority":0.30, #回款比例 "actual_reback_amount":14000.00, #实际回款数额 "reback_note":"xxxx", #回款备注 }, ... ] }
修改销售合同回款信息
Verb: PUTPath: /api/v1/financial/contracts/{$contract_unid}/rebacksHeader: (Content-Type: application/json)Request Body：
{ "list_reback_data": #回款信息列表 [ { "reback_unid":xxxx, #回款unid "reback_progress":3, #回款进度 "reback_date":"2018-03-02", #回款时间 "actual_reback_amount":14000.00, #实际回款数额 "reback_note ":"xxxx", #回款备注 }, ... ] }Response Body：
{ "ecode":"200", #修改成功返回码 "enote":"OK" #返回说明 }
删除销售合同回款信息
Verb: DELETEPath: /api/v1/financial/contracts/{$contract_unid}/rebacksHeader: (Content-Type: application/json)Request Body：
{ "reback_unids": #回款unid数组 [ xxxx, #回款unid ... ] }Response Body：
{ "ecode":"200", #删除成功返回码 "enote":"OK" #返回说明 }
销售合同开票
增加销售合同开票信息
Verb: POSTPath: /api/v1/financial/contracts/{$contract_unid}/receiptsHeader: (Content-Type: application/json)Request Body：
{ "list_receipt_data": #合同发票信息表 [ { "receipt_progress":3, #开票进度 "receipt_amount":14000.00, #开票金额 "oa_flow_id":"12345", #oa流水号 "receipt_note":"xxxx", #发票备注 }, ... ] }Response Body：
{ "ecode":"200", #新增成功返回码 "enote":"OK" #返回说明 }
查询具体合同开票信息
Verb: GETPath: /api/v1/financial/contracts/{$contract_unid}/receiptsHeader: (Content-Type: application/json)Request Body：无
Response Body：{ "list_receipt_data": #开票信息列表 [ { "receipt_unid":xxxx, #发票unid "receipt_progress":3, #开票次数 "oa_flow_id ":"12345", #oa流水号 "receipt_amount":14000.00, #开票金额 "total_receipt_amount":5000.00, #累计开票金额 "receipt_propority":0.30, #开票比例 "receipt_note":"xxxx", #开票备注 "create_date":"2018-03-02", #开票时间 }, ... ] }
修改销售合同开票信息
Verb: PUTPath: /api/v1/financial/contracts/{$contract_unid}/receiptsHeader: (Content-Type: application/json)Request Body：
{ "list_receipt_data": #合同发票信息表 [ { "receipt_unid":xxxx, #发票unid "receipt_progress":3, #开票进度 "receipt_amount":14000.00, #开票金额 "oa_flow_id":"12345", #oa流水号 "receipt_note":"xxxx", #发票备注 }, ... ] }Response Body：
{ "ecode":"200", #修改成功返回码 "enote":"OK" #返回说明 }
删除销售合同开票信息
Verb: DELETEPath: /api/v1/financial/contracts/{$contract_unid}/receiptsHeader: (Content-Type: application/json)Request Body：
{ "receipt_unids": #发票unid数组 [ xxxx, #发票unid ... ] }Response Body：
{ "ecode":"200", #删除成功返回码 "enote":"OK" #返回说明 }
销售合同发货
增加销售合同发货信息
Verb: POSTPath: /api/v1/financial/contracts/{$contract_unid}/deliversHeader: (Content-Type: application/json)Request Body：
{ "list_deliver_data": #合同发货信息表 [ { "deliver_goods_date":"2018-03-02", #发货时间 "goods_acceptanc_date":"2018-06-03", #到货验收时间 ("goods_sign_appendix":"xxxx", #到货签收单附件) "appendix_unids":["xxxx","xxxx",...] #合同附件(若有附件上传该字段) }, ... ] }Response Body：
{ "ecode":"200", #增加成功返回码 "enote":"OK" #返回说明 }
查询具体合同发货信息
Verb: GETPath: /api/v1/financial/contracts/{$contract_unid}/deliversHeader: (Content-Type: application/json)Request Body：无
Response Body：{ "list_deliver_data": #发货信息列表 [ { "deliver_unid":xxxx, #发货unid "deliver_goods_date":"2018-03-02", #发货时间 "goods_acceptanc_date ":"2018-06-09", #到货验收时间 "appendix_list": #附件列表集合 [ { "appendix_unid":"1234", #附件unid "appendix_url":"http://xxxx.pdf" #附件url } ... ] }, ... ] }
修改销售合同发货信息
Verb: PUTPath: /api/v1/financial/contracts/{$contract_unid}/deliversHeader: (Content-Type: application/json)Request Body：
{ "list_deliver_data": #合同发货信息表 [ { "deliver_unid":xxxx, #发货unid "deliver_goods_date":"2018-03-02", #发货时间 "goods_acceptanc_date":"2018-03-02", #到货验收时间 ("goods_sign_appendix":"xxxx",) #到货签收单附件 "appendix_unids":["xxxx","xxxx",...], #合同附件(若有附件上传该字段 }, ... ] }Response Body：
{ "ecode":"200", #修改成功返回码 "enote":"OK" #返回说明 }
删除销售合同发货信息
Verb: DELETEPath: /api/v1/financial/contracts/{$contract_unid}/deliversHeader: (Content-Type: application/json)Request Body：
{ "deliver_unids": #发货unid数组 [ "deliver_unid":xxxx, #发货unid ... ] }Response Body：
{ "ecode":"200", #删除成功返回码 "enote":"OK" #返回说明 }
销售合同工程验收
增加销售合同工程验收信息
Verb: POSTPath: /api/v1/financial/contracts/{$contract_unid}/project/acceptancsHeader: (Content-Type: application/json)Request Body：
{ "list_check_data": [ { "acceptanc_type":"1", #验收类型(1为初验、2为终验 "acceptanc_date":"2018-06-09", #验收时间 "acceptanc_note":"xxxx" #验收备注 "appendix_unids":["1234","5678",...] #附件列表 } ] }Response Body：
{ "ecode":"200", #增加成功返回码 "enote":"OK" #返回说明 }
查询具体合同工程验收信息
Verb: GETPath: /api/v1/financial/contracts/{$contract_unid}/project/acceptancsHeader: (Content-Type: application/json)Request Body：无
Response Body：{ "list_check_data": #工程验收信息列表 [ { "acceptanc_unid":xxxx, #工程id "acceptanc_type":"2", #验收类型 "acceptanc_date":"2018-07-02", #验收时间 "acceptanc_note":"xxxx", #验收备注 "appendix_list": #附件列表集合 [ { "appendix_unid":"1234", #附件unid "appendix_url":"http://xxxx.pdf" #附件url } ... ] }, ... ] }
修改销售合同工程验收信息
Verb: PUTPath: /api/v1/financial/contracts/{$contract_unid}/project/acceptancsHeader: (Content-Type: application/json)Request Body：
{ "list_check_data": #工程验收信息表 [ { "acceptanc_unid":xxxx, #工程验收unid "acceptanc_type":"2", #验收类型(1为初验、2为终验) "acceptanc_date":"2018-05-02", #验收时间 "acceptanc_note":"xxxx" #验收备注 "appendix_unids":["1234","5678",...] #附件列表 }, ... ] }Response Body：
{ "ecode":"200", #修改成功返回码 "enote":"OK" #返回说明 }
删除销售合同工程验收信息
Verb: DELETEPath: /api/v1/financial/contracts/{$contract_unid}/project/acceptancsHeader: (Content-Type: application/json)Request Body：
{ "acceptanc_unids": #验收unid数组 [ "acceptanc_unid":xxxx, #验收unid ... ] }Response Body：
{ "ecode":"200", #删除成功返回码 "enote":"OK" #返回说明 }
上传附件
Verb: POSTPath: /api/v1/financial/contracts/{$contract_unid}/upload/appendixesHeader: (Content-Type: multipart/form-data)Request Body：
{ "business_table":"project_acceptanc", #业务表名 "appendix_files":["xxxx","xxxxx"] #上传附件文件（file类型 }Response Body：
{ "appendix_data":[ { "business_table":"project_acceptanc", #业务表名 "appendix_unid":xxxxxxx #附件主键 }, ... ] }
查询合同编号
Verb: GETPath: /api/v1/financial/contracts/codesHeader: (Content-Type: application/json)Request Body：无
Request Body：
{ "contract_unids": #合同编号集合 [ "2018-032", "2018-079", ... ] }
查询顾客表
Verb: GETPath: /api/v1/financial/contracts/customersHeader: (Content-Type: application/json)Request Body：无
Request Body：
{ "customer_list": #顾客列表集合 [ { "customer_unid":1000, #顾客id "customer_name":"金源时代购物中心有限公司" #顾客名称 }, ... ] }
查询项目表
Verb: GETPath: /api/v1/financial/contracts/projectsHeader: (Content-Type: application/json)Request Body：无
Request Body：
{ "project_list": #项目列表集合 [ { "project_unid":1234, #项目id "project_name":"金源时代客流项目" #项目名称 }, ... ] }