旺店通·企业奇门与金蝶云星空对接集成查询采购入库单连通采购入库新增(采购入库单 all)
来源系统:旺店通·企业奇门
旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算SaaS服务模式，以体系化解决方案，助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案，致力于帮助企业实现数字化转型，企业规模化发展
对接目标平台:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
数据集成方案配置
通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将旺店通·企业奇门、金蝶云星空之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，Web界面追踪调试日志等功能。 平台兼具实时数据处理和数据集成分发功能，用户通过可视化的拖、拽即可完成数据处理逻辑，将数据加工处理后分发到下游业务系统或其他异构存储中。
旺店通·企业奇门接口明细
- API：wdt.stockin.order.query.purchase
- NAME：查询采购入库单
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| start_time | 开始时间 | {{LAST_SYNC_TIME datetime}} | 增量获取数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss |
| end_time | 结束时间 | {{CURRENT_TIME datetime}} | 增量获取数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss |
| status | 状态 | 入库单状态 10已取消20编辑中25待价格确认30待审核60待结算80已完成（默认80） | |
| src_order_no | 上层单据编号 | 上层单据编号，默认为采购单号，传该字段可以不传开始时间和结束时间 | |
| warehouse_no | 仓库编号 | 代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号) | |
| page_size | 分页大小 | {{PAGINATION_PAGE_SIZE}} | 每页返回的数据条数，输入值范围1100，不传本参数，输入值默认为40，使用举例单击这里 |
| page_no | 页号 | {{PAGINATION_START_PAGE}} | 不传值默认从0页开始 |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| stockin_id | 入库单主键id | 入库单主键id | |
| order_no | 入库单号 | 入库单号 | |
| status | 状态 | 10已取消20编辑中25待价格确认30待审核60待结算80已完成 | |
| warehouse_no | 仓库编号 | 代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置） | |
| warehouse_name | 仓库 | 仓库 | |
| stockin_time | 修改时间 | 修改时间，格式：yyyy-MM-dd HH:mm:ss | |
| check_time | 审核时间 | 审核时间，格式：yyyy-MM-dd HH:mm:ss | |
| created_time | 创建时间 | 创建时间，格式：yyyy-MM-dd HH:mm:ss | |
| src_order_no | 采购单号 | 采购单号 | |
| remark | 备注 | 备注 | |
| stockin_reason | 入库原因 | 入库原因 | |
| order_type | 入库类型 | 入库类型（该接口只返回采购入库类型） | |
| order_type_name | 入库类型名称 | 入库类型名称（默认为采购入库） | |
| goods_amount | 货款总额 | 货款总额 | |
| total_price | 总成本 | 总成本 | |
| discount | 优惠 | 优惠 | |
| tax_amount | 税后金额 | 税后金额 | |
| post_fee | 邮费 | 邮费 | |
| other_fee | 其他费用 | 其他费用 | |
| logistics_type | 物流类型 | 物流方式，详情介绍，单击这里 | |
| logistics_code | 物流公司编号 | 旺店通系统内物流公司编号 | |
| logistics_name | 物流公司名称 | 旺店通系统内物流公司名称 | |
| logistics_no | 物流单号 | 物流单号 | |
| purchase_no | 采购单编号 | 采购单编号 | |
| provider_no | 供应商编号 | 供应商编号 | |
| provider_name | 供应商名称 | 供应商名称 | |
| outer_no | 外部单号 | 上层单据的采购单号可做该入库单的外部单号 | |
| goods_count | 货品总数量 | 货品总数量 | |
| adjust_num | 纠错数量 | 调整量，正数或者负数 | |
| adjust_price | 纠错金额 | 纠错金额 | |
| right_nums | 调整后数量 | 调整后数量 | |
| right_price | 调整后总金额 | 调整后总金额 | |
| stockin_no | 入库单号 | 入库单号 | |
| wms_outer_no | 仓储外部编号 | 默认为''，仓储外部编号 | |
| wms_status | 外部状态 | 默认为'0'，外部状态,与wms对接使用 0初始化 1失败 2成功 | |
| wms_result | 外部结果 | 默认为''，外部结果,与wms对接使用 | |
| warehouse_id | 仓库id | 默认为'0'，仓库id | |
| src_order_type | 源单据类型 | 1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库 | |
| src_order_id | 源单据id | 默认为'0'，源单据id | |
| reason_id | 原因 | 默认为'0'，原因 | |
| fa_status | 财务同步状态 | 默认为'0'，财务同步状态 | |
| logistics_id | 物流公司 | 默认为'0'，物流公司 | |
| post_share_type | 邮费分摊类型 | 默认为'0'，邮费分摊类型0,不分摊 1,按数量分摊2,按照金额分摊 | |
| operator_id | 操作员id | 操作员id | |
| check_operator_id | 审核人id | 默认为'0'，审核人id | |
| goods_type_count | 货品种类数 | 默认为'0'，货品种类数 | |
| note_count | 便签数量 | 默认为'0'，便签数量 | |
| flag_id | 标记 | 默认为'0'，标记 | |
| modified | 最后修改时间 | 最后修改时间 | |
| details_list | 明细节点 | 响应参数的2级数据节点，包含采购入库货品明细属性信息,节点下数据字段详见下述“details_list” | |
| details_list.stockin_id | 入库单主键id | 入库单主键id | |
| details_list.rec_id | 入库明细主键 | 入库明细主键 | |
| details_list.src_order_detail_id | 上层单据明细主键 | 上层单据明细主键 | |
| details_list.spec_no | 商家编码 | 代表单品(sku)所有属性的编码，SKU概念介绍,单击这里 | |
| details_list.goods_count | 货品数量 | 货品数量 | |
| details_list.discount | 优惠金额 | 优惠金额 | |
| details_list.cost_price | 单价 | 单价 | |
| details_list.production_date | 生产日期 | 生产日期，格式：yyyy-MM-dd HH:mm:ss | |
| details_list.validity_days | 有效期天数 | 有效期天数 | |
| details_list.expire_date | 有效期 | 有效期，格式：yyyy-MM-dd HH:mm:ss | |
| 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.right_num | 调整后数量 | 调整后数量 | |
| details_list.right_price | 调整后单价 | 调整后单价 | |
| details_list.right_cost | 调整后总金额 | 调整后总金额 | |
| details_list.brand_no | 品牌编号 | 品牌编号 | |
| details_list.brand_name | 品牌名称 | 品牌名称 | |
| details_list.goods_name | 货品名称 | 货品名称 | |
| details_list.goods_no | 货品编号 | 货品编号，代表SPU所有属性的唯一编号，用于获取系统货品的数据，SPU概念介绍，单击这里 | |
| details_list.spec_name | 规格名称 | 规格名称 | |
| details_list.spec_code | 规格码 | 规格码 | |
| details_list.prop2 | 自定义属性 | 自定义属性 | |
| details_list.goods_unit | 单位名称 | 单位名称 | |
| details_list.batch_no | 批次号 | 批次号 | |
| details_list.batch_remark | 批次备注 | 批次备注 | |
| details_list.position_no | 货位编号 | 货位编号 | |
| details_list.src_order_type | 源单据类型 | 1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库 | |
| details_list.org_stockin_detail_id | 原始入库单明细 | 默认为'0'，原始入库单明细 | |
| details_list.spec_id | 规格id | 规格id | |
| details_list.batch_id | 批次 | 默认为'0'，批次 | |
| details_list.position_id | 货位id | 默认为'0'，货位ID，入库时默认ID | |
| details_list.num | 数量 | 默认为'0.0000'，数量 | |
| details_list.num2 | 数量2 | 默认为'0.0000'，辅助数量 | |
| details_list.unit_id | 辅助单位 | 默认为'0'，辅助单位 | |
| details_list.base_unit_id | 基本单位 | 默认为'0'，基本单位 | |
| details_list.unit_ratio | 单位换算关系 | 默认为'1.0000'，单位换算关系 | |
| details_list.expect_num | 预期入库数量 | 默认为'0.0000'，预期入库数量 | |
| details_list.cost_price2 | 辅助成本价 | 默认为'0.0000'，辅助成本价 | |
| details_list.share_post_cost | 邮资分摊成本 | 默认为'0.0000'，邮资分摊成本 | |
| details_list.share_post_total | 邮资分摊总成本 | 默认为'0.0000'，邮资分摊总成本 | |
| details_list.modified | 最后修改时间 | 最后修改时间 | |
| details_list.created | 创建时间 | 创建时间 |
金蝶云星空接口明细
- 接口：batchSave
- 接口名称：采购入库新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|---|---|---|
| FBillTypeID | 单据类型 | string | 单据类型 |
| FBusinessType | 业务类型 | string | 下拉列表 |
| FStockOrgId | 收料组织 | string | 组织 |
| FStockDeptId | 收料部门 | string | 基础资料 |
| FPurchaseOrgId | 采购组织 | string | 组织 |
| FSupplierId | 供应商 | string | 基础资料 |
| FDate | 入库日期 | string | 日期 |
| FDeliveryBill | 送货单号 | string | 文本 |
| FTakeDeliveryBill | 提货单号 | string | 文本 |
| FSupplyId | 供货方 | string | 基础资料 |
| FInStockFin | 财务信息 | object | |
| FInStockFin.FSettleOrgId | 结算组织 | string | 组织 |
| FInStockFin.FPayOrgId | 付款组织 | string | 组织 |
| FInStockFin.FInStockEntry | 明细信息 | array | |
| FInStockFin.FInStockEntry.FMaterialId | 物料编码 | string | 基础资料 |
| FInStockFin.FInStockEntry.FCMKBarCode | 零售条形码 | string | 文本 |
| FInStockFin.FInStockEntry.FLot | 批号 | string | 批次 |
| FInStockFin.FInStockEntry.FStockId | 仓库 | string | 基础资料 |
| FInStockFin.FInStockEntry.FStockLocId | 仓位 | string | 维度关联字段 |
| FInStockFin.FInStockEntry.FMtoNo | 计划跟踪号 | string | 文本 |
| FInStockFin.FInStockEntry.FGiveAway | 是否赠品 | string | 复选框 |
| FInStockFin.FInStockEntry.FNote | 备注 | string | 多行文本 |
| FInStockFin.FInStockEntry.FRealQty | 实收数量 | string | 数量 |
| FInStockFin.FInStockEntry.FTaxPrice | 单价 | string | 单价 |
| FInStockFin.FInStockEntry.FOWNERID | 货主 | string | 多类别基础资料 |
| FInStockFin.FInStockEntry.FSRCBILLTYPEID | 源单类型 | string | |
| FInStockFin.FInStockEntry.FSRCBillNo | 源单编号 | string | |
| FInStockFin.FInStockEntry.FPOOrderNo | 订单编号 | string | |
| FInStockFin.FInStockEntry.FPOORDERENTRYID | 采购订单分录行id | string | |
| FInStockFin.FInStockEntry.FInStockEntry_Link | 关联关系 | array | |
| FInStockFin.FInStockEntry.FInStockEntry_Link.FInStockEntry_Link_FSBillId | 源单ID | string | |
| FInStockFin.FInStockEntry.FInStockEntry_Link.FInStockEntry_Link_FRuleId | 下推关系 | string | |
| FInStockFin.FInStockEntry.FInStockEntry_Link.FInStockEntry_Link_FSId | 表体ID | string | |
| FInStockFin.FInStockEntry.FInStockEntry_Link.FInStockEntry_Link_FSTableName | 源单表名 | string | |
| FInStockFin.FInStockEntry.FInStockEntry_Link.FEntryTaxRate | 税率(%) | string | |
| FInStockFin.FInStockEntry.FInStockEntry_Link.FWWInType | 入库类型 | string | |
| FInStockFin.FInStockEntry.FInStockEntry_Link.FMustQty | 应收数量 | string | |
| FInStockFin.FInStockEntry.FInStockEntry_Link.FTextWWDDH | 委外订单号 | string | |
| FInStockFin.FInStockEntry.FInStockEntry_Link.FQtyWWDDSL | 委外订单数量 | string | |
| FInStockFin.FInStockEntry.FSettleCurrId | 结算币别 | string | |
| FInStockFin.FInStockEntry.FTextWDTDH | 旺店通单号 | string | |
| FInStockFin.FInStockEntry.F_LJT_Base_JHY | 计划员 | string | |
| FInStockFin.FInStockEntry.FPurchaserId | 采购员 | string | |
| FInStockFin.FInStockEntry.FPurchaseDeptId | 采购部门 | string | |
| FInStockFin.FInStockEntry.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如 |
| FInStockFin.FInStockEntry.IsAutoSubmitAndAudit | 提交并审核 | bool | |
| FInStockFin.FInStockEntry.Operation | 执行的操作 | string | |
| FInStockFin.FInStockEntry.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
| FInStockFin.FInStockEntry.SubSystemId | 系统模块 | string | 默认仓库模块 |
数据对接效果
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
