马帮对接打通金蝶云星空获取订单列表接口与销售出库新增接口
接入系统：马帮
马帮ERP旗下有马帮ERP3.0、马帮ERP亚马逊专用版、马帮WMS仓储管理系统、马帮云仓、马帮TMS、跨境分销、马帮供应链SCM管理系统等产品，为跨境电商卖家提供高效管理方法和解决方案，具体提供：卖家开店、品牌出海、选品、物流、供应链、金融、销售渠道拓展等帮助。
对接系统：金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
接口方案配置
通过系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：马帮，然后选择对应的连接器。选择对应的order-get-order-list作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。
马帮接口明细
- 接口：order-get-order-list
- 接口名称：获取订单列表
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|---|---|---|
| status | 状态 | string | |
| expressTimeStart | 发货时间开始时间 | string | |
| expressTimeEnd | 发货时间结束时间 | string | |
| platformOrderIds | 销售订单 | string | |
| page | 页码 | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|---|---|---|
| platformOrderId | platformOrderId | string |
金蝶云星空接口明细
- API：batchSave
- NAME：销售出库新增
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| FBillTypeID | 单据类型 | XSCKD01_SYS | 单据类型 |
| FBillNo | 单据编号 | {{platformOrderId}} | 单据编号 |
| FDate | 日期 | {{expressTime}} | 日期 |
| FSaleOrgId | 销售组织 | {{shopId}} | 组织 |
| FCustomerID | 客户 | {{shopId}} | 基础资料 |
| FCarriageNO | 运输单号 | {{trackNumber}} | 文本 |
| FStockOrgId | 发货组织 | 100 | 组织 |
| FLinkPhone | 联系电话 | 文本 | |
| FLinkMan | 收货人姓名 | 文本 | |
| FReceiveAddress | 收货方地址 | 文本 | |
| SubHeadEntity | 财务信息 | ||
| SubHeadEntity.FSettleCurrID | 币别 | _function case when'{{currencyId}}' ='' then 'CNY' else '{{currencyId}}' end | 基础资料 |
| SubHeadEntity.FSettleOrgID | 结算组织 | {{shopId}} | 文本 |
| SubHeadEntity.FExchangeRate | 汇率 | {{currencyRate}} | 文本 |
| SubHeadEntity.FAllDisCount | 整单折扣额 | {{voucherPriceOrigin}} | 文本 |
| SubHeadEntity.FEntity | 明细信息 | orderItem | |
| SubHeadEntity.FEntity.FMaterialID | 物料编码 | {{orderItem.platformSku}} | 基础资料 |
| SubHeadEntity.FEntity.FRealQty | 实发数量 | {{orderItem.platformQuantity}} | 数量 |
| SubHeadEntity.FEntity.FTaxPrice | 含税单价 | {{orderItem.sellPriceOrigin}} | 单价 |
| SubHeadEntity.FEntity.FStockID | 仓库 | {{orderItem.shopId}} | 基础资料 |
| SubHeadEntity.FEntity.F_SWPA_Text_ysddh | 原始订单号 | {{platformOrderId}} | |
| SubHeadEntity.FEntity.FDiscountRate | 折扣率 | ||
| SubHeadEntity.FEntity.FDiscount | 折扣额 | {{orderItem.zke}} | |
| SubHeadEntity.FEntity.F_PCWF_CheckBox | 清除仓库 | {{orderItem.new_jdqcck}} | |
| SubHeadEntity.FEntity.F_TransactionId | TransactionId | {{orderItem.transactionId}} | |
| SubHeadEntity.FEntity.F_Quantity | 商品数量 | {{orderItem.quantity}} | |
| SubHeadEntity.FEntity.F_isCombo | 是否组合商品 | {{orderItem.isCombo}} | |
| SubHeadEntity.FEntity.F_SWPA_Combo_LYXT | 来源系统 | 1 | |
| SubHeadEntity.FEntity.FNote | 备注 | {{remark}} | |
| SubHeadEntity.FEntity.F_SWPA_Text_khbm | 客户编码 | {{buyerUserId}} | |
| SubHeadEntity.FEntity.F_SWPA_Text_khmc | 客户名称 | {{buyerName}} | |
| SubHeadEntity.FEntity.F_SWPA_Text | 交易号 | {{salesRecordNumber}} | |
| SubHeadEntity.FEntity.F_SWPA_Remarks_ysdh | 原始单号 | {{platformOrderId}} | |
| SubHeadEntity.FEntity.FormId | 业务对象表单Id | SAL_OUTSTOCK | 必须填写金蝶的表单ID如:PUR_PurchaseOrder |
| SubHeadEntity.FEntity.Operation | 执行的操作 | Save | |
| SubHeadEntity.FEntity.IsAutoSubmitAndAudit | 提交并审核 | true | |
| SubHeadEntity.FEntity.IsVerifyBaseDataField | 验证基础资料 | true | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
| SubHeadEntity.FEntity.SubSystemId | 系统模块 | 21 | 默认仓库模块 |
| SubHeadEntity.FEntity.BatchCount | 服务端开启的线程数，整型 | 5 | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
系统数据对接
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通马帮到金蝶云星空之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。
