02-finance-http.rst.txt

财务进度服务http接口
=======================

销售合同
^^^^^^^^^^^^^^^^^^^

增加销售合同
*************

 | Verb: POST 
 | Path: /api/v1/financial/contracts
 | Header: (Content-Type: application/json)

  Request Body：

  .. code-block:: python
     
	 {
		"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：

  .. code-block:: python
  
	{
		"ecode":"200", 		                                           #新增成功返回码
		"enote":"OK"                                                   #返回说明 
		
	}
	

	
查询具体合同详情
******************	

 | Verb: GET 
 | Path: /api/v1/financial/contracts/{$contract_unid}
 | Header: (Content-Type: application/json)

  Request Body：无
	
  Response Body：

  .. code-block:: python
  
    {
		"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: PUT 
 | Path: /api/v1/financial/contracts/{$contract_unid}
 | Header: (Content-Type: application/json)

  Request Body：

  .. code-block:: python
     
	 {
		"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：

  .. code-block:: python
  
	{
		"ecode":"200", 		                                        #修改成功返回码
		"enote":"OK"                                                #返回说明 
		
	}

	
删除销售合同
****************

 | Verb: DELETE 
 | Path: /api/v1/financial/contracts/{$contract_unid}
 | Header: (Content-Type: application/json)

  Request Body：无
	 
  Response Body：                                                      

  .. code-block:: python
  
	{
		"ecode":"200", 		                                           #删除成功返回码
		"enote":"OK"                                                   #返回说明 
		
	}

查询合同列表
********************************

 | Verb: GET 
 | Path: /api/v1/financial/contracts
 | Header: (Content-Type: application/json)

  Request Body：

  .. code-block:: python
  
    {
		"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：

  .. code-block:: python
  
    {
		"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: GET 
 | Path: /api/v1/financial/contracts/export
 | Header: (Content-Type: application/json)

  Request Body：

  .. code-block:: python
  
    {
		"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: POST 
 | Path: /api/v1/financial/contracts/{$contract_unid}/payments
 | Header: (Content-Type: application/json)

  Request Body：

  .. code-block:: python
     
	 {
		"list_payment_data":                                                #付款约定信息表
		[
			{
				"payment_progress":2,                                  #付款进度（1,2,3,4）
				"payment_type":"3",                                      #付款类型，通过code服务进行选择
				"days":45,                                              #天数
				"payment_propority":0.30,                                 #付款比例
				"payment_requirement":""                                  #付款条件
			},
			...
		]
	}
	 
  Response Body：

  .. code-block:: python
  
	{
		"ecode":"200", 		                                           #新增成功返回码
		"enote":"OK"                                                   #返回说明 
		
	}


查询具体合同付款约定信息
***************************	

 | Verb: GET 
 | Path: /api/v1/financial/contracts/{$contract_unid}/payments
 | Header: (Content-Type: application/json)

  Request Body：无
	
  Response Body：

  .. code-block:: python
  
    {
		"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: PUT 
 | Path: /api/v1/financial/contracts/{$contract_unid}/payments
 | Header: (Content-Type: application/json)

  Request Body：

  .. code-block:: python
     
	 {
		"list_payment_data":                                            #付款约定列表
		[
			{
				"payment_unid":xxxx,                                  #付款unid
				"payment_progress":2,                              #付款进度
				"payment_type":"3",                                   #付款类型
				"days":30,                                          #天数
				"payment_propority":0.30,                             #付款比例
				"payment_requirement":"xxxx"                            #付款条件
			},
			...
		]
	}
	 
  Response Body：

  .. code-block:: python
  
	{
		"ecode":"200", 		                                           #修改成功返回码
		"enote":"OK"                                                   #返回说明 
		
	}
	
		
删除销售合同付款约定信息
*******************************

 | Verb: DELETE 
 | Path: /api/v1/financial/contracts/{$contract_unid}/payments
 | Header: (Content-Type: application/json)

  Request Body：

  .. code-block:: python
     
	 {
		"payment_unids":                                               #付款unid数组
		[
			xxxx,                                     #付款unid
			...
		]
	}
	 
  Response Body：

  .. code-block:: python
  
	{
		"ecode":"200", 		                                           #删除成功返回码
		"enote":"OK"                                                   #返回说明 
		
	}
	
销售合同回款
^^^^^^^^^^^^^^^^^^^^^^^^^
		
增加销售合同回款信息
************************

 | Verb: POST 
 | Path: /api/v1/financial/contracts/{$contract_unid}/rebacks
 | Header: (Content-Type: application/json)

  Request Body：
	
  Response Body：

  .. code-block:: python
  
	 {
		"list_reback_data":                                         #合同回款信息表
		[
			{
				"reback_progress ":1,                          #回款进度
				"reback_date":"2018-06-03",                               #回款时间
				"actual_reback_amount":14000.00,                      #实际回款数额
				"reback_note":"xxxx",                               #回款备注
			},
			...
		]
	}
	
 Response Body：

  .. code-block:: python
  
	{
		"ecode":"200", 		                                           #新增成功返回码
		"enote":"OK"                                                   #返回说明 
		
	}
	
	
查询具体合同回款信息
***********************	

 | Verb: GET 
 | Path: /api/v1/financial/contracts/{$contract_unid}/rebacks
 | Header: (Content-Type: application/json)

  Request Body：无
	
    Response Body：

  .. code-block:: python
  
    {
		"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: PUT 
 | Path: /api/v1/financial/contracts/{$contract_unid}/rebacks
 | Header: (Content-Type: application/json)

  Request Body：

  .. code-block:: python
     
	 {
		"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：

  .. code-block:: python
  
	{
		"ecode":"200", 		                                           #修改成功返回码
		"enote":"OK"                                                   #返回说明 
		
	}
	
删除销售合同回款信息
**************************

 | Verb: DELETE 
 | Path: /api/v1/financial/contracts/{$contract_unid}/rebacks
 | Header: (Content-Type: application/json)

  Request Body：

  .. code-block:: python
     
	 {
		"reback_unids":                                               #回款unid数组
		[
			xxxx,                                     #回款unid
			...
		]
	}
	 
  Response Body：

  .. code-block:: python
  
	{
		"ecode":"200", 		                                           #删除成功返回码
		"enote":"OK"                                                   #返回说明 
		
	}
	
销售合同开票
^^^^^^^^^^^^^^^^^^
			
增加销售合同开票信息
****************************

 | Verb: POST 
 | Path: /api/v1/financial/contracts/{$contract_unid}/receipts
 | Header: (Content-Type: application/json)

  Request Body：
  
    .. code-block:: python
	
	  {
		"list_receipt_data":                                        #合同发票信息表
		[
			{
				"receipt_progress":3,                          #开票进度
				"receipt_amount":14000.00,                            #开票金额
				"oa_flow_id":"12345",                                #oa流水号
				"receipt_note":"xxxx",                              #发票备注  
			},
			...
		]
	  }
  
  Response Body：

  .. code-block:: python
  
	{
		"ecode":"200", 		                                           #新增成功返回码
		"enote":"OK"                                                   #返回说明 
		
	}

查询具体合同开票信息
****************************	

 | Verb: GET 
 | Path: /api/v1/financial/contracts/{$contract_unid}/receipts
 | Header: (Content-Type: application/json)

  Request Body：无
	
    Response Body：

  .. code-block:: python
  
    {
		"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: PUT 
 | Path: /api/v1/financial/contracts/{$contract_unid}/receipts
 | Header: (Content-Type: application/json)

  Request Body：

  .. code-block:: python
     
	 {
		"list_receipt_data":                                        #合同发票信息表
		[
			{
				"receipt_unid":xxxx,                              #发票unid
 				"receipt_progress":3,                          #开票进度
				"receipt_amount":14000.00,                            #开票金额
				"oa_flow_id":"12345",                                #oa流水号
				"receipt_note":"xxxx",                              #发票备注  
			},
			...
		]
	}
	 
  Response Body：

  .. code-block:: python
  
	{
		"ecode":"200", 		                                           #修改成功返回码
		"enote":"OK"                                                   #返回说明 
		
	}
	
	
删除销售合同开票信息
******************************

 | Verb: DELETE 
 | Path: /api/v1/financial/contracts/{$contract_unid}/receipts
 | Header: (Content-Type: application/json)

  Request Body：

  .. code-block:: python
     
	 {
		"receipt_unids":                                                #发票unid数组
		[
			xxxx,                                     #发票unid
			...
		]
	}
	 
  Response Body：

  .. code-block:: python
  
	{
		"ecode":"200", 		                                           #删除成功返回码
		"enote":"OK"                                                   #返回说明 
		
	}
	
	
销售合同发货
^^^^^^^^^^^^^^^^^^^^^^^^^
	
增加销售合同发货信息
****************************

 | Verb: POST 
 | Path: /api/v1/financial/contracts/{$contract_unid}/delivers
 | Header: (Content-Type: application/json)

  Request Body：

  .. code-block:: python
  
	 {
		"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：

  .. code-block:: python
  
	{
		"ecode":"200", 		                                               #增加成功返回码
		"enote":"OK"                                                       #返回说明 
		
	}

	
查询具体合同发货信息
************************	

 | Verb: GET 
 | Path: /api/v1/financial/contracts/{$contract_unid}/delivers
 | Header: (Content-Type: application/json)

  Request Body：无
	
    Response Body：

  .. code-block:: python
  
    {
		"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: PUT 
 | Path: /api/v1/financial/contracts/{$contract_unid}/delivers
 | Header: (Content-Type: application/json)

  Request Body：

  .. code-block:: python
     
	 {
		"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：

  .. code-block:: python
  
	{
		"ecode":"200", 		                                           #修改成功返回码
		"enote":"OK"                                                   #返回说明 
		
	}

	
删除销售合同发货信息
************************** 

 | Verb: DELETE 
 | Path: /api/v1/financial/contracts/{$contract_unid}/delivers
 | Header: (Content-Type: application/json)

  Request Body：

  .. code-block:: python
     
	 {
		"deliver_unids":                                               #发货unid数组                                    
		[
			"deliver_unid":xxxx,                                     #发货unid
			...
		]
	}
	 
  Response Body：

  .. code-block:: python
  
	{
		"ecode":"200", 		                                           #删除成功返回码
		"enote":"OK"                                                   #返回说明 
		
	}
	
	
销售合同工程验收
^^^^^^^^^^^^^^^^^^^^^^^
	
增加销售合同工程验收信息
******************************

 | Verb: POST 
 | Path: /api/v1/financial/contracts/{$contract_unid}/project/acceptancs
 | Header: (Content-Type: application/json)

  Request Body：

  .. code-block:: python
  
	 {
		"list_check_data":
		[
			{
				"acceptanc_type":"1",                                     #验收类型(1为初验、2为终验
				"acceptanc_date":"2018-06-09",                                     #验收时间
				"acceptanc_note":"xxxx"                                      #验收备注
				"appendix_unids":["1234","5678",...]                     #附件列表
			}
		]
		
	}
  
  Response Body：

  .. code-block:: python
  
	{
		"ecode":"200", 		                                             #增加成功返回码
		"enote":"OK"                                                     #返回说明 
		
	}


查询具体合同工程验收信息
**************************	

 | Verb: GET 
 | Path: /api/v1/financial/contracts/{$contract_unid}/project/acceptancs
 | Header: (Content-Type: application/json)

  Request Body：无
	
    Response Body：

  .. code-block:: python
  
    {
		"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: PUT 
 | Path: /api/v1/financial/contracts/{$contract_unid}/project/acceptancs
 | Header: (Content-Type: application/json)

  Request Body：

  .. code-block:: python
     
	 {
		"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：

  .. code-block:: python
  
	{
		"ecode":"200", 		                                           #修改成功返回码
		"enote":"OK"                                                   #返回说明 
		
	}
	
	

删除销售合同工程验收信息
*****************************

 | Verb: DELETE 
 | Path: /api/v1/financial/contracts/{$contract_unid}/project/acceptancs
 | Header: (Content-Type: application/json)

  Request Body：

  .. code-block:: python
     
	 {
		"acceptanc_unids":                                               #验收unid数组
		[
			"acceptanc_unid":xxxx,                                     #验收unid
			...
		]
	}
	 
  Response Body：

  .. code-block:: python
  
	{
		"ecode":"200", 		                                           #删除成功返回码
		"enote":"OK"                                                   #返回说明 
		
	}
	


上传附件
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

 | Verb: POST 
 | Path: /api/v1/financial/contracts/{$contract_unid}/upload/appendixes
 | Header: (Content-Type: multipart/form-data)

  Request Body：

  .. code-block:: python
  
	 {
	   "business_table":"project_acceptanc",            #业务表名
	   "appendix_files":["xxxx","xxxxx"]	            #上传附件文件（file类型
	}
  
  Response Body：

  .. code-block:: python
  
	{
		"appendix_data":[
		    {
		      "business_table":"project_acceptanc",   #业务表名
		      "appendix_unid":xxxxxxx               #附件主键
		    },
		    ...
		]
		
	}



查询合同编号
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

 | Verb: GET 
 | Path: /api/v1/financial/contracts/codes
 | Header: (Content-Type: application/json)

  Request Body：无
  
  Request Body：

  .. code-block:: python
  
    {
		"contract_unids":   #合同编号集合
		[
		    "2018-032",         
		    "2018-079",
		    ...
		]                       
	}
	
	
查询顾客表
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

 | Verb: GET 
 | Path: /api/v1/financial/contracts/customers
 | Header: (Content-Type: application/json)

  Request Body：无
  
  Request Body：

  .. code-block:: python
  
    {
		"customer_list":                                 #顾客列表集合
		[
			{
				"customer_unid":1000,                  #顾客id
				"customer_name":"金源时代购物中心有限公司"                   #顾客名称 
			},
			...
		]
	}
	
	
查询项目表
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

 | Verb: GET 
 | Path: /api/v1/financial/contracts/projects
 | Header: (Content-Type: application/json)

  Request Body：无
  
  Request Body：

  .. code-block:: python
  
    {
		"project_list":                                 #项目列表集合
		[
			{
				"project_unid":1234,                 #项目id
				"project_name":"金源时代客流项目"                  #项目名称 
			},
			...
		]
	}