管易云和金蝶云星空接口打通对接实战

管易云和金蝶云星空接口打通对接实战

接入系统：管易云

金蝶管易云是金蝶集团旗下以电商和新零售为核心业务的子公司，公司于2008年成立，拥有从事电商及新零售业务相关专业知识工作者超过1000人。为伊利、网易有道、东阿阿胶、金龙鱼、海康、科大讯飞等超过110000家企业客户提供专业服务，用户数超过100万人。金蝶管易云与淘宝、天猫、京东、拼多多、抖音等超过150+主流电商平台建立合作关系。

目标系统:金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

多系统对接方案配置

通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将管易云、金蝶云星空之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，Web界面追踪调试日志等功能。 平台兼具实时数据处理和数据集成分发功能，用户通过可视化的拖、拽即可完成数据处理逻辑，将数据加工处理后分发到下游业务系统或其他异构存储中。

 

管易云接口明细

• API：gy.erp.kingdeecloud.delivery.orders.querybydate
• NAME：发货单查询2.0
• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
start_date	创建时间开始段	2022-04-12 00:00:00
end_date	创建时间结束段	2022-04-13 00:00:00
del	返回是否作废的单据
delivery	发货状态	1
shop_code	店铺代码
page_size	分页大小	{{PAGINATION_PAGE_SIZE}}	默认为10
page_no	页号	{{PAGINATION_START_PAGE}}	默认1
detailApi	详情查询api
detailApi.api	api	gy.erp.kingdeecloud.delivery.details.querybycode

响应参数

接口字段	字段名称	预设值	描述
code	单据编号	SDO468846236532
tagName	标记名
tagCode	标记码
shop_code	店铺代码
warehouse_code	仓库代码
delivery_time	交货时间
platform_code	平台单号
vip_code	会员代码
vip_name	会员名称
receiver_name	收货人姓名
receiver_phone	收货人电话
receiver_mobile	审核人
area_name	收货地区
receiver_address	收货地址
express_code	快递公司代码
express_name	快递公司名称
express_no	快递单号
listId	列表Id
detailApi	详细Api
details	商品列表
details.qty	商品数量
details.price	实际单价
details.amount	商品总价
details.memo	备注
details.batchs	批次
details.sns	社交网络
details.goods_id	商品标识
details.is_gift	是否赠品
details.discount_fee	让利金额
details.amount_after	让利后金额
details.post_fee	物流费用
details.post_cost	物流成本
details.tax_rate	税率
details.cost_price	成本价
details.trade_code	销售订单号
details.platform_code	平台单号
details.other_service_fee	其他服务费
details.tax_amount	税额

金蝶云星空接口明细

• API：batchSave
• NAME：销售出库新增
• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FBillTypeID	单据类型	XSCKD01_SYS	单据类型
FBillNo	单据编号	{{code}}	单据编号
FDate	日期	{{delivery_time}}	日期
FSaleOrgId	销售组织	100	组织
FCustomerID	客户	{{shop_code}}	基础资料
FBranchId	销售门店		基础资料
FSaleDeptID	销售部门	{{shop_code}}	基础资料
FCorrespondOrgId	对应组织	100	组织
FCarrierID	承运商		基础资料
FCarriageNO	运输单号		文本
FSalesGroupID	销售组		基础资料
FSalesManID	销售员		基础资料
FStockOrgId	发货组织	100	组织
FDeliveryDeptID	发货部门		基础资料
FLinkPhone	联系电话		文本
FLinkMan	收货人姓名		文本
FStockerID	仓管员		基础资料
FNote	备注		多行文本
FReceiverID	收货方		基础资料
FReceiveAddress	收货方地址		文本
FSettleID	结算方		基础资料
FReceiverContactID	收货方联系人		基础资料
FPayerID	付款方		基础资料
FOwnerTypeIdHead	货主类型	BD_OwnerOrg	多类别基础资料列表
FSHOPNUMBER	网店编码		文本
FSALECHANNEL	销售渠道		文本
FOwnerIdHead	货主	100	多类别基础资料
SubHeadEntity	财务信息
SubHeadEntity.FSettleOrgID	结算组织	100	组织
SubHeadEntity.FSettleTypeID	结算方式		基础资料
SubHeadEntity.FReceiptConditionID	收款条件		基础资料
SubHeadEntity.FBuyerNick	会员名称		文本
SubHeadEntity.FReceiverAddress	收货人地址		文本
SubHeadEntity.FReceiverName	收货人		文本
SubHeadEntity.FReceiverMobile	收货人手机		文本
SubHeadEntity.FReceiverCountry	收货人国家		文本
SubHeadEntity.FReceiverState	收货人省份		文本
SubHeadEntity.FReceiverCity	收货人城市		文本
SubHeadEntity.FReceiverDistrict	收货人地区		文本
SubHeadEntity.FReceiverPhone	收货人电话		文本
SubHeadEntity.FVIPCODE	会员编码		文本
SubHeadEntity.FEntity	明细信息
SubHeadEntity.FEntity.FCustMatID	客户物料编码		基础资料
SubHeadEntity.FEntity.FMaterialID	物料编码	{{details.details_goods_code}}	基础资料
SubHeadEntity.FEntity.FBarcode	零售条形码		文本
SubHeadEntity.FEntity.FRealQty	实发数量	{{details.details_batchs_qty}}	数量
SubHeadEntity.FEntity.FPrice	单价		单价
SubHeadEntity.FEntity.FTaxPrice	含税单价		单价
SubHeadEntity.FEntity.FIsFree	是否赠品		复选框
SubHeadEntity.FEntity.FLot	批号	{{details.details_batchs_batch}}	批次
SubHeadEntity.FEntity.FProduceDate	生产日期	{{details.details_batchs_product_date}}	日期
SubHeadEntity.FEntity.FExpiryDate	有效期至	{{details.details_batchs_expire_date}}	日期
SubHeadEntity.FEntity.FEntryTaxRate	税率%	_function {{details.details_tax_rate}} * (100)	小数
SubHeadEntity.FEntity.FEntryTaxAmount	税额		金额
SubHeadEntity.FEntity.FAmount	金额		金额
SubHeadEntity.FEntity.FAllAmount	价税合计	{{details.details_amount_after}}	金额
SubHeadEntity.FEntity.FStockID	仓库	{{warehouse_code}}	基础资料
SubHeadEntity.FEntity.FStockLocID	仓位		维度关联字段
SubHeadEntity.FEntity.FStockStatusID	库存状态		基础资料
SubHeadEntity.FEntity.FMtoNo	计划跟踪号		文本
SubHeadEntity.FEntity.FEntrynote	备注	{{details.details_memo}}	文本
SubHeadEntity.FEntity.FSoorDerno	订单单号		文本
SubHeadEntity.FEntity.FDiscountRate	折扣率%		小数
SubHeadEntity.FEntity.FEntity_Link	关联关系表
SubHeadEntity.FEntity.FEntity_Link_FRuleId	转换规则		SaleOrder-OutStock T_SAL_ORDERENTRY DeliveryNotice-OutStock T_SAL_DELIVERYNOTICEENTRY
SubHeadEntity.FEntity.FEntity_Link_FSTableName	源单表
SubHeadEntity.FEntity.FEntity_Link_FSBillId	源单内码
SubHeadEntity.FEntity.FEntity_Link_FSId	源单分录内码
SubHeadEntity.FEntity.FormId	业务对象表单Id	SAL_OUTSTOCK	必须填写金蝶的表单ID如 UR_PurchaseOrder
SubHeadEntity.FEntity.Operation	执行的操作	Save
SubHeadEntity.FEntity.IsAutoSubmitAndAudit	提交并审核	false
SubHeadEntity.FEntity.IsVerifyBaseDataField	验证基础资料	false	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
SubHeadEntity.FEntity.SubSystemId	系统模块	21	默认仓库模块

系统对接总览

从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通管易云到金蝶云星空之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。