旺店通·企业版对接打通金蝶云星空订单查询接口与销售出库新增接口
数据源平台:旺店通·企业版
旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算SaaS服务模式，以体系化解决方案，助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案，致力于帮助企业实现数字化转型，企业规模化发展
接入系统：金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
数据接口配置方案
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取旺店通·企业版的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。
旺店通·企业版接口明细
- API：trade_query
- NAME：订单查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| status | 订单状态 | 1 | |
| start_time | 开始时间 | 2022-12-21 11:24:04 | 1 |
| end_time | 结束时间 | 2022-12-21 12:24:04 | 11 |
| src_tid | 原始单号 | 1 | |
| trade_no | 订单编号 | 1 | |
| shop_no | 店铺编号 | 111 | |
| warehouse_no | 仓库编号 | 111 | |
| goodstax | 使用税率 | 111 | |
| has_logistics_no | 物流单号限制 | 1111 | |
| src | 是否返回交易流水号、付款状态、付款时间 | nu1ll | |
| logistics_no | 物流单号 | ||
| page_size | 分页大小 | {{PAGINATION_PAGE_SIZE}} | 每页返回的数据条数，输入值范围1100，不传本参数，输入值默认为40，使用举例单击这里 |
| page_no | 页号 | {{PAGINATION_START_PAGE}} | 不传值默认从0页开始 |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| trade_id | erp订单表的主键 | trade_id | |
| trade_no | 订单编号 | trade_no | |
| platform_id | 平台ID | platform_id | |
| shop_no | 店铺编号 | shop_no | |
| shop_name | 店铺名称 | shop_name | |
| shop_remark | 店铺备注 | shop_remark | |
| warehouse_type | 仓库类型 | warehouse_type | |
| warehouse_no | 仓库编号 | warehouse_no | |
| src_tids | 原始单号 | src_tids | |
| trade_status | 订单状态 | trade_status | |
| consign_status | 发货状态 | consign_status | |
| trade_type | 订单类型 | trade_type | |
| delivery_term | 发货条件 | delivery_term | |
| freeze_reason | 冻结原因 | freeze_reason | |
| refund_status | 退款状态 | refund_status | |
| fenxiao_type | 分销类别 | fenxiao_type | |
| fenxiao_nick | 分销商名称 | fenxiao_nick | |
| trade_time | 下单时间 | trade_time | |
| pay_time | 付款时间 | pay_time | |
| customer_name | 客户名称 | customer_name | |
| customer_no | 客户编码 | customer_no | |
| pay_account | 买家付款账号 | pay_account | |
| buyer_nick | 客户网名 | buyer_nick | |
| receiver_name | 收件人 | buyer_nick | |
| receiver_province | 收件人省份 | receiver_province | |
| receiver_city | 收件人城市 | receiver_city | |
| receiver_district | 收件人地区 | receiver_district | |
| receiver_address | 地址 | receiver_address | |
| receiver_mobile | 手机 | receiver_mobile | |
| receiver_telno | 电话 | receiver_telno | |
| receiver_zip | 邮编 | receiver_zip | |
| receiver_area | 省市县 | receiver_area | |
| receiver_ring | 区域 | receiver_ring | |
| receiver_dtb | 大头笔 | receiver_dtb | |
| to_deliver_time | 派送时间 | to_deliver_time | |
| bad_reason | 异常订单 | bad_reason | |
| logistics_id | 物流公司ID | logistics_id | |
| logistics_name | 物流公司名称 | logistics_name | |
| logistics_code | 物流公司编号 | logistics_code | |
| logistics_type | 物流方式 | logistics_type | |
| logistics_no | 物流单号 | logistics_no | |
| shop_id | 店铺id | shop_id | |
| warehouse_id | 仓库id | warehouse_id | |
| check_step | 审核步骤 | 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 | 单据类型 | {{FBillTypeID}} | 单据类型 |
| FBillNo | 单据编号 | {{FBillTypeID}} | 单据编号 |
| FDate | 日期 | {{FDate}} | 日期 |
| FSaleOrgId | 销售组织 | {{FSaleOrgId}} | 组织 |
| FCustomerID | 客户 | {{FCustomerID}} | 基础资料 |
| FCarriageNO | 运输单号 | FCarriageNO | 文本 |
| FStockOrgId | 发货组织 | FStockOrgId | 组织 |
| FLinkPhone | 联系电话 | FLinkPhone | 文本 |
| FLinkMan | 收货人姓名 | FLinkMan | 文本 |
| FReceiveAddress | 收货方地址 | FReceiveAddress | 文本 |
| SubHeadEntity | 财务信息 | ||
| SubHeadEntity.FSettleTypeID | 结算方式 | JSFS04_SYS | 基础资料 |
| SubHeadEntity.FReceiverAddress | 收货人地址 | FReceiverAddress | 文本 |
| SubHeadEntity.FReceiverName | 收货人 | 文本 | |
| SubHeadEntity.FReceiverMobile | 收货人手机 | FReceiverMobile | 文本 |
| SubHeadEntity.FEntity | 明细信息 | FEntity | |
| SubHeadEntity.FEntity.FMaterialID | 物料编码 | {{FEntity}} | 基础资料 |
| SubHeadEntity.FEntity.FRealQty | 实发数量 | {{FRealQty}} | 数量 |
| SubHeadEntity.FEntity.FTaxPrice | 含税单价 | FTaxPrice | 单价 |
| SubHeadEntity.FEntity.FStockID | 仓库 | FStockID | 基础资料 |
| SubHeadEntity.FEntity.FormId | 业务对象表单Id | {{FormId}} | 必须填写金蝶的表单ID如UR_PurchaseOrder |
| SubHeadEntity.FEntity.Operation | 执行的操作 | {{Operation}} | |
| SubHeadEntity.FEntity.IsAutoSubmitAndAudit | 提交并审核 | {{IsAutoSubmitAndAudit}} | |
| SubHeadEntity.FEntity.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
| SubHeadEntity.FEntity.SubSystemId | 系统模块 | SubSystemId | 默认仓库模块 |
系统对接概况
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
