接口調(diào)用過程流程圖
文檔閱讀說明
使用HTTP協(xié)議、JSON數(shù)據(jù)格式、UTF8編碼，POST請(qǐng)求請(qǐng)?jiān)贖TTP Header中設(shè)置 Content-Type:application/json。所有請(qǐng)求的根路徑為http://ip:port/pm/purchase
所有的請(qǐng)求包體，必須按以下json報(bào)文格式封裝，業(yè)務(wù)數(shù)據(jù)放入body中，其他數(shù)據(jù)按格式傳空值即可。請(qǐng)求響應(yīng)是否成功，根據(jù)errcode判斷，0表示成功，其他表示失敗，"errcode"與"errmsg"一定會(huì)返回。
{
"service": {
"sysHead": {
"branchId": "",
"ver": "",
"serviceCode": "",
"sysId": "",
"tranMode": "",
"globSeqNum": "",
"sysSeqNum": "",
"prdCode": "",
"userId": "",
"serviceScene": "",
"tranTime": "",
"infType": "",
"tellerId": "",
"originSysId": "",
"tranDate": "",
"tranCode": "",
"infSeqNum": ""
},
"appHead": {},
"body": {}
}
}
1 新增供應(yīng)商
請(qǐng)求方式：POST
請(qǐng)求地址：/addSupplier.ws
請(qǐng)求包結(jié)構(gòu)體：
{
"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":""
}
}
}
請(qǐng)求參數(shù)說明：
返回結(jié)果：
{
"errcode": 0,
"errmsg": "ok",
"data": ""
}
2 更新供應(yīng)商
請(qǐng)求方式：POST
請(qǐng)求地址：/updateSupplier.ws
請(qǐng)求包結(jié)構(gòu)體：
{
"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":""
}
}
}
請(qǐng)求參數(shù)說明（如果非必須的字段未指定，則后臺(tái)不改變?cè)撟侄沃霸O(shè)置好的值）：
返回結(jié)果：
{
"errcode": 0,
"errmsg": "ok",
"data": ""
}
3 新增中標(biāo)結(jié)果（不含附件，附件上傳接口單獨(dú)提供）
請(qǐng)求方式：POST
請(qǐng)求地址：/addBid/{demandId}.ws（demandId為項(xiàng)目管理系統(tǒng)推給采購系統(tǒng)的“立項(xiàng)主鍵ID”，例如demandId為17569，請(qǐng)求地址為：/addBid/17569.ws）
請(qǐng)求包結(jié)構(gòu)體：
{
"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": "變更原因"
}
}
}
請(qǐng)求參數(shù)說明：
返回結(jié)果：
{
"errcode": 0,
"errmsg": "ok",
"data": "13259" //預(yù)中標(biāo)id，項(xiàng)目管理系統(tǒng)預(yù)中標(biāo)結(jié)果唯一標(biāo)識(shí)bidId
}
4 更新中標(biāo)結(jié)果（不含附件，附件上傳接口單獨(dú)提供）
請(qǐng)求方式：POST
請(qǐng)求地址：/updateBid/{bidId}.ws（bidId為項(xiàng)目管理系新增統(tǒng)預(yù)中標(biāo)結(jié)果時(shí)返回的唯一標(biāo)識(shí) 預(yù)中標(biāo)id，例如bidId為13259，請(qǐng)求地址為：/updateBid/13259.ws）
請(qǐng)求包結(jié)構(gòu)體：
{
"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": "變更原因"
}
}
}
請(qǐng)求參數(shù)說明（如果非必須的字段未指定，則后臺(tái)不改變?cè)撟侄沃霸O(shè)置好的值）：
返回結(jié)果：
{
"errcode": 0,
"errmsg": "ok",
"data": ""
}
5 附件上傳
請(qǐng)求方式：POST
請(qǐng)求地址：/uploadFile/{demandId}.ws（demandId為項(xiàng)目管理系統(tǒng)推給采購系統(tǒng)的“立項(xiàng)主鍵ID”，例如demandId為17569，請(qǐng)求地址為：/uploadFile/17569.ws）
請(qǐng)求包結(jié)構(gòu)體：
{
"service": {
"sysHead": {
"branchId": "",
"ver": "",
"serviceCode": "",
"sysId": "",
"tranMode": "",
"globSeqNum": "",
"sysSeqNum": "",
"prdCode": "",
"userId": "",
"serviceScene": "",
"tranTime": "",
"infType": "",
"tellerId": "",
"originSysId": "",
"tranDate": "",
"tranCode": "",
"infSeqNum": ""
},
"appHead": {},
"body": {
}
}
}
請(qǐng)求參數(shù)說明：
只需傳入esb要求的報(bào)文格式和文件流數(shù)據(jù)
返回結(jié)果：
{
"errcode": 0,
"errmsg": "ok",
"data": ""
}
6 發(fā)票回傳
請(qǐng)求方式：POST
請(qǐng)求地址：/addInvoice/{payNumber}.ws（payNumber為項(xiàng)目管理系統(tǒng)推給采購系統(tǒng)的“付款編號(hào)”，例如payNumber為17569，請(qǐng)求地址為：/addInvoice/17569.ws）
請(qǐng)求包結(jié)構(gòu)體：
{
"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": "增值稅專用發(fā)票"
}
}
}
請(qǐng)求參數(shù)說明：
返回結(jié)果：
{
"errcode": 0,
"errmsg": "ok",
"data": ""
}
