金蝶云星辰V1与聚水潭对接集成客户查询连通订单上传(查询客户)
对接源平台:金蝶云星辰V1
金蝶云星辰是金蝶集团公司为小微型工商贸企业定制的一款集财务、进销存、订货商城和税务管理为一体的SAAS云平台,有标准版和专业版两个版本,标准版适用于小型企业(10-50人)业财一体化管理,专业版面向小型(10-100人)企业管理需求。金蝶云星辰聚焦小型企业在线经营和数字化管理,赋能小型企业拓客开源、智能管理和实时决策。
写入目标:聚水潭
聚水潭成立于2014年,创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初,以电商SaaSERP切入市场,凭借出色的产品和服务,快速获得市场的肯定。随着客户需求的不断变化,如今聚水潭已经发展成为以SaaSERP为核心,集多种商家服务为一体的SaaS协同平台。经过8年多的发展,公司员工从2014年成立之初的9人增加到现在近4000人。聚水潭已在全国设立了超过100个线下服务网点,服务范围覆盖超过400个城镇,为客户提供及时、周到和专业的服务。
配置集成方案
系统对接前期需要通过调研公司的业务,规划出最便捷,效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地,轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台:金蝶云星辰V1的接口参数设置,以及设定好目标平台:聚水潭的映射,即可启动方案进行测试
金蝶云星辰V1接口明细
- 接口:jdy/basedata/customer_list
- 接口名称:客户查询
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
pagesize | 每页大小 | string | |
selectfields | 自定义返回字段(除默认字段外) | string | |
search | 按客户名称、客户编码模糊查询 | string | |
page | 页码 | string | |
begintime | 开始时间(格式:“时间戳”,-1表示不过滤) | string | |
expiretime | 结束时间(格式:“时间戳”,-1表示不过滤) | string | |
响应参数
字段 | 名称 | 类型 | 描述 |
customerlat | customerlat | string | _autoFillResponse |
createtime | createtime | string | _autoFillResponse |
countryid_name | countryid_name | string | _autoFillResponse |
group_name | group_name | string | _autoFillResponse |
countryid_number | countryid_number | string | _autoFillResponse |
customerlng | customerlng | string | _autoFillResponse |
bankaccount | bankaccount | string | _autoFillResponse |
accountopenaddr | accountopenaddr | string | _autoFillResponse |
remark | remark | string | _autoFillResponse |
number | number | string | _autoFillResponse |
bank | bank | string | _autoFillResponse |
mullabel | mullabel | object | _autoFillResponse |
group_id | group_id | string | _autoFillResponse |
group_number | group_number | string | _autoFillResponse |
rate | rate | string | _autoFillResponse |
enable | enable | string | _autoFillResponse |
last_tracetime | last_tracetime | string | _autoFillResponse |
name | name | string | _autoFillResponse |
next_tracetime | next_tracetime | string | _autoFillResponse |
id | id | string | _autoFillResponse |
addr | addr | string | _autoFillResponse |
countryid_id | countryid_id | string | _autoFillResponse |
聚水潭接口明细
- 接口: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 | 收获邮箱(需符合邮箱格式否则忽略上传,不可更新) |
数据对接价值
当企业规模逐渐增大时,作为支撑业务运营的IT建设也变得越来越重要,不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程,这样的结果就是,企业上的IT系统很多很全,从ERP到HR、CRM、PDM、OA等,貌似所有的业务都覆盖到了,但实际上因为这些系统的不集成,而形成了企业很多新的信息孤岛,非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看,也不可避免会遇到上述问题,毕竟企业经营的多样化,并不是所有的业务都能在一个系统中完成,所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。