回款单新建/编辑

POST/v1/invoices/receipt/push

请求参数

12345678

string

可选

自定义字段，若自定义单选字段，值来自/v1/invoices/order/fields中对应字段的ext_info中的一个或多个

order_id

integer

可选

如果关联的是订单，则设置order_id,不要设置opportunity_id

collection_date

string

回款日期

可选

amount

integer

必需

回款金额(打款金额)

currency

string

币种

必需

exchange_rate

number

可选

当前币种换人民币汇率，不传取系统取系统设置的汇率，与exchange_rate_usd可以同时传，但必须有其中一个

exchange_rate_usd

number

可选

当前币种换美元汇率，不传系统取系统配置的汇率，与exchange_rate可以同时传，但必须有其中一个

bank_charge

number

回款手续费

可选

finance_verify_name

string

可选

财务确认人，可选字段(该字段废弃，请勿使用)

finance_verify_date

string

可选

财务确认时间，可选字段(该字段废弃，请勿使用)

comment

string

备注，可选字段

可选

payee

string

财务确认人，可选

可选

collect_status

integer

可选

回款状态，值为 1 已生效，0 未生效，默认0

trade_no

string

交易号/票据号

可选

cash_collection_no

string

回款单号

可选

capital_account_id

integer

可选

资金账户，值传入资金账户ID，/v1/capitalAccount/list. capital_account_id

file_list

array[string]

可选

{
     "order_id":1100025081, // 如果关联的是订单，则设置order_id,不要设置opportunity_id
     //"opportunity_id":3333333 // 如果关联是商机，则设置opportunity_id，不要设置order_id
     "collection_date":"2019-11-20", // 回款日期
     "amount":100,"type":"L/C", // /v1/invoices/receipt/types 接口返回的付款类型
     "currency":"CNY", // 金额
     "exchange_rate":15, // 汇率
     "finance_verify_name" : "李四", // 财务确认人，可选字段
     "finance_verify_date":"2019-12-01" // 财务确认时间，可选字段
     "comment":"这是18号货款", // 备注，可选字段
     "payee": "张三" // 收款人，可选字段
     "1101054282":'已汇款' //自定义字段
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

integer

必需

message

string

必需

now

string

必需

data

object

必需

cash_collection_id

integer

回款单ID

必需

cash_collection_no

string

回款单编号

必需

{
  "code": 200,
  "message": "success",
  "now": "2024-05-20 18:01:15",
  "data": {
    "cash_collection_id": 3555544681,
    "cash_collection_no": "HKD2024052001568"
  }
}

最后修改时间： 3 个月前