接入系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
目标系统:旺店通·旗舰奇门
慧策(原旺店通)是一家技术驱动型智能零售服务商,基于云计算PaaS、SaaS模式,以一体化智能零售解决方案,帮助零售企业数字化智能化升级,实现企业规模化发展。
多系统对接方案配置
集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息),用户可以根据业务的不同新建多个不同规则的集成方案。比如:采购订单同步,线上销售出库同步,线下销售出库同步。一个集成方案必须要配置源系统:金蝶云星空,源系统 API:销售订单查询,目标系统:旺店通·旗舰奇门,目标系统 API原始单推送。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
金蝶云星空接口明细
调用接口:executeBillQuery
接口名称:销售订单查询
方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
FSaleOrderEntry_FEntryID | FSaleOrderEntry_FEntryID | string | FSaleOrderEntry_FEntryID |
FID | FID | string | FID |
FBillNo | 单据编号 | string | FBillNo |
FDocumentStatus | 单据状态 | string | FDocumentStatus |
FSaleOrgId_FNumber | 销售组织 | string | FSaleOrgId.FNumber |
FDate | 日期 | string | FDate |
FCustId_FNumber | 客户 | string | FCustId.FNumber |
FCustId_FName | 客户 | string | FCustId.FName |
FSaleDeptId_Fnumber | 销售部门 | string | FSaleDeptId.Fnumber |
FSaleGroupId | 销售组 | string | FSaleGroupId |
FSalerId | 销售员 | string | FSalerId |
FReceiveId | 收货方 | string | FReceiveId |
FSettleId | 结算方 | string | FSettleId |
FSettleAddress | 结算方地址 | string | FSettleAddress |
FChargeId | 付款方 | string | FChargeId |
FCreatorId | 创建人 | string | FCreatorId |
FCreateDate | 创建日期 | string | FCreateDate |
FModifierId | 最后修改人 | string | FModifierId |
FModifyDate | 最后修改日期 | string | FModifyDate |
FApproverId | 审核人 | string | FApproverId |
FApproveDate | 审核日期 | string | FApproveDate |
FCloseStatus | 关闭状态 | string | FCloseStatus |
FCloserId | 关闭人 | string | FCloserId |
FCloseDate | 关闭日期 | string | FCloseDate |
FCancelStatus | 作废状态 | string | FCancelStatus |
FCancellerId | 作废人 | string | FCancellerId |
FCancelDate | 作废日期 | string | FCancelDate |
FVersionNo | 版本号 | string | FVersionNo |
FChangerId | 变更人 | string | FChangerId |
FChangeDate | 变更日期 | string | FChangeDate |
FChangeReason | 变更原因 | string | FChangeReason |
FBillTypeID_Fnumber | 单据类型 | string | FBillTypeID.Fnumber |
FBusinessType | 业务类型 | string | FBusinessType |
FHeadDeliveryWay | 交货方式 | string | FHeadDeliveryWay |
FReceiveAddress | 收货方地址 | string | FReceiveAddress |
FHEADLOCID_FADDRESS | 交货地点 | string | FHEADLOCID.FADDRESS |
FHEADLOCID_FTCONTACT | 交货地点 | string | FHEADLOCID.FContact |
FHEADLOCID_FTEL | 交货地点 | string | FHEADLOCID.FTEL |
FReceiveContact | 收货方联系人 | string | FReceiveContact |
FNote | 备注 | string | FNote |
FSignStatus | 签收状态 | string | FSignStatus |
FManualClose | 是否手工关闭 | string | FManualClose |
FSOFrom | 订单来源 | string | FSOFrom |
FMaterialId_Fnumber | 物料编码 | string | FMaterialId.Fnumber |
FMaterialName | 物料名称 | string | FMaterialName |
FMaterialModel | 规格型号 | string | FMaterialModel |
FMaterialType | 物料类别 | string | FMaterialType |
FUnitID_Fnumber | 销售单位 | string | FUnitID.Fnumber |
FPrice | 单价 | string | FPrice |
FTaxPrice | 含税单价 | string | FTaxPrice |
FBomId | BOM版本 | string | FBomId |
FPriceUnitId | 计价单位 | string | FPriceUnitId |
FPriceUnitQty | 计价数量 | string | FPriceUnitQty |
FPriceCoefficient | 价格系数 | string | FPriceCoefficient |
FDiscountRate | 折扣率% | string | FDiscountRate |
FDiscount | 折扣额 | string | FDiscount |
FEntryTaxRate | 税率% | string | FEntryTaxRate |
FEntryTaxAmount | 税额 | string | FEntryTaxAmount |
FAllAmount | 价税合计 | string | FAllAmount |
FTaxNetPrice | 净价 | string | FTaxNetPrice |
FBaseUnitQty | 销售基本数量 | string | FBaseUnitQty |
FDeliveryControl | 控制发货数量 | string | FDeliveryControl |
FDeliveryMaxQty | 发货上限 | string | FDeliveryMaxQty |
FDeliveryMinQty | 发货下限 | string | FDeliveryMinQty |
FTransportLeadTime1 | 运输提前期 | string | FTransportLeadTime1 |
FBefDisAllAmt | 折前价税合计 | string | FBefDisAllAmt |
FBefDisAmt | 折前金额 | string | FBefDisAmt |
FTaxAmount_LC | 税额(本位币) | string | FTaxAmount_LC |
FAmount_LC | 金额(本位币) | string | FAmount_LC |
FAllAmount_LC | 价税合计(本位币) | string | FAllAmount_LC |
FMrpCloseStatus | 业务关闭 | string | FMrpCloseStatus |
FMrpFreezeStatus | 业务冻结 | string | FMrpFreezeStatus |
FFreezerId | 冻结人 | string | FFreezerId |
FFreezeDate | 冻结日期 | string | FFreezeDate |
FMrpTerminateStatus | 业务终止 | string | FMrpTerminateStatus |
FTerminaterId | 终止人 | string | FTerminaterId |
FTerminateDate | 终止日期 | string | FTerminateDate |
FBaseDeliJoinQty | (代码有用)关联发货通知数量(销售基本) | string | FBaseDeliJoinQty |
FRemainOutQty | 剩余未出数量(销售) | string | FRemainOutQty |
FBaseInvoiceJoinQty | 关联开票数量(基本)(作废) | string | FBaseInvoiceJoinQty |
FInvoiceJoinQty | 关联开票数量(作废) | string | FInvoiceJoinQty |
FBasePurJoinQty | 关联采购/生产数量(销售基本) | string | FBasePurJoinQty |
FPurJoinQty | 关联采购/生产数量 | string | FPurJoinQty |
FReceiptOrgId | 收款组织 | string | FReceiptOrgId |
FSettleOrgIds | 结算组织 | string | FSettleOrgIds |
FAmount | 金额 | string | FAmount |
FEntryNote | 备注 | string | FEntryNote |
FQty | 销售数量 | string | FQty |
FLimitDownPrice | 最低限价 | string | FLimitDownPrice |
FSysPrice | 系统定价 | string | FSysPrice |
FStockOrgId | 库存组织 | string | FStockOrgId |
FBaseUnitId | 基本单位 | string | FBaseUnitId |
FChangeFlag | 变更标志 | string | FChangeFlag |
FMapId | 客户物料编码 | string | FMapId |
FOwnerTypeId | 货主类型 | string | FOwnerTypeId |
FOwnerId | 货主 | string | FOwnerId |
FIsFree | 是否赠品 | string | FIsFree |
FLOCKQTY | 锁库/预留数量(库存单位) | string | FLOCKQTY |
FLOCKFLAG | 锁库/预留标识 | string | FLOCKFLAG |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
FSaleOrderEntry_FEntryID | FSaleOrderEntry_FEntryID | string | |
FID | FID | string | |
FBillNo | 单据编号 | string | |
FDocumentStatus | 单据状态 | string | |
FSaleOrgId_FNumber | 销售组织 | string | |
FDate | 日期 | string | |
FCustId_FNumber | 客户 | string | |
FCustId_FName | 客户 | string | |
FSaleDeptId_Fnumber | 销售部门 | string | |
FSaleGroupId | 销售组 | string | |
FSalerId | 销售员 | string | |
FReceiveId | 收货方 | string | |
FSettleId | 结算方 | string | |
FSettleAddress | 结算方地址 | string | |
FChargeId | 付款方 | string | |
FCreatorId | 创建人 | string | |
FCreateDate | 创建日期 | string | |
FModifierId | 最后修改人 | string | |
FModifyDate | 最后修改日期 | string | |
FApproverId | 审核人 | string | |
FApproveDate | 审核日期 | string | |
FCloseStatus | 关闭状态 | string | |
FCloserId | 关闭人 | string | |
FCloseDate | 关闭日期 | string | |
FCancelStatus | 作废状态 | string | |
FCancellerId | 作废人 | string | |
FCancelDate | 作废日期 | string | |
FVersionNo | 版本号 | string | |
FChangerId | 变更人 | string | |
FChangeDate | 变更日期 | string | |
FChangeReason | 变更原因 | string | |
FBillTypeID_Fnumber | 单据类型 | string | |
FBusinessType | 业务类型 | string | |
FHeadDeliveryWay | 交货方式 | string | |
FReceiveAddress | 收货方地址 | string | |
FHEADLOCID_FADDRESS | 交货地点 | string | |
FHEADLOCID_FTCONTACT | 交货地点 | string | |
FHEADLOCID_FTEL | 交货地点 | string | |
FReceiveContact | 收货方联系人 | string | |
FNote | 备注 | string | |
FSignStatus | 签收状态 | string | |
FManualClose | 是否手工关闭 | string | |
FSOFrom | 订单来源 | string | |
FMaterialId_Fnumber | 物料编码 | string | |
FMaterialName | 物料名称 | string | |
FMaterialModel | 规格型号 | string | |
FMaterialType | 物料类别 | string | |
FUnitID_Fnumber | 销售单位 | string | |
FPrice | 单价 | string | |
FTaxPrice | 含税单价 | string | |
FBomId | BOM版本 | string | |
FPriceUnitId | 计价单位 | string | |
FPriceUnitQty | 计价数量 | string | |
FPriceCoefficient | 价格系数 | string | |
FDiscountRate | 折扣率% | string | |
FDiscount | 折扣额 | string | |
FEntryTaxRate | 税率% | string | |
FEntryTaxAmount | 税额 | string | |
FAllAmount | 价税合计 | string | |
FTaxNetPrice | 净价 | string | |
FBaseUnitQty | 销售基本数量 | string | |
FDeliveryControl | 控制发货数量 | string | |
FDeliveryMaxQty | 发货上限 | string | |
FDeliveryMinQty | 发货下限 | string | |
FTransportLeadTime1 | 运输提前期 | string | |
FBefDisAllAmt | 折前价税合计 | string | |
FBefDisAmt | 折前金额 | string | |
FTaxAmount_LC | 税额(本位币) | string | |
FAmount_LC | 金额(本位币) | string | |
FAllAmount_LC | 价税合计(本位币) | string | |
FMrpCloseStatus | 业务关闭 | string | |
FMrpFreezeStatus | 业务冻结 | string | |
FFreezerId | 冻结人 | string | |
FFreezeDate | 冻结日期 | string | |
FMrpTerminateStatus | 业务终止 | string | |
FTerminaterId | 终止人 | string | |
FTerminateDate | 终止日期 | string | |
FBaseDeliJoinQty | (代码有用)关联发货通知数量(销售基本) | string | |
FRemainOutQty | 剩余未出数量(销售) | string | |
FBaseInvoiceJoinQty | 关联开票数量(基本)(作废) | string | |
FInvoiceJoinQty | 关联开票数量(作废) | string | |
FBasePurJoinQty | 关联采购/生产数量(销售基本) | string | |
FPurJoinQty | 关联采购/生产数量 | string | |
FReceiptOrgId | 收款组织 | string | |
FSettleOrgIds | 结算组织 | string | |
FAmount | 金额 | string | |
FEntryNote | 备注 | string | |
FQty | 销售数量 | string | |
FLimitDownPrice | 最低限价 | string | |
FSysPrice | 系统定价 | string | |
FStockOrgId | 库存组织 | string | |
FBaseUnitId | 基本单位 | string | |
FChangeFlag | 变更标志 | string | |
FMapId | 客户物料编码 | string | |
FOwnerTypeId | 货主类型 | string | |
FOwnerId | 货主 | string | |
FIsFree | 是否赠品 | string | |
FLOCKQTY | 锁库/预留数量(库存单位) | string | |
FLOCKFLAG | 锁库/预留标识 | string |
旺店通·旗舰奇门接口明细
接口:sales.RawTrade.pushSelf
接口名称:原始单推送
接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
shop_no | 店铺编号 | string | 店铺编号 |
rawTradeList | 原始单信息 | array | 原始单信息信息集合 |
rawTradeList.is_auto_wms | 是否是自流转 | string | true自流转,false 非自流转 |
rawTradeList.post_amount | 邮费 | string | 邮费 |
rawTradeList.other_amount | 其他费用 | string | 其他费用 |
rawTradeList.discount | 优惠金额 | string | 优惠金额 |
rawTradeList.platform_cost | 平台费用 | string | |
rawTradeList.goods_count | 货品总数量 | string | 货品总数量 |
rawTradeList.cod_amount | 货到付款金额 | string | 若delivery_term=2,则为应付金额,否则则为0 |
rawTradeList.tid | 原始单号 | string | 指商城、官网等平台的订单编号,ERP称之为原始单号,同一个sid下通过本接口新增订单的tid保证唯一。 |
rawTradeList.process_status | 处理状态 | string | 若为线下门店订单则统一为10。 |
rawTradeList.received | 已从平台收款的金额 | string | 已从平台收款的金额 |
rawTradeList.trade_status | 平台状态 | string | 10未确认 20待尾款 30待发货 40部分发货 50已发货 60已签收 70已完成 80已退款 90已关闭(付款前取消) |
rawTradeList.refund_status | 退款状态 | string | 0无退款 1申请退款 2部分退款 3全部退款 |
rawTradeList.pay_status | 付款状态 | string | 0未付款1部分付款2已付款 |
rawTradeList.order_count | 子订单个数 | string | 原始单包含的子订单数 |
rawTradeList.pay_method | 支付方式 | string | 1在线转帐 2现金,3银行转账,4邮局汇款 5预付款 6刷卡 |
rawTradeList.trade_time | 下单时间 | string | 下单时间 |
rawTradeList.pay_time | 支付时间 | string | 支付时间 |
rawTradeList.end_time | 交易结束时间 | string | 交易结束时间,若无则传null |
rawTradeList.buyer_nick | 买家账号 | string | 若无则传一个固定值 |
rawTradeList.buyer_message | 买家备注 | string | 若无则传‘’ |
rawTradeList.buyer_email | 买家邮箱 | string | ‘’ |
rawTradeList.buyer_area | 买家地区 | string | ‘’ |
rawTradeList.receiver_name | 收件人姓名 | string | 收件人姓名 |
rawTradeList.receiver_area | 省市区 | string | 省市区空格分隔 |
rawTradeList.receiver_address | 地址 | string | 地址,不包含省市区 |
rawTradeList.receiver_zip | 收件人邮编 | string | 收件人邮编,若无则传‘’ |
rawTradeList.receiver_mobile | 收件人手机 | string | 此值若为空则receiver_telno必须有合法值 |
rawTradeList.receiver_telno | 收件人电话 | string | 此值若为空则receiver_mobile必须有合法值 |
rawTradeList.invoice_type | 发票类别 | string | 0 不需要,1普通发票,2增值税发票 |
rawTradeList.invoice_title | 发票抬头 | string | 发票抬头,若无则传‘’ |
rawTradeList.invoice_content | 发票内容 | string | 发票内容,若无则传‘’ |
rawTradeList.logistics_type | 物流类别 | string | -1 |
rawTradeList.cust_data | 物流编号 | string | 系统物流编号(设置--基本设置--物流) |
rawTradeList.delivery_term | 发货条件 | string | 1款到发货 2货到付款(包含部分货到付款) 3分期付款 |
rawTradeList.to_deliver_time | 买家要求的送货日期 | string | 买家要求的送货日期 |
rawTradeList.pay_id | 平台支付订单ID | string | ‘’ |
rawTradeList.remark | 客服备注 | string | 客服备注 |
rawTradeList.remark_flag | 客服备注标记 | string | 标旗(1 红、2 黄、3 绿、4 蓝、5 紫 无则填0) |
rawTradeList.warehouse_no | 仓库编号 | string | 自流转情况须填写仓库编号, 非自流转订单传入空字符串即可 |
rawTradeList.pay_account | 买家支付宝帐号 | string | ‘’ |
rawTradeList.consign_interval | 淘宝新增,物流到货时效,单位天 | string | |
rawTradeList.receivable | 应收金额 | string | 应收金额,售前退款会变化,“详细金额逻辑点击查看” |
rawTradeList.rawTradeOrderList | 原始子单信息 | array | 原始子单信息集合 |
rawTradeList.rawTradeOrderList.tid | 原始订单号 | string | |
rawTradeList.rawTradeOrderList.oid | 原始子单号 | string | |
rawTradeList.rawTradeOrderList.order_type | 子单类型 | string | |
rawTradeList.rawTradeOrderList.status | 平台的状态 | string | |
rawTradeList.rawTradeOrderList.refund_status | 退款标记 | string | |
rawTradeList.rawTradeOrderList.goods_id | 平台货品ID | string | |
rawTradeList.rawTradeOrderList.spec_id | 平台规格ID | string | |
rawTradeList.rawTradeOrderList.goods_no | 货品编号 | string | |
rawTradeList.rawTradeOrderList.spec_no | 规格编码 | string | |
rawTradeList.rawTradeOrderList.goods_name | 货品名称 | string | |
rawTradeList.rawTradeOrderList.spec_name | 规格名称 | string | |
rawTradeList.rawTradeOrderList.num | 数量 | string | |
rawTradeList.rawTradeOrderList.price | 单价 | string | |
rawTradeList.rawTradeOrderList.adjust_amount | 手工调整的优惠金额 | string | |
rawTradeList.rawTradeOrderList.refund_amount | 退款金额 | string | |
rawTradeList.rawTradeOrderList.discount | 优惠 | string | |
rawTradeList.rawTradeOrderList.share_discount | 分摊优惠 | string | |
rawTradeList.rawTradeOrderList.total_amount | 总价格 | string | |
rawTradeList.rawTradeOrderList.cid | 平台类目 | string | |
rawTradeList.rawTradeOrderList.remark | 备注 | string | |
rawTradeList.rawTradeOrderList.json | json串 | string |
系统对接总览
大部分的企业都可能只用一套系统组织架构复杂,业务流程繁琐,内部同时有OA系统、BI系统、ERP系统......且各个系统都需要独立登陆,造成IT部门数据监管困难!如何在同一套中台系统上关联多管理系统呢?系统集成平台,就可以无缝集成各个业务系统,主数不统一、交易数据来回导出导入、业务融合等问题。通过轻易云系统集成平台完美结合:打破企业内部数据孤岛,无需繁琐的处理工序,与数据集成服务完美结合,让数据真正通起来。 资源互补:汇集各种行业解决方案,资源互补,企业管理融合提升。让对接开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。