金蝶云星空对接打通旺店通·企业奇门销售退货查询接口与创建其他入库单接口

对接系统：金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

对接目标平台:旺店通·企业奇门

慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。

接口方案配置

在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用

金蝶云星空接口明细

• API：executeBillQuery

• NAME：销售退货查询

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FID	FID	FID
FBillNo	单据编码	FBillNo
FDate	单据日期	FDate
FSaleOrgId_FNumber	销售组织	FSaleOrgId.FNumber
FRetcustId_FNumber	退货客户	FRetcustId.FNumber
SubHeadEntity_FEntryId	SubHeadEntity_FEntryId	SubHeadEntity_FEntryId
FMaterialId_FNumber	物料编码	FMaterialId.FNumber
FStockId_FNumber	仓库编码	FStockId.FNumber
FRealQty	实退数量	FRealQty
Limit	最大行数	{{PAGINATION_PAGE_SIZE}}	金蝶的查询分页参数
StartRow	开始行索引	{{PAGINATION_START_ROW}}	金蝶的查询分页参数
TopRowCount	返回总行数		金蝶的查询分页参数
FilterString	过滤条件	FApproveDate>='{{LAST_SYNC_TIME dateTime}}'	示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=
FieldKeys	需查询的字段key集合		金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber
FormId	业务对象表单Id	SAL_RETURNSTOCK	必须填写金蝶的表单ID如 UR_PurchaseOrder

响应参数

接口字段	字段名称	预设值	描述
FID	FID
FBillNo	单据编码
FDate	单据日期
FSaleOrgId_FNumber	销售组织
FRetcustId_FNumber	退货客户
SubHeadEntity_FEntryId	SubHeadEntity_FEntryId
FMaterialId_FNumber	物料编码
FStockId_FNumber	仓库编码
FRealQty	实退数量

旺店通·企业奇门接口明细

• 接口：wdt.stockin.order.push

• 接口名称：创建其他入库单

• 接口方法：POST

请求参数

字段	名称	类型	描述
outer_no	外部单号	string	外部系统的唯一单据编号，避免重复推送数据
warehouse_no	仓库编号	string	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置）
logistics_code	物流编号	string	代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置）
logistics_no	物流单号	string	物流公司的运单号，用于追踪物流、快递流转信息（路由）的数字编码
is_check	是否审核	string	1：审核 0：不审核 默认0
is_create_batch	是否创建批次	string	0:否；1:是，默认是0。ERP“批次管理”不存在推送的批次号，是否允许单据创建成功，并创建新的“批次号”。
post_fee	邮资	string	物流或者快递运输货物产生的费用
other_fee	其他费用	string	其他费用
remark	备注	string	其他入库单备注
reason	入库原因	string	入库原因（需要在客户端维护好该原因，如客户端无该原因或者原因停用，则推送失败，路径：设置—>基本设置—>原因列表）
goods_list	货品明细节点	array	入库单货品列表节点
goods_list.spec_no	商家编码	string	ERP内单品唯一编码（SKU），代表单品(SKU)所有属性，并且为库存量出入计算最小单元。SKU概念介绍,单击这里
goods_list.stockin_num	入库数量	string	入库数量
goods_list.position_no	货位编号	string	商品在仓库内的位置编号,不传此参数，读ERP配置【入库开单货位优先级配置】，来决定取默认货位、上一次入库货位、ZANCUN货位其中一个货位。
goods_list.batch_no	批次	string	货品批次编号
goods_list.batch_remark	批次备注	string	货品批次备注
goods_list.production_date	生产日期	string	货品生产日期，格式：yyyy-MM-dd HH:mm:ss
goods_list.validity_days	有效期天数	string	商品有效期，单位：天
goods_list.src_price	原价	string	上层单据的的货品价格，例如采购单的税前折后单价为采购入库的原价，原价减去入库价得出货品优惠。其他入库没有上层单据，根据业务情况自行传值。无特殊业务建议同入库价一致。
goods_list.stockin_price	入库价	string	入库价格，如推送为0默认取成本价。
goods_list.tax	税率	string	对征税对象的征收比例或征收额度。例如税率为16%，请求时填值为0.16
goods_list.is_enable_sn	是否开启序列号	string	是否开启序列号: 0代表不开启序列号 1代表开启序列号 默认为不开启
goods_list.sn_list	序列号列表	string	序列号列表，多个序列号通过","隔开字符串区分，例如"xxx1,xxx2,xxx3"
goods_list.stockin_info	stockin_info	string

数据对接价值

从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到旺店通·企业奇门之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。