旺店通·企业版和金蝶云星空接口打通对接实战
对接系统:旺店通·企业版
慧策(原旺店通)是一家技术驱动型智能零售服务商,基于云计算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资产的可插拔、可复用、可组成。