Versions Compared

Version Old Version 6 New Version Current
Changes made by

Kook Siong Then

Kook Siong Then

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel2
outlinefalse
typelist
printablefalse

基准URL: /smartfin/api/v1/whitelist


获取公司数据

...

POST /smartfin/api/v1/whitelist/select

获取当前用户可见的所有公司数据。

验证 / 授权

  •  API密钥（令牌）

请求标头

架构

...

请求标头:

  • Content-Type: application/json

...

  • string - JWT <<您的API密钥（令牌）>> (必填项)

响应

例子:

Code Block
{
    "error_code": 0,
    "value": {
        "list": [
            {
                "entity_id": 261580,
                "company_id": 119,
                "entity_name": "TESTUPLOADFILE1",
                "entity_type": "COUNTERPARTY",
                "address": null,
                "email": null,
                "tel": null,
                "country": null,
                "create_by": 2,
                "create_time": "2024-01-18 10:27:51",
                "update_by": 2,
                "update_time": "2024-01-18 10:40:04",
                "user_id": 2,
                "credit_amt": 2345.0,
                "invoice_code": "234",
                "invoice_add": null,
                "invoice_bank": null,
                "reg_no": null,
                "entity_ccy": "DOP",
                "fax_no": null,
                "invalid": null,
                "client_attr": [
                    1,
                    2
                ],
                 "regused_entity_capname": 0.0, [
                    "TEST",
                    "TEST1"
                ],
                "reg_cap": 0.0,
                "own_eq": 0.0,
                "credit_score": 0.0,
                "credit_lvl": 0.0,
                "rec_credit_amt": 0.0,
                "aff_group": null,
                "biz_abbrev": null_abbrev": null,
                "aff_group_credit_amt": 0.0,
                "company_auth_amt": "",
                "aff_group_creditauth_amt": 0.0"",
                "c_name": "test2",
                "u_name": "test2"
            },
            ...
        ],
        "dropdown_list": {
            "entity_name": [
                "CONN",
                "上海嵘亿国际贸易有限公司",
                "U",
                "BASIS TRADE CHINA",
                "OKOKOK",
                "SALES4",
                "1",
                "123",
                ...
            ],
            "aff_group": [
                "ADSF"
            ],
            "validation": [
                "entity_type",
                "client_attr"
            ],
            "entity_type": [
                "COUNTERPARTY",
                "BROKER"
            ],
            "client_attr": [
                {
                    "value": 1,
                    "label": "DOMESTIC TRADE COUNTERPARTY"
                },
                {
                    "value": 2,
                    "label": "FOREIGN TRADE COUNTERPARTY"
                }
            ]
        }
    }

返回

  • 一个名为list的对象列表，每个对象表示一个公司数据 ( 按entity_id降序排列 )

  • 一个名为dropdown_list的列表，其中包含在输入/更新公司数据时使用的各种选择列表。

...

Code Block
entity_name, entity_type, entity_name_eng - string

  • entity_name - 公司名称 客户名称 (必填项)

  • entity_type - 公司类型 (COUNTERPARTY (客户) or BROKER (经纪商)) (必填项)

  • entity_name_eng - 客户英文名称

Info

entity_name 和 entity_type 不能重复。

  • 如果在数据库中找到相同的 entity_name ， 则将不允许存储entity_name 。

  • 'COMPANY NAME' 的 entity_name 和 'COUNTERPARTY' 的 entity_type 如果在数据库中已存在，将不允许存储相同的 entity_name 和 entity_type。

entity_name_eng 与 entity_name 不能有相同文本。

Code Block
client_attr - array[integer] or null

...


used_entity_name - array[string]

  • client_attr - 客户属性

  • used_entity_name - 客户曾用名

  • 数据以参数数组( array )形式存在，或者如果参数、为空，则将解析为 null。

Code Block
address, email, tel, country, fax_no, country, invoice_addr, 
invoice_bank, invoice_code, entity_ccy  - string

  • address - 地址

  • email - 电邮地址

  • tel - 联络号码

  • fax_no - 传真

  • country - 国家 （注： 传递国家代码而不是国家名称， China 代表者 CN）

  • invoice_code - 购买纳税人识别号

  • invoice_addr add - 开票地址

  • invoice_bank - 开票银行

  • reg_no - 营业执照编码

  • entity_ccy - 货币

Code Block
credit_amt, aff_group_credit_amt , rec_credit_amt, credit_lvlscore, own_eq
creditreg_scorecap, owncompany_auth_eq, reg_capamt, aff_group_auth_amt - float

credit_lvl - integer

aff_group, biz_abbrev - string

  • credit_amt - 授信额度 单一客户授信总额

  • aff_group_credit_amt - 所属集团联合授信总额（折人民币万元）

  • biz_abbrev - 客商简称客户简称

  • aff_group - 所属集团

  • rec_credit_amt - 建议信用额度 (折人民币万元）

  • credit_lvl- 信用评级

  • credit_score- 信用分值

  • own_eq- 所有者权益 (折人民币万元）

  • reg_cap- 注册资本（折人民币万元）_cap- 注册资本(本位币万元)

  • company_auth_amt - 单一客户未了结合同总额（折人民币万元）

  • aff_group_auth_amt - 所属集团未了结合同总额（折人民币万元）

Code Block
invalid - boolean

公司的现状 (true （停用） or false ““ )

更新 / 输入公司数据

...

更新URL:
POST/smartfin/api/v1/whitelist/update

输入URL:
POST/smartfin/api/v1/whitelist/insert

将新的公司数据输入或更新到数据库中。

验证 / 授权

  •  API密钥（令牌）

请求标头

架构

...

请求标头:

  • Content-Type: application/json

...

  • string - JWT <<您的API密钥（令牌）>> (必填项)

请求载荷 （ 更新 ）

例子:

JSON 主体:

Code Block
{
   "update_list":[
      {
         "entity_id":261580,
         "entity_name":"TESTUPLOADFILE1",
         "entity_type":"COUNTERPARTY",
         "address":"Address",
         "email":"",
         "tel":"",
         "fax_no":"",
         "country":"",
         "credit_amt":2345,
         "entity_ccy":"DOP",
         "invoice_code":"234",
         "invoice_add":"",
         "invoice_bank":"",
         "reg_no":"",
         "invalid":""":"",
         "client_attr":[
            1,
            2
         ],
         "clientused_entity_attrname": [
            1"TEST",
            "TEST1"
2          ],
         "reg_cap":0,
         "own_eq":0,
         "credit_score":0,
         "credit_lvl":0,
         "rec_credit_amt":0,
         "aff_group":"",
         "biz_abbrev":"",
         "aff_group_credit_amt":0,
         "company_auth_amt": "",
         "aff_group_creditauth_amt":0 "",
      }
   ]
}

请求载荷 ( 输入 )

例子:

JSON 主体:

Code Block
{
   "insert_list":[
      {
         "entity_id":"",
         "entity_name":"test company",
         "entity_type":"BROKER",
         "address":"",
         "email":"",
         "tel":"",
         "fax_no":"",
         "country":"",
         "credit_amt":"",
         "entity_ccy":"",
         "invoice_code":"",
         "invoice_add":"",
         "invoice_bank":"",
         "reg_no":"",
         "invoice_addinvalid":"",
         "invoiceclient_bankattr":"",
         "regused_entity_noname":"" [],
         "invalidreg_cap":"",
         "clientown_attreq":"",
         "regcredit_capscore":"",
         "owncredit_eqlvl":"",
         "rec_credit_scoreamt":"",
         "creditaff_lvlgroup":"",
         "recbiz_credit_amtabbrev":"",
         "aff_group_credit_amt":"",
         "bizcompany_auth_abbrevamt": "",
         "aff_group_creditauth_amt": "",
      }
   ]
}

请求架构

...

Code Block
insert_list - array[object]

...

响应:

删除公司数据

...

DELETE/smartfin/api/v1/whitelist/delete

根据其 entity_id 删除单个/多个公司数据。

验证 / 授权

  •  API密钥（令牌）

请求标头

架构

...

请求标头:

  • Content-Type: application/json

...

  • string - JWT <<您的API密钥（令牌）>> (必填项)

请求载荷

例子:

JSON 主体:

Code Block
{
  "del_ids":[261579]
}
Code Block
del_ids - array[integer]

  • 包含用户删除的独立entity_id的数组。

响应: