金蝶云星空和管易云单据接口对接源系统:管易云管易云是上海管易云计算软件有限公司旗下的专注提供电商企业管理软件服务的品牌，总部位于中国上海张江高科技产业园区。管易云旗下拥有管易云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组织及交付能力。

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

刘培强qeasy

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

源系统:管易云

管易云是上海管易云计算软件有限公司旗下的专注提供电商企业管理软件服务的品牌，总部位于中国上海张江高科技产业园区。管易云旗下拥有管易云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组织及交付能力。