创建工资代发 - 财资云开放平台（开发版）

请求参数

Header 参数

command_code

string

指令代码

可选

Body 参数application/json

batch_no

string

来源系统批次号

必需

同一租户同一来源系统下唯一

>= 1 字符<= 64 字符

示例值:

PCH20230717151932123

total_mount

number

总金额

必需

用于批次数据完整性校验；校验失败时直接返回异常报错信息；支付明细集合中交易金额的汇总值

total_num

number

总笔数

必需

用于批次数据完整性校验；校验失败时直接返回异常报错信息；支付明细集合中交易金额的汇总值

payer_info

object

本方信息

必需

pay_org_name

string

本方组织名称

必需

本方组织名称和本方账号必须有一个必填。填写【系统管理-日常维护-组织管理】中的组织全称/组织简称/组织编码/英文全称/英文简称

pay_account_number

string

本方账号

必需

本方组织名称和本方账号必须有一个必填。填写【智能账户-账户管理】中维护的账号信息

pay_account_currency

string

本方币种

必需

由账号带出默认币种。账号多币种情况下也可指定币种，填写【数据中心-基础数据中心-系统-币种】中维护的编码

pay_virtual_account_number

string

Mock 本方虚拟账号

可选

填写【智能账户-虚拟账户管理】中维护的账号信息

pay_info

object

支付信息

必需

purpose_code

string

用途编码

必需

银行要求填写的工资代发用途编码

purpose

string

用途

必需

银行要求填写的工资代发用途名称

pay_way_code

string

支付方式编码

必需

默认A1，见《支付方式》字典

appointment_date_time

string

预约支付时间

可选

若填写了预约支付时间，则启用预约支付，付款审批完成后，系统按预约支付时间提交支付。若预约支付时间小于当前审批完成时间，则立即提交支付 yyyy-MM-dd HH:mm:ss

submit_by

string

提交人

必需

details

array [object {6}]

支付明细

必需

>= 1 items<= 1000 items

source_flow_number

string

来源系统流水号

必需

同一租户同一来源系统下唯一

>= 1 字符<= 64 字符

示例值:

LSH20230717152532123

source_note_code

string

来源系统单据号

可选

可重复

>= 0 字符<= 64 字符

示例值:

DJH20230717152532123

basic_info

object

基本信息

可选

opp_info

object

对方信息

可选

trans_info

object

交易信息

可选

attachs

array [object {2}]

必需

示例

{
    "batch_no": "PCH20230717151932123",
    "total_mount": 0,
    "total_num": 0,
    "payer_info": {
        "pay_org_name": "string",
        "pay_account_number": "string",
        "pay_account_currency": "string",
        "pay_virtual_account_number": "string"
    },
    "pay_info": {
        "purpose_code": "string",
        "purpose": "string",
        "pay_way_code": "string",
        "appointment_date_time": "string",
        "submit_by": "string"
    },
    "details": [
        {
            "source_flow_number": "LSH20230717152532123",
            "source_note_code": "DJH20230717152532123",
            "basic_info": {
                "apply_org_name": "大力神集团总公司",
                "pay_biz_type_code": "投资性支出",
                "budget_item_code": " 商务费",
                "cost_center": "大力神集团总公司",
                "extension_info": "string"
            },
            "opp_info": {
                "opp_name": "百世物流有限公司",
                "opp_account_number": "1000000000024",
                "opp_account_name": "百世物流有限公司",
                "is_same_bank": 0,
                "opp_bank_location": "交通银行嘉兴分行",
                "opp_cnaps": "011588006022",
                "card_type": 0
            },
            "trans_info": {
                "currency_code": "string",
                "trans_amount": 12000,
                "urgent_flag": 1,
                "purpose": "原材料采购",
                "summary": "工资",
                "memo": "工资奖金"
            },
            "attachs": [
                {
                    "attach_title": "string",
                    "attach_url": "string"
                }
            ]
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/settlement/salary/create' \
--header 'command_code;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "batch_no": "PCH20230717151932123",
    "total_mount": 0,
    "total_num": 0,
    "payer_info": {
        "pay_org_name": "string",
        "pay_account_number": "string",
        "pay_account_currency": "string",
        "pay_virtual_account_number": "string"
    },
    "pay_info": {
        "purpose_code": "string",
        "purpose": "string",
        "pay_way_code": "string",
        "appointment_date_time": "string",
        "submit_by": "string"
    },
    "details": [
        {
            "source_flow_number": "LSH20230717152532123",
            "source_note_code": "DJH20230717152532123",
            "basic_info": {
                "apply_org_name": "大力神集团总公司",
                "pay_biz_type_code": "投资性支出",
                "budget_item_code": " 商务费",
                "cost_center": "大力神集团总公司",
                "extension_info": "string"
            },
            "opp_info": {
                "opp_name": "百世物流有限公司",
                "opp_account_number": "1000000000024",
                "opp_account_name": "百世物流有限公司",
                "is_same_bank": 0,
                "opp_bank_location": "交通银行嘉兴分行",
                "opp_cnaps": "011588006022",
                "card_type": 0
            },
            "trans_info": {
                "currency_code": "string",
                "trans_amount": 12000,
                "urgent_flag": 1,
                "purpose": "原材料采购",
                "summary": "工资",
                "memo": "工资奖金"
            },
            "attachs": [
                {
                    "attach_title": "string",
                    "attach_url": "string"
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

batch_no

string

来源系统批次号

必需

>= 0 字符<= 64 字符

total_num

integer

总笔数

必需

success_num

integer

成功笔数

必需

fail_num

integer

失败笔数

必需

responseBody

array [object {4}]

支付明细结果

必需

source_flow_number

string

来源系统流水号

必需

status

enum<integer>

处理状态

必需

0：成功，其他：失败

枚举值:

status_msg

string

处理信息

必需

biz_numer

string

资金系统业务单据号（唯一性）

可选

成功状态才会返回

示例

{
    "batch_no": "string",
    "total_num": 0,
    "success_num": 0,
    "fail_num": 0,
    "responseBody": [
        {
            "source_flow_number": "string",
            "status": 1,
            "status_msg": "string",
            "biz_numer": "string"
        }
    ]
}