# 第三方对接模块拆解分析 ## 一、功能描述 1、管理与第三方对接 2、公开CRM内部接口提供给有赞（商城调用） 3、封装调用WMS、SAP、CMS接口 ## **二、代码运行截图** ![输入图片说明](/imgs/2024-03-04/HVoCHBGtzM3aH5wz.png)![](https://dev.rzdata.net/download/attachments/51773469/image2024-2-17_15-29-8.png?version=1&modificationDate=1708154949000&api=v2) ## **三、接口说明** ### **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 GET /queryExpress queryExpress 查询wms快递信息
/api/wms/returns WmsReturnsController wms对接退换货 GET GET /verification verification 退换货总部发货的出库单锁单
POST POST /send/updateStatus updateSendStatus 更新退换货总部发货出库单状态
/api/wms/stockOut WmsStockOutController wms对接出库单 POST /save POST /save saveStockOut 新增
POST POST /update updateStockOut 修改
POST POST /verification verificationStockOut 校验、锁单、取消拣配
POST 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 用户列表查询接口（有赞）
## **四****、核心业务流程图** ![输入图片说明](/imgs/2024-02-26/LPC0C9tERb6GoMlc.png) ![输入图片说明](/imgs/2024-02-26/d3yyayaHpB9LMExf.png) ![输入图片说明](/imgs/2024-02-26/sKcVPGrNUG6UvoOJ.png) ## **五、数据库** ****主要表截图如下：**** ![输入图片说明](/imgs/2024-02-26/NjYsBWQFIP65rU4j.png)class="confluenceTd">POST /signIn signIn 签收（总部出库单-签收） POST /delte/atom deleteAtom 删除(原子性)