五星电器-预采购APP接口

1、订单列表

链接：/interfaces/xpmContract/getOrderList

参数：
projectSid-项目主键
dataType 【0-待下单 1-已下单 2-部门发货 3-已发货 4-到货验收】
pageNumber-页码
pageSize-每页个数
search-查询参数

返回字段解析：
订单主键：contractId
订单名称：contractName
供方：supplierName
订单类型：contractTypeName
含税价格：standardCurrencyTypeContractTaxMoney

2、获取订单数字

链接：/interfaces/xpmContract/getOrderNumber
参数：
projectSid-项目主键

返回值解析：
101-待下单
102-已下单
103-部分发货
104-已发货
105-已验收

3、获取年框合同

链接：/interfaces/xpmContract/getYearContract
参数：
pageNumber-页码
pageSize-每页个数
search-查询参数
state-合同状态【默认传3】

返回字段解析：
合同主键：id
合同名称：contractName
品类：category
供方：supplierName
有效期（开始）：vStartTime
有效期（结束）：vEndTime

4、获取料表清单

链接：/interfaces/xpmContract/getYearContractDetail
参数：
id-预采购订单主键
projectSid-项目主键
pageNumber-页码
pageSize-每页个数
search-查询参数

返回字段解析：
主键：id
编号：code
名称：name
规格型号：spec
单位：descs
不含税单价：price
含税单价：priceRate

5、获取合同类型

链接：/interfaces/xpmContract/getContractTypeList
参数：
type-类型【默认传0】

返回字段解析：
订单类型主键：contractTypeSid
订单类型名称：contractTypeName

6、保存实体

链接：/interfaces/xpmContract/saveEntity
参数：
param-保存参数集合
{
entity-实体组合
contractDetailed-订单明细
contractReceivables-付款节点
projectSid-项目主键
}
样例：
param:{
entity: {“createSid”:”5ec3a5020acb448aa9653d554287d826_admin”,”contractId”:”1ac1540da62a490da9e8725c884381c8”,”projectSid”:”a23f1d760a0a40d8a28fa1c5a888f40d”,”xpmYearContractId”:”aa50be0aeae14b258c4b3eab233405cd”,”contractBusinessType”:”0”,”projectCode”:”XJ-202104002”,”projectName”:”于金艳测试项目”,”contractNumber”:”20210608135543”,”contractName”:”DEMO”,”contractType”:””,”contractTypeName”:””,”supplierSid”:”c5a37253b6bc46d29518440f28b9e382”,”supplierName”:”江苏林洋综合能源服务有限公司”,”supplierConnectorId”:”5ec3a5020acb448aa9653d554287d826_admin”,”supplierConnector”:”京东五星电器管理员”,”receiveTime”:”2021-07-14”,”standardCurrencyTypeContractTaxMoney”:”1100.00”,”standardCurrencyTypeContractMoney”:”973.45”,”taxRate”:”13.00”,”receiverId”:”5ec3a5020acb448aa9653d554287d826_admin”,”receiver”:”京东五星电器管理员”,”receiverPhone”:”18606197707”,”demandName”:”京东五星电器集团有限公司”,”makeOrderHuman”:””,”makeOrderTime”:””,”remarks”:””,”originalCoinMoney”:”0”,”totalPrice”:”0”}
contractDetailed: [{“xpmContractLedgerSid”:”1ac1540da62a490da9e8725c884381c8”,”largeClassName”:null,”inventoryProjectDetailSid”:null,”totalPrice”:”￥265.49”,”num”:”1”,”DEFAULT_SORT_COLUMNS_HIBERNATE”:” sid DESC”,”remark”:null,”totalPriceRate”:”￥300.00”,”sid”:”72602a29-3d72-e0e2-3f5e-59ff0aabac5f”,”procurementDocumentPackageDetailSid”:”bea8dfbbe50d45b197626c66caa6917a”,”smallClassName”:null,”inventoryUnit”:null,”inventoryName”:”三线轨道（黑）2M”,”unitPrice”:”￥265.49”,”parentSid”:null,”inventorySpec”:”2000mm”,”inventoryCode”:”D-27”,”OutlineNumber”:”1”,”inventoryModel”:null,”largeClassCode”:null,”unitPriceRate”:”￥300.00”,”picture”:null,”inventoryDetailSid”:null,”smallClassCode”:null,”inventoryRemark”:”根”,”OutlineLevel”:1,”expanded”:true,”_id”:3,”_uid”:3,”_pid”:-1,”_level”:0,”contractSid”:”1ac1540da62a490da9e8725c884381c8”},{“xpmContractLedgerSid”:”1ac1540da62a490da9e8725c884381c8”,”largeClassName”:null,”inventoryProjectDetailSid”:null,”totalPrice”:”￥707.96”,”num”:”2”,”DEFAULT_SORT_COLUMNS_HIBERNATE”:” sid DESC”,”remark”:null,”totalPriceRate”:”￥800.00”,”sid”:”48aceb92-a9c3-9162-ad94-c43e101b628f”,”procurementDocumentPackageDetailSid”:”233fd1e8e81949d2a39ac6e71a63de17”,”smallClassName”:null,”inventoryUnit”:null,”inventoryName”:”象鼻灯-黑”,”unitPrice”:”￥353.98”,”parentSid”:null,”inventorySpec”:”5000K，24W”,”inventoryCode”:”Q-09”,”OutlineNumber”:”2”,”inventoryModel”:null,”largeClassCode”:null,”unitPriceRate”:”￥400.00”,”picture”:null,”inventoryDetailSid”:null,”smallClassCode”:null,”inventoryRemark”:”只”,”OutlineLevel”:1,”expanded”:true,”_id”:4,”_uid”:4,”_pid”:-1,”_level”:0,”contractSid”:”1ac1540da62a490da9e8725c884381c8”}]
contractReceivables: []
projectSid: a23f1d760a0a40d8a28fa1c5a888f40d
}

7、获取合同实体
链接：/interfaces/xpmContract/getContractBySid
参数：contractSid-合同主键

返回参数解析：
项目名称：projectName
项目编号：projectCode
项目主键：projectSid
订单id：contractId
订单编号：contractNumber
订单名称：contractName
订单类型：contractType
订单类型名称：contractTypeName
要求到货时间：receiveTime
备注：remarks
供方主键：supplierSid
供方：supplierName
供方联系人主键：supplierConnectorId
供方联系人：supplierConnector
需方：demandName
下单人：makeOrderHuman
下单人主键：makeOrderHumanSid
收货人主键：receiverId
收货人：receiver
联系电话：receiverPhone
订单状态：contractStatus
基础数据【101待下单 102已下单 103部分发货 104已发货 105到货验收】
订单金额【含税】：standardCurrencyTypeContractTaxMoney
订单金额【不含税】：standardCurrencyTypeContractMoney
税率：taxRate
年框合同主键：xpmYearContractId

8、根据合同ID获取清单明细
链接：/interfaces/xpmContract/getPurchaseOrderDetailList
参数：contractSid-合同主键

返回参数解析：
订单ID：xpmContractLedgerSid
订单明细主键：procurementDocumentPackageDetailSid
物资编号：inventoryCode
物资名称：inventoryName
规格型号：inventorySpec
单位：inventoryRemark
不含税单价：unitPrice
含税单价：unitPriceRate
订单数量：num
不含税合价：totalPrice
含税合价：totalPriceRate

9、根据合同清单获取合同收款节点
链接：/interfaces/xpmContract/getContractReceivablesList
参数：contractSid-合同主键
yearContractId-年框合同主键

返回参数解析：
订单主键：contractSid
主键：paymentSid
付款项：paymentItem
付款比例：paymentRatio
付款金额（含税）：paymentTaxAmount
付款金额（不含税）：paymentAmount
备注：remark

10、到货验收列表
链接：/interfaces/BatchLogisticsArrival/getList
参数：projectSid-项目主键
pageNumber-页码
pageSize-每页个数
search-查询参数
state-状态【已验收传3、未验收不用传】

返回参数解析：
主键：batchLogisticsArrivalSid
批次：batch
承运方：shipper
物流方/快递方/专车车牌号：logistics
物流运单号/快递运单号/驾驶员联系电话：logisticsOrderCode
实际发货时间：actualDeliveryTime
计划到货时间：planArrivalTime
收货人：consignee

11、物流基本信息查询
链接：/interfaces/BatchLogisticsArrival/getById
参数：id-物流到货主键

返回参数解析：
物流到货主键：batchLogisticsArrivalSid
物流主键：batchLogisticsSid
项目主键：projectSid
项目编码：projectCode
项目名称：projectName
批次：batch
承运方主键：shipperSid
承运方：shipper
物流方：logistics
物流运单号：logisticsOrderCode
发货人：consignor
发货人主键：consignorSid
实际发货时间：actualDeliveryTime
计划到货时间：planArrivalTime
收货人：consignee
收货人主键：consigneeSid
联系电话：consigneePhone
实际到货时间：actualArrivalTime
实际收货人：actualConsignee
实际收货人主键：actualConsigneeSid
实际验收时间：actualCheckTime
备注：remark

12、获取订单明细列表

链接：/interfaces/BatchLogisticsArrival/getOrederDetailList
参数：id-物流到货主键

返回参数解析：
订单明细主键：batchLogisticsArrivalDetailSid
订单名称：orderName
编号：orderCode
名称：name
规格型号：spec
单位：remark
发货数量：batchNumber
到货数量：actualNumber
差异说明：reason

13、保存/提交到货验收
链接：/interfaces/BatchLogisticsArrival/saveBatchLogisticsArrival
参数案例：
{
actualArrivalTime: “2021-06-11”，
actualCheckTime: “2021-06-10T07:50:49”，
actualConsignee: “京东五星电器管理员”，
actualConsigneeSid: “5ec3a5020acb448aa9653d554287d826_admin”，
actualDeliveryTime: “2021-04-23”，
batchLogisticsArrivalSid: “b82492e703f64599abb5f51211f0e3de”，
batchLogisticsSid: “e7f98381-f3fe-446c-86fc-25480e55587d”，
consignee: “刘宝栋”，
consigneePhone: “13601452775”，
consigneeSid: “6ba85c48143547bcb6bbadbe8e4bf72c”，
consignor: “京东五星电器管理员”，
consignorSid: “”，
logistics: “中通”，
logisticsOrderCode: “3214134”，
operator: “modified”，
planArrivalTime: “2021-04-24”，
projectCode: “20210421103213602”，
projectName: “湘潭莲城步行街城市旗舰店”，
projectSid: “5dae0b9dc0644c5a9931d440ac5b9e38”，
remark: “”，
shipper: “物流 “，
shipperSid: “logistics”，
state: “3”，
batchLogisticsArrivalDetails: [
{
actualNumber: 30
batchLogisticsArrivalDetailSid: “38ec160e53074654b93e9fb1f2f7f654”
batchLogisticsArrivalSid: “b82492e703f64599abb5f51211f0e3de”
batchNumber: 30
name: “COB射灯-白”
orderCode: “S-03”
orderContractDetailSid: “cfd76fbc-02d4-4b30-1693-82971814fbc4”
orderName: “灯具第二批”
orderSid: “4cb847dee394448ca26f201b4a6a46e9”
reason: “无”
remark: null
spec: “3000K”
}，
{
actualNumber: 30
batchLogisticsArrivalDetailSid: “38ec160e53074654b93e9fb1f2f7f654”
batchLogisticsArrivalSid: “b82492e703f64599abb5f51211f0e3de”
batchNumber: 30
name: “COB射灯-白”
orderCode: “S-03”
orderContractDetailSid: “cfd76fbc-02d4-4b30-1693-82971814fbc4”
orderName: “灯具第二批”
orderSid: “4cb847dee394448ca26f201b4a6a46e9”
reason: “无”
remark: null
spec: “3000K”
}，
]
}

参数解析：
物流到货主键：batchLogisticsArrivalSid
物流主键：batchLogisticsSid
项目主键：projectSid
项目编码：projectCode
项目名称：projectName
批次：batch
承运方主键：shipperSid
承运方：shipper
物流方：logistics
物流运单号：logisticsOrderCode
发货人：consignor
发货人主键：consignorSid
实际发货时间：actualDeliveryTime
计划到货时间：planArrivalTime
收货人：consignee
收货人主键：consigneeSid
联系电话：consigneePhone
实际到货时间：actualArrivalTime
实际收货人：actualConsignee
实际收货人主键：actualConsigneeSid
实际验收时间：actualCheckTime
备注：remark
订单明细列表：batchLogisticsArrivalDetails
订单明细主键：batchLogisticsArrivalDetailSid
订单名称：orderName
编号：orderCode
名称：name
规格型号：spec
单位：remark
发货数量：batchNumber
到货数量：actualNumber
差异说明：reason

14、到货验收数字查询
链接：/interfaces/BatchLogisticsArrival/getNumber
参数：projectSid-项目主键
返回参数解析：
已验收数字：ACCEPTED
未验收数字：NOT_ACCEPTED