有赞云对接金蝶云星空案例

01 系统说明：
有赞云:有赞目前拥有社交电商、新零售、美业、教育及有赞国际化五大业务体系，通过旗下的社交电商、门店管理和其他新零售SaaS软件产品、解决方案及服务，全面帮助商家解决在移动互联网时代遇到的推广获客、成交转化、客户留存、复购增长、分享裂变等问题。
webAPI接口地址：https://doc.youzanyun.com/detail/API/0/389
金蝶云星空：金蝶云·星空 财务云为成长型企业提供全面的业财税一体管理平台，实现财务的标准化、流程化和专业化。结合新兴技术、新管理模式，提供公司财务状况、经营分析的关键洞察，支撑企业经营活动的科学决策。
webAPI接口地址：详情进去金蝶云星空

轻易云集成平台：https://www.qliang.cloud/platform
更多集成方案：：https://bbs.qeasy.cloud/

02 客户背景
公司主营业务是蛋糕连锁店，目前使用有赞云系统以及金蝶云星空系统，需要通过对接把两个系统的对接数据进行数据打通
03 客户化集成方案

集成明细
1 基础资料同步
一、物料同步
物料由金蝶同步至有赞，具体字段对应如下（按照当天创建同步）
金蝶物料 有赞货品档案
物料编码 货品编号
物料名称 货品名称
物料编码 商家编码
物料名称 规格名称
注： 1、同步编码在金蝶新增字段。
二、店铺-客户同步
有赞店铺资料同步到金蝶客户资料，具体字段如下
有赞店铺 金蝶客户
店铺编号 客户代码
店铺名称 客户名称
注：创建组织和使用组织默认为100组织
三、仓库数据手工各自维护
保证编码一致
2 业务单据同步
一、销售出库单同步（按已入账状态自动关联生成应收单）
描述：有赞单据传递到金蝶生成销售出库单
同步条件：发货时间10分钟同步一次
事务类型，1商品下单， 3商品换货(换出)， 5商品返现， 9购买储值卡/礼品卡，10购买优惠券，11购买权益卡
同步条件：单据状态：已发货和无需发货
销售出库单的明细表子单原单单号，F_PJTS_Remarks
同步：自动同步、手动同步（同步失败时,根据错误信息调整源单数据,需要进行手工维护同步）
API描述：商品销售明细查询 金蝶销售出库单
单据号 单据编号
发生日期 日期
销售单元 客户代码
仓库编号（取店铺中的仓库编码字段） 仓库代码
商家编码 物料编码
数量 实发数量
成交金额 价税合计
sku单位 库存单位
默认6% 税率
支付方式类型 自定义表体字段（支付方式备注）
F_PJTS_REMARKS2
源单号 自定义表体字段（子单原单单号）F_PJTS_Remarks
配送方式 自定义表体字段（配送方式备注）

注：金蝶发货组织默认为100，销售出库单据类型为零售销售出库单类型，币別默认为人民币，税率取金蝶物料默认税率，计量单位取物料基本单位
二、销售退货单（按已入账状态自动关联生成应收单）
描述：有赞已完成状态的单据传递到金蝶生成销售退货单（零售销售退货单类型）
同步条件：单据状态：已发货和无需发货，修改时间
事务类型， 7商品退货，8商品换货(换入)
销售出库单的明细表子单原单单号，F_PJTS_Remarks，销售出库单明细表配送方式字段：F_PJTS_Remark1
同步：自动同步、手动同步（同步失败时,根据错误信息调整源单数据,需要进行手工维护同步）
API描述：商品销售明细查询 金蝶销售退货单
单据号 单据编号
发生日期 日期
销售单元 客户代码
仓库编号（取店铺中的仓库编码字段） 仓库代码
商家编码 物料编码
数量 实发数量
成交金额 价税合计
sku单位 库存单位
默认6% 税率
支付方式类型 自定义表体字段（支付方式备注）
F_PJTS_REMARKS2
源单号 自定义表体字段（子单原单单号）F_PJTS_Remarks
配送方式 自定义表体字段（配送方式备注）

注：金蝶发货组织默认为100，销售出库单据类型为零售销售出库单类型，币別默认为人民币，税率取金蝶物料默认税率，计量单位取物料基本单位
三、会员充值后同步生成金蝶云收款单（查询对账单记录）
描述：会员充值后同步生成收款单，结算方式是有赞银包，收款用途：预收款
同步条件：单据状态已完成且账户类型为储值资金和现金 ，修改时间
业务类型，常见的业务类型枚举：充值、充值手续费
同步：自动同步、手动同步（同步失败时,根据错误信息调整源单数据,需要进行手工维护同步）

有赞收款单 金蝶收款单
支付流水号 单据编号
入账时间 日期
店铺来源 往来单位、付款单位
金额 收款金额
支付方式 明细字段支付方式备注
F_PJTS_REMARKS2
收款用途 预收款，SFKYT02_SYS
结算方式 有赞钱包，001
银行账号 有赞钱包，160108155310185838
默认100广州许个愿 收款组织，结算组织，销售组织
有赞订单号 自定义表体字段，tid
四、商品下单单独生成收款单（查询对账单记录）
描述：商品下单的交易类型后单独同步生成收款单，结算方式是有赞银包，收款用途：销售收款
同步条件：单据状态已完成且账户类型为店铺余额和现金，修改时间
业务类型，常见的业务类型枚举：订单入账、交易手续费
同步：自动同步、手动同步（同步失败时,根据错误信息调整源单数据,需要进行手工维护同步）
有赞收款单（查询对账单记录） 金蝶收款单
支付流水号 单据编号
入账时间 日期
店铺来源 往来单位、付款单位
金额 收款金额
支付方式 明细字段支付方式备注
F_PJTS_REMARKS2
收款用途 销售收款，SFKYT01_SYS
结算方式 有赞钱包，001
银行账号 有赞钱包，160108155310185838
默认100广州许个愿 收款组织，结算组织，销售组织
有赞订单号 自定义表体字段tid
五 会员充值退款后同步生成金蝶云收款退款单（查询对账单记录）
描述：会员充值退款后同步生成收款退款单，结算方式是有赞银包，收款用途：预收款
同步条件：单据状态已完成且账户类型为店铺余额，修改时间
业务类型，常见的业务类型枚举：储值卡充值退款、充值手续费退回
同步：自动同步、手动同步（同步失败时,根据错误信息调整源单数据,需要进行手工维护同步）
有赞收款单（查询对账单记录） 金蝶收款单
支付流水号 单据编号
入账时间 日期
店铺来源 往来单位、付款单位
金额 收款金额
支付方式 明细字段支付方式备注
F_PJTS_REMARKS2
收款用途 销售收款，SFKYT01_SYS
结算方式 有赞钱包，001
银行账号 有赞钱包，160108155310185838
默认100广州许个愿 收款组织，结算组织，销售组织
有赞订单号 自定义表体字段tid
六 商品退款后同步生成金蝶云收款退款单（查询对账单记录）
描述：商品退款后同步生成收款退款单，结算方式是有赞银包，收款用途：销售收款
同步条件：单据状态已完成且账户类型为店铺余额和现金，修改时间
业务类型，常见的业务类型枚举：退款、交易手续费退回

同步：自动同步、手动同步（同步失败时,根据错误信息调整源单数据,需要进行手工维护同步）
有赞收款单（查询对账单记录） 金蝶收款单
支付流水号 单据编号
入账时间 日期
店铺来源 往来单位、付款单位
金额 收款金额
支付方式 明细字段支付方式备注
F_PJTS_REMARKS2
收款用途 预收款，SFKYT02_SYS
结算方式 有赞钱包，001
银行账号 有赞钱包，160108155310185838
默认100广州许个愿 收款组织，结算组织，销售组织
有赞订单号 自定义表体字段tid
04 集成成果

05 集成原理
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成

06集成总结
云时代已经汹涌而至，系统集成平台作为iPaaS的核心组件，在扩展API管理之后将更敏捷，强化对API的治理能力，解决企业内部的异构系统集成、企业内部与外部的集成、线上与线下集成的难题。本方案主要结合互联网开放式的企业信息化建设思路、数通畅联深厚的技术沉淀及IT架构规划能力，提出“基于平台构建中台”的信息化建设理念，通过对数据中台、集成中台、应用中台的构建，逐步深化、推进大中台战略体系的落地。数通畅联始终坚持SOA综合应用集成、数据治理分析领域，打造稳定柔韧的IT架构和iPaaS集成套件平台，为客户/伙伴提供开放敏捷的集成方案、灵活组合的集成平台套件，推动最终客户的数字化转型与业务创新。