Versions Compared

Version Old Version 11 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

...

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, [
                    "own_eq": 0.0,TEST",
                    "credit_score": 0.0TEST1"
                ],
                "creditreg_lvlcap": 0.0,
                "recown_credit_amteq": 0.0,
                "affcredit_groupscore": null0.0,
                "bizcredit_abbrevlvl": null0.0,
                "aff_grouprec_credit_amt": 0.0,
                "companyaff_auth_amtgroup": ""null,
                "aff_group_auth_amtbiz_abbrev": ""null,
                "c_nameaff_group_credit_amt": "test2"0.0,
                "ucompany_auth_nameamt": "test2",
            },      "aff_group_auth_amt": "",
      ...         ],
  "c_name": "test2",
      "dropdown_list": {
            "entityu_name": "test2"
[            },
    "CONN",        ...
        "上海嵘亿国际贸易有限公司",],
        "dropdown_list": {
            "U",entity_name": [
                "BASIS TRADE CHINACONN",
                "OKOKOK上海嵘亿国际贸易有限公司",
                "SALES4U",
                "1BASIS TRADE CHINA",
                "123OKOKOK",
                ...
        "SALES4",
   ],             "aff_group": [1",
                "ADSF123"
,
           ],     ...
       "validation": [    ],
            "entityaff_typegroup",: [
                "client_attrADSF"
            ],
            "entity_typevalidation": [
                "COUNTERPARTYentity_type",
                "BROKERclient_attr"
            ],
            "cliententity_attrtype": [
                {"COUNTERPARTY",
                "BROKER"
   "value": 1,        ],
            "labelclient_attr": [
  "DOMESTIC TRADE COUNTERPARTY"            {
    },                 {"value": 1,
                    "valuelabel": 2,"DOMESTIC TRADE COUNTERPARTY"
                },
 "label               {
                    "value": "FOREIGN2,
TRADE COUNTERPARTY"                 }  "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。

...

  • address - 地址

  • email - 电邮地址

  • tel - 联络号码

  • fax_no - 传真

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

  • invoice_code - 购买纳税人识别号

  • invoice_addradd - 开票地址

  • invoice_bank - 开票银行

  • reg_no - 营业执照编码

  • entity_ccy - 货币

Code Block
credit_amt, aff_group_credit_amt , rec_credit_amt, credit_lvl,  credit_score, own_eq,
reg_cap, company_auth_amt, aff_group_auth_amt - float

credit_lvl - integer

aff_group, biz_abbrev - string

...

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

更新 / 输入公司数据

...

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

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

...

JSON 主体:

Code Block
{
   "update_list":[
      {
         "entity_id":261580,
         "entity_namename":"TESTUPLOADFILE1",
         "entity_type":"COUNTERPARTY",
         "address":"Address",
         "email":"",
         "tel":"TESTUPLOADFILE1",
         "entityfax_typeno":"COUNTERPARTY",
         "addresscountry":"Address",
         "emailcredit_amt":""2345,
         "telentity_ccy":"DOP",
         "faxinvoice_nocode":"234",
         "countryinvoice_add":"",
         "creditinvoice_amtbank":2345"",
         "entityreg_ccyno":"DOP",
         "invoice_codeinvalid":"234",
         "invoiceclient_addattr":"",[
            1,
   "invoice_bank":"",          "reg_no":"",2
          "invalid":""],
         "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_auth_amt": "",
      }
   ]
}

...

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":"",
         "invalid":"",
         "client_attr":"",
         "used_entity_name": [],
         "reg_cap":"",
         "own_eq":"",
         "credit_score":"",
         "credit_lvl":"",
         "rec_credit_amt":"",
         "aff_group":"",
         "biz_abbrev":"",
         "aff_group_credit_amt":"",
         "company_auth_amt": "",
         "aff_group_auth_amt": "",
      }
   ]
}

...

删除公司数据

...

DELETE/smartfin/api/v1/whitelist/delete

...