应付单新增接口
[TOC]
简要描述
- 应付单新增接口
请求URL
http://(域名|IP):端口/nccloud/api/nantou/bill/needPay/insert
请求方式
- POST
请求字符集
- UTF-8
参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| financeOrgCode | 是 | string | 公司编码（财务组织编码） |
| financeOrgName | 否 | string | 公司名称（财务组织名称） |
| isUrgent | 是 | string | 是否紧急 是=Y；否=N; |
| sharedGroupCode | 否 | string | 共享专业组编码 |
| sharedGroupName | 否 | string | 共享专业组名称 |
| thirdSysCode | 否 | string | 来源系统编码 |
| thirdSysName | 否 | string | 来源系统名称 |
| thirdSysBillTypeCode | 是 | string | 来源单据类型编码 |
| thirdSysBillTypeName | 否 | string | 来源单据类型名称 |
| thirdSysBillCode | 否 | string | 来源单据号 |
| thirdSysScanId | 否 | string | 第三方系统注册影像ID |
| thirdSysURL | 否 | string | 来源URL |
| tradeTypeCode | 是 | string | 应付类型编码：F1-Cxx-WZ：物资应付单；F1-Cxx-FY：费用应付单；F1-Cxx-XM：项目应付单；F1-Cxx-ZG：暂估应付单； |
| tradeTypeName | 否 | string | 应付类型名称 |
| deptCode | 否 | string | 部门编码 |
| deptName | 否 | string | 部门名称 |
| billDate | 是 | string | 单据日期, 数据格式: yyyy-MM-dd HH:mm:ss |
| objType | 是 | string | 往来对象 0=客户; 1=供应商; 2=部门; 3=业务员; |
| supplierCode | 是 | string | 供应商编码 |
| supplierName | 否 | string | 供应商名称 |
| customerCode | 是 | string | 客户编码 |
| customerName | 否 | string | 客户名称 |
| busiTypeCode | 否 | string | 业务流程编码 |
| busiTypeName | 否 | string | 业务流程名称 |
| invoiceTypeCode | 否 | string | 发票类型编码 |
| invoiceTypeName | 否 | string | 发票类型名称 |
| invoiceNo | 否 | string | 发票号 |
| contractCode | 否 | string | 合同号 |
| contractName | 否 | string | 合同名称 |
| contractAmount | 否 | string | 合同金额 |
| sumBalanceAmount | 否 | string | 累计结算金额 |
| kxTypeCode | 否 | string | 款项类别编码(物资应付单) |
| kxTypeName | 否 | string | 款项类别名称(物资应付单) |
| commercialTicketCode | 否 | string | 商票期限编码(物资应付单) |
| commercialTicketName | 否 | string | 商票期限名称(物资应付单) |
| balatypeCode | 否 | string | 结算方式编号(物资应付单) |
| balatypeName | 否 | string | 结算方式名称(物资应付单) |
| sumInvoiceAmount | 否 | string | 累计收票金额 |
| scomment | 否 | string | 摘要(付款备注) |
| scommentCode | 否 | string | 摘要编码 |
| scommentName | 否 | string | 摘要名称 |
| quantityAmount | 否 | string | 质保金 |
| projectAmount | 否 | string | 项目款 |
| salaryDepositAmount | 否 | string | 工人工资保证金 |
| produceAmount | 否 | string | 安全生产费 |
| fineAmount | 否 | string | 罚款 |
| subjCode | 否 | string | 收支项目编码 |
| subjName | 否 | string | 收支项目名称 |
| paymentAccountNo | 否 | string | 付款银行账户 |
| receiveAccountNo | 否 | string | 收款银行账户 |
| billMaker | 否 | string | 制单人 |
| fjzs | 否 | string | 附件张数 |
| detail | array | 数据 | |
| subjCode | 否 | string | 收支项目编码 |
| subjName | 否 | string | 收支项目名称 |
| costAttrCode | 否 | string | 费用属性编码（费用应付单） |
| costAttrName | 否 | string | 费用属性名称（费用应付单） |
| researchProjectCode | 否 | string | 研发项目编码（费用应付单） |
| researchProjectName | 否 | string | 研发项目名称（费用应付单） |
| turnoverAmount | 否 | string | 进出项转出金额（费用应付单） |
| contractCode | 否 | string | 合同编码（暂估应付单） |
| contractName | 否 | string | 合同名称（暂估应付单） |
| materialDetails | 否 | string | 支撑材料明细（暂估应付单） |
| frameProjectCode | 否 | string | 框架项目编码 |
| frameProjectName | 否 | string | 框架项目名称 |
| projectCode | 是 | string | 项目编码 |
| projectName | 否 | string | 项目名称 |
| calcMethodCode | 否 | string | 项目计税方式编码 |
| calcMethodName | 否 | string | 项目计税方式名称 |
| taxAmount | 是 | string | 税额 |
| amount | 是 | string | 价税合计金额 |
| prepayAmount | 否 | string | 本期冲预付金额(物资应付单) |
| creditGoodAmount | 否 | string | 挂账-货款(物资应付单) |
| creditQuantityAmount | 否 | string | 挂账-质保金(物资应付单) |
| produceAmount | 否 | string | 挂账-安全生产费 |
| salaryDepositAmount | 否 | string | 挂账-工人工资保证金 |
| deductionAmount | 否 | string | 挂账-扣款 |
| payAmount | 否 | string | 本期支付金额(物资应付单) |
| thirdSysBillCode | 是 | string | 第三方来源单据号或ID（明细） |
| def27 | 否 | string | 核销单据号 |
| notax_cr | 是 | string | 无税金额 |
传参示例
说明:传参为JSON格式, 放在请求的BODY中
{
"thirdSysBillTypeName": "个人还款单",
"invoiceTypeName": "工程建安发票",
"balatypeCode": "02",
"isUrgent": "Y",
"deptName": "公司领导",
"busiTypeCode": "AP01",
"supplierCode": "DL00000009",
"financeOrgName": "广州南方投资集团有限公司（本部）",
"commercialTicketCode": "01",
"produceAmount": "500",
"sumInvoiceAmount": "500",
"projectAmount": "500",
"thirdSysURL": "http://www.baidu.com",
"balatypeName": "转账支票",
"contractName": "合同名称",
"invoiceNo": "发票号",
"scommentName": "收建行资金池往来款",
"objType": "1",
"sumBalanceAmount": "500",
"kxTypeCode": "0003",
"tradeTypeCode": "F1-Cxx-ZG",
"thirdSysName": "一体化平台",
"supplierName": "广州市图鉴城市规划勘测设计有限公司",
"financeOrgCode": "DL01",
"receiveAccountNo": "129001518010000273",
"sharedGroupName": "项目核算部",
"paymentAccountNo": "44001580048052500608",
"billDate": "2022-11-10 00:00:00",
"quantityAmount": "500",
"busiTypeName": "选择付款",
"commercialTicketName": "1个月",
"salaryDepositAmount": "500",
"tradeTypeName": "暂估应付单",
"fineAmount": "500",
"thirdSysCode": "lyxt02",
"thirdSysBillTypeCode": "1007",
"invoiceTypeCode": "01",
"contractAmount": "500",
"sharedGroupCode": "zyz01",
"detail": [
{
"subjName": "测试收支项目",
"prepayAmount": "200",
"researchProjectName": "",
"amount": "400",
"frameProjectCode": "--2210-0001",
"calcMethodName": "一般计税",
"subjCode": "01",
"researchProjectCode": "",
"turnoverAmount": "5000",
"creditGoodAmount": "200",
"creditQuantityAmount": "200",
"frameProjectName": "测试框架项目",
"costAttrName": "直接费用",
"taxAmount": "13",
"payAmount": "200",
"projectCode": "--2210-0001",
"contractName": "合同名称",
"materialDetails": "支撑材料明细",
"projectName": "测试框架项目",
"calcMethodCode": "01",
"contractCode": "合同编码",
"thirdSysBillCode": "1",
"costAttrCode": "002"
},
{
"subjName": "测试收支项目",
"prepayAmount": "40",
"researchProjectName": "",
"amount": "80",
"frameProjectCode": "--2210-0001",
"calcMethodName": "一般计税",
"subjCode": "01",
"researchProjectCode": "",
"turnoverAmount": "5000",
"creditGoodAmount": "40",
"creditQuantityAmount": "40",
"frameProjectName": "测试框架项目",
"costAttrName": "直接费用",
"taxAmount": "13",
"payAmount": "40",
"projectCode": "--2210-0001",
"contractName": "合同名称",
"materialDetails": "支撑材料明细",
"projectName": "测试框架项目",
"calcMethodCode": "01",
"contractCode": "合同编码",
"thirdSysBillCode": "2",
"costAttrCode": "002"
}
],
"kxTypeName": "结算款",
"contractCode": "合同编码",
"thirdSysBillCode": "MD20221110214120",
"deptCode": "GL01",
"scommentCode": "001"
}
返回示例
{
"success": true,
"data": {
"head": {
"recaccount": {
"code": "129001518010000273",
"name": null,
"pk": "1001B110000000028T28"
},
"pk_deptid": {
"code": "GL01",
"name": "公司领导",
"pk": "1001B110000000000N7T"
},
"supplier_v": {
"code": "DL00000009",
"name": "广州市图鉴城市规划勘测设计有限公司",
"pk": "1001B11000000001FCI8"
},
"sett_org": {
"code": "DL01",
"name": "DL01",
"pk": "0001B11000000000FBSR"
},
"pu_org_v": "0",
"isurgent": "N",
"supplier": {
"code": "DL00000009",
"name": "DL00000009",
"pk": "1001B11000000001FCI8"
},
"pk_subjcode": {
"code": "01",
"name": "测试收支项目",
"pk": "1001B110000000039S91"
},
"globallocal": "0.00000000",
"pk_tradetype": "F1-Cxx-ZG",
"isreded": "N",
"pu_deptid": {
"code": "GL01",
"name": "公司领导",
"pk": "1001B110000000000N7T"
},
"pk_fiorg_v": {
"code": "DL01",
"name": "DL01",
"pk": "0001B11000000000FBSQ"
},
"billdate": "2022-11-10 00:00:00",
"billno": "D12022111000000136",
"src_syscode": 1,
"scomment": {
"code": "001",
"name": "收建行资金池往来款",
"pk": "1001B11000000002C10J"
},
"approvestatus": -1,
"pk_currtype": {
"code": "CNY",
"name": "人民币",
"pk": "1002Z0100000000001K1"
},
"billclass": "yf",
"syscode": 1,
"def10": "500",
"pk_fiorg": {
"code": "DL01",
"name": "DL01",
"pk": "0001B11000000000FBSR"
},
"def11": "500",
"def12": "500",
"def13": "500",
"def14": "500",
"def15": "500",
"def16": {
"code": "01",
"name": "1个月",
"pk": "1001B11000000002QTM4"
},
"def17": {
"code": "0003",
"name": "结算款",
"pk": "1001B11000000002R527"
},
"local_money": "480.00000000",
"creator": {
"code": "ythpt",
"name": "一体化平台",
"pk": "1001B11000000000RRDW"
},
"pk_tradetypeid": "1001A11000000003R9B9",
"sett_org_v": {
"code": "DL01",
"name": "DL01",
"pk": "0001B11000000000FBSQ"
},
"grouplocal": "0.00000000",
"effectstatus": 0,
"saga_frozen": 0,
"grouprate": "0.00000000",
"pk_deptid_v": {
"code": "GL01",
"name": "公司领导",
"pk": "0001B11000000000FBSV"
},
"ts": "2022-11-10 21:41:30",
"pk_group": {
"code": "nftzjt",
"name": "NT集团",
"pk": "0001B110000000001I45"
},
"isflowbill": "N",
"rececountryid": {
"code": "CN",
"name": "中国",
"pk": "0001Z010000000079UJJ"
},
"modifier": {
"code": "ythpt",
"name": "一体化平台",
"pk": "1001B11000000000RRDW"
},
"isinit": "N",
"dr": 0,
"pk_org": {
"code": "DL01",
"name": "DL01",
"pk": "0001B11000000000FBSR"
},
"accessorynum": 0,
"pu_deptid_v": {
"code": "GL01",
"name": "公司领导",
"pk": "0001B11000000000FBSV"
},
"pk_balatype": {
"code": "02",
"name": "支票",
"pk": "0001Z0100000000000Y1"
},
"billstatus": -1,
"pk_busitype": "1010Z3100000000002BE",
"objtype": 1,
"def20": {
"code": "zyz01",
"name": "项目核算部",
"pk": "1001B110000000038XO4"
},
"billmaker": {
"code": "ythpt",
"name": "一体化平台",
"pk": "1001B11000000000RRDW"
},
"pk_payablebill": "1001A21000000004DBLS",
"busidate": "2022-11-10 21:41:23",
"billperiod": "11",
"creationtime": "2022-11-10 21:41:30",
"pk_org_v": {
"code": "DL01",
"name": "DL01",
"pk": "0001B11000000000FBSQ"
},
"pk_billtype": "F1",
"saga_status": 0,
"billyear": "2022",
"payaccount": {
"code": "44001580048052500608",
"name": "公司三一",
"pk": "1001A11000000003V7ZY"
},
"rate": "1.00000000",
"taxcountryid": {
"code": "CN",
"name": "中国",
"pk": "0001Z010000000079UJJ"
},
"globalrate": "0.00000000",
"def3": "MD20221110214120",
"def4": "http://www.baidu.com",
"def1": {
"code": "lyxt02",
"name": "一体化平台",
"pk": "1001B11000000002FK68"
},
"def2": {
"code": "1007",
"name": "个人还款单",
"pk": "1001A11000000003PR8R"
},
"money": "480.00000000",
"def9": "500",
"def7": "合同名称",
"invoiceno": "发票号",
"def8": "500",
"def5": {
"code": "01",
"name": "工程建安发票",
"pk": "1001B11000000002QTHE"
},
"def6": "合同编码"
},
"detail": [
{
"recaccount": {
"code": "129001518010000273",
"name": null,
"pk": "1001B110000000028T28"
},
"pk_deptid": {
"code": "GL01",
"name": "公司领导",
"pk": "1001B110000000000N7T"
},
"sett_org": {
"code": "DL01",
"name": "DL01",
"pk": "0001B11000000000FBSR"
},
"def80": "1",
"isurgent": "N",
"taxprice": "0.00000000",
"pk_subjcode": {
"code": "01",
"name": "测试收支项目",
"pk": "1001B110000000039S91"
},
"pk_tradetype": "F1-Cxx-ZG",
"quantity_bal": "0.00000000",
"pk_fiorg_v": {
"code": "DL01",
"name": "DL01",
"pk": "0001B11000000000FBSQ"
},
"settlemoney": "0.00000000",
"scomment": {
"code": "001",
"name": "收建行资金池往来款",
"pk": "1001B11000000002C10J"
},
"pk_currtype": {
"code": "CNY",
"name": "人民币",
"pk": "1002Z0100000000001K1"
},
"local_money_bal": "400",
"grouprate": "0.00000000",
"globalbalance": "0.00000000",
"money_cr": "400",
"ts": "2022-11-10 21:41:30",
"project": {
"code": "--2210-0001",
"name": "--2210-0001",
"pk": "1001B110000000020NWP"
},
"dr": 0,
"notax_cr": "353.98230088",
"buysellflag": 2,
"pausetransact": "N",
"pk_payableitem": "1001A21000000004DBLT",
"def20": "支撑材料明细",
"busidate": "2022-11-10 21:41:23",
"local_tax_cr": "46.01769912",
"pk_billtype": "F1",
"groupbalance": "0.00000000",
"rate": "1.00000000",
"groupcrebit": "0.00000000",
"def3": {
"code": "01",
"name": "一般计税",
"pk": "1001B11000000002Q9W7"
},
"def1": {
"code": "--2210-0001",
"name": "--2210-0001",
"pk": "1001B110000000020NWP"
},
"def2": {
"code": "--2210-0001",
"name": "--2210-0001",
"pk": "1001B110000000020NWP"
},
"opptaxflag": "N",
"comment": "1001B11000000002C10J",
"def7": "合同名称",
"def5": "200",
"def6": "合同编码",
"globalcrebit": "0.00000000",
"supplier_v": {
"code": "DL00000009",
"name": "广州市图鉴城市规划勘测设计有限公司",
"pk": "1001B11000000001FCI8"
},
"pu_org_v": "0",
"price": "0.00000000",
"supplier": {
"code": "DL00000009",
"name": "DL00000009",
"pk": "1001B11000000001FCI8"
},
"nosubtax": "0.00000000",
"sendcountryid": {
"code": "CN",
"name": "中国",
"pk": "0001Z010000000079UJJ"
},
"groupnotax_cre": "0.00000000",
"billdate": "2022-11-10 00:00:00",
"billno": "D12022111000000136",
"taxcodeid": {
"code": "CN13",
"name": "一般纳税货品增值税（13%）",
"pk": "1002Z01000000001CNE2"
},
"billclass": "yf",
"local_taxprice": "0.00000000",
"pk_fiorg": {
"code": "DL01",
"name": "DL01",
"pk": "0001B11000000000FBSR"
},
"def11": "200",
"def12": "200",
"def13": "200",
"def16": "5000",
"occupationmny": "400",
"rowno": 0,
"pk_tradetypeid": "1001A11000000003R9B9",
"sett_org_v": {
"code": "DL01",
"name": "DL01",
"pk": "0001B11000000000FBSQ"
},
"pk_deptid_v": {
"code": "GL01",
"name": "公司领导",
"pk": "0001B11000000000FBSV"
},
"pk_group": {
"code": "nftzjt",
"name": "NT集团",
"pk": "0001B110000000001I45"
},
"pk_org": {
"code": "DL01",
"name": "DL01",
"pk": "0001B11000000000FBSR"
},
"taxrate": "13",
"objtype": 1,
"pk_payablebill": "1001A21000000004DBLS",
"pk_org_v": {
"code": "DL01",
"name": "DL01",
"pk": "0001B11000000000FBSQ"
},
"local_price": "0.00000000",
"taxtype": 1,
"caltaxmny": "353.98230088",
"nosubtaxrate": "0.00000000",
"payaccount": {
"code": "44001580048052500608",
"name": "公司三一",
"pk": "1001A11000000003V7ZY"
},
"globalrate": "0.00000000",
"direction": -1,
"globalnotax_cre": "0.00000000",
"local_notax_cr": "353.98230088",
"money_bal": "400",
"quantity_cr": "0.00000000",
"local_money_cr": "400",
"invoiceno": "发票号"
},
{
"recaccount": {
"code": "129001518010000273",
"name": null,
"pk": "1001B110000000028T28"
},
"pk_deptid": {
"code": "GL01",
"name": "公司领导",
"pk": "1001B110000000000N7T"
},
"sett_org": {
"code": "DL01",
"name": "DL01",
"pk": "0001B11000000000FBSR"
},
"def80": "2",
"isurgent": "N",
"taxprice": "0.00000000",
"pk_subjcode": {
"code": "01",
"name": "测试收支项目",
"pk": "1001B110000000039S91"
},
"pk_tradetype": "F1-Cxx-ZG",
"quantity_bal": "0.00000000",
"pk_fiorg_v": {
"code": "DL01",
"name": "DL01",
"pk": "0001B11000000000FBSQ"
},
"settlemoney": "0.00000000",
"scomment": {
"code": "001",
"name": "收建行资金池往来款",
"pk": "1001B11000000002C10J"
},
"pk_currtype": {
"code": "CNY",
"name": "人民币",
"pk": "1002Z0100000000001K1"
},
"local_money_bal": "80",
"grouprate": "0.00000000",
"globalbalance": "0.00000000",
"money_cr": "80",
"ts": "2022-11-10 21:41:30",
"project": {
"code": "--2210-0001",
"name": "--2210-0001",
"pk": "1001B110000000020NWP"
},
"dr": 0,
"notax_cr": "70.79646018",
"buysellflag": 2,
"pausetransact": "N",
"pk_payableitem": "1001A21000000004DBLU",
"def20": "支撑材料明细",
"busidate": "2022-11-10 21:41:23",
"local_tax_cr": "9.20353982",
"pk_billtype": "F1",
"groupbalance": "0.00000000",
"rate": "1.00000000",
"groupcrebit": "0.00000000",
"def3": {
"code": "01",
"name": "一般计税",
"pk": "1001B11000000002Q9W7"
},
"def1": {
"code": "--2210-0001",
"name": "--2210-0001",
"pk": "1001B110000000020NWP"
},
"def2": {
"code": "--2210-0001",
"name": "--2210-0001",
"pk": "1001B110000000020NWP"
},
"opptaxflag": "N",
"comment": "1001B11000000002C10J",
"def7": "合同名称",
"def5": "40",
"def6": "合同编码",
"globalcrebit": "0.00000000",
"supplier_v": {
"code": "DL00000009",
"name": "广州市图鉴城市规划勘测设计有限公司",
"pk": "1001B11000000001FCI8"
},
"pu_org_v": "0",
"price": "0.00000000",
"supplier": {
"code": "DL00000009",
"name": "DL00000009",
"pk": "1001B11000000001FCI8"
},
"nosubtax": "0.00000000",
"sendcountryid": {
"code": "CN",
"name": "中国",
"pk": "0001Z010000000079UJJ"
},
"groupnotax_cre": "0.00000000",
"billdate": "2022-11-10 00:00:00",
"billno": "D12022111000000136",
"taxcodeid": {
"code": "CN13",
"name": "一般纳税货品增值税（13%）",
"pk": "1002Z01000000001CNE2"
},
"billclass": "yf",
"local_taxprice": "0.00000000",
"pk_fiorg": {
"code": "DL01",
"name": "DL01",
"pk": "0001B11000000000FBSR"
},
"def11": "40",
"def12": "40",
"def13": "40",
"def16": "5000",
"occupationmny": "80",
"rowno": 0,
"pk_tradetypeid": "1001A11000000003R9B9",
"sett_org_v": {
"code": "DL01",
"name": "DL01",
"pk": "0001B11000000000FBSQ"
},
"pk_deptid_v": {
"code": "GL01",
"name": "公司领导",
"pk": "0001B11000000000FBSV"
},
"pk_group": {
"code": "nftzjt",
"name": "NT集团",
"pk": "0001B110000000001I45"
},
"pk_org": {
"code": "DL01",
"name": "DL01",
"pk": "0001B11000000000FBSR"
},
"taxrate": "13",
"objtype": 1,
"pk_payablebill": "1001A21000000004DBLS",
"pk_org_v": {
"code": "DL01",
"name": "DL01",
"pk": "0001B11000000000FBSQ"
},
"local_price": "0.00000000",
"taxtype": 1,
"caltaxmny": "70.79646018",
"nosubtaxrate": "0.00000000",
"payaccount": {
"code": "44001580048052500608",
"name": "公司三一",
"pk": "1001A11000000003V7ZY"
},
"globalrate": "0.00000000",
"direction": -1,
"globalnotax_cre": "0.00000000",
"local_notax_cr": "70.79646018",
"money_bal": "80",
"quantity_cr": "0.00000000",
"local_money_cr": "80",
"invoiceno": "发票号"
}
]
},
"code": "1000000000",
"message": null,
"errorStack": null
}
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | string | 编号 |
| success | string | 接口调用状态, true:成功, false:失败 |
| message | string | 错误信息 |
| errorStack | string | 错误信息堆栈 |
| data | array | 数据 |
| pk_payablebill | string | 单据ID |
| billUrl | string | 单据访问URL |
备注
- 更多返回错误代码请看首页的错误代码描述