马帮对接打通金蝶云星空订单

news2024/9/28 23:51:54

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

接入系统：马帮

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