回款登记新建/编辑

POST/v1/invoices/receiptRegistration/push

请求参数

cash_collection_invoice_id

integer

可选

回款登记ID，编辑时可传入

cash_collection_invoice_no

string

可选

回款登记编号，编辑时可以传入

collection_date

string <date>

回款日期

可选

type

string

可选

回款方式，值为 /v1/invoices/receipt/types 接口返回列表中的值

trade_no

string

交易号/票据号

可选

account_name

string

来款方

可选

bank_name

string

来款银行

可选

bank_account

string

来款账户

可选

remark

string

备注

可选

currency

string

币种

必需

exchange_rate

number

可选

汇率，100单位单据币种（兑CNY）

exchange_rate_usd

number

可选

汇率，100单位单据币种汇率（兑USD）

amount

number

必需

回款金额/客户打款金额（单据币种）

real_amount

number

可选

实到账金额（单据币种）

company_id

integer

关联客户ID

可选

capital_account_id

integer

可选

资金账户ID，值参考/v1/capitalAccount/list接口的资金账户ID

handler

array [object {1}]

可选

认领业务员，新建时传入业务认领人和关联客户后，回款登记的状态为待核销，否则是待核销或者草稿，调试时请注意传入后的状态是否符合业务需求

integer

用户ID

可选

create_user

integer

创建人

可选

record_list

array [object {5}]

可选

暂时还不支持新建核销明细，还在开发中

cash_collection_comment

string

回款单备注

可选

refer_id

integer

必需

关联回款源单ID，可能是订单或者商机ID

refer_type

integer

必需

关联源单类型，1订单，2商机

cash_collection_amount

number

回款金额

可选

cash_collection_invoice_amount

number

分配登记金额

可选

{
  "cash_collection_invoice_no": "CXK9527",
  "collection_date": "2023-01-12",
  "type": "T/T",
  "trade_no": "No.1001",
  "account_name": "Test Account",
  "bank_name": "Test Bank",
  "bank_account": "TB16511351123",
  "remark": "Invoice remark",
  "currency": "USD",
  "exchange_rate": 676.72,
  "exchange_rate_usd": 100,
  "amount": 20,
  "real_amount": 20,
  "company_id": 10142656515495,
  "capital_account_id": 3179534607,
  "handler": [
    3267567129,
    3267567130
  ]
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

integer

错误码

可选

now

string

当前时间

可选

message

string

错误信息

可选

data

object

响应数据

可选

cash_collection_invoice_id

integer

回款登记ID

可选

cash_collection_invoice_no

string

回款登记编号

可选

{
  "code": 0,
  "now": "string",
  "message": "string",
  "data": {
    "cash_collection_invoice_id": 0,
    "cash_collection_invoice_no": "string"
  }
}

最后修改时间： 14 天前