马帮和金蝶云星空接口打通对接实战
源系统:马帮
马帮ERP隶属于上海马帮科技有限公司，马帮ERP成立十余年，聚焦服务于各阶段、各领域的跨境电商从业者，为跨境卖家提供订单处理、商品库存管理、采购供应链管理，物流渠道管理、WMS仓储发货等全流程跨境电商解决方案管理软件。国内外团队800多人，跨境业务范围遍布全国20多个城市，已开通海外东南亚本地化服务。我们已经服务超20万家电商卖家，对接电商近100家主流平台、1000多家物流公司、多家跨境主流收款工具
接通系统：金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
数据集成方案配置
在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用
马帮接口明细
- 调用接口：order-get-order-list
- 接口名称：获取订单列表
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 | |
|---|---|---|---|---|
| status | 状态 | string | 3 | |
| expressTimeStart | 发货时间开始时间{{LAST_SYNC_TIME | datetime}} | string | 2022-12-02 00:00:00 |
| expressTimeEnd | 发货时间结束时间{{CURRENT_TIME | datetime}} | string | 2022-12-02 23:59:59 |
| platformOrderIds | 销售订单 | string | 1433370741 | |
| page | 页码 | string | 1 |
金蝶云星空接口明细
- API：batchSave
- NAME：销售出库新增
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| FBillTypeID | 单据类型 | XSCKD01_SYS | 单据类型 |
| FBillNo | 单据编号 | {{platformOrderId}} | 单据编号 |
| FDate | 日期 | {{expressTime}} | 日期 |
| FSaleOrgId | 销售组织 | {{shopId}} | 组织 |
| FCustomerID | 客户 | function case when'{{shopName}}' ='批发订单 DISTIRIBUTOR' then "{{buyerUserId}}" else '{{shopId}}' end | 基础资料 |
| FCarriageNO | 运输单号 | {{trackNumber}} | 文本 |
| FStockOrgId | 发货组织 | {{shopId}} | 组织 |
| FLinkPhone | 联系电话 | 文本 | |
| FLinkMan | 收货人姓名 | 文本 | |
| FReceiveAddress | 收货方地址 | 文本 | |
| FEntity | 明细信息 | orderItem | |
| FEntity.FMaterialID | 物料编码 | _function case '{{orderItem.new_title}}' when '' then '{{orderItem.stockSku}}' else '{{orderItem.new_title}}' end | 基础资料 |
| FEntity.FRealQty | 实发数量 | {{orderItem.quantity}} | 数量 |
| FEntity.FTaxPrice | 含税单价 | {{orderItem.sellPriceOrigin}} | 单价 |
| FEntity.FStockID | 仓库 | {{orderItem.stockWarehouseId}} | 基础资料 |
| FEntity.F_SWPA_Text_ysddh | 原始单号 | {{platformOrderId}} | |
| FEntity.FDiscountRate | 折扣率 | ||
| FEntity.FDiscount | 折扣额 | {{orderItem.zke}} | |
| FEntity.F_PCWF_CheckBox | 清除仓库 | {{orderItem.new_jdqcck}} | |
| FEntity.SubHeadEntity | 财务信息 | orderItem | |
| FEntity.SubHeadEntity.FSettleCurrID | 币别 | _function case when'{{currencyId}}' ='' then 'CNY' else '{{currencyId}}' end | 基础资料 |
| FEntity.SubHeadEntity.FSettleOrgID | 结算组织 | {{shopId}} | 文本 |
| FEntity.SubHeadEntity.FExchangeRate | 汇率 | {{currencyRate}} | 文本 |
| FEntity.SubHeadEntity.FAllDisCount | 整单折扣额 | {{voucherPriceOrigin}} | |
| FEntity.SubHeadEntity.F_SWPA_Combo_LYXT | 来源系统 | 1 | |
| FEntity.SubHeadEntity.FNote | 备注 | {{remark}} | |
| FEntity.SubHeadEntity.F_SWPA_Text_khbm | 客户编码 | {{buyerUserId}} | |
| FEntity.SubHeadEntity.F_SWPA_Text_khmc | 客户名称 | {{buyerName}} | |
| FEntity.SubHeadEntity.F_SWPA_Text | 交易号 | {{salesRecordNumber}} | |
| FEntity.SubHeadEntity.F_SWPA_Remarks_ysdh | 原始单号 | {{platformOrderId}} | |
| FEntity.SubHeadEntity.shopName | 判断店铺名称 | {{shopName}} | |
| FEntity.SubHeadEntity.FormId | 业务对象表单Id | SAL_OUTSTOCK | 必须填写金蝶的表单ID如 |
| FEntity.SubHeadEntity.Operation | 执行的操作 | Save | |
| FEntity.SubHeadEntity.IsAutoSubmitAndAudit | 提交并审核 | false | |
| FEntity.SubHeadEntity.IsVerifyBaseDataField | 验证基础资料 | true | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
| FEntity.SubHeadEntity.SubSystemId | 系统模块 | 21 | 默认仓库模块 |
系统对接概况
通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。 而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。
