金蝶云星空和管易云单据接口对接

金蝶云星空和管易云单据接口对接

源系统:管易云

管易云是上海管易云计算软件有限公司旗下的专注提供电商企业管理软件服务的品牌，总部位于中国上海张江高科技产业园区。管易云旗下拥有管易云C-ERP、EC-OMS、EC-WMS、B2C/B2B/BBC/微商城开发、PDA无纸化仓储解决方案、新零售一体化解决方案等产品

目标系统:金蝶云星空

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

接口方案配置

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：管易云的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：金蝶云星空，把获取的数据组装成目标系统需要的格式进行写入。
 

 

管易云接口明细

• 接口：gy.erp.trade.get
• 接口名称：订单查询
• 接口方法：POST

请求参数

字段	名称	类型	描述
start_date	开始时间	string
end_date	结束时间	string
date_type	时间类型	string
order_state	订单类型	string
warehouse_code	仓库代码	string
shop_code	店铺代码	string
vip_name	会员名称	string
platform_code	平台单号	string
receiver_mobile	收件手机	string
code	单据编号	string
has_cancel_data	是否附带返回已取消与已删除的订单数据	string
page_size	分页大小	string	默认为10
page_no	页号	string	默认1

响应参数

字段	名称	类型	描述
id	id	string
hold_info	拦截信息	string
code	单据编号	string
tax_amount	税额	string
payment	支付金额	string
approve	是否审核	string
cod	是否货到付款	string
vipIdCard	身份证号	string
vipEmail	电子邮箱	string
vipRealName	真实姓名	string
accountStatus	到账状态	string
accountAmount	到账金额	string
assignState	配货状态	string
platform_code	平台单号	string
createtime	创建时间	string
modifytime	修改时间	string
dealtime	拍单时间	string
paytime	支付时间	string
shop_name	店铺名称	string
shop_code	店铺代码	string
warehouse_name	仓库名称	string
warehouse_code	仓库代码	string
express_name	快递公司名称	string
express_code	快递公司代码	string
vip_name	会员名称	string
vip_code	会员代码	string
receiver_name	收货人姓名	string
receiver_phone	收货人电话	string
receiver_mobile	收货人手机	string
receiver_zip	收货邮编	string
receiver_address	收货地址	string
receiver_area	地区信息	string
buyer_memo	买家留言	string
seller_memo	卖家备注	string
seller_memo_late	二次备注	string
cod_fee	货到付款服务费	string
post_cost	物流成本	string
weight_origin	标准重量	string
payment_amount	商品总金额	string
business_man	业务员	string
extend_memo	附加信息	string
delivery_state	发货状态	string
order_type_name	订单类型	string
platform_flag	平台旗帜	string
approveDate	审核时间	string
accountDate	到账时间	string
trade_tag_code	订单标记代码	string
trade_tag_name	订单标记名称	string
plan_delivery_date	预计发货时间	string
platform_trading_state	平台交易状态	string
substitut_order	非代发	string
details	商品列表	array
details.oid	子订单号	string
details.qty	数量	string
details.price	实际单价	string
details.amount	实际金额	string
details.note	备注	string
details.cancel	是否取消	string
details.item_code	商品代码	string
details.item_name	商品名称	string
details.item_simple_name	商品简称	string
details.sku_name	规格名称	string
details.sku_code	规格代码	string
details.post_fee	物流费用	string
details.discount_fee	让利金额	string
details.amount_after	让利后金额	string
details.refund	退款状态	string
details.platform_item_name	平台规格名称	string
details.platform_sku_name	平台规格代码	string
details.sku_note	商品备注	string

金蝶云星空接口明细

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

请求参数

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

系统打通概况

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