金蝶云星辰V1与旺店通·企业版对接集成采购入库单查询（列表+详情）连通创建其他入库单(其他)
接入系统：金蝶云星辰V1
金蝶云·星辰基于金蝶云·苍穹云原生PaaS平台构建，聚焦小型企业在线经营和数字化管理，提供财务云、税务云、进销存云、零售云、订货商城等SaaS服务，支持企业拓客开源、智能管理、实时决策；金蝶云·星辰还提供轻量级PaaS平台和全面的API接口，广泛连接生态伙伴，为小微企业提供一站式服务，助力企业快速成长
对接系统：旺店通·企业版
慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。
数据接口配置
通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星辰V1，并且选择对应的连接器（关于金蝶云星辰V1的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的采购入库单查询（列表+详情）接口作为数据对接来源。然后再通过写入目标平台配置目标系统为旺店通·企业版，并且选择对应连接器。选择对应的创建其他入库单接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
金蝶云星辰V1接口明细
- 调用接口：jdy/pur/pur_inbound_list
- 接口名称：采购入库单查询（列表+详情）
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|---|---|---|
| deptid | 部门ID | string | |
| empid | 职员ID | string | |
| supplierid | 供应商ID | string | |
| billstatus | 单据状态（所有：“”，已审核：“C”，未审核：“Z”） | string | |
| startdate | 开始日期（格式：“yyyy-MM-dd”，为空表示不过滤），创建日期 | string | |
| enddate | 结束日期（格式：“yyyy-MM-dd”，为空表示不过滤），创建日期 | string | |
| begindate | 开始日期（格式：“yyyy-MM-dd”，为空表示不过滤），修改日期 | string | |
| expiredate | 结束日期（格式：“yyyy-MM-dd”，为空表示不过滤），修改日期 | string | |
| starttime | 开始时间（格式：“时间戳”，-1表示不过滤），创建时间 | string | |
| endtime | 结束时间（格式：“时间戳”，-1表示不过滤），创建时间 | string | |
| begintime | 开始时间（格式：“时间戳”，-1表示不过滤），修改时间 | string | |
| expiretime | 结束时间（格式：“时间戳”，-1表示不过滤），修改时间 | string | |
| startbilldate | 单据日期-开始日期（“yyyy-MM-dd”） | string | |
| endbilldate | 单据日期-结束日期（“yyyy-MM-dd”） | string | |
| search | 模糊搜索，支持供应商名称、职员名称、商品名称、单据编码 | string | |
| page | 当前页（默认1） | string | |
| pagesize | 每页显示条数，（默认10，最大值100） | string |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|---|---|---|
| billno | 单据编码 | string | |
| billdate | 单据日期 | string | |
| billstatus | 单据状态，Z：未审核，C：已审核 | string | |
| createtime | 创建时间 | string | |
| modifytime | 修改时间 | string | |
| audittime | 审核时间 | string | |
| creatorid_id | 创建人id | string | |
| creatorid_name | 创建人名称 | string | |
| creatorid_number | 创建人编码 | string | |
| modifierid_id | 修改人id | string | |
| modifierid_name | 修改人名称 | string | |
| modifierid_number | 修改人编码 | string | |
| auditorid_id | 审核人id | string | |
| auditorid_name | 审核人名称 | string | |
| auditorid_number | 审核人编码 | string | |
| transtype | 业务类型 | string | |
| remark | 备注 | string | |
| deptid_id | 部门id | string | |
| deptid_name | 部门名称 | string | |
| deptid_number | 部门编码 | string | |
| empid_id | 业务员id | string | |
| empid_name | 业务员名称 | string | |
| empid_number | 业务员编码 | string | |
| customerid_id | 客户id | string | |
| customerid_name | 客户名称 | string | |
| customerid_number | 客户编码 | string | |
| supplierid_id | 供应商id | string | |
| supplierid_name | 供应商名称 | string | |
| supplierid_number | 供应商编码 | string | |
| contact_phone | 联系电话 | string | |
| contact_country_id | 客户国家id | string | |
| contact_country_name | 客户国家名称 | string | |
| contact_country_number | 客户国家编码 | string | |
| contact_province_id | 客户省份id | string | |
| contact_province_name | 客户省份名称 | string | |
| contact_province_number | 客户省份编码 | string | |
| contact_city_id | 客户市区id | string | |
| contact_city_name | 客户市区名称 | string | |
| contact_city_number | 客户市区编码 | string | |
| contact_district_id | 客户区县id | string | |
| contact_district_name | 客户区县名称 | string | |
| contact_district_number | 客户区县编码 | string | |
| contact_address | 具体地址 | string | |
| totalunsettleamount | 已核销金额 | string | |
| totalunsettleamountfor | 已核销金额（本位币） | string | |
| exchangerate | 汇率 | string | |
| settlestatus | 本单核销状态 | string | |
| alldebt | 应付款余额 | string | |
| lastdebt | 上次欠款余额 | string | |
| totalamount | 本单成交 | string | |
| edit_pay_type_id | 付款方式id | string | |
| edit_pay_type_name | 付款方式名称 | string | |
| edit_pay_type_number | 付款方式编码 | string | |
| totalpreamount | 抵扣预付款 | string | |
| bill_dis_amount | 整单折扣额 | string | |
| edit_pay_account_id | 付款账户id | string | |
| edit_pay_account_name | 付款账户名称 | string | |
| edit_pay_account_number | 付款账户编码 | string | |
| bill_dis_rate | 整单折扣率 | string | |
| totalinsamount | 付款合计 | string | |
| material_entity | 商品分录 | array | |
| material_entity.id | 分录ID | string | |
| material_entity.picture | 图片url | string | |
| material_entity.seq | 分录序号 | string | |
| material_entity.materialid_id | 商品id | string | |
| material_entity.materialid_name | 商品名称 | string | |
| material_entity.materialid_number | 商品编码 | string | |
| material_entity.materialid_ismulti_unit | 商品是否多单位 | string | |
| material_entity.materialid_isserial | 商品是否序列号 | string | |
| material_entity.materialid_isasstattr | 商品是否启用辅助属性 | string | |
| material_entity.materialid_iskfperiod | 商品是否开启保质期 | string | |
| material_entity.materialid_isbatch | 商品是否开启批次 | string | |
| material_entity.materialid_model | 商品规格 | string | |
| material_entity.stockid_id | 仓库id | string | |
| material_entity.stockid_name | 仓库名称 | string | |
| material_entity.stockid_number | 仓库编码 | string | |
| material_entity.stockid_isallowfreight | 仓库启用仓位管理 | string | |
| material_entity.spid_id | 仓位id | string | |
| material_entity.spid_name | 仓位名称 | string | |
| material_entity.spid_number | 仓位编码 | string | |
| material_entity.auxpropid_id | 辅助属性id | string | |
| material_entity.auxpropid_name | 辅助属性名称 | string | |
| material_entity.auxpropid_number | 辅助属性编码 | string | |
| material_entity.auxid1_id | 辅助属性1id | string | |
| material_entity.auxid1_name | 辅助属性1名称 | string | |
| material_entity.auxid1_number | 辅助属性1编码 | string | |
| material_entity.auxid2_id | 辅助属性2id | string | |
| material_entity.auxid2_name | 辅助属性2名称 | string | |
| material_entity.auxid2_number | 辅助属性2编码 | string | |
| material_entity.auxid3_id | 辅助属性3id | string | |
| material_entity.auxid3_name | 辅助属性3名称 | string | |
| material_entity.auxid3_number | 辅助属性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 | 保质期天数 | string | |
| material_entity.sn | 序列号 | string | |
| material_entity.snlistid | 序列号流转ID | string | |
| material_entity.baseunit_id | 基本单位id | string | |
| material_entity.baseunit_name | 基本单位名称 | string | |
| material_entity.baseunit_number | 基本单位编码 | string | |
| material_entity.unit_id | 单位id | string | |
| material_entity.unit_name | 单位名称 | string | |
| material_entity.unit_number | 单位编码 | string | |
| material_entity.auxunitid_id | 辅助单位id | string | |
| material_entity.auxunitid_name | 辅助单位名称 | string | |
| material_entity.auxunitid_number | 辅助单位编码 | string | |
| material_entity.conversionrate | 换算公式 | string | |
| material_entity.qty | 数量 | string | |
| material_entity.inv_qty | 库存数量 | string | |
| material_entity.baseqty | 基本数量 | string | |
| material_entity.inv_baseqty | 基本库存数量 | string | |
| material_entity.auxqty | 辅助单位数量 | string | |
| material_entity.deffloatqty | 辅助基本数量 | string | |
| material_entity.auxcoefficient | 辅助换算率 | string | |
| material_entity.coefficient | 换算率 | string | |
| material_entity.price | 单价 | string | |
| material_entity.discount | 折扣（小数） | string | |
| material_entity.comment | 行备注 | string | |
| material_entity.srcbillno | 源单编码 | string | |
| material_entity.srcbilltypeid_id | 源单类型id | string | |
| material_entity.srcbilltypeid_name | 源单类型名称 | string | |
| material_entity.srcbilltypeid_number | 源单类型编码 | string | |
| material_entity.srcinterid | 源单内码 | string | |
| material_entity.src_billdate | 源单日期 | string | |
| material_entity.srcseq | 源单行号 | string | |
| material_entity.srcentryid | 源单分录内码 | string | |
| material_entity.entrysettlestatus | 分录核销状态 | string | |
| material_entity.cursettleamountfor | 本次核销金额 | string | |
| material_entity.returnable_qty | 可退数量 | string | |
| material_entity.disrate | 折扣率 | string | |
| material_entity.cess | 增值税率 | string | |
| material_entity.cost_view | 入库成本 | string | |
| material_entity.unitcost_view | 入库单位成本 | string |
旺店通·企业版接口明细
- 接口：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数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：旺店通·企业版与金蝶云星辰V1之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。
