金蝶云星辰V1对接外部旺店通·企业奇门系统
数据源平台:旺店通·企业奇门
慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。
目标系统:金蝶云星辰V1
金蝶云·星辰基于金蝶云·苍穹云原生PaaS平台构建，聚焦小型企业在线经营和数字化管理，提供财务云、税务云、进销存云、零售云、订货商城等SaaS服务，支持企业拓客开源、智能管理、实时决策；金蝶云·星辰还提供轻量级PaaS平台和全面的API接口，广泛连接生态伙伴，为小微企业提供一站式服务，助力企业快速成长
系统对接接口配置
使用系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：旺店通·企业奇门，然后选择对应的连接器。选择对应的查询入库单管理作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星辰V1,并且选择对应连接器（关于金蝶云星辰V1的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的其他入库单保存新增接口作为数据写入动作，既可以完成第一步的数据对接配置。
旺店通·企业奇门接口明细
- API：wdt.stockin.order.query
- NAME：查询入库单管理
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| start_time | 开始时间 | {{LAST_SYNC_TIME datetime}} |
| end_time | 结束时间 | {{CURRENT_TIME datetime}} |
| order_type | 源单据类别 | 6 |
| status | 入库单状态 | 80 |
| warehouse_no | 仓库编号 | |
| src_order_no | 上层单据编号 | |
| stockin_no | 入库单号 | |
| page_size | 分页大小 | {{PAGINATION_PAGE_SIZE}} |
| page_no | 页号 | {{PAGINATION_START_PAGE}} |
响应参数
| 接口字段 | 名称 | 预设值 |
|---|
| stockin_id | 入库单主键id | |
| order_no | 入库单号 | |
| stockin_no | 入库单号 | |
| wms_status | 委外状态 | |
| wms_result | 错误信息 | |
| warehouse_id | 仓库ID | |
| src_order_type | 入库类型 | |
| src_order_id | 入库id | |
| reason_id | 其他入库原因 | |
| fa_status | 财务同步状态 | |
| logistics_id | 物流公司 | |
| post_share_type | 邮费分摊类型 | |
| operator_id | 经办人 | |
| note_count | 便签条数 | |
| flag_id | 标记颜色 | |
| modified | 最后修改时间 | |
| warehouse_no | 仓库编号 | |
| warehouse_name | 仓库名称 | |
| status | 状态 | |
| stockin_time | 入库时间 | |
| created_time | 创建时间 | |
| remark | 备注 | |
| stockin_reason | 入库原因 | |
| order_type | 订单类别 | |
| order_type_name | 订单类别名称 | |
| goods_count | 货品数量 | |
| goods_amount | 货款总额 | |
| total_price | 扣除优惠后货款总额 | |
| discount | 优惠金额 | |
| tax_amount | 税后金额 | |
| post_fee | 邮费 | |
| other_fee | 其他费用 | |
| logistics_type | 物流类型 | |
| check_time | 审核时间 | |
| src_order_no | 源单号 | |
| outer_no | 外部单号 | |
| logistics_no | 物流单号 | |
| operator_name | 操作员姓名 | |
| details_list | 货品列表节点 | |
| details_list.stockin_id | 入库单主键id | |
| details_list.rec_id | 主键 | |
| details_list.src_order_detail_id | 上层单据明细主键 | |
| details_list.src_order_type | 入库类型 | |
| details_list.org_stockin_detail_id | 原始入库单明细 | |
| details_list.spec_id | 规格ID | |
| details_list.batch_id | 批次 | |
| details_list.position_id | 货位ID | |
| details_list.num | 库存单位 | |
| details_list.num2 | 辅助单位量 | |
| details_list.unit_id | 辅助单位 | |
| details_list.base_unit_id | 基本单位 | |
| details_list.unit_ratio | 单位换算关系 | |
| details_list.expect_num | 预期入库数量 | |
| details_list.cost_price2 | 辅助成本价 | |
| details_list.share_post_cost | 邮资分摊成本 | |
| details_list.share_post_total | 邮资分摊总成本 | |
| details_list.modified | 最后修改时间 | |
| details_list.created | 创建时间 | |
| details_list.spec_no | 商家编码 | |
| details_list.goods_count | 货品数量 | |
| details_list.discount | 优惠金额 | |
| details_list.right_num | 调整后数量 | |
| details_list.right_price | 调整后单价 | |
| details_list.right_cost | 调整后总金额 | |
| details_list.cost_price | 成本价 | |
| details_list.production_date | 生产日期 | |
| details_list.validity_days | 有效期天数 | |
| details_list.expire_date | 有效期 | |
| details_list.src_price | 原价 | |
| details_list.tax_price | 税后单价 | |
| details_list.tax_amount | 税后金额 | |
| details_list.tax | 税率 | |
| details_list.total_cost | 总成本 | |
| details_list.remark | 备注 | |
| details_list.adjust_num | 调整数量 | |
| details_list.adjust_price | 调整单价金额 | |
| details_list.brand_no | 品牌编号 | |
| details_list.brand_name | 品牌名称 | |
| details_list.goods_name | 货品名称 | |
| details_list.goods_no | 货品编号 | |
| details_list.spec_name | 规格名称 | |
| details_list.spec_code | 规格码 | |
| details_list.prop2 | 自定义属性2 | |
| details_list.goods_unit | 单位 | |
| details_list.batch_no | 批次号 | |
| details_list.batch_remark | 批次备注 | |
| details_list.position_no | 货位编号 | |
金蝶云星辰V1接口明细
- 调用接口：jdy/inv/inv_otherin_save
- 接口名称：其他入库单保存新增
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| billdate | 单据日期 | string | {{stockin_time}} |
| transtype_id | 业务类型id(辅助资料id) | string | {{src_order_type}} |
| supplierid_id | 供应商 | string | |
| contact_info | 联系信息 | string | |
| currencyid_id | 币别 | string | |
| material_entity | 商品分录 | array | details_list |
| material_entity.materialid_id | 商品 | string | findCollection find id from 87620e1d-bf21-3b1b-a036-5d64ec61ad39 where number={{details_list.goods_no}} |
| material_entity.stockid_id | 仓库 | string | _findCollection find id from 38d1bf66-eeed-38f7-adf6-93ae7b2c7ce8 where number={{details_list.warehouse_no}} |
| material_entity.qty | 数量 | number | {{details_list.goods_count}} |
| material_entity.auxqty | 辅助数量 | number | |
| material_entity.auxunitid_id | 辅助单位id | string | |
| material_entity.unit_id | 单位 | string | _findCollection find baseunitid_id from 87620e1d-bf21-3b1b-a036-5d64ec61ad39 where number={{details_list.goods_no}} |
| material_entity.auxpropid_id | 辅助属性(辅助属性商品必填) | string | |
| material_entity.auxid1_id | 辅助属性1 | string | |
| material_entity.auxid2_id | 辅助属性2 | string | |
| material_entity.auxid3_id | 辅助属性3 | string | |
| material_entity.barcode | 条形码 | string | |
| material_entity.batchno | 批次号 (批次商品必填) | string | |
| material_entity.proplace | 产地 | string | |
| material_entity.proregno | 注册证号 | string | |
| material_entity.prolicense | 生产许可证号 | string | |
| material_entity.kfdate | 生产日期 | string | |
| material_entity.validdate | 有效日期 | string | |
| material_entity.kftype | 保质期类型，1：天，2：月，3：年 | string | |
| material_entity.kfperiod | 保质期天数 | number | |
| material_entity.snlistid | 序列号流转id；单据新增后会在单据详情中带回这个字段信息，序列号商品修改时必填 | string | |
| material_entity.sn_list | 序列号 格式：001:备注1;002:备注2 （序列号:序列号备注 多个序列号以英文分号字符;分隔）,序列号商品必填 | string | |
| material_entity.cost | 出库成本 | number | |
| material_entity.unitcost | 出库单位成本 | number | |
| material_entity.comment | 行备注 | string | |
| material_entity.srcbillno | 源单编码 | string | {{details_list.goods_no}} |
| material_entity.srcbilltypeid_id | 源单类型 | string | |
| material_entity.srcinterid | 源单内码 | number | |
| material_entity.src_billdate | 源单日期 | string | |
| material_entity.srcseq | 源单行号 | number | |
| material_entity.srcentryid | 源单分录内码 | number | |
系统对接概况
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通旺店通·企业奇门到金蝶云星辰V1之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。
