创建国内付款 - 财资云开放平台（开发版）

请求参数

Header 参数

command_code

string

指令代码

可选

Body 参数application/json

batch_no

string

来源系统批次号

必需

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

>= 1 字符<= 64 字符

示例值:

PCH20230717151932123

total_mount

number

总金额

必需

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

total_num

number

总笔数

必需

用于批次数据完整性校验，校验失败时直接返回异常报错信息；支付明细稽核中记录总笔数

details

array [object {9}]

支付明细

必需

>= 1 items<= 1000 items

source_flow_number

string

来源系统流水号

必需

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

>= 1 字符<= 64 字符

示例值:

LSH20230717152532123

source_note_code

string

来源系统单据号

可选

可重复

>= 0 字符<= 64 字符

示例值:

DJH20230717152532123

basic_info

object

基本信息

可选

payer_info

object

本方信息

可选

opp_info

object

对方信息

可选

trans_info

object

交易信息

可选

contracts

array [object {4}]

合同信息

可选

invoices

array [object {6}]

发票

可选

attachs

array [object {2}]

附件

可选

示例

{
    "batch_no": "PCH20230717151932123",
    "total_mount": 0,
    "total_num": 0,
    "details": [
        {
            "source_flow_number": "LSH20230717152532123",
            "source_note_code": "DJH20230717152532123",
            "basic_info": {
                "apply_org_name": "大力神集团总公司",
                "pay_biz_type_code": "投资性支出",
                "pay_way_code": "A1",
                "pay_date（可以去掉)": "yyyyMMdd",
                "appointment_date_time": "yyyyMMdd HHmm",
                "is_inner_trans(移到收方类型,交易对手类型)，员工是否放到交易对手中": 0,
                "budget_item_code": " 商务费",
                "cost_center": "大力神集团总公司",
                "submit_by": "财务某某",
                "extension_info": "string"
            },
            "payer_info": {
                "pay_org_name": "大力神集团总公司",
                "pay_account_number": "0200041419201222209",
                "pay_account_currency": "人民币",
                "pay_virtual_account_number": "0000000000",
                "linkage_pay_account_number": "0200041419201222209"
            },
            "opp_info": {
                "opp_name": "百世物流有限公司",
                "opp_account_number": "1000000000024",
                "opp_account_name": "百世物流有限公司",
                "opp_virtual_account_number": "string",
                "is_same_bank": 0,
                "opp_bank_location": "交通银行嘉兴分行",
                "opp_cnaps": "011588006022",
                "private_flag": 0,
                "card_type（考虑去掉）": 0,
                "notice_phone": "浙江省杭州市滨江区xxxxxxxxxx",
                "notice_email": "string"
            },
            "trans_info": {
                "currency_code": "string",
                "trans_amount": 12000,
                "urgent_flag（整合到汇款邮路）  pay_route": "string",
                "purpose": "原材料采购",
                "summary": "工资",
                "memo": "工资奖金"
            },
            "contracts": [
                {
                    "contract_code": "string",
                    "contract_funditem": "string",
                    "contract_amount": 0,
                    "contract_currency_code": "string"
                }
            ],
            "invoices": [
                {
                    "invoice_code": "string",
                    "invoice_description": "string",
                    "invoice_date": "yyyyMMdd",
                    "invoice_amount": 0,
                    "invoice_currency_code": "string",
                    "invoice_rate": 0
                }
            ],
            "attachs": [
                {
                    "attach_title": "string",
                    "attach_url": "string"
                }
            ]
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/settlement/single/create' \
--header 'command_code;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "batch_no": "PCH20230717151932123",
    "total_mount": 0,
    "total_num": 0,
    "details": [
        {
            "source_flow_number": "LSH20230717152532123",
            "source_note_code": "DJH20230717152532123",
            "basic_info": {
                "apply_org_name": "大力神集团总公司",
                "pay_biz_type_code": "投资性支出",
                "pay_way_code": "A1",
                "pay_date（可以去掉)": "yyyyMMdd",
                "appointment_date_time": "yyyyMMdd HHmm",
                "is_inner_trans(移到收方类型,交易对手类型)，员工是否放到交易对手中": 0,
                "budget_item_code": " 商务费",
                "cost_center": "大力神集团总公司",
                "submit_by": "财务某某",
                "extension_info": "string"
            },
            "payer_info": {
                "pay_org_name": "大力神集团总公司",
                "pay_account_number": "0200041419201222209",
                "pay_account_currency": "人民币",
                "pay_virtual_account_number": "0000000000",
                "linkage_pay_account_number": "0200041419201222209"
            },
            "opp_info": {
                "opp_name": "百世物流有限公司",
                "opp_account_number": "1000000000024",
                "opp_account_name": "百世物流有限公司",
                "opp_virtual_account_number": "string",
                "is_same_bank": 0,
                "opp_bank_location": "交通银行嘉兴分行",
                "opp_cnaps": "011588006022",
                "private_flag": 0,
                "card_type（考虑去掉）": 0,
                "notice_phone": "浙江省杭州市滨江区xxxxxxxxxx",
                "notice_email": "string"
            },
            "trans_info": {
                "currency_code": "string",
                "trans_amount": 12000,
                "urgent_flag（整合到汇款邮路）  pay_route": "string",
                "purpose": "原材料采购",
                "summary": "工资",
                "memo": "工资奖金"
            },
            "contracts": [
                {
                    "contract_code": "string",
                    "contract_funditem": "string",
                    "contract_amount": 0,
                    "contract_currency_code": "string"
                }
            ],
            "invoices": [
                {
                    "invoice_code": "string",
                    "invoice_description": "string",
                    "invoice_date": "yyyyMMdd",
                    "invoice_amount": 0,
                    "invoice_currency_code": "string",
                    "invoice_rate": 0
                }
            ],
            "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"
        }
    ]
}