接口调用过程流程图
项目管理、财务、采购系统交互流程.png
文档阅读说明
使用HTTP协议、JSON数据格式、UTF8编码，POST请求请在HTTP Header中设置 Content-Type:application/json。所有请求的根路径为http://ip:port/pm/purchase
所有的请求包体，必须按以下json报文格式封装，业务数据放入body中，其他数据按格式传空值即可。请求响应是否成功，根据errcode判断，0表示成功，其他表示失败，"errcode"与"errmsg"一定会返回。
{
"service": {
"sysHead": {
"branchId": "",
"ver": "",
"serviceCode": "",
"sysId": "",
"tranMode": "",
"globSeqNum": "",
"sysSeqNum": "",
"prdCode": "",
"userId": "",
"serviceScene": "",
"tranTime": "",
"infType": "",
"tellerId": "",
"originSysId": "",
"tranDate": "",
"tranCode": "",
"infSeqNum": ""
},
"appHead": {},
"body": {}
}
}
1 新增供应商
请求方式：POST
请求地址：/addSupplier.ws
请求包结构体：
{
"service": {
"sysHead": {
"branchId": "",
"ver": "",
"serviceCode": "",
"sysId": "",
"tranMode": "",
"globSeqNum": "",
"sysSeqNum": "",
"prdCode": "",
"userId": "",
"serviceScene": "",
"tranTime": "",
"infType": "",
"tellerId": "",
"originSysId": "",
"tranDate": "",
"tranCode": "",
"infSeqNum": ""
},
"appHead": {},
"body": {
"title": "",
"str02": "",
"str13": "",
"str41": "",
"str10": "",
"date01": "",
"str04": "",
"str42": "",
"str11": "",
"str12": "",
"str15": "",
"str14": "",
"str43": "",
"text02": "",
"date03": "",
"date04": "",
"status":""
}
}
}
请求参数说明：
新增供应商请求体数据说明.png
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"data": ""
}
2 更新供应商
请求方式：POST
请求地址：/updateSupplier.ws
请求包结构体：
{
"service": {
"sysHead": {
"branchId": "",
"ver": "",
"serviceCode": "",
"sysId": "",
"tranMode": "",
"globSeqNum": "",
"sysSeqNum": "",
"prdCode": "",
"userId": "",
"serviceScene": "",
"tranTime": "",
"infType": "",
"tellerId": "",
"originSysId": "",
"tranDate": "",
"tranCode": "",
"infSeqNum": ""
},
"appHead": {},
"body": {
"title": "",
"str02": "",
"str13": "",
"str41": "",
"str10": "",
"date01": "",
"str04": "",
"str42": "",
"str11": "",
"str12": "",
"str15": "",
"str14": "",
"str43": "",
"text02": "",
"date03": "",
"date04": "",
"status":""
}
}
}
请求参数说明（如果非必须的字段未指定，则后台不改变该字段之前设置好的值）：
更新供应商请求体数据说明.png
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"data": ""
}
3 新增中标结果（不含附件，附件上传接口单独提供）
请求方式：POST
请求地址：/addBid/{demandId}.ws（demandId为项目管理系统推给采购系统的“立项主键ID”，例如demandId为17569，请求地址为：/addBid/17569.ws）
请求包结构体：
{
"service": {
"sysHead": {
"branchId": "",
"ver": "",
"serviceCode": "",
"sysId": "",
"tranMode": "",
"globSeqNum": "",
"sysSeqNum": "",
"prdCode": "",
"userId": "",
"serviceScene": "",
"tranTime": "",
"infType": "",
"tellerId": "",
"originSysId": "",
"tranDate": "",
"tranCode": "",
"infSeqNum": ""
},
"appHead": {},
"body": {
"supplierSid": "2",
"amount": "34500",
"bidTimeStr": "20191212",
"remark": "描述",
"changeReason": "变更原因"
}
}
}
请求参数说明：
新增中标结果请求体数据说明.png
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"data": "13259" //预中标id，项目管理系统预中标结果唯一标识bidId
}
4 更新中标结果（不含附件，附件上传接口单独提供）
请求方式：POST
请求地址：/updateBid/{bidId}.ws（bidId为项目管理系新增统预中标结果时返回的唯一标识 预中标id，例如bidId为13259，请求地址为：/updateBid/13259.ws）
请求包结构体：
{
"service": {
"sysHead": {
"branchId": "",
"ver": "",
"serviceCode": "",
"sysId": "",
"tranMode": "",
"globSeqNum": "",
"sysSeqNum": "",
"prdCode": "",
"userId": "",
"serviceScene": "",
"tranTime": "",
"infType": "",
"tellerId": "",
"originSysId": "",
"tranDate": "",
"tranCode": "",
"infSeqNum": ""
},
"appHead": {},
"body": {
"supplierSid": "2",
"amount": "34500",
"bidTimeStr": "20191212",
"remark": "描述",
"changeReason": "变更原因"
}
}
}
请求参数说明（如果非必须的字段未指定，则后台不改变该字段之前设置好的值）：
更新中标结果请求体数据说明.png
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"data": ""
}
5 附件上传
请求方式：POST
请求地址：/uploadFile/{demandId}.ws（demandId为项目管理系统推给采购系统的“立项主键ID”，例如demandId为17569，请求地址为：/uploadFile/17569.ws）
请求包结构体：
{
"service": {
"sysHead": {
"branchId": "",
"ver": "",
"serviceCode": "",
"sysId": "",
"tranMode": "",
"globSeqNum": "",
"sysSeqNum": "",
"prdCode": "",
"userId": "",
"serviceScene": "",
"tranTime": "",
"infType": "",
"tellerId": "",
"originSysId": "",
"tranDate": "",
"tranCode": "",
"infSeqNum": ""
},
"appHead": {},
"body": {
}
}
}
请求参数说明：
只需传入esb要求的报文格式和文件流数据
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"data": ""
}
6 发票回传
请求方式：POST
请求地址：/addInvoice/{payNumber}.ws（payNumber为项目管理系统推给采购系统的“付款编号”，例如payNumber为17569，请求地址为：/addInvoice/17569.ws）
请求包结构体：
{
"service": {
"sysHead": {
"branchId": "",
"ver": "",
"serviceCode": "",
"sysId": "",
"tranMode": "",
"globSeqNum": "",
"sysSeqNum": "",
"prdCode": "",
"userId": "",
"serviceScene": "",
"tranTime": "",
"infType": "",
"tellerId": "",
"originSysId": "",
"tranDate": "",
"tranCode": "",
"infSeqNum": ""
},
"appHead": {},
"body": {
"code": "",
"number": "",
"typeCode": "0101",
"typeName": "增值税专用发票"
}
}
}
请求参数说明：
发票回传请求数据说明.png
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"data": ""
}
网友评论