02-finance-http.rst
26.4 KB
财务进度服务http接口
增加销售合同
Verb: POSTPath: /api/v1/financial/contractHeader: (Content-Type: application/json)Request Body：
{ "constract_code"":"2018-079", #合同编号，选择 "salesperson_unid":"吴旭", #销售员id，选择 "project_unid":"金源时代客流项目", #项目名称，选择 "customer_unid":"北京金源时代购物中心有限公司", #客户名称，选择 "location_province":"河北省", #项目所在地的省份 "location_city":"沧州市", #项目所在地的市区 "location_area":"献县", #项目所在地的县或区 "quality_cycle":"6/12/.../60", #质保周期,月份,步长为6 "sign_date":"2018/3/9", #签订时间 "year":"2018", #所属年份 "month":"3", #所属月份 "product_line_type":"xxxx", #产品线类型,(安防、交通、客流、维保) "contract_state":"xxxx", #合同状态,(已完成、待发货，施工中，项目暂停) "contract_nature":"xxxx", #合同性质,(供货，施工，集成，维保) "contract_amount":"140000.00", #合同金额,小数点保留两位 "deduct_amount":"5000.00", #折扣金额,小数点保留两位 "contract_amount_note":"xxxx", #合同金额备注,文本 "total_reback_amount":"133000.00", #累计回款额,小数点保留两位 "stop_amount":"xxxx", #暂停金额,小数点保留两位 "reback_note":"xxxx", #累计回款额备注,文本 "contract_remaining":"xxxx", #合同余额,小数点保留两位 "exemptions_amount":"xxxx", #豁免金额,小数点保留两位 "contract_remain_note":"xxxx", #合同余额备注 "is_file":"xxxx", #是否归档 "bad_amount":"xxxx", #坏账金额,小数点保留两位 "bad_amount_note":"xxxx", #坏账金额备注 "total_receive_amount":"xxxx", #累计应收款,小数点保留两位 "total_leave_amount":"xxxx", #应收账款余额,小数点保留两位 "over_days_unid":"176", #逾期天数 "confirm_income_amount":"xxxx", #确定收入金额,小数点保留两位 "amount_state_unid":"xxxx", #帐款状态 "start_guarantee_date":"xxxx", #维保服务期开始时间 "end_guarantee_date":"xxxx", #维保服务期结束时间 "quality_start_point":"xxxx", #质保期开始节点 "start_quality_date":"xxxx", #质保期开始时间 "end_quality_date":"xxxx", #质保期结束时间 "contract_note":"xxxx", #合同备注 "contract_appendix":"xxxx", #合同附件 "list_payment_data": #付款约定数据列表 [ { "payment_id":"xxxx", #付款约定表主键 "payment_period_number":"xxxx", #合同期数 "payment_period_state":"xxxx", #合同期数的状态 "total_days":"xxxx", #天数 "payment_agree_date":"xxxx", #应付款日期 "payment_amount":"xxxx", #应付金额 "payment_propority":"xxxx", #付款比例 "payment_requirement":"xxxx", #付款条件 }, ...... ] "list_reback_data": #合同回款信息表 [ { "return_id":"xxxx", #回款信息表主键 "payment_period_number":"xxxx", #付款期数 "actual_reback_amount":"xxxx", #实际回款数额 "reback_propority":"xxxx", #回款比例 "reback_note":"xxxx", #回款备注 }, ...... ] "list_receipt_data": #合同开票信息表 [ { "receipt_id":"xxxx", #开票信息表主键 "receipt_progress":"xxxx", #开票进度 "receipt_amount":"xxxx", #开票金额 "oa_flow_id":"xxxx", #oa流水号 "receipt_propority":"xxxx", #开票比例 "total_receipt_amount":"xxxx", #累计开票金额 "is_reback":"xxxx", #是否回款 "receipt_note":"xxxx", #发票备注 }, ...... ] "deliver_goods_date":"xxxx", #发货时间 "goodsl_check_date":"xxxx", #到货验收时间 "goods_sign_appendix":"xxxx", #到货签收单附件 "is_first_check":"xxxx", #是否是初验 "first_check_date":"xxxx", #初验时间 "first_check_appendix":"xxxx", #初验附件 "is_end_check":"xxxx", #是否是终验 "end_check_date":"xxxx", #终验时间 "check_note":"xxxx", #验收备注 "end_check_appendix":"xxxx" #终验附件 }Response Body：
{ "ecode":"200", #新增成功返回码 "ecote":"OK" #返回说明 }
查询合同详情
Verb: GETPath: /api/v1/financial/contract/{constract_code}Header: (Content-Type: application/json)Request Body：
Response Body：
{ "constract_code"":"2018-079", #合同编号，选择 "salesperson_unid":"吴旭", #销售员id，选择 "project_unid":"金源时代客流项目", #项目名称，选择 "customer_unid":"北京金源时代购物中心有限公司", #客户名称，选择 "location_province":"河北省", #项目所在地的省份 "location_city":"沧州市", #项目所在地的市区 "location_area":"献县", #项目所在地的县或区 "quality_cycle":"6/12/.../60", #质保周期,月份,步长为6 "sign_date":"2018/3/9", #签订时间 "year":"2018", #所属年份 "month":"3", #所属月份 "product_line_type":"xxxx", #产品线类型,(安防、交通、客流、维保) "contract_state":"xxxx", #合同状态,(已完成、待发货，施工中，项目暂停) "contract_nature":"xxxx", #合同性质,(供货，施工，集成，维保) "contract_amount":"140000.00", #合同金额,小数点保留两位 "deduct_amount":"5000.00", #折扣金额,小数点保留两位 "contract_amount_note":"xxxx", #合同金额备注,文本 "total_reback_amount":"133000.00", #累计回款额,小数点保留两位 "stop_amount":"xxxx", #暂停金额,小数点保留两位 "reback_note":"xxxx", #累计回款额备注,文本 "contract_remaining":"xxxx", #合同余额,小数点保留两位 "exemptions_amount":"xxxx", #豁免金额,小数点保留两位 "contract_remain_note":"xxxx", #合同余额备注 "is_file":"xxxx", #是否归档 "bad_amount":"xxxx", #坏账金额,小数点保留两位 "bad_amount_note":"xxxx", #坏账金额备注 "total_receive_amount":"xxxx", #累计应收款,小数点保留两位 "total_leave_amount":"xxxx", #应收账款余额,小数点保留两位 "over_days_unid":"176", #逾期天数 "confirm_income_amount":"xxxx", #确定收入金额,小数点保留两位 "amount_state_unid":"xxxx", #帐款状态 "start_guarantee_date":"xxxx", #维保服务期开始时间 "end_guarantee_date":"xxxx", #维保服务期结束时间 "quality_start_point":"xxxx", #质保期开始节点 "start_quality_date":"xxxx", #质保期开始时间 "end_quality_date":"xxxx", #质保期结束时间 "contract_note":"xxxx", #合同备注 "contract_appendix":"xxxx", #合同附件 "list_payment_data": #付款约定数据列表 [ { "payment_id":"xxxx", #付款约定表主键 "payment_period_number":"xxxx", #合同期数 "payment_period_state":"xxxx", #合同期数的状态 "total_days":"xxxx", #天数 "payment_agree_date":"xxxx", #应付款日期 "payment_amount":"xxxx", #应付金额 "payment_propority":"xxxx", #付款比例 "payment_requirement":"xxxx", #付款条件 }, ...... ] "list_reback_data": #合同回款信息表 [ { "return_id":"xxxx", #回款信息表主键 "payment_period_number":"xxxx", #付款期数 "actual_reback_amount":"xxxx", #实际回款数额 "reback_propority":"xxxx", #回款比例 "reback_note":"xxxx", #回款备注 }, ...... ] "list_receipt_data": #合同开票信息表 [ { "receipt_id":"xxxx", #开票信息表主键 "receipt_progress":"xxxx", #开票进度 "receipt_amount":"xxxx", #开票金额 "oa_flow_id":"xxxx", #oa流水号 "receipt_propority":"xxxx", #开票比例 "total_receipt_amount":"xxxx", #累计开票金额 "is_reback":"xxxx", #是否回款 "receipt_note":"xxxx", #发票备注 }, ...... ] "deliver_goods_date":"xxxx", #发货时间 "goodsl_check_date":"xxxx", #到货验收时间 "goods_sign_appendix":"xxxx", #到货签收单附件 "is_first_check":"xxxx", #是否是初验 "first_check_date":"xxxx", #初验时间 "first_check_appendix":"xxxx", #初验附件 "is_end_check":"xxxx", #是否是终验 "end_check_date":"xxxx", #终验时间 "check_note":"xxxx", #验收备注 "end_check_appendix":"xxxx" #终验附件 }
删除销售合同
Verb: DELETEPath: /api/v1/financial/contract/{constract_code}Header: (Content-Type: application/json)Request Body：无
Response Body：
{ "ecode":"200", #删除成功返回码 "ecote":"OK" #返回说明 }
修改销售合同
Verb: POSTPath: /api/v1/financial/contract/{constract_code}Header: (Content-Type: application/json)Request Body：
{ "constract_code"":"2018-079", #合同编号，选择 "salesperson_unid":"吴旭", #销售员id，选择 "project_unid":"金源时代客流项目", #项目名称，选择 "customer_unid":"北京金源时代购物中心有限公司", #客户名称，选择 "location_province":"河北省", #项目所在地的省份 "location_city":"沧州市", #项目所在地的市区 "location_area":"献县", #项目所在地的县或区 "quality_cycle":"6/12/.../60", #质保周期,月份,步长为6 "sign_date":"2018/3/9", #签订时间 "year":"2018", #所属年份 "month":"3", #所属月份 "product_line_type":"xxxx", #产品线类型,(安防、交通、客流、维保) "contract_state":"xxxx", #合同状态,(已完成、待发货，施工中，项目暂停) "contract_nature":"xxxx", #合同性质,(供货，施工，集成，维保) "contract_amount":"140000.00", #合同金额,小数点保留两位 "deduct_amount":"5000.00", #折扣金额,小数点保留两位 "contract_amount_note":"xxxx", #合同金额备注,文本 "total_reback_amount":"133000.00", #累计回款额,小数点保留两位 "stop_amount":"xxxx", #暂停金额,小数点保留两位 "reback_note":"xxxx", #累计回款额备注,文本 "contract_remaining":"xxxx", #合同余额,小数点保留两位 "exemptions_amount":"xxxx", #豁免金额,小数点保留两位 "contract_remain_note":"xxxx", #合同余额备注 "is_file":"xxxx", #是否归档 "bad_amount":"xxxx", #坏账金额,小数点保留两位 "bad_amount_note":"xxxx", #坏账金额备注 "total_receive_amount":"xxxx", #累计应收款,小数点保留两位 "total_leave_amount":"xxxx", #应收账款余额,小数点保留两位 "over_days_unid":"176", #逾期天数 "confirm_income_amount":"xxxx", #确定收入金额,小数点保留两位 "amount_state_unid":"xxxx", #帐款状态 "start_guarantee_date":"xxxx", #维保服务期开始时间 "end_guarantee_date":"xxxx", #维保服务期结束时间 "quality_start_point":"xxxx", #质保期开始节点 "start_quality_date":"xxxx", #质保期开始时间 "end_quality_date":"xxxx", #质保期结束时间 "contract_note":"xxxx", #合同备注 "contract_appendix":"xxxx", #合同附件 "list_payment_data": #付款约定数据列表 [ { "payment_id":"xxxx", #付款约定表主键 "payment_period_number":"xxxx", #合同期数 "payment_period_state":"xxxx", #合同期数的状态 "total_days":"xxxx", #天数 "payment_agree_date":"xxxx", #应付款日期 "payment_amount":"xxxx", #应付金额 "payment_propority":"xxxx", #付款比例 "payment_requirement":"xxxx", #付款条件 }, ...... ] "list_reback_data": #合同回款信息表 [ { "return_id":"xxxx", #回款信息表主键 "payment_period_number":"xxxx", #付款期数 "actual_reback_amount":"xxxx", #实际回款数额 "reback_propority":"xxxx", #回款比例 "reback_note":"xxxx", #回款备注 }, ...... ] "list_receipt_data": #合同开票信息表 [ { "receipt_id":"xxxx", #开票信息表主键 "receipt_progress":"xxxx", #开票进度 "receipt_amount":"xxxx", #开票金额 "oa_flow_id":"xxxx", #oa流水号 "receipt_propority":"xxxx", #开票比例 "total_receipt_amount":"xxxx", #累计开票金额 "is_reback":"xxxx", #是否回款 "receipt_note":"xxxx", #发票备注 }, ...... ] "deliver_goods_date":"xxxx", #发货时间 "goodsl_check_date":"xxxx", #到货验收时间 "goods_sign_appendix":"xxxx", #到货签收单附件 "is_first_check":"xxxx", #是否是初验 "first_check_date":"xxxx", #初验时间 "first_check_appendix":"xxxx", #初验附件 "is_end_check":"xxxx", #是否是终验 "end_check_date":"xxxx", #终验时间 "check_note":"xxxx", #验收备注 "end_check_appendix":"xxxx" #终验附件 }Response Body：
{ "ecode":"200", #修改成功返回码 "ecote":"OK" #返回说明 }
查询合同列表
Verb: GETPath: /api/v1/financial/contractHeader: (Content-Type: application/json)Request Body：
{ "salesperson_unid":"吴旭", #销售员 "project_unid":"金源时代客流项目", #项目名称 "customer_unid":"北京金源时代购物中心有限公司", #客户名称 "location_province":"河北省", #项目所在省 "location_city":"沧州市", #项目所在市 "location_area":"献县", #项目所在县（区） "quality_cycle":"xxxx", #质保周期 "year":"2018", #所属年份 "month":"3", #所属月份 "product_line_type":"xxxx", #产品线类型(安防、交通、客流、维保) "contract_state":"xxxx", #合同状态(已完成、待发货，施工中，项目暂停) "contract_nature":"xxxx", #合同性质(供货，施工，集成，维保) "is_end_check":"xxxx", #是否终验 "is_file":"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", #合同编号 "year":"2018", #所属年份 "product_line_type":"xxxx", #产品线类型(安防、交通、客流、维保) "sign_date":"xxxx", #签订日期 "month":"3", #所属月份 "salesperson_unid":"xxxx", #销售员 "location_province":"河北省", #所在省份 "location_city":"沧州市", #所在市 "location_area":"献县", #所在县（区） "customer_unid":"北京金源时代购物中心有限公司", #客户名称 "project_unid":"金源时代客流项目", #项目名称 "contract_amount":"xxxx", #合同金额 "stop_amount":"xxxx", #暂停金额 "bad_amount":"xxxx", #坏账金额 "exemptions_amount":"xxxx", #豁免金额 "deduct_amount":"xxxx", #抵扣金额 "total_reback_amount":"xxxx", #累计回款额 "contract_remaining":"xxxx", #合同余额 "amount_state_unid":"xxxx", #账款状态 "total_receive_amount":"xxxx", #累计应收款 "total_leave_amount":"xxxx", #应收账款余额 "over_days_unid":"xxxx", #逾期天数 "payment_amount":"xxxx", #预付款金额 "payment_amount":"xxxx", #到货款金额 "payment_amount":"xxxx", #验收款金额 "payment_amount":"xxxx", #质保金额 "deliver_goods_date":"xxxx", #发货时间 "payment_agree_date":"xxxx", #到货款到期日 "payment_agree_date":"xxxx", #验收款到期日 "end_quality_date":"xxxx", #质保期结束时间 "goods_check_date":"xxxx", #验收日期 "check_note":"xxxx", #合同备注 ], ...... }
导出表格
Verb: GETPath: /api/v1/financial/contract/exportHeader: (Content-Type: application/json)Request Body：
{ "salesperson_unid":"吴旭", #销售员 "project_unid":"金源时代客流项目", #项目名称 "customer_unid":"北京金源时代购物中心有限公司", #客户名称 "location_province":"河北省", #项目所在省 "location_city":"沧州市", #项目所在市 "location_area":"献县", #项目所在县（区） "quality_cycle":"xxxx", #质保周期 "year":"2018", #所属年份 "month":"3", #所属月份 "product_line_type":"xxxx", #产品线类型(安防、交通、客流、维保) "contract_state":"xxxx", #合同状态(已完成、待发货，施工中，项目暂停) "contract_nature":"xxxx", #合同性质(供货，施工，集成，维保) "is_end_check":"xxxx", #是否终验 "is_file":"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：