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

数据源平台:管易云

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

接入系统：金蝶云星空

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

数据接口配置方案

通过系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：管易云，然后选择对应的连接器。选择对应的gy.erp.trade.deliverys.get作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。

管易云接口明细

调用接口：gy.erp.trade.deliverys.get
接口名称：发货单查询
方法：POST

请求参数

字段字段名称类型配置值 start_create创建时间开始段string end_create创建时间结束段string start_delivery_date发货时间开始段string{{LAST_SYNC_TIME datetime}} end_delivery_date发货时间结束段string{{CURRENT_TIME datetime}} start_ modify_date修改时间开始段string end_ modify_date修改时间结束段string del返回是否作废的单据string delivery发货状态string1 code单据编号string page_size分页大小string{{PAGINATION_PAGE_SIZE}} page_no页号string{{PAGINATION_START_PAGE}}

响应参数

字段字段名称类型配置值 ididstring code单据编号string warehouse_code仓库代码string shop_code店铺代码string outer_code平台单号string print打印状态string scan扫描状态string delivery发货状态string cod货到付款状态string vip_name会员名称string create_date制单时间string modify_date修改时间string delivery_date发货时间string cancel取消状态string payment已付金额string pay_time支付时间string invoiceDate确认开票时间string bigchar大头笔string unpaid_amount未付金额string cod_fee货到付款服务费string post_cost物流成本string plan_delivery_date预计发货时间string buyer_memo买家留言string seller_memo卖家备注string receiver_name收货人姓名string receiver_phone收货人电话string receiver_mobile收货人手机string receiver_zip收货邮编string receiver_address收货地址string create_name制单人string express_no快递单号string shop_name店铺名称string area_name收货地区string warehouse_name仓库名称string location_code库位代码string express_code快递公司代码string express_name快递公司名称string tag_name订单标记名称string seller_memo_late二次备注string shelf_no格子号string details商品列表array details.qty商品数量string details.price实际单价string details.amount商品总价string details.refund退款状态string details.itemCategoryName商品类别名称string details.itemUnitName商品单位string details.barcode商品条码string details.tariff关税string details.memo备注string details.picUrl图片地址string details.oid子订单号string details.trade_code销售订单号string details.item_id商品IDstring details.item_sku_id规格IDstring details.item_code商品代码string details.item_name商品名称string details.sku_code规格代码string details.sku_name规格名称string details.sku_note商品的规格备注string details.discount_fee让利金额string details.amount_after让利后金额string details.post_fee物流费用string details.order_type订单类型string details.platform_flag平台旗帜string details.detail_unique唯一码列表string details.detail_batch批次列表array details.is_gift是否赠品string details.businessman_name业务员string details.platform_code平台单号string details.tax_rate税率string details.tax_amount税额string details.tax_no税号string details.other_service_fee其他服务费string details.gift_source_view赠品来源string details.currency_code币别代码string details.currency_name币别名称string details.detail_batch批次列表array details.detail_batch.batchNumber批次号string details.detail_batch.qty数量string details.detail_batch.productionTime生产日期string details.detail_batch.validTime有效日期string details.detail_batch.delivery_statusInfo单据状态信息array details.detail_batch.delivery_statusInfo.delivery_date发货时间string details.detail_batch.delivery_statusInfo.invoices发票列表string details.detail_batch.delivery_statusInfo.vip_code会员代码string details.detail_batch.delivery_statusInfo.vip_real_name真实姓名string details.detail_batch.delivery_statusInfo.vip_id_card身份证号码string details.detail_batch.delivery_statusInfo.package_center_code集包地代码string details.detail_batch.delivery_statusInfo.package_center_name集包地名称string details.detail_batch.delivery_statusInfo.sync_status数据同步状态string details.detail_batch.delivery_statusInfo.sync_memo数据同步备注string details.detail_batch.delivery_statusInfo.picture_bill是否多包裹string details.detail_batch.delivery_statusInfo.drp_tenant_name分销商名称string details.detail_batch.delivery_statusInfo.drp_tenant_mobile分销商手机号string

金蝶云星空接口明细

调用接口：batchSave
接口名称：销售出库新增
方法：POST

请求参数

字段字段名称类型配置值 FBillTypeID单据类型stringXSCKD01_SYS FBillNo单据编号string{{code}} FDate日期string{{delivery_statusInfo.delivery_date}} FSaleOrgId销售组织string100 FCustomerID客户string{{shop_code}} FSaleDeptID销售部门string{{shop_code}} FStockOrgId发货组织string100 FNote备注string F_ora_platform_code网上订单号string{{platform_code}} F_PBLH_Text平台单号string{{platform_code}} SubHeadEntity财务信息object SubHeadEntity.FSettleOrgID结算组织string100 SubHeadEntity.FSETTLECURRID结算币别stringPRE001 SubHeadEntity.FEntity明细信息arraydetails SubHeadEntity.FEntity.FMaterialID物料编码string{{details.sku_code}} SubHeadEntity.FEntity.FRealQty实发数量string{{details.qty}} SubHeadEntity.FEntity.FPrice单价string SubHeadEntity.FEntity.FTaxPrice含税单价string SubHeadEntity.FEntity.FIsFree是否赠品string SubHeadEntity.FEntity.FLot批号string SubHeadEntity.FEntity.FProduceDate生产日期string SubHeadEntity.FEntity.FExpiryDate有效期至string SubHeadEntity.FEntity.FEntryTaxRate税率%string SubHeadEntity.FEntity.FAmount金额string SubHeadEntity.FEntity.FAllAmount价税合计string{{details.amount_after}} SubHeadEntity.FEntity.FStockID仓库string{{warehouse_code}} SubHeadEntity.FEntity.FOwnerTypeId货主类型stringBD_OwnerOrg SubHeadEntity.FEntity.FOwnerId货主string100 SubHeadEntity.FEntity.FEntrynote备注string SubHeadEntity.FEntity.F_PBLH_Decimal原订单金额string{{amount}} SubHeadEntity.FEntity.F_PBLH_Decimal1让利金额string{{discount_fee}} SubHeadEntity.FEntity.F_PBLH_Assistant管易订单类型string{{order_type}} SubHeadEntity.FEntity.F_PBLH_Decimal4管易让利后金额对比string{{details.amount_after}} SubHeadEntity.FEntity.F_PBLH_Decimal5管易物流费用string{{details.post_fee}} SubHeadEntity.FEntity.FormId业务对象表单IdstringSAL_OUTSTOCK SubHeadEntity.FEntity.Operation执行的操作stringSave SubHeadEntity.FEntity.IsAutoSubmitAndAudit提交并审核boolfalse SubHeadEntity.FEntity.IsVerifyBaseDataField验证基础资料booltrue SubHeadEntity.FEntity.SubSystemId相应位置string21

系统对接概况

通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。

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