从金蝶云星辰V1到聚水潭通过接口配置打通数据

对接系统:金蝶云星辰V1
金蝶云·星辰基于金蝶云·苍穹云原生PaaS平台构建,聚焦小型企业在线经营和数字化管理,提供财务云、税务云、进销存云、零售云、订货商城等SaaS服务,支持企业拓客开源、智能管理、实时决策;金蝶云·星辰还提供轻量级PaaS平台和全面的API接口,广泛连接生态伙伴,为小微企业提供一站式服务,助力企业快速成长
目标系统:聚水潭
聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年,创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初,以电商SaaSERP切入市场,凭借出色的产品和服务,快速获得市场的肯定。
数据接口配置方案
通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程,将金蝶云星辰V1、聚水潭之间接口数据联通,支持数据在线预览、数据集成流程全过程调试,Web界面追踪调试日志等功能。 平台兼具实时数据处理和数据集成分发功能,用户通过可视化的拖、拽即可完成数据处理逻辑,将数据加工处理后分发到下游业务系统或其他异构存储中。

金蝶云星辰V1接口明细
- 调用接口:jdy/basedata/customer_list
- 接口名称:客户查询
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
pagesize | 每页大小 | string | {{PAGINATION_PAGE_SIZE}} |
selectfields | 自定义返回字段(除默认字段外) | string | saledeptid,salerid,rate,bankaccount,bank,accountopenaddr,mullabel,createtime,last_tracetime,next_tracetime,countryid,provinceid,cityid,districtid,addr,customerlng,customerlat,contactperson_main,mobile_main |
search | 按客户名称、客户编码模糊查询 | string | |
page | 页码 | string | {{PAGINATION_START_PAGE}} |
begintime | 开始时间(格式:“时间戳”,-1表示不过滤) | string | function {{LAST_SYNC_TIME}}0001 |
expiretime | 结束时间(格式:“时间戳”,-1表示不过滤) | string | _function {{CURRENT_TIME}}000*1 |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
customerlat | customerlat | string | |
createtime | createtime | string | |
countryid_name | countryid_name | string | |
group_name | group_name | string | |
countryid_number | countryid_number | string | |
customerlng | customerlng | string | |
bankaccount | bankaccount | string | |
accountopenaddr | accountopenaddr | string | |
remark | remark | string | |
number | number | string | |
bank | bank | string | |
mullabel | mullabel | object | |
group_id | group_id | string | |
group_number | group_number | string | |
rate | rate | string | |
enable | enable | string | |
last_tracetime | last_tracetime | string | |
name | name | string | |
next_tracetime | next_tracetime | string | |
id | id | string | |
addr | addr | string | |
countryid_id | countryid_id | string | |
聚水潭接口明细
- 接口:jushuitan.orders.upload
- 接口名称:订单上传
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
shop_id | 店铺编号 | string | 店铺编号 |
so_id | 线上订单号 | string | 线上订单号, 长度 <= 50 |
order_date | 订单日期 | string | 订单日期 |
shop_status | 订单 | string | 订单: 等待买家付款=WAIT_BUYER_PAY, 等待卖家发货=WAIT_SELLER_SEND_GOODS,等待买家确认收货=WAIT_BUYER_CONFIRM_GOODS, 交易成功=TRADE_FINISHED, 付款后交易关闭=TRADE_CLOSED,付款前交易关闭=TRADE_CLOSED_BY_TAOBAO;发货前可更新 |
shop_buyer_id | 买家帐号 长度 <= 50 | string | 买家帐号 长度 <= 50 |
receiver_state | 收货省份 | string | 收货省份 长度 <= 50;发货前可更新 |
receiver_city | 收货市 | string | 收货市 长度<=50;发货前可更新 |
receiver_district | 收货区 | string | 收货区 长度<=50;发货前可更新 |
receiver_address | 收货地址 | string | 收货地址 长度<=200;发货前可更新 |
receiver_name | 收件人 | string | 收件人 长度<=50;发货前可更新 |
receiver_phone | 联系电话 | string | 联系电话 长度<=50;发货前可更新 |
receiver_mobile | 手机 | string | 手机 长度<=50;发货前可更新 |
pay_amount | 应付金额 | string | 应付金额,保留两位小数,单位元) |
freight | 运费 | string | 运费 |
buyer_message | 买家留言 | string | 买家留言 长度<=400;可更新 |
remark | 卖家备注 | string | 卖家备注 长度<=150;可更新 |
is_cod | 是否货到付款 | string | 是否货到付款 |
shop_modified | 订单修改日期 | string | 订单修改日期 |
l_id | 快递单号 | string | 快递单号 |
logistics_company | 快递公司名称 | string | 快递公司名称 |
question_desc | 订单异常描述 | string | 订单异常描述 |
seller_flag | 卖家标签 | string | 卖家标签(旗帜),可选1:red, 2:yellow, 3:green, 4:blue, 5:purple |
items | 商品明细 | array | 商品明细 |
items.sku_id | ERP内商品编码 | string | ERP内商品编码 长度 <=40 PS: 设置预售标识订单,修改商品编码=商品编码+预售(或==)+预计交货日期(可选) 比如: "A321232" 修改为 "A321232预售2015-12-12" 或者 "A321232" 修改为 "A321232==2015-12-12" 当商品被购买后ERP将自动识别为预售订单并更正商品编码为正确商品编码 |
items.shop_sku_id | 店铺商品编码 | string | 店铺商品编码 长度<=128 |
items.i_id | ERP内款号/货号 | string | ERP内款号/货号 长度<=40 |
items.pic | 图片地址 | string | 图片地址 长度<=300 |
items.properties_value | 商品属性;长度<=100 | string | 商品属性;长度<=100 |
items.amount | 成交总额 | string | 成交总额,保留两位小数,单位(元);备注:可能存在人工改价 |
items.base_price | 原价,保留两位小数,单位(元) | string | 原价,保留两位小数,单位(元) |
items.qty | 数量 | string | 数量 |
items.name | 商品名称 长度<=100 | string | 商品名称 长度<=100 |
items.refund_status | PS | string | PS:值存在,会自动将订单转异常,success 状态的,发货将不发该商品,不支持单商品发部分; 退款状态:可选 退款中=waiting; 退款成功=success,closed=退款关闭:发货前可更新 |
items.outer_oi_id | 商家系统订单商品明细主键 | string | 商家系统订单商品明细主键,为了拆单合单时溯源,最长不超过 50,保持唯一 |
items.remark | 订单明细备注 | string | 订单明细备注 |
items.pay | shop_status | array | shop_status=WAIT_BUYER_PAY 的时候可不给 |
items.pay.outer_pay_id | 外部支付单号 | string | 外部支付单号,最大50 |
items.pay.pay_date | 支付日期 | string | 支付日期 |
items.pay.payment | 支付方式,最大20 | string | 支付方式,最大20 |
items.pay.seller_account | 卖家支付账号 | string | 卖家支付账号,最大 50 |
items.pay.buyer_account | 买家支付账号 | string | 买家支付账号,最大 200 |
items.pay.amount | 支付总额 | string | 支付总额 |
items.pay.card | 身份证信息 | array | 身份证信息;非必填节点 |
items.pay.card.name | 姓名 | string | 姓名;可更新,card节点存在必填 |
items.pay.card.card_id | 证件号 | string | 证件号;可更新,card节点存在必填 |
items.pay.card.send_date | 发货日期 | string | 发货日期 |
items.pay.card.labels | 订单多标签 | string | 订单多标签 长度<=200 以逗号分隔,单个标签不能超过十个字符 |
items.pay.card.lc_id | 快递公司编码 | string | 快递公司编码 |
items.pay.card.receiver_country | 收货国家 仅支持二字码 | string | 收货国家 仅支持二字码 |
items.pay.card.receiver_zip | 邮政编码 | string | 邮政编码 |
items.pay.card.currency | 货币代码 | string | 货币代码,跨境自有平台可使用 |
items.pay.card.invoice_type | 发票类型 | string | 发票类型:个人电子普通;单位电子普通;个人纸质普通;单位纸质普通;个人电子增值税;单位电子增值税;个人纸质增值税;单位纸质增值税 |
items.pay.card.invoice_title | 发票抬头 | string | 发票抬头 |
items.pay.card.buyer_tax_no | 发票税号 | string | 发票税号 |
items.pay.card.invoice | 专票信息 | array | 专票信息 |
items.pay.card.invoice.address | 专票地址 | string | 专票地址 |
items.pay.card.invoice.bank | 专票银行 | string | 专票银行 |
items.pay.card.invoice.phone | 专票电话 | string | 专票电话 |
items.pay.card.invoice.account | 专票账户 | string | 专票账户 |
items.pay.card.invoice.email | 专票邮箱 | string | 专票邮箱 |
items.pay.card.invoice.userName | 专票人姓名 | string | 专票人姓名 |
items.pay.card.invoice.userPhone | 专票人电话 | string | 专票人电话 |
items.pay.card.invoice.userAddress | 专票人地址 | string | 专票人地址 |
items.pay.card.invoice.node | 线下备注 | string | 线下备注 |
items.pay.card.invoice.receiver_town | 收货街道 | string | 收货街道 |
items.pay.card.invoice.receiver_email | 收获邮箱 | string | 收获邮箱(需符合邮箱格式否则忽略上传,不可更新) |
系统数据对接
通过无代码的数据集成与数据建模的智能数据管道技术,帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中,并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接金蝶云星辰V1和聚水潭,使得单据无缝互通。打造企业内部数据一体化,让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通,同时支持供应链数据分析流程自动化,结果推送,推进相关供应链问题优化。及时打通供应链孤岛,实现数据驱动供应链协同,进一步提升企业竞争力。
