新增实体账户信息 - 财资云开放平台（开发版）

创建实体账户信息；主数据同步，记录对方id；字典信息可查询范围，支付用途，监管代码、账户种类；字典映射关系配置（特殊情况）

请求参数

Body 参数application/json

array of:

oid

string

账户ID

必需

外部系统账户唯一标识

<= 32 字符

account_number

string

账号

必需

<= 64 字符

account_engname

string

账户英文名称

必需

<= 128 字符

account_name

string

账户名称

必需

<= 128 字符

currency_info

array [object {1}]

币种

必需

若填写多个币种，表示账户属于多币种账户

currency_code

string

币种代码

必需

三位编码（国际标准）

<= 3 字符

bank_code

string

银行编码

可选

银行编码和银行名称必须选填一个

<= 32 字符

bank_name

string

银行名称

可选

银行编码和银行名称必须选填一个

<= 128 字符

bank_location

string

开户行名称

必需

中国境外开户行请填写英文名称

<= 128 字符

swift_code

string

BIC

可选

若未填写，系统匹配开户行时带入

<= 32 字符

cnaps

string

联行号

可选

若未填写，系统匹配开户行时带入

<= 20 字符

is_direct

integer

是否直联

必需

0-否 1-是默认0

memo

string

备注

可选

<= 255 字符

memonic_code

string

助记码

可选

若不填写，默认为账号后四位

<= 32 字符

manage_info

object

管理信息

必需

org_code

string

组织编码

必需

组织编码和组织名称必须选填一个

<= 32 字符

org_name

string

组织名称

必需

组织编码和组织名称必须选填一个

<= 128 字符

account_type_code

string

账户种类编码

必需

BZJZH 保证金（包括：安全、质量等） DKZH 贷款 DPZH 电票专户 DQZH 定期 HQZH 活期 LCZH 理财 SUPERVISION_ACCOUNT 监管账户 THIRDPAY 第三方支付 TZZH 通知 XDZH 协定 XJH 现金户 XMZH 项目专户 NBZH 内部账户 JSK 结算卡 GWK 公务卡 DQCK 定期存款 NRA NRA LA 离岸 NFT NFT NBZZH 内部子账户

<= 16 字符

account_property_code

string

账户性质编码

可选

填写账户性质编码

<= 16 字符

fund_type_range

string

账户标签

可选

多值，用","分割；返回账户标签名称

<= 128 字符

legal_person

string

法人信息

可选

<= 32 字符

user_dept_code

string

使用部门编码

可选

组织编码和组织名称必须选填一个

<= 32 字符

user_dept_name

string

使用部门名称

可选

组织编码和组织名称必须选填一个

<= 128 字符

manager_org_code

string

归口管理部门编码

可选

组织编码和组织名称必须选填一个

<= 32 字符

manager_org_name

string

归口管理部门名称

可选

组织编码和组织名称必须选填一个

<= 128 字符

is_supervision

integer

是否受监管

可选

0-否 1-是默认0

is_manage_by_group

integer

是否集团代管

可选

0-否 1-是默认0

is_linked_virtual_account

integer

是否下挂虚拟户

可选

0-否 1-是默认0

is_bill_settlement

integer

是否用于票据结算的标识

可选

0-否 1-是默认0

project_item

string

项目

可选

填写项目编码或名称

<= 64 字符

other_info

object

附加信息

必需

country_code

string

国家或地区

必需

三位编码（国际标准）

<= 3 字符

reserved_seal

string

预留印鉴

必需

印鉴图片先上传，再填入文件路径

<= 255 字符

opn

string

账户标识

可选

花旗OPN标识、摩根银行客户号

<= 128 字符

tax_rate

number

税率

可选

area_code

string

行政区域

可选

目前仅中国地区行政区域

<= 16 字符

address

string

账户地址

可选

<= 255 字符

enquiry_address

string

询证地址

可选

<= 255 字符

registration

string

注册地

可选

<= 255 字符

resident_type

string

居民类型编码

可选

<= 16 字符

related_account_number

string

关联购汇账号

可选

<= 64 字符

sign_format

string

报文签约格式

可选

对接AMH时填写 1-FIN，2-FILEACT

<= 1 字符

pay_flag

integer

是否支持支付指令

可选

对接AMH时填写 0-是,1-否

enterprise_code

string

企业BOC编码

可选

对接AMH时填写

<= 32 字符

extension_info

string

扩展信息

可选

<= 512 字符

depositor_query_code

string

存款人查询码

可选

<= 128 字符

contactInfo

array [object {5}]

联系人信息

可选

contact

string

联系人

必需

phone

string

联系电话

必需

string

电子邮箱

必需

position

string

职位

必需

description

string

备注

可选

示例

[
  {
    "oid": "string",
    "account_number": "string",
    "account_engname": "string",
    "account_name": "string",
    "currency_info": [
      {
        "currency_code": "str"
      }
    ],
    "bank_code": "string",
    "bank_name": "string",
    "bank_location": "string",
    "swift_code": "string",
    "cnaps": "string",
    "is_direct": 0,
    "memo": "string",
    "memonic_code": "string",
    "manage_info ": {
      "org_code": "string",
      "org_name": "string",
      "account_type_code": "string",
      "account_property_code": "string",
      "fund_type_range": "string",
      "legal_person": "string",
      "user_dept_code": "string",
      "user_dept_name": "string",
      "manager_org_code": "string",
      "manager_org_name": "string",
      "is_supervision": 0,
      "is_manage_by_group": 0,
      "is_linked_virtual_account": 0,
      "is_bill_settlement": 0,
      "project_item": "string"
    },
    "other_info ": {
      "country_code": "str",
      "reserved_seal": "string",
      "opn": "string",
      "tax_rate": 0,
      "area_code": "string",
      "address": "string",
      "enquiry_address": "string",
      "registration": "string",
      "resident_type": "string",
      "related_account_number": "string",
      "sign_format": "s",
      "pay_flag": 0,
      "enterprise_code": "string",
      "extension_info": "string",
      "depositor_query_code": "string"
    },
    "contactInfo": [
      {
        "contact": "string",
        "phone": "string",
        "email": "string",
        "position": "string",
        "description": "string"
      }
    ]
  }
]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'openapi/account/createaccount' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "oid": "string",
        "account_number": "string",
        "account_engname": "string",
        "account_name": "string",
        "currency_info": [
            {
                "currency_code": "str"
            }
        ],
        "bank_code": "string",
        "bank_name": "string",
        "bank_location": "string",
        "swift_code": "string",
        "cnaps": "string",
        "is_direct": 0,
        "memo": "string",
        "memonic_code": "string",
        "manage_info ": {
            "org_code": "string",
            "org_name": "string",
            "account_type_code": "string",
            "account_property_code": "string",
            "fund_type_range": "string",
            "legal_person": "string",
            "user_dept_code": "string",
            "user_dept_name": "string",
            "manager_org_code": "string",
            "manager_org_name": "string",
            "is_supervision": 0,
            "is_manage_by_group": 0,
            "is_linked_virtual_account": 0,
            "is_bill_settlement": 0,
            "project_item": "string"
        },
        "other_info ": {
            "country_code": "str",
            "reserved_seal": "string",
            "opn": "string",
            "tax_rate": 0,
            "area_code": "string",
            "address": "string",
            "enquiry_address": "string",
            "registration": "string",
            "resident_type": "string",
            "related_account_number": "string",
            "sign_format": "s",
            "pay_flag": 0,
            "enterprise_code": "string",
            "extension_info": "string",
            "depositor_query_code": "string"
        },
        "contactInfo": [
            {
                "contact": "string",
                "phone": "string",
                "email": "string",
                "position": "string",
                "description": "string"
            }
        ]
    }
]'

返回响应

🟢200成功

application/json

Body

array of:

oid

string

来源ID

必需

status_code

integer

状态

必需

0-成功 1-失败

msg

string

状态信息

必需

string

账户ID

可选

资金系统产生的账户ID；状态为“成功”时有值

示例

[
  {
    "oid": "string",
    "status_code": 0,
    "msg": "string",
    "id": "string"
  }
]