# 财务中台--SRM

简介:财务中台文档

HOST:localhost:8180

联系人:王萌、陈宇宙、林哲、操敏敏、周文

Version:1.0.0

接口路径:/v2/api-docs?group=1.0.0

[TOC]

# SRM单据推送管理

# srm推送采购发票取消

接口地址:/openApi/srm/push/invoice/cancel

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "outInvoiceId": "",
  "requestId": ""
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
ao	ao	body	true	传入实体采购发票明细对象	传入实体采购发票明细对象
outInvoiceId	发票单唯一标识 SRM发票结算单号		true	string
requestId	请求ID		false	string

响应状态:

状态码	说明	schema
200	OK	HttpResult«传入实体采购明细对象»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code		integer(int32)	integer(int32)
data		传入实体采购明细对象	传入实体采购明细对象
isSuccess	主体编码	boolean
message		string

响应示例:

{
	"code": 0,
	"data": {
		"isSuccess": false
	},
	"message": ""
}

# srm推送采购发票保存

接口地址:/openApi/srm/push/invoice/save

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "bizCheckDate": "",
  "currency": "",
  "invoiceCreateTime": "",
  "invoiceDate": "",
  "invoiceNo": "",
  "invoiceTotalAmount": 0,
  "invoiceTypeCode": "",
  "invoiceTypeName": "",
  "mainGroupCode": "",
  "noTaxAmount": 0,
  "outInvoiceId": "",
  "outRemark": "",
  "requestId": "",
  "savePurchaseInvoiceDetailList": [
    {
      "bizLineNo": "",
      "bizNo": "",
      "deliveryLineNo": "",
      "deliveryNo": "",
      "feeTypeCode": "",
      "feeTypeName": "",
      "includeTaxAmount": 0,
      "includeTaxPrice": 0,
      "isReturn": "",
      "noTaxAmount": 0,
      "noTaxPrice": 0,
      "outBizDetailId": "",
      "outInvoiceDetailId": "",
      "qty": 0,
      "skuBarCode": "",
      "skuUnit": "",
      "sourceTaxAmount": 0,
      "taxRate": 0,
      "warehouseCode": ""
    }
  ],
  "supplierCode": "",
  "supplierName": "",
  "taxAmount": 0,
  "taxTypeId": ""
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
ao	ao	body	true	传入实体采购发票对象	传入实体采购发票对象
bizCheckDate	业务单据审批通过时间		true	string(date-time)
currency	币种按照实际币种传输，目前有海外采购业务		true	string
invoiceCreateTime	单据创建时间		true	string(date-time)
invoiceDate	发票日期真实发票上日期		false	string(date-time)
invoiceNo	发票号真实发票上的发票号；真实的有多张发票，多个号码隔开一起传		true	string
invoiceTotalAmount	发票总金额		true	number
invoiceTypeCode	发票类型编码默认值普通发票25-01费用发票25-05		true	string
invoiceTypeName	发票类型名称普通发票/费用发票		true	string
mainGroupCode	主体编码默认值：G；即：白贝壳，月半		true	string
noTaxAmount	发票不含税金额		true	number
outInvoiceId	发票单唯一标识 SRM发票结算单号		true	string
outRemark	备注		false	string
requestId	请求ID		true	string
savePurchaseInvoiceDetailList	采购发票明细		true	array	传入实体采购发票明细对象_1
bizLineNo	业务订单行号，采购订单行号		false	string
bizNo	业务单号，采购订单号/费用单号		false	string
deliveryLineNo	Srm送货单行号		false	string
deliveryNo	Srm送货单号 srm		false	string
feeTypeCode	费用类别code 只有费用类型才有此类型		false	string
feeTypeName	费用类别名称只有费用类型才有此类型		false	string
includeTaxAmount	含税金额原币		true	number
includeTaxPrice	含税单价原币		true	number
isReturn	是否退货 Y N		false	string
noTaxAmount	无税金额原币		true	number
noTaxPrice	无税单价原币		true	number
outBizDetailId	采购入库明细id/费用单明细id 入库类必填		true	string
outInvoiceDetailId	SRM发票明细id srm		true	string
qty	数量；费用单数量填0		false	integer
skuBarCode	物料编码费用类物料编码非必填		true	string
skuUnit	物料单位计量单位		false	string
sourceTaxAmount	原币税额原币		true	number
taxRate	税率		true	number
warehouseCode	仓库编码		false	string
supplierCode	供应商编码		true	string
supplierName	供应商名称		true	string
taxAmount	发票税额		true	number
taxTypeId	扣税类别默认值1=应税外加;0=应税内含;		true	string

响应状态:

状态码	说明	schema
200	OK	HttpResult«传入实体采购明细对象»_2
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code		integer(int32)	integer(int32)
data		传入实体采购明细对象_3	传入实体采购明细对象_3
isSuccess	主体编码	boolean
message		string

响应示例:

{
	"code": 0,
	"data": {
		"isSuccess": false
	},
	"message": ""
}

# srm付款单取消

接口地址:/openApi/srm/push/paymentDoc/cancel

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "payBillNo": "",
  "requestId": ""
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
ao	ao	body	true	传入实体采购发票对象_1	传入实体采购发票对象_1
payBillNo	付款单据号单据唯一标识		true	string
requestId	请求ID		false	string

响应状态:

状态码	说明	schema
200	OK	HttpResult«boolean»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	boolean
message	string

响应示例:

{
	"code": 0,
	"data": true,
	"message": ""
}

# srm付款单保存

接口地址:/openApi/srm/push/paymentDoc/save

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "createTime": "",
  "creator": "",
  "expectedPayDate": "",
  "incomePayCode": "",
  "incomePayName": "",
  "mainGroupCode": "",
  "mainGroupName": "",
  "payBillNo": "",
  "paySuccessDate": "",
  "payType": "",
  "receiveAccountName": "",
  "receiveAccountType": "",
  "receiveBankAccount": "",
  "receiveBankType": "",
  "receiveChannelType": "",
  "receiveSubBranch": "",
  "receiveSubBranchNo": "",
  "requestId": "",
  "savePaymentDocDetailList": [
    {
      "bizLineNo": "",
      "bizNo": "",
      "currency": "",
      "deliveryLineNo": "",
      "deliveryNo": "",
      "feeTypeCode": "",
      "feeTypeName": "",
      "includeTaxAmount": 0,
      "includeTaxPrice": 0,
      "invoiceNo": "",
      "lineNo": "",
      "noTaxAmount": 0,
      "noTaxPrice": 0,
      "outBizDetailId": "",
      "outInvoiceDetailId": "",
      "qty": 0,
      "settleType": "",
      "skuBarCode": "",
      "srmPushPrePaymentDocDetailAOList": [
        {
          "currency": "",
          "currentVerifacationAmoun": 0,
          "outBizDetailId": "",
          "preOrderPayNo": "",
          "preOrderSettleLineNo": ""
        }
      ],
      "taxRate": 0
    }
  ],
  "sourceAmount": 0,
  "sourceNeedAmount": 0,
  "sourcePreAmount": 0,
  "supplierCode": "",
  "supplierName": ""
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
ao	ao	body	true	传入实体采购发票对象_4	传入实体采购发票对象_4
createTime	创建时间		true	string(date-time)
creator	创建人		true	string
expectedPayDate	期望付款日期		false	string(date-time)
incomePayCode	收支项目编码		true	string
incomePayName	收支项目名称		true	string
mainGroupCode	主体编码默认值：G；即：白贝壳，月半		true	string
mainGroupName	主体		true	string
payBillNo	付款单据号单据唯一标识		true	string
paySuccessDate	付款成功日期付款成功日期；nccc回传的日期		true	string(date-time)
payType	付款类型编码 pay 付款 pre 预付款；预付款srm是否有预付款单明细？预付款财务中台无需即刻核销应付单；非预付款单需要在生成付款单时即刻核销应付单		true	string
receiveAccountName	收款账户名称		true	string
receiveAccountType	收款账户类型对公、对私		false	string
receiveBankAccount	收款银行账号		true	string
receiveBankType	收款银行类型工商银行、农业银行等		false	string
receiveChannelType	收款渠道类型银行、微信、支付宝		false	string
receiveSubBranch	支行名称		true	string
receiveSubBranchNo	收款银行支行号 srm的收款开户行		true	string
requestId	请求ID		false	string
savePaymentDocDetailList	付款单明细		false	array	传入实体采购发票对象_3
bizLineNo	业务订单行号，采购订单行号		true	string
bizNo	业务单号，采购订单号/费用单号		true	string
currency	币种		true	string
deliveryLineNo	Srm送货单行号		true	string
deliveryNo	Srm送货单号		true	string
feeTypeCode	费用明细类型编码		false	string
feeTypeName	费用明细类型		false	string
includeTaxAmount	原币含税金额		true	number
includeTaxPrice	原币含税单价		true	number
invoiceNo	发票号		true	string
lineNo	行号		true	string
noTaxAmount	原币不含税金额		true	number
noTaxPrice	原币不含税单价		true	number
outBizDetailId	采购入库明细id/费用单明细id		true	string
outInvoiceDetailId	发票明细id		true	string
qty	数量		true	integer
settleType	结算方式按照标准传		true	string
skuBarCode	物料编码		true	string
srmPushPrePaymentDocDetailAOList	预付款单核销对象		true	array	传入实体采购发票对象_2
currency	币种		false	string
currentVerifacationAmoun	本次核销金额		false	number
outBizDetailId	采购入库明细id/费用单明细id		false	string
preOrderPayNo	预付款单号		false	string
preOrderSettleLineNo	预付款结算单行号		false	string
taxRate	税率		true	number
sourceAmount	原币应付总金额		false	number
sourceNeedAmount	原币应付余额		false	number
sourcePreAmount	原币预付核销总额		false	number
supplierCode	供应商编码		true	string
supplierName	供应商名称		true	string

响应状态:

状态码	说明	schema
200	OK	HttpResult«boolean»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	类型	schema
code	integer(int32)	integer(int32)
data	boolean
message	string

响应示例:

{
	"code": 0,
	"data": true,
	"message": ""
}

# srm推送采购订单保存

接口地址:/openApi/srm/push/purchase/save

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "requestId": "",
  "srmPushPurchaseDetailAOList": [
    {
      "bizLineNo": "",
      "bizNo": "",
      "bizStockInDate": "",
      "businessType": "",
      "deliveryLineNum": "",
      "deliveryNo": "",
      "deliveryTotalAmount": "",
      "isPresent": "",
      "isReturn": "",
      "isSubstituteSend": "",
      "mainGroupCode": "",
      "noTaxAmount": "",
      "omsDetailId": "",
      "omsInternalSn": "",
      "originalCurrency": "",
      "outBizDetailId": "",
      "qty": 0,
      "receiveStore": "",
      "skuBarCode": "",
      "skuUnit": "",
      "sourceNoTaxPrice": "",
      "sourceTaxPrice": "",
      "subStore": "",
      "supplierCode": "",
      "supplierName": "",
      "taxAmount": "",
      "taxRate": "",
      "wmsDetailId": ""
    }
  ]
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
ao	ao	body	true	传入实体采购明细对象集合	传入实体采购明细对象集合
requestId	请求ID		false	string
srmPushPurchaseDetailAOList	传入实体采购明细对象		false	array	传入实体采购明细对象_2
bizLineNo	采购订单行号		false	string
bizNo	采购订单号		false	string
bizStockInDate	业务入库日期(格式:yyyy-MM-dd HH:mm:ss)		false	string
businessType	业务类型(COMMON:普通采购，WWCP:委外加工（成品）)		false	string
deliveryLineNum	srm送货单行号		false	string
deliveryNo	srm送货单号		false	string
deliveryTotalAmount	送货单总金额		false	string
isPresent	是否赠品(Y 是 N 否)		false	string
isReturn	是否退货(Y 是 N 否)		false	string
isSubstituteSend	是否一件代发(Y 是 N 否)		false	string
mainGroupCode	公司主体编码		false	string
noTaxAmount	原币无税金额		false	string
omsDetailId	oms入库明细id		false	string
omsInternalSn	OMS入库流水批次号		false	string
originalCurrency	原币币种		false	string
outBizDetailId	采购入库明细id		false	string
qty	入库主数量		false	integer
receiveStore	收货仓库（总仓）		false	string
skuBarCode	sku条码		false	string
skuUnit	sku单位编码		false	string
sourceNoTaxPrice	原币无税单价		false	string
sourceTaxPrice	原币含税单价		false	string
subStore	分仓		false	string
supplierCode	供应商编码		false	string
supplierName	供应商名称		false	string
taxAmount	原币含税金额		false	string
taxRate	税率		false	string
wmsDetailId	WMS入库明细id		false	string

响应状态:

状态码	说明	schema
200	OK	HttpResult«传入实体采购明细对象»_1
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code		integer(int32)	integer(int32)
data		传入实体采购明细对象_1	传入实体采购明细对象_1
isSuccess	主体编码	boolean
message		string

响应示例:

{
	"code": 0,
	"data": {
		"isSuccess": false
	},
	"message": ""
}

← 资金管理-BPM TMS对接 →