02-finance-http.rst.txt
25.9 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
财务进度服务http接口
=======================
增加销售合同
^^^^^^^^^^^^^^^
| Verb: POST
| Path: /api/v1/financial/contract
| Header: (Content-Type: application/json)
Request Body：
.. code-block:: python
{
"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：
.. code-block:: python
{
"ecode":"200", #新增成功返回码
"ecote":"OK" #返回说明
}
查询合同详情
^^^^^^^^^^^^^^^^^^^^^
| Verb: GET
| Path: /api/v1/financial/contract/{constract_code}
| Header: (Content-Type: application/json)
Request Body：
Response Body：
.. code-block:: python
{
"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: DELETE
| Path: /api/v1/financial/contract/{constract_code}
| Header: (Content-Type: application/json)
Request Body：无
Response Body：
.. code-block:: python
{
"ecode":"200", #删除成功返回码
"ecote":"OK" #返回说明
}
修改销售合同
^^^^^^^^^^^^^^^
| Verb: POST
| Path: /api/v1/financial/contract/{constract_code}
| Header: (Content-Type: application/json)
Request Body：
.. code-block:: python
{
"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：
.. code-block:: python
{
"ecode":"200", #修改成功返回码
"ecote":"OK" #返回说明
}
查询合同列表
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
| Verb: GET
| Path: /api/v1/financial/contract
| Header: (Content-Type: application/json)
Request Body：
.. code-block:: python
{
"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：
.. code-block:: python
{
[
"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: GET
| Path: /api/v1/financial/contract/export
| Header: (Content-Type: application/json)
Request Body：
.. code-block:: python
{
"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：
.. code-block:: python