马帮对接打通金蝶云星空获取订单列表接口与销售出库新增接口

马帮对接打通金蝶云星空获取订单列表接口与销售出库新增接口

接入系统：马帮

马帮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架构。