旺店通·企业版和金蝶云星空集成接口设计
接入系统：旺店通·企业版
旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算SaaS服务模式，以体系化解决方案，助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案，致力于帮助企业实现数字化转型，企业规模化发展
接通系统：金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
数据接口配置
通过系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：旺店通·企业版，然后选择对应的连接器。选择对应的trade_query作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。系统数据集成平台更加专注于数据集成与流程自动化的应用连接器，通过自研引擎，与各个平台或者服务完成对接，从而打通数据孤岛，实现数据的跨系统自由流转，让数据真正成为企业的核心生产力。
旺店通·企业版接口明细
- API：trade_query
- NAME：订单查询
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| status | 订单状态 | |
| start_time | 开始时间 | 2022-12-21 11:24:04 |
| end_time | 结束时间 | 2022-12-21 12:24:04 |
| src_tid | 原始单号 | |
| trade_no | 订单编号 | |
| shop_no | 店铺编号 | |
| warehouse_no | 仓库编号 | |
| goodstax | 使用税率 | |
| has_logistics_no | 物流单号限制 | |
| src | 是否返回交易流水号、付款状态、付款时间 | |
| logistics_no | 物流单号 | |
| page_size | 分页大小 | {{PAGINATION_PAGE_SIZE}} |
| page_no | 页号 | {{PAGINATION_START_PAGE}} |
响应参数
| 接口字段 | 名称 | 预设值 |
|---|
| trade_id | erp订单表的主键 | |
| trade_no | 订单编号 | |
| platform_id | 平台ID | |
| shop_no | 店铺编号 | |
| shop_name | 店铺名称 | |
| shop_remark | 店铺备注 | |
| warehouse_type | 仓库类型 | |
| warehouse_no | 仓库编号 | |
| src_tids | 原始单号 | |
| trade_status | 订单状态 | |
| consign_status | 发货状态 | |
| trade_type | 订单类型 | |
| delivery_term | 发货条件 | |
| freeze_reason | 冻结原因 | |
| refund_status | 退款状态 | |
| fenxiao_type | 分销类别 | |
| fenxiao_nick | 分销商名称 | |
| trade_time | 下单时间 | |
| pay_time | 付款时间 | |
| customer_name | 客户名称 | |
| customer_no | 客户编码 | |
| pay_account | 买家付款账号 | |
| buyer_nick | 客户网名 | |
| receiver_name | 收件人 | |
| receiver_province | 收件人省份 | |
| receiver_city | 收件人城市 | |
| receiver_district | 收件人地区 | |
| receiver_address | 地址 | |
| receiver_mobile | 手机 | |
| receiver_telno | 电话 | |
| receiver_zip | 邮编 | |
| receiver_area | 省市县 | |
| receiver_ring | 区域 | |
| receiver_dtb | 大头笔 | |
| to_deliver_time | 派送时间 | |
| bad_reason | 异常订单 | |
| logistics_id | 物流公司ID | |
| logistics_name | 物流公司名称 | |
| logistics_code | 物流公司编号 | |
| logistics_type | 物流方式 | |
| logistics_no | 物流单号 | |
| shop_id | 店铺id | |
| warehouse_id | 仓库id | |
| check_step | 审核步骤 | |
| unmerge_mask | 未合并标记 | |
| delay_to_time | 延迟处理 | |
| customer_type | 客户类型 | |
| customer_id | 买家id | |
| receiver_country | 收件人国家 | |
| pre_charge_time | 预配送时间 | |
| is_prev_notify | 是否京配 | |
| note_count | 便签条数 | |
| buyer_message_count | 买家留言条数 | |
| cs_remark_count | 客服备注条数 | |
| cs_remark_change_count | 客服备注变化 | |
| discount_change | 优惠变化金额 | |
| trade_prepay | 使用的预存款 | |
| pi_amount | 分期付款金额 | |
| other_cost | 其它成本 | |
| volume | 体积 | |
| sales_score | 销售积分 | |
| flag_id | 标记id | |
| is_sealed | 不可合并拆分 | |
| gift_mask | 赠品标记 | |
| split_from_trade_id | 拆分订单，原单ID | |
| logistics_template_id | 物流单模板ID | |
| sendbill_template_id | 发货单模板id | |
| revert_reason | 驳回原因 | |
| cancel_reason | 取消原因 | |
| is_unpayment_sms | 催未付款订单消息发送标记 | |
| package_id | 包装id | |
| trade_mask | 订单标记位 | |
| reserve | 保留 | |
| large_type | 大件类型 | |
| buyer_message | 买家留言 | |
| cs_remark | 客服备注 | |
| remark_flag | 标旗 | |
| print_remark | 打印备注 | |
| goods_type_count | 货品种类数 | |
| goods_count | 货品总数 | |
| goods_amount | 货品总额 | |
| post_amount | 邮资 | |
| other_amount | 其它费用 | |
| discount | 折扣 | |
| receivable | 应收金额 | |
| dap_amount | 款到发货金额 | |
| cod_amount | COD金额 | |
| ext_cod_fee | 买家COD费用 | |
| goods_cost | 货品预估成本 | |
| post_cost | 邮资成本 | |
| paid | 已付金额 | |
| weight | 预估重量 | |
| profit | 预估毛利 | |
| tax | 税额 | |
| tax_rate | 税率 | |
| commission | 佣金 | |
| invoice_type | 发票类型 | |
| invoice_title | 发票抬头 | |
| invoice_content | 发票内容 | |
| salesman_id | 业务员 | |
| checker_id | 审核人 | |
| fullname | 业务员姓名 | |
| checker_name | 审核人 | |
| fchecker_id | 财审人 | |
| checkouter_id | 签出人 | |
| stockout_no | 出库单号 | |
| flag_name | 标记名称 | |
| trade_from | 订单来源 | |
| single_spec_no | 货品商家编码 | |
| raw_goods_count | 原始货品数量 | |
| raw_goods_type_count | 原始货品种类数 | |
| currency | 币种 | |
| split_package_num | 线上包裹拆分数 | |
| invoice_id | 发票ID | |
| version_id | 版本号 | |
| modified | 最后修改时间 | |
| created | 订单生成时间 | |
| id_card_type | 证件类别 | |
| id_card | 证件号码 | |
| goods_list | 货品列表节点 | |
| goods_list.rec_id | erp子订单主键 | |
| goods_list.trade_id | erp订单主键 | |
| goods_list.spec_id | erp内商品主键 | |
| goods_list.platform_id | 平台 | |
| goods_list.src_oid | 子订单编号 | |
| goods_list.platform_goods_id | 平台货品ID | |
| goods_list.platform_spec_id | 平台商品ID | |
| goods_list.suite_id | 组合装ID | |
| goods_list.flag | 区分子单拆分的唯一性标记 | |
| goods_list.src_tid | 原始订单编号 | |
| goods_list.gift_type | 赠品方式 | |
| goods_list.refund_status | 退款状态 | |
| goods_list.guarantee_mode | 担保方式 | |
| goods_list.delivery_term | 发货条件 | |
| goods_list.bind_oid | 关联发货 | |
| goods_list.num | 下单数量 | |
| goods_list.price | 标价 | |
| goods_list.actual_num | 实发数量 | |
| goods_list.refund_num | 售后退款数量 | |
| goods_list.order_price | 成交价 | |
| goods_list.share_price | 分摊后价格 | |
| goods_list.adjust | 手工调整价 | |
| goods_list.discount | 总折扣金额 | |
| goods_list.share_amount | 分摊后总价 | |
| goods_list.share_post | 分摊邮费 | |
| goods_list.paid | 已付 | |
| goods_list.goods_name | 货品名称 | |
| goods_list.prop2 | 自定义属性2 | |
| goods_list.barcode | 主条码 | |
| goods_list.goods_id | 货品id | |
| goods_list.goods_no | 货品编号 | |
| goods_list.spec_name | 规格名 | |
| goods_list.spec_no | 商家编码 | |
| goods_list.spec_code | 规格码 | |
| goods_list.suite_no | 组合装编码 | |
| goods_list.suite_name | 拆自组合装 | |
| goods_list.suite_num | 组合装数量 | |
| goods_list.suite_amount | 组合装分摊后总价 | |
| goods_list.suite_discount | 组合装优惠 | |
| goods_list.share_amount2 | share_amount备份值 | |
| goods_list.is_print_suite | 是否打印组合装 | |
| goods_list.is_zero_cost | 是否允许0成本 | |
| goods_list.stock_reserved | 库存保留情况 | |
| goods_list.is_consigned | 平台已发货 | |
| goods_list.is_received | 是否打款 | |
| goods_list.is_master | 是否为主子订单 | |
| goods_list.api_goods_name | 平台货品名称 | |
| goods_list.api_spec_name | 平台规格名称 | |
| goods_list.weight | 估重 | |
| goods_list.commission | 佣金 | |
| goods_list.goods_type | 货品类别 | |
| goods_list.large_type | 大件类型 | |
| goods_list.invoice_type | 发票类别 | |
| goods_list.invoice_content | 发票内容 | |
| goods_list.from_mask | 原始单标记 | |
| goods_list.cid | 类目id | |
| goods_list.remark | 备注 | |
| goods_list.modified | 最后修改时间 | |
| goods_list.created | 创建时间 | |
| goods_list.tax_rate | 税率 | |
| goods_list.base_unit_id | 基本单位 | |
| goods_list.unit_name | 基本单位名称 | |
| goods_list.pay_id | 交易流水单号 | |
| goods_list.pay_status | 子单付款状态 | |
| goods_list.pay_time | 子单付款时间 | |
金蝶云星空接口明细
- API：batchSave
- NAME：销售出库新增
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| FBillTypeID | 单据类型 | XSCKD01_SYS |
| FBillNo | 单据编号 | |
| FDate | 日期 | |
| FSaleOrgId | 销售组织 | |
| FCustomerID | 客户 | |
| FCarriageNO | 运输单号 | |
| FStockOrgId | 发货组织 | |
| FLinkPhone | 联系电话 | |
| FLinkMan | 收货人姓名 | |
| FReceiveAddress | 收货方地址 | |
| SubHeadEntity | 财务信息 | |
| SubHeadEntity.FSettleTypeID | 结算方式 | JSFS04_SYS |
| SubHeadEntity.FReceiverAddress | 收货人地址 | |
| SubHeadEntity.FReceiverName | 收货人 | |
| SubHeadEntity.FReceiverMobile | 收货人手机 | |
| SubHeadEntity.FEntity | 明细信息 | |
| SubHeadEntity.FEntity.FMaterialID | 物料编码 | |
| SubHeadEntity.FEntity.FRealQty | 实发数量 | |
| SubHeadEntity.FEntity.FTaxPrice | 含税单价 | |
| SubHeadEntity.FEntity.FStockID | 仓库 | |
| SubHeadEntity.FEntity.FormId | 业务对象表单Id | SAL_OUTSTOCK |
| SubHeadEntity.FEntity.Operation | 执行的操作 | Save |
| SubHeadEntity.FEntity.IsAutoSubmitAndAudit | 提交并审核 | true |
| SubHeadEntity.FEntity.IsVerifyBaseDataField | 验证基础资料 | false |
| SubHeadEntity.FEntity.SubSystemId | 系统模块 | 21 |
系统数据对接
通过无代码的数据集成与数据建模的智能数据管道技术，帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中，并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接旺店通·企业版和金蝶云星空，使得单据无缝互通。打造企业内部数据一体化，让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通，同时支持供应链数据分析流程自动化，结果推送，推进相关供应链问题优化。及时打通供应链孤岛，实现数据驱动供应链协同，进一步提升企业竞争力。
