金蝶云星空对接打通赛意SMOM委外退料单接口与保存ASN数据接口

金蝶云星空对接打通赛意SMOM委外退料单接口与保存ASN数据接口

​编辑

对接源平台:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

接入系统：赛意SMOM

赛意信息旗下产品-赛意制造运营管理系统SMOM产品通过华为云云商店考核，正式入驻华为云商店联营商品。通过联营联运模式，双方合作能够深入产品、解决方案、生态等多个领域。

数据对接方案

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：金蝶云星空，源系统 API：委外退料单，目标系统：赛意SMOM，目标系统 API保存ASN数据。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
​编辑
​编辑

金蝶云星空接口明细

• 调用接口：executeBillQuery
• 接口名称：委外退料单
• 方法：POST

请求参数

字段	字段名称	类型	配置值
FID	实体主键	string	FID
FBillNo	单据编号	string	FBillNo
FDocumentStatus	单据状态	string	FDocumentStatus
FApproverId	审核人	string	FApproverId
FApproveDate	审核日期	string	FApproveDate
FModifierId	修改人	string	FModifierId
FCreateDate	创建日期	string	FCreateDate
FCreatorId	创建人	string	FCreatorId
FModifyDate	修改日期	string	FModifyDate
FCancelDate	作废日期	string	FCancelDate
FCanceler	作废人	string	Fcanceler
FCancelStatus	作废状态	string	FCancelStatus
FDescription	备注	string	FDescription
FBillType	单据类型	string	FBillType.FNUMBER
FStockOrgId	收料组织	string	FStockOrgId.Fnumber
FOwnerId0	货主	string	FOwnerId0.Fnumber
FStockId0	仓库	string	FStockId0.Fnumber
Fdate	日期	string	Fdate
FSubOrgId	委外组织	string	FSubOrgId.Fnumber
FSubSupplierId	供应商	string	FSubSupplierId.Fnumber
FOwnerTypeId0	货主类型	string	FOwnerTypeId0
FCurrId	本位币	string	FCurrId.Fnumber
FTransferBizType	跨组织业务类型	string	FTransferBizType
FSTOCKERID	仓管员	string	FSTOCKERID.Fnumber
FReturnerId	退料人	string	FReturnerId.Fnumber
FIsCrossTrade	跨法人交易	string	FIsCrossTrade
FVmiBusiness	VMI业务	string	FVmiBusiness
FSourceType	倒冲来源	string	FSourceType
FIsOwnerTInclOrg	货主含组织	string	FIsOwnerTInclOrg
FMaterialId	物料编码	string	FMaterialId.Fnumber
FPPBOMEntryId	委外用料清单分录ID	string	FPPBOMEntryId
FMaterialName	物料名称	string	FMaterialName
FSpecification	规格型号	string	FSpecification
FUnitID	单位	string	FUnitID.Fnumber
FBomId	BOM版本	string	FBomId
FAPPQty	申请数量	string	FAPPQty
FQty	实退数量	string	FQty
FSelRePickedQty	补料选单数	string	FSelRePickedQty
FReturnType	退料类型	string	FReturnType
FReturnReason	退料原因	string	FReturnReason
FStockId	仓库	string	FStockId.Fnumber
FStockLocId	仓位	string	FStockLocId
FSUBReqBillNo	委外订单	string	FSUBReqBillNo
FSUBReqId	委外订单ID	string	FSUBReqId
FSUBReqEntrySeq	委外订单行号	string	FSUBReqEntrySeq
FSubReqEntryId	委外订单分录ID	string	FSubReqEntryId
FAuxPropId	辅助属性	string	FAuxPropId
FOwnerTypeId	货主类型	string	FOwnerTypeId
FOwnerId	货主	string	FOwnerId.Fnumber
FSrcBillType	系统源单类型	string	FSrcBillType
FSrcBillNo	系统源单编号	string	FSrcBillNo
FSrcBillId	系统源单内码	string	FSrcBillId
FSrcEntrySeq	系统源单行号	string	FSrcEntrySeq
FSrcEntryId	系统源单分录内码	string	FSrcEntryId
FBaseUnitId	基本单位	string	FBaseUnitId.Fnumber
FBaseSelRePickedQty	基本单位补料选单数	string	FBaseSelRePickedQty
FBaseAppQty	基本单位申请数量	string	FBaseAppQty
FBaseQty	基本单位实退数量	string	FBaseQty
FStockUnitId	主库存单位	string	FStockUnitId.Fnumber
FStockAppQty	主库存申请数量	string	FStockAppQty
FStockQty	主库存实退数量	string	FStockQty
FSecUnitId	辅库存单位	string	FSecUnitId
FSecStockQty	辅库存实退数量	string	FSecStockQty
FMtoNo	计划跟踪号	string	FMtoNo
FStockStatusId	库存状态	string	FStockStatusId.Fnumber
FProduceDate	生产日期	string	FProduceDate
FExpPeriod	保质期	string	FExpPeriod
FExpiryDate	有效期至	string	FExpiryDate
FKeeperTypeId	保管者类型	string	FKeeperTypeId
FKeeperId	保管者	string	FKeeperId.Fnumber
FOperId	工序号	string	FOperId
FProcessId	作业	string	FProcessId
FMemo	备注	string	FMemo
FPrice	成本价	string	FPrice
FAmount	总成本	string	FAmount
FStockFlag	更新库存标志位	string	FStockFlag
FLot	批号	string	FLot
FPPBomBillNo	委外用料清单编号	string	FPPBomBillNo
FParentOwnerTypeId	产品货主类型	string	FParentOwnerTypeId
FParentOwnerId	产品货主	string	FParentOwnerId.Fnumber
FSRCBIZBILLTYPE	业务源单类型	string	FSRCBIZBILLTYPE
FSRCBIZBILLNO	业务源单编号	string	FSRCBIZBILLNO
FSRCBIZINTERID	业务源单内码	string	FSRCBIZINTERID
FSRCBIZENTRYID	业务源单分录内码	string	FSRCBIZENTRYID
FSRCBIZENTRYSEQ	业务源单行号	string	FSRCBIZENTRYSEQ
FBFLowId	业务流程	string	FBFLowId
FParentMaterialId	产品编码	string	FParentMaterialId
FSNUnitID	序列号单位	string	FSNUnitID.Fnumber
FSNQty	序列号单位数量	string	FSNQty
FReserveType	预留类型	string	FReserveType
FSettleOrgId	结算组织	string	FSettleOrgId
FBaseStockQty	主库存基本单位实退数量	string	FBaseStockQty
FConsome	消耗汇总	string	FConsome
FEntryVmiBusiness	VMI业务	string	FEntryVmiBusiness
FReqSrc	需求来源	string	FReqSrc
FReqBillNo	需求单据	string	FReqBillNo
FReqBillId	需求单据内码	string	FReqBillId
FReqEntrySeq	需求单据行号	string	FReqEntrySeq
FReqEntryId	需求单据分录内码	string	FReqEntryId
FPOOrderBillNo	采购订单	string	FPOOrderBillNo
FPOOrderSeq	采购订单行号	string	FPOOrderSeq
FSupplierId	供应商	string	FSupplierId.Fnumber
FIsUpdateQty	不更新未领	string	FIsUpdateQty
FEntity_FEntryID	FEntity_FEntryID	string	FEntity_FEntryID
Limit	最大行数	string	{{PAGINATION_PAGE_SIZE}}
StartRow	开始行索引	string	{{PAGINATION_START_ROW}}
TopRowCount	返回总行数	int
FilterString	过滤条件	string	FApproveDate>='2022-09-09 00:00:00'
FieldKeys	需查询的字段key集合	array
FormId	业务对象表单Id	string	SUB_RETURNMTRL

响应参数

字段	字段名称	类型	配置值
FID	实体主键	string
FBillNo	单据编号	string
FDocumentStatus	单据状态	string
FApproverId	审核人	string
FApproveDate	审核日期	string
FModifierId	修改人	string
FCreateDate	创建日期	string
FCreatorId	创建人	string
FModifyDate	修改日期	string
FCancelDate	作废日期	string
FCanceler	作废人	string
FCancelStatus	作废状态	string
FDescription	备注	string
FBillType	单据类型	string
FStockOrgId	收料组织	string
FOwnerId0	货主	string
FStockId0	仓库	string
Fdate	日期	string
FSubOrgId	委外组织	string
FSubSupplierId	供应商	string
FOwnerTypeId0	货主类型	string
FCurrId	本位币	string
FTransferBizType	跨组织业务类型	string
FSTOCKERID	仓管员	string
FReturnerId	退料人	string
FIsCrossTrade	跨法人交易	string
FVmiBusiness	VMI业务	string
FSourceType	倒冲来源	string
FIsOwnerTInclOrg	货主含组织	string
FMaterialId	物料编码	string
FPPBOMEntryId	委外用料清单分录ID	string
FMaterialName	物料名称	string
FSpecification	规格型号	string
FUnitID	单位	string
FBomId	BOM版本	string
FAPPQty	申请数量	string
FQty	实退数量	string
FSelRePickedQty	补料选单数	string
FReturnType	退料类型	string
FReturnReason	退料原因	string
FStockId	仓库	string
FStockLocId	仓位	string
FSUBReqBillNo	委外订单	string
FSUBReqId	委外订单ID	string
FSUBReqEntrySeq	委外订单行号	string
FSubReqEntryId	委外订单分录ID	string
FAuxPropId	辅助属性	string
FOwnerTypeId	货主类型	string
FOwnerId	货主	string
FSrcBillType	系统源单类型	string
FSrcBillNo	系统源单编号	string
FSrcBillId	系统源单内码	string
FSrcEntrySeq	系统源单行号	string
FSrcEntryId	系统源单分录内码	string
FBaseUnitId	基本单位	string
FBaseSelRePickedQty	基本单位补料选单数	string
FBaseAppQty	基本单位申请数量	string
FBaseQty	基本单位实退数量	string
FStockUnitId	主库存单位	string
FStockAppQty	主库存申请数量	string
FStockQty	主库存实退数量	string
FSecUnitId	辅库存单位	string
FSecStockQty	辅库存实退数量	string
FMtoNo	计划跟踪号	string
FStockStatusId	库存状态	string
FProduceDate	生产日期	string
FExpPeriod	保质期	string
FExpiryDate	有效期至	string
FKeeperTypeId	保管者类型	string
FKeeperId	保管者	string
FOperId	工序号	string
FProcessId	作业	string
FMemo	备注	string
FPrice	成本价	string
FAmount	总成本	string
FStockFlag	更新库存标志位	string
FLot	批号	string
FPPBomBillNo	委外用料清单编号	string
FParentOwnerTypeId	产品货主类型	string
FParentOwnerId	产品货主	string
FSRCBIZBILLTYPE	业务源单类型	string
FSRCBIZBILLNO	业务源单编号	string
FSRCBIZINTERID	业务源单内码	string
FSRCBIZENTRYID	业务源单分录内码	string
FSRCBIZENTRYSEQ	业务源单行号	string
FBFLowId	业务流程	string
FParentMaterialId	产品编码	string
FSNUnitID	序列号单位	string
FSNQty	序列号单位数量	string
FReserveType	预留类型	string
FSettleOrgId	结算组织	string
FBaseStockQty	主库存基本单位实退数量	string
FConsome	消耗汇总	string
FEntryVmiBusiness	VMI业务	string
FReqSrc	需求来源	string
FReqBillNo	需求单据	string
FReqBillId	需求单据内码	string
FReqEntrySeq	需求单据行号	string
FReqEntryId	需求单据分录内码	string
FPOOrderBillNo	采购订单	string
FPOOrderSeq	采购订单行号	string
FSupplierId	供应商	string
FIsUpdateQty	不更新未领	string
FEntity_FEntryID	FEntity_FEntryID	string

赛意SMOM接口明细

• API：SmomWebApiController.SaveAsns
• NAME：保存ASN数据
• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
No	编码	{{FBillNo}}
ErpId	ErpId	{{Id}}
OrderType	订单类型	98
WarehouseCode	仓库编码	{{details.FStockId}}
DeliveryDate	发货日期	{{Fdate}}
Contacts	联系人
CustomerCode	客户编码
EnterpriseCode	企业编码
SupplierCode	供应商编码	{{FSubSupplierId}}
ShipperCode	承运商编码
AsnState	Asn状态
Remark	备注
ErpKey	ErpKey	{{Id}}
Code	代码	{{FBillNo}}
Name	名称	金蝶委外退料单
Infkey	Infkey
IsDelete	是否删除	false
LastUpdateDate	最近更新时间	0001-01-01T00:00:00+08:00
DetailList	明细列表	details
DetailList.LineNo	行号	{{details.FEntity_FEntryID}}
DetailList.ItemCode	商品编码	{{details.FMaterialId}}
DetailList.PurchaseExpectQty	数量	{{details.FQty}}
DetailList.ErpId	ErpId	{{Id}}
DetailList.OrderNo	订单编码	{{Id}}
DetailList.PoNo	PoNo	{{Id}}
DetailList.PoDetailLineNo	Po明细编码	{{Id}}
DetailList.AsnState	Asn状态
DetailList.ErpKey	ErpKey	{{Id}}
DetailList.Remark	备注	来自金蝶
DetailList.Code	代码	{{FBillNo}}
DetailList.LotAtt01	批次属性1
DetailList.LotAtt02	批次属性2
DetailList.LotAtt03	批次属性3
DetailList.LotAtt04	批次属性4
DetailList.LotAtt05	批次属性5
DetailList.Infkey	Infkey
DetailList.Name	商品名称
DetailList.IsDelete	是否删除	false
DetailList.LastUpdateDate	最近更新时间	0001-01-01T00:00:00+08:00
DetailList.ReceiveStorageLocationCode	明细仓库编码	{{details.FStockId}}
DetailList.Thatokid	明细ID	{{details.FEntity_FEntryID}}
DetailList.ExpectQty	预期数量	{{details.FQty}}
DetailList.ActualQty	实到数量	{{details.FQty}}
DetailList.TransactionCode	单据小类	WWTLD01_SYS
DetailList.Headid	表头ID	{{FID}}
DetailList.EnterpriseCode	部门编码

系统数据集成价值

全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：赛意SMOM与金蝶云星空之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。
​编辑