Commit e936e4da2728afa96286dbff8a057679916b6232

Authored by 张楣扬
1 parent 17fd755a

docs(config): 添加中瑞商城业务费用项字段配置文档

- 新增“业务费用项配置”详细字段说明,包括订单金额、佣金、积分、优惠券等入出项
- 描述应收单、收款单、收款退款单的费用类型编码与支付方式映射关系
- 补充账套配置示例,明确系统类型和租户信息
- 提供应收单各配置项JSON格式示例,包括结算组织、币别、销售组织等动态映射配置
- 详细列出费用承担部门、销售部门、费用项的动态配置映射表
- 文档内容完整覆盖配置参数与业务用途,方便后续开发和维护参考
doc/商城中瑞生产字段配置.md
@@ -272,11 +272,11 @@ PLAT_WITHDRAW(11, "平台提现"); @@ -272,11 +272,11 @@ PLAT_WITHDRAW(11, "平台提现");
272 code: "MALL_57", 272 code: "MALL_57",
273 // 账套名称 mall+租户id 273 // 账套名称 mall+租户id
274 params: { 274 params: {
275 - dCID: "61bacdc5abc2c5",  
276 - appId: "299721_w6aNWcEuVuh/WWzO41xKQ/StTqWdSqLP",  
277 - userName: "市场",  
278 - appSecret: "d9d5ff0f237a43f3b0e66a45aa79aef2",  
279 - serverUrl: "http://120.46.151.190/k3cloud/", 275 + "dCID": "69b9e6ec5253c7",
  276 + "appId": "338616_67du6wDJ4rqb3WSvS11t17+FSMRa6qsL",
  277 + "userName": "市场",
  278 + "appSecret": "e52ebd4238154e048d7495e80d918d70",
  279 + "serverUrl": "http://114.116.243.168/k3cloud"
280 }, 280 },
281 } 281 }
282 ``` 282 ```
doc/大润发中瑞生产字段配置.md
@@ -58,11 +58,11 @@ MINI_PROGRAM(3, "小程序"); @@ -58,11 +58,11 @@ MINI_PROGRAM(3, "小程序");
58 "code": "CASHIER_1001", 58 "code": "CASHIER_1001",
59 // 账套名称 mall+租户id 59 // 账套名称 mall+租户id
60 "params": { 60 "params": {
61 - "dCID": "61bacdc5abc2c5",  
62 - "appId": "299721_w6aNWcEuVuh/WWzO41xKQ/StTqWdSqLP", 61 + "dCID": "69b9e6ec5253c7",
  62 + "appId": "338616_67du6wDJ4rqb3WSvS11t17+FSMRa6qsL",
63 "userName": "市场", 63 "userName": "市场",
64 - "appSecret": "d9d5ff0f237a43f3b0e66a45aa79aef2",  
65 - "serverUrl": "http://120.46.151.190/k3cloud/", 64 + "appSecret": "e52ebd4238154e048d7495e80d918d70",
  65 + "serverUrl": "http://114.116.243.168/k3cloud"
66 }, 66 },
67 } 67 }
68 ``` 68 ```
doc/水电费中瑞生产字段配置.md 0 → 100644
  1 +# 业务费用项配置(采用 结算方式+"-"+"业务")
  2 +
  3 +```
  4 +WATER_BILLS(1, "水费"),
  5 +ELECTRICITY_BILLS(2, "电费");
  6 +```
  7 +
  8 +# 线上线下渠道
  9 +
  10 +```
  11 +PARK_CARD(1, "园区卡"),
  12 +WECHAT_PAY(10, "微信支付");
  13 +```
  14 +
  15 +## 应收单
  16 +
  17 +### 水费(入)(CI027)
  18 +
  19 +```
  20 +1 水费
  21 +
  22 +```
  23 +
  24 +### 电费(出)(CI028)
  25 +
  26 +```
  27 +2 电费
  28 +```
  29 +
  30 +## 收款单
  31 +
  32 +### 支付(CI185)
  33 +
  34 +```
  35 +1. 微信支付 10
  36 +```
  37 +
  38 +## 收款退款单
  39 +
  40 +### 订单退款(CI185)
  41 +
  42 +```
  43 +1. 微信支付 10
  44 +```
  45 +
  46 +## 1.账套配置 JSON
  47 +
  48 +```json5
  49 +{
  50 + "group": "MALL",
  51 + //固定
  52 + "entity": "57",
  53 + //商城对应租户id
  54 + "systemType": "kingdee",
  55 + "name": "中瑞水电费账套",
  56 + "code": "ETRADE_ZR",
  57 + // 账套名称 mall+租户id
  58 + "params": {
  59 + "dCID": "69b9e6ec5253c7",
  60 + "appId": "338616_67du6wDJ4rqb3WSvS11t17+FSMRa6qsL",
  61 + "userName": "市场",
  62 + "appSecret": "e52ebd4238154e048d7495e80d918d70",
  63 + "serverUrl": "http://114.116.243.168/k3cloud"
  64 + }
  65 +}
  66 +```
  67 +
  68 +## 2.应收单配置 JSON
  69 +
  70 +### 2.1 settleOrg 结算组织
  71 +
  72 +```json
  73 +{
  74 + "pipelineId": 3,
  75 + "documentType": "AR_receivable",
  76 + "configKey": "settleOrg",
  77 + "settingFieldType": 0,
  78 + "fixedValue": "101"
  79 +}
  80 +```
  81 +
  82 +### 2.2 currency 币别
  83 +
  84 +```json
  85 +{
  86 + "pipelineId": 3,
  87 + "documentType": "AR_receivable",
  88 + "configKey": "currency",
  89 + "settingFieldType": 0,
  90 + "fixedValue": "PRE001"
  91 +}
  92 +```
  93 +
  94 +### 2.3 saleOrg 销售组织
  95 +
  96 +```json
  97 +{
  98 + "pipelineId": 3,
  99 + "documentType": "AR_receivable",
  100 + "configKey": "saleOrg",
  101 + "settingFieldType": 0,
  102 + "fixedValue": "101"
  103 +}
  104 +```
  105 +
  106 +### 2.4 businessType 业务类型
  107 +
  108 +```json
  109 +{
  110 + "pipelineId": 3,
  111 + "documentType": "AR_receivable",
  112 + "configKey": "businessType",
  113 + "settingFieldType": 0,
  114 + "fixedValue": "scfyys-002"
  115 +}
  116 +```
  117 +
  118 +### 2.5 standardCurrency 本位币
  119 +
  120 +```json
  121 +{
  122 + "pipelineId": 3,
  123 + "documentType": "AR_receivable",
  124 + "configKey": "standardCurrency",
  125 + "settingFieldType": 0,
  126 + "fixedValue": "PRE001"
  127 +}
  128 +```
  129 +
  130 +### 2.6 payOrg 收款组织
  131 +
  132 +```json
  133 +{
  134 + "pipelineId": 3,
  135 + "documentType": "AR_receivable",
  136 + "configKey": "payOrg",
  137 + "settingFieldType": 0,
  138 + "fixedValue": "101"
  139 +}
  140 +```
  141 +
  142 +### 2.7 chargeItemDept 费用承担部门
  143 +
  144 +```json
  145 +{
  146 + "pipelineId": 3,
  147 + "documentType": "AR_receivable",
  148 + "configKey": "chargeItemDept",
  149 + "settingFieldType": 0,
  150 + "fixedValue": "BM000040"
  151 +}
  152 +```
  153 +
  154 +### 2.8 saleDept 销售部门
  155 +
  156 +```json
  157 +{
  158 + "pipelineId": 3,
  159 + "documentType": "AR_receivable",
  160 + "configKey": "saleDept",
  161 + "settingFieldType": 1,
  162 + "dynamicValues": [
  163 + {
  164 + "configValue": "10",
  165 + "configMapValue": "BM000099"
  166 + },
  167 + {
  168 + "configValue": "1",
  169 + "configMapValue": "BM000042"
  170 + }
  171 + ]
  172 +}
  173 +```
  174 +
  175 +### 2.9 chargeItem 费用项
  176 +
  177 +```json
  178 +{
  179 + "pipelineId": 3,
  180 + "documentType": "AR_receivable",
  181 + "configKey": "chargeItem",
  182 + "settingFieldType": 1,
  183 + "dynamicValues": [
  184 + {
  185 + "configValue": "1",
  186 + "configMapValue": "CI027"
  187 + },
  188 + {
  189 + "configValue": "2",
  190 + "configMapValue": "CI028"
  191 + }
  192 + ]
  193 +}
  194 +```
  195 +
  196 +### 2.10 settleMethod 结算方式
  197 +
  198 +```json
  199 +{
  200 + "pipelineId": 3,
  201 + "documentType": "AR_receivable",
  202 + "configKey": "settleMethod",
  203 + "settingFieldType": 0,
  204 + "fixedValue": "1"
  205 +}
  206 +```
  207 +
  208 +### 2.11 receiveDept 收款部门
  209 +
  210 +```json
  211 +{
  212 + "pipelineId": 3,
  213 + "documentType": "AR_receivable",
  214 + "configKey": "receiveDept",
  215 + "settingFieldType": 0,
  216 + "fixedValue": ""
  217 +}
  218 +```
  219 +
  220 +## 3.收款单配置 JSON
  221 +
  222 +### 3.1 currency 币别
  223 +
  224 +```json
  225 +{
  226 + "pipelineId": 3,
  227 + "documentType": "AR_RECEIVEBILL",
  228 + "configKey": "currency",
  229 + "settingFieldType": 0,
  230 + "fixedValue": "PRE001"
  231 +}
  232 +```
  233 +
  234 +### 3.2 settleOrg 结算组织
  235 +
  236 +```json
  237 +{
  238 + "pipelineId": 3,
  239 + "documentType": "AR_RECEIVEBILL",
  240 + "configKey": "settleOrg",
  241 + "settingFieldType": 0,
  242 + "fixedValue": "101"
  243 +}
  244 +```
  245 +
  246 +### 3.3 saleOrg 销售组织
  247 +
  248 +```json
  249 +{
  250 + "pipelineId": 3,
  251 + "documentType": "AR_RECEIVEBILL",
  252 + "configKey": "saleOrg",
  253 + "settingFieldType": 0,
  254 + "fixedValue": "101"
  255 +}
  256 +```
  257 +
  258 +### 3.4 businessType 业务类型
  259 +
  260 +```json
  261 +{
  262 + "pipelineId": 3,
  263 + "documentType": "AR_RECEIVEBILL",
  264 + "configKey": "businessType",
  265 + "settingFieldType": 0,
  266 + "fixedValue": "zr002"
  267 +}
  268 +```
  269 +
  270 +### 3.5 contactType 往来单位类型
  271 +
  272 +```json
  273 +{
  274 + "pipelineId": 3,
  275 + "documentType": "AR_RECEIVEBILL",
  276 + "configKey": "contactType",
  277 + "settingFieldType": 0,
  278 + "fixedValue": "BD_Customer"
  279 +}
  280 +```
  281 +
  282 +### 3.6 payContactType 付款单位类型
  283 +
  284 +```json
  285 +{
  286 + "pipelineId": 3,
  287 + "documentType": "AR_RECEIVEBILL",
  288 + "configKey": "payContactType",
  289 + "settingFieldType": 0,
  290 + "fixedValue": "BD_Customer"
  291 +}
  292 +```
  293 +
  294 +### 3.7 payOrg 收款组织
  295 +
  296 +```json
  297 +{
  298 + "pipelineId": 3,
  299 + "documentType": "AR_RECEIVEBILL",
  300 + "configKey": "payOrg",
  301 + "settingFieldType": 0,
  302 + "fixedValue": "101"
  303 +}
  304 +```
  305 +
  306 +### 3.8 settleMethod 结算方式
  307 +
  308 +```json
  309 +{
  310 + "pipelineId": 3,
  311 + "documentType": "AR_RECEIVEBILL",
  312 + "configKey": "settleMethod",
  313 + "settingFieldType": 0,
  314 + "fixedValue": "JSFS04_SYS"
  315 +}
  316 +```
  317 +
  318 +### 3.9 receiveUsedFor 收款用途
  319 +
  320 +```json
  321 +{
  322 + "pipelineId": 3,
  323 + "documentType": "AR_RECEIVEBILL",
  324 + "configKey": "receiveUsedFor",
  325 + "settingFieldType": 0,
  326 + "fixedValue": "SFKYT02_SYS"
  327 +}
  328 +```
  329 +
  330 +### 3.10 chargeItemDept 费用承担部门
  331 +
  332 +```json
  333 +{
  334 + "pipelineId": 3,
  335 + "documentType": "AR_RECEIVEBILL",
  336 + "configKey": "chargeItemDept",
  337 + "settingFieldType": 0,
  338 + "fixedValue": "BM000099"
  339 +}
  340 +```
  341 +
  342 +### 3.11 chargeItem 费用项
  343 +
  344 +```json
  345 +{
  346 + "pipelineId": 3,
  347 + "documentType": "AR_RECEIVEBILL",
  348 + "configKey": "chargeItem",
  349 + "settingFieldType": 0,
  350 + "fixedValue": "CI185"
  351 +}
  352 +```
  353 +
  354 +### 3.12 settleCurrency 币别
  355 +
  356 +```json
  357 +{
  358 + "pipelineId": 3,
  359 + "documentType": "AR_RECEIVEBILL",
  360 + "configKey": "settleCurrency",
  361 + "settingFieldType": 0,
  362 + "fixedValue": "PRE001"
  363 +}
  364 +```
  365 +
  366 +### 3.13 bankCardNumber 银行账号
  367 +
  368 +```json
  369 +{
  370 + "pipelineId": 3,
  371 + "documentType": "AR_RECEIVEBILL",
  372 + "configKey": "bankCardNumber",
  373 + "settingFieldType": 0,
  374 + "fixedValue": "20000178223210300000034"
  375 +}
  376 +```
  377 +
  378 +### 3.14 saleDept 销售部门
  379 +
  380 +```json
  381 +{
  382 + "pipelineId": 3,
  383 + "documentType": "AR_RECEIVEBILL",
  384 + "configKey": "saleDept",
  385 + "settingFieldType": 0,
  386 + "fixedValue": "BM000099"
  387 +}
  388 +```
  389 +
  390 +## 4.收款退款单配置 JSON
  391 +
  392 +### 4.1 currency 币别
  393 +
  394 +```json
  395 +{
  396 + "pipelineId": 3,
  397 + "documentType": "AR_REFUNDBILL",
  398 + "configKey": "currency",
  399 + "settingFieldType": 0,
  400 + "fixedValue": "PRE001"
  401 +}
  402 +```
  403 +
  404 +### 4.2 settleOrg 结算组织
  405 +
  406 +```json
  407 +{
  408 + "pipelineId": 3,
  409 + "documentType": "AR_REFUNDBILL",
  410 + "configKey": "settleOrg",
  411 + "settingFieldType": 0,
  412 + "fixedValue": "101"
  413 +}
  414 +```
  415 +
  416 +### 4.3 saleOrg 销售组织
  417 +
  418 +```json
  419 +{
  420 + "pipelineId": 3,
  421 + "documentType": "AR_REFUNDBILL",
  422 + "configKey": "saleOrg",
  423 + "settingFieldType": 0,
  424 + "fixedValue": "101"
  425 +}
  426 +```
  427 +
  428 +### 4.4 businessType 业务类型
  429 +
  430 +```json
  431 +{
  432 + "pipelineId": 3,
  433 + "documentType": "AR_REFUNDBILL",
  434 + "configKey": "businessType",
  435 + "settingFieldType": 0,
  436 + "fixedValue": "SKTKDLX04_SYS"
  437 +}
  438 +```
  439 +
  440 +### 4.5 payOrg 收款组织
  441 +
  442 +```json
  443 +{
  444 + "pipelineId": 3,
  445 + "documentType": "AR_REFUNDBILL",
  446 + "configKey": "payOrg",
  447 + "settingFieldType": 0,
  448 + "fixedValue": "101"
  449 +}
  450 +```
  451 +
  452 +### 4.6 receiveContactType 收款单位类型
  453 +
  454 +```json
  455 +{
  456 + "pipelineId": 3,
  457 + "documentType": "AR_REFUNDBILL",
  458 + "configKey": "receiveContactType",
  459 + "settingFieldType": 0,
  460 + "fixedValue": "BD_Customer"
  461 +}
  462 +```
  463 +
  464 +### 4.7 contactType 往来单位类型
  465 +
  466 +```json
  467 +{
  468 + "pipelineId": 3,
  469 + "documentType": "AR_REFUNDBILL",
  470 + "configKey": "contactType",
  471 + "settingFieldType": 0,
  472 + "fixedValue": "BD_Customer"
  473 +}
  474 +```
  475 +
  476 +### 4.8 settleCurrency 结算币别
  477 +
  478 +```json
  479 +{
  480 + "pipelineId": 3,
  481 + "documentType": "AR_REFUNDBILL",
  482 + "configKey": "settleCurrency",
  483 + "settingFieldType": 0,
  484 + "fixedValue": "PRE001"
  485 +}
  486 +```
  487 +
  488 +### 4.9 settleMethod 结算方式
  489 +
  490 +```json
  491 +{
  492 + "pipelineId": 3,
  493 + "documentType": "AR_REFUNDBILL",
  494 + "configKey": "settleMethod",
  495 + "settingFieldType": 0,
  496 + "fixedValue": "JSFS04_SYS"
  497 +}
  498 +```
  499 +
  500 +### 4.10 receiveUsedFor 原收款用途
  501 +
  502 +```json
  503 +{
  504 + "pipelineId": 3,
  505 + "documentType": "AR_REFUNDBILL",
  506 + "configKey": "receiveUsedFor",
  507 + "settingFieldType": 0,
  508 + "fixedValue": "SFKYT02_SYS"
  509 +}
  510 +```
  511 +
  512 +### 4.11 chargeItemDept 费用承担部门
  513 +
  514 +```json
  515 +{
  516 + "pipelineId": 3,
  517 + "documentType": "AR_REFUNDBILL",
  518 + "configKey": "chargeItemDept",
  519 + "settingFieldType": 0,
  520 + "fixedValue": "BM000099"
  521 +}
  522 +```
  523 +
  524 +### 4.12 chargeItem 费用项
  525 +
  526 +```json
  527 +{
  528 + "pipelineId": 3,
  529 + "documentType": "AR_REFUNDBILL",
  530 + "configKey": "chargeItem",
  531 + "settingFieldType": 0,
  532 + "fixedValue": "CI185"
  533 +}
  534 +```
  535 +
  536 +### 4.13 saleDept 销售部门
  537 +
  538 +```json
  539 +{
  540 + "pipelineId": 3,
  541 + "documentType": "AR_REFUNDBILL",
  542 + "configKey": "saleDept",
  543 + "settingFieldType": 0,
  544 + "fixedValue": "BM000099"
  545 +}
  546 +```
  547 +
  548 +### 4.14 bankCardNumber 银行账号
  549 +
  550 +```json
  551 +{
  552 + "pipelineId": 3,
  553 + "documentType": "AR_REFUNDBILL",
  554 + "configKey": "bankCardNumber",
  555 + "settingFieldType": 0,
  556 + "fixedValue": "20000178223210300000034"
  557 +}
  558 +```