旺店通·企业版和金蝶云星空接口打通对接实战
对接系统：旺店通·企业版
慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。
对接目标平台:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
配置集成方案
通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将旺店通·企业版、金蝶云星空之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，Web界面追踪调试日志等功能。 平台兼具实时数据处理和数据集成分发功能，用户通过可视化的拖、拽即可完成数据处理逻辑，将数据加工处理后分发到下游业务系统或其他异构存储中。
旺店通·企业版接口明细
- API：trade_query
- NAME：订单查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| status | 订单状态 | | |
| start_time | 开始时间 | {{DAYS_AGO_1 datetime}} | |
| end_time | 结束时间 | {{CURRENT_TIME datetime}} | |
| src_tid | 原始单号 | | |
| trade_no | 订单编号 | | |
| shop_no | 店铺编号 | | |
| warehouse_no | 仓库编号 | | |
| goodstax | 使用税率 | | |
| has_logistics_no | 物流单号限制 | | |
| src | 是否返回交易流水号、付款状态、付款时间 | | |
| logistics_no | 物流单号 | | |
| page_size | 分页大小 | {{PAGINATION_PAGE_SIZE}} | 每页返回的数据条数，输入值范围1100，不传本参数，输入值默认为40，使用举例单击这里 |
| page_no | 页号 | {{PAGINATION_START_PAGE}} | 不传值默认从0页开始 |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| 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 | 子单付款时间 | | |
金蝶云星空接口明细
- 调用接口：batchSave
- 接口名称：销售订单新增
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FBillNo | 单据编号 | string | |
| FSaleOrgId | 销售组织 | string | 100 |
| FDate | 日期 | string | {{trade_time}} |
| FCustId | 客户 | string | {{shop_no}} |
| FBillTypeID | 单据类型 | string | XSDD01_SYS |
| FNote | 备注 | string | |
| FLinkMan | 收货人姓名 | string | |
| FLinkPhone | 联系电话 | string | |
| FSaleOrderEntry | 订单明细 | array | |
| FSaleOrderEntry.FMaterialId | 物料编码 | string | |
| FSaleOrderEntry.FQty | 销售数量 | string | |
| FSaleOrderEntry.FPrice | 单价 | string | |
| FSaleOrderEntry.FTaxPrice | 含税单价 | string | |
| FSaleOrderEntry.FSettleOrgIds | 结算组织 | string | 100 |
| FSaleOrderEntry.FEntryNote | 备注 | string | |
| FSaleOrderEntry.FSalerId | 销售员 | string | 008_GW000002_100052 |
| FSaleOrderEntry.FormId | 业务对象表单Id | string | SAL_SaleOrder |
| FSaleOrderEntry.Operation | 执行的操作 | string | BatchSave |
| FSaleOrderEntry.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
| FSaleOrderEntry.IsVerifyBaseDataField | 验证基础资料 | bool | false |
系统对接总览
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
