knowledge/项目管理库/诺唯赞CRM项目/CRM模块拆解分析/合同服务拆解分析2.md

合同服务拆解分析2

一、功能描述

1、管理与第三方对接 2、公开CRM内部接口提供给有赞（商城调用） 3、封装调用WMS、SAP、CMS接口

二、代码运行截图

三、接口说明

1.CMS接口

类地址	类名	类说明	请求方式	方法地址	方法名	方法说明
/api/cms/contract	CmsContractController	cms对接合同	POST	/pass	pass	合同审核通过
			POST	/close	close	合同关闭

2.SAP接口

类地址	类名	类说明	请求方式	方法地址	方法名	方法说明
/api/sap/allot	SapAllotController	sap对接分布式调拨单	POST	/callback/update	updateBySap	更新调拨单状态(SAP调用)
			POST	/sync	sync	调拨单调入后同步到SAP
/api/sap/cancelOrder	SapCancelOrderController	sap对接退货订单	POST	/save	saveCancelOrder	新增退货订单
			POST	/delete	delete	删除退货订单
			POST	/delete/atom	deleteAtom	删除(原子性)
/api/sap/client	SapClientController	sap对接客户	POST	/save	saveClient	新建客户
			POST	/update	updateClient	修改客户
			POST	/delete	deleteClient	删除客户
			POST	/freeze	freezeClient	冻结客户
			POST	/unFreeze	unFreezeClient	解冻客户
			POST	/partialUpdate	partialUpdate	sap更新客户或组织信息后调用
			POST	/updateBatch	updateBatch	批量修改客户
			POST	/syncClient	syncClient	初始化客户
			POST	/addRelation	addRelation	增加关联
			GET	/selectSapCodeByClientCode	selectSapCodeByClientCode	根据客户编码查询客户的sap编码
			POST	/saveClientSap	saveClientSap	保存客户sap关联
			POST	/batchSave	batchSaveClientOrg	基于组织关联批量保存客户sap关联
			POST	/batchSaveClientSap	batchSaveClientSap	基于客户关联批量保存客户sap关联
			GET	/getSapClientCode	getSapOrderCode	通过CRM客户编码查询对应的SAP客户编号
			POST	/batchImport	batchImport	批量插入sap客户关联
			POST	/getSapCode	getSapCode	查询sap编码
/api/sap/exchange	SapExchangeController	sap对接汇率	POST	/getExchange	saveCancelOrder	月初调取记账汇率
/api/sap/instrumentPut	SapInstrumentPutController	sap对接其他出库单	POST	/save	saveInstrumentPut	建立资产卡片，新增其他出库单
			POST	/saveQtckd	saveQtckd	新增其他出库单
			POST	/update	update	更新单据数据（sap调用）
/api/sap/invoice	SapInvoiceController	sap对接发票	POST	/save	saveInvoice	新增
			POST	/writeOff	writeOffInvoice	冲销
			POST	/update	updateInvoice	更新发票
			POST	/importUpdate	importUpdate	导入更新发票
/api/sap/invoiceLost	SapInvoiceLostController	sap对接发票丢失	POST	/pushOtherIn	pushOtherIn	发票丢失下推退换货退回订单
			POST	/lost/delete	deleteLost	删除发票丢失下推的退换货退回订单
/api/sap/moneyBack	SapMoneyBackController	sap对接收款单	POST	/push	push	收款单数据推送
/api/sap/orderErp	SapOrderErpController	sap对接订单	POST	/save	saveOrderErp	新增订单
			POST	/update	updateOrderErp	修改订单
			POST	/close	closeOrderErp	关闭订单
			POST	/delete	deleteOrderErp	删除订单
			POST	/modifySale	modifySales	更新订单销售员
			POST	/importRelation	importRelation	导入订单关联
			GET	/getSapOrderCode	getSapOrderCode	通过CRM订单编号查询对应的SAP订单编号
/api/sap/org	SapOrgController	sap对接组织	POST	/save	saveOrg	新增组织
			POST	/update	updateOrg	修改组织
			GET	/getSapOrgCode	getSapOrderCode	通过CRM客户编码查询对应的SAP客户编号
			POST	/batchImport	batchImport	批量插入sap组织关联
/api/sap/product	SapProductController	sap对接物料	POST	/syn	syn	sap同步物料到crm
			POST	/getSapCode	getSapCode	通过crm的productCode集合查询出SAP的productCode
			POST	/getSapBusiCodeMap	getSapBusiCodeMap	通过SAP的productCode集合查询出crm的productCode
/api/sap/production	SapProductionController	sap对接定制生产	POST	/save	save	新增
/api/sap/purchaseOrder	SapPurchaseOrderController	sap对接采购订单	POST	/save	save	采购订单
/api/sap/receivable	SapReceivableController	sap对接应收单	POST	/save	saveReceivable	新增
			POST	/writeOff	writeOffReceivable	冲销
			GET	/checkWhetherExist	checkWhetherExist	检查应收单是否存在关联
			GET	/getSapCode	getSapCode	根据crm单号查询sap应收单号
/api/sap/refund	SapRefundController	sap对接退款单	POST	/save	saveRefund	新增
			POST	/update	update	退款单状态回传接口
/api/sap/returns	SapReturnsController	sap对接退换货	POST	/back	back	退换货-退货
			POST	/send	send	退换货-发货
			POST	/send/modify	modifySend	退换货-发货修改
			POST	/send/delete	deleteSend	退换货-发货删除
			GET	/send/unAudit	unAuditSend	退换货-发货反审核(办事处发货)
			POST	/back/chargeAgainstBackStockOut	chargeAgainstBackStockOut	退换货-退回出库单核销
			POST	/back/deleteBackStockOut	deleteBackStockOut	退换货-删除退换货退回出库单
			POST	/back/deleteBackOrder	deleteBackOrder	退换货-删除退换货退回订单
			POST	/send/deleteWmsSendStockOut	deleteWmsSendStockOut	退换货-发货WMS出库单删除
			POST	/send/chargeAgainstSendStockOut	chargeAgainstBackStockOut	退换货-发货出库单核销
			POST	/send/deleteSendStockOut	deleteSendStockOut	退换货-删除退换货发货出库单
			POST	/send/deleteSendOrder	deleteSendOrder	退换货-删除退换货发货订单
/api/sap/scrapApply	SapScrapApplyController	sap对接报废	POST	/save	save	新增
/api/sap/stock	SapStockController	sap对接库存	GET	/usableStockCalculate	usableStockCalculate	可用库存计算
			POST	/usableStockCalculateBatch	usableStockCalculateBatch	批量可用库存计算
			POST	/usableStockCalculateBatchGift	usableStockCalculateBatchGift	批量可用库存计算
			POST	/instantStockQuery	instantStockQuery	即时库存查询
			POST	/instantStockQueryNoLotnum	instantStockQueryNoLotnum	无批次即时库存查询(礼品库存)
			POST	/instantStockQueryAll	instantStockQueryAll	即时库存查询所有
/api/sap/stockingApply	SapStockingApplyController	备货申请	POST	/save	saveStockingApply	新增备货申请
			POST	/delete	deleteStockingApply	删除备货申请
/api/sap/stockOut	SapStockOutController	sap对接出库单	POST	/save	saveStockOut	新增
			POST	/update	updateStockOut	修改
			POST	/delete	deleteStockOut	删除
			POST	/deleteByReturns	deleteStockOutByReturns	退货业务删除出库单
			POST	/posting	postingStockOut	过账
			POST	/chargeAgainst	chargeAgainstStockOut	冲销
			POST	/unAudit	unAudit	反审核
			GET	/getSapStockOutCode	getSapOrderCode	通过CRM出库单编码查询对应的SAP出库单编号
			POST	/delete/atom	deleteAtom	删除(原子性)
			POST	/sureIn	sureIn	确认入库
			POST	/confirm	confirm	报关
			POST	/getSapCode	getSapCode	查询sap编码
/api/sap/storehouse	SapStorehouseController	sap对接仓库	GET	/querySapStoreHouse	querySapStoreHouse	查询SAP所有仓库信息
/api/sap/writeOff	SapWriteOffController	sap对接收款确认单	POST	/save	saveWriteOff	新增

3.wms接口

类地址	类名	类说明	请求方式	方法地址	方法名	方法说明
/api/wms/allow	WmsAllotController	sap对接分布式调拨单	GET	/queryExpress	queryExpress	查询wms快递信息
/api/wms/returns	WmsReturnsController	wms对接退换货	GET	/verification	verification	退换货总部发货的出库单锁单
			POST	/send/updateStatus	updateSendStatus	更新退换货总部发货出库单状态
/api/wms/stockOut	WmsStockOutController	wms对接出库单	POST	/save	saveStockOut	新增
			POST	/update	updateStockOut	修改
			POST	/verification	verificationStockOut	校验、锁单、取消拣配
			POST	/updateStatus	updateStatus	更新CRM出库单状态
			POST	/signIn	signIn	签收（总部出库单-签收）
			POST	/delte/atom	deleteAtom	删除(原子性)

4.有赞（商城）接口

类地址	类名	类说明	请求方式	方法地址	方法名	方法说明
/api/youzan/order	OrderController	订单控制器	POST	/list	orderList	订单列表（有赞）
			POST	/detail	orderDetail	订单详情（有赞）
/api/youzan/preorder	PreorderController	预付款订单查询控制器	POST	/list	listByQuery	客户预付款订单列表查询接口
			POST	/detail	getDetailByQuery	客户预付款订单使用详情查询接口
/api/youzan/imprest	PreorderImprestController	预付款余额查询控制器	POST	/	imprest	客户预付款余额查询接口
/api/youzan/user	UserController	用户控制器	POST	/list	userList	用户列表查询接口（有赞）

四**、核心业务流程图**

五、数据库

主要表截图如下：