跳到主要内容

POST 详情(含明细)

POST 查询。body 为筛选条件 JSON(分页类含 pageNum、pageSize)。

接口编码所需范围后端接口
finance.payment-request.detailfinance:readPOST /v1/payment-request/detail(comap-finance)

请求体字段(body)

字段类型必填说明
idinteger(int64)是主键 ID

「必填」仅反映接口规格声明的部分。服务内还有未体现在规格里的校验, 标「—」不等于可以不传;租户在主站配置的字段必填不约束本接口。 详见必填字段的判定与字段清单与自定义字段。

请求示例

curl -X POST https://open.risemap.cn/v1/api/invoke \
-H "Authorization: Bearer <访问令牌>" \
-H "Content-Type: application/json" \
-d '{
"apiCode": "finance.payment-request.detail",
"body": {
"id": "1961000000000000001"
}
}'

响应 data 字段

字段类型必填说明
idinteger(int64)—ID
requestNostring—申请编号
sourceModulestring—来源module
sourceTypestring—PURCHASE_INBOUND=采购订单, PURCHASE_MILESTONE=采购订单, SUBCONTRACT_SETTLEMENT=外协结算, EXPENSE_REIMBURSEMENT=费用报销, COMPANY_EXPENSE=企业支出, PAYMENT_REQUEST=付款申请, SALARY_BONUS=工资奖金, TAX=税费, SOCIAL_INSURANCE=社保公积金, RENT_PROPERTY=租金物业 等17项
sourceIdinteger(int64)—来源ID
sourceNostring—来源单号
purchaseOrderIdinteger(int64)—关联采购订单ID
purchaseOrderNostring—关联采购订单号
linkedApNosstring—关联应付单号,多个以逗号分隔
flowInstanceCodestring—流程实例编码
partyTypestring—CUSTOMER=客户, SUPPLIER=供应商, EMPLOYEE=员工, OTHER=其他
partyIdinteger(int64)—往来单位ID
partyNamestring—往来单位名称
totalAmountnumber—总金额
currencyIdinteger(int64)—币种ID
currencyCodestring—币种编码
currencySymbolstring—币种符号
paymentDatePlanstring(date)—付款dateplan
payTypeIdinteger(int64)—付款方式ID
payTypeNamestring—付款方式名称
statusstring—DRAFT=草稿, PENDING=待付款, PARTIAL=部分付款, SETTLED=已结清, VOID=已作废
initiatorIdinteger(int64)—发起人ID
initiatorNamestring—发起人名称
submitAtstring(date-time)—提交时间
approvedByinteger(int64)—审批by
approvedAtstring(date-time)—审批时间
rejectReasonstring—驳回原因
registeredAmountnumber—已登记付款金额合计
writtenOffAmountnumber—已核销金额合计(同批次所有付款单已核销金额之和)
writeOffStatusstring—核销状态: null=无付款单, NONE=未核销, PARTIAL=部分核销, FULL=已核销
createTimestring(date-time)—创建时间
supplierBankIdinteger(int64)—供应商银行账户ID
supplierBankNamestring—供应商收款账户-开户行(申请时快照)
supplierBankAccountNamestring—供应商收款账户-账户名(申请时快照)
supplierBankNostring—供应商收款账户-银行账号(申请时快照)
payeeAccountIdinteger(int64)—通用收款账户ID(个人报销等非供应商付款使用)
payeeAccountMethodstring—收款渠道 BANK/WECHAT/ALIPAY/OTHER
payeeAccountNamestring—收款人或账户名称快照
payeeAccountNostring—收款账号快照
payeeBankNamestring—开户行快照(银行卡渠道)
batchNostring—批量申请批次号(同批次多张合并显示为一个付款任务;单张为空)
batchCountinteger(int32)—批次内付款申请张数(=1 为单张;>1 为批量合并,本行为代表行)
batchTotalnumber—批次内合计申请金额(同批次各申请金额之和)
batchOrdersstring—批次内各订单号(逗号分隔,供合并任务展示)
partyCodestring—往来方编码
reasonstring—原因
items9PaymentRequestItemVO[]—明细列表

错误处理​

响应统一信封 { code, message, data },code == 200 为成功。以下是本接口可能返回的开放平台层错误:

错误码说明可重试
92101访问凭证无效否
92201接口未登记或已停用否
92202超出凭证授权范围——本接口需 finance:read否
92204绑定员工无此接口的功能权限否
92203上游服务调用失败是
92301请求过于频繁是

除此之外,comap-finance 自身的业务校验失败会原样透传其业务码与提示 (如字段校验、状态不允许、数据不存在),这类码不在开放平台的号段内, 以响应里的 message 为准。完整的平台层错误码见错误码说明。

← 返回付款申请