从金蝶云星辰V1到吉客云通过接口配置打通数据
对接系统金蝶云星辰V1
金蝶云星辰是金蝶集团公司为小微型工商贸企业定制的一款集财务、进销存、订货商城和税务管理为一体的SAAS云平台，有标准版和专业版两个版本，标准版适用于小型企业(10-50人)业财一体化管理，专业版面向小型(10-100人)企业管理需求。金蝶云星辰聚焦小型企业在线经营和数字化管理，赋能小型企业拓客开源、智能管理和实时决策。
写入目标:吉客云
“吉客云”是一站式企业数字化解决方案系统，可实现业务、财务、办公、人事等一体化管理。相对于传统多套软件系统的集成方案，“吉客云”具有业务流程更流畅，数据共享更充分，使用成本更低廉等优势。不仅如此，通过“吉链”，可以快捷的与您的合作伙伴进行系统对接。同时“吉客云”还打造了供销关系、仓储委托关系、生产委外加工关系、物流代发关系等多种企业间数字化协作通道，数据对接就像加微信好友一样方便！
数据接口配置
轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：金蝶云星辰V1的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：吉客云，把获取的数据组装成目标系统需要的格式进行写入。
金蝶云星辰V1接口明细
- 接口：jdy/pur/pur_inbound_list
- 接口名称：采购入库单查询（列表+详情）
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|---|---|---|
| deptid | 部门ID | string | 部门ID |
| empid | 职员ID | string | 职员ID |
| supplierid | 供应商ID | string | 供应商ID |
| billstatus | 单据状态（所有：“”，已审核：“C”，未审核：“Z”） | string | 单据状态（所有：“”，已审核：“C”，未审核：“Z”） |
| startdate | 开始日期（格式：“yyyy-MM-dd”，为空表示不过滤），创建日期 | string | 开始日期（格式：“yyyy-MM-dd”，为空表示不过滤），创建日期 |
| enddate | 结束日期（格式：“yyyy-MM-dd”，为空表示不过滤），创建日期 | string | 结束日期（格式：“yyyy-MM-dd”，为空表示不过滤），创建日期 |
| begindate | 开始日期（格式：“yyyy-MM-dd”，为空表示不过滤），修改日期 | string | 开始日期（格式：“yyyy-MM-dd”，为空表示不过滤），修改日期 |
| expiredate | 结束日期（格式：“yyyy-MM-dd”，为空表示不过滤），修改日期 | string | 结束日期（格式：“yyyy-MM-dd”，为空表示不过滤），修改日期 |
| starttime | 开始时间（格式：“时间戳”，-1表示不过滤），创建时间 | string | 开始时间（格式：“时间戳”，-1表示不过滤），创建时间 |
| endtime | 结束时间（格式：“时间戳”，-1表示不过滤），创建时间 | string | 结束时间（格式：“时间戳”，-1表示不过滤），创建时间 |
| begintime | 开始时间（格式：“时间戳”，-1表示不过滤），修改时间 | string | 开始时间（格式：“时间戳”，-1表示不过滤），修改时间 |
| expiretime | 结束时间（格式：“时间戳”，-1表示不过滤），修改时间 | string | 结束时间（格式：“时间戳”，-1表示不过滤），修改时间 |
| startbilldate | 单据日期-开始日期（“yyyy-MM-dd”） | string | 单据日期-开始日期（“yyyy-MM-dd”） |
| endbilldate | 单据日期-结束日期（“yyyy-MM-dd”） | string | 单据日期-结束日期（“yyyy-MM-dd”） |
| search | 模糊搜索，支持供应商名称、职员名称、商品名称、单据编码 | string | 模糊搜索，支持供应商名称、职员名称、商品名称、单据编码 |
| page | 当前页（默认1） | string | 当前页（默认1） |
| pagesize | 每页显示条数，（默认10，最大值100） | string | 每页显示条数，（默认10，最大值100） |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|---|---|---|
| id | 单据ID | string | 单据ID |
| billno | 单据编码 | string | 单据编码 |
| billdate | 单据日期 | string | 单据日期 |
| billstatus | 单据状态，Z：未审核，C：已审核 | string | 单据状态，Z：未审核，C：已审核 |
| createtime | 创建时间 | string | 创建时间 |
| modifytime | 修改时间 | string | 修改时间 |
| audittime | 审核时间 | string | 审核时间 |
| creatorid_id | 创建人id | string | 创建人id |
| creatorid_name | 创建人名称 | string | 创建人名称 |
| creatorid_number | 创建人编码 | string | 创建人编码 |
| modifierid_id | 修改人id | string | 修改人id |
| modifierid_name | 修改人名称 | string | 修改人名称 |
| modifierid_number | 修改人编码 | string | 修改人编码 |
| auditorid_id | 审核人id | string | 审核人id |
| auditorid_name | 审核人名称 | string | 审核人名称 |
| auditorid_number | 审核人编码 | string | 审核人编码 |
| transtype | 业务类型 | string | 业务类型 |
| remark | 备注 | string | 备注 |
| deptid_id | 部门id | string | 部门id |
| deptid_name | 部门名称 | string | 部门名称 |
| deptid_number | 部门编码 | string | 部门编码 |
| empid_id | 业务员id | string | 业务员id |
| empid_name | 业务员名称 | string | 业务员名称 |
| empid_number | 业务员编码 | string | 业务员编码 |
| customerid_id | 客户id | string | 客户id |
| customerid_name | 客户名称 | string | 客户名称 |
| customerid_number | 客户编码 | string | 客户编码 |
| supplierid_id | 供应商id | string | 供应商id |
| supplierid_name | 供应商名称 | string | 供应商名称 |
| supplierid_number | 供应商编码 | string | 供应商编码 |
| contact_phone | 联系电话 | string | 联系电话 |
| contact_country_id | 客户国家id | string | 客户国家id |
| contact_country_name | 客户国家名称 | string | 客户国家名称 |
| contact_country_number | 客户国家编码 | string | 客户国家编码 |
| contact_province_id | 客户省份id | string | 客户省份id |
| contact_province_name | 客户省份名称 | string | 客户省份名称 |
| contact_province_number | 客户省份编码 | string | 客户省份编码 |
| contact_city_id | 客户市区id | string | 客户市区id |
| contact_city_name | 客户市区名称 | string | 客户市区名称 |
| contact_city_number | 客户市区编码 | string | 客户市区编码 |
| contact_district_id | 客户区县id | string | 客户区县id |
| contact_district_name | 客户区县名称 | string | 客户区县名称 |
| contact_district_number | 客户区县编码 | string | 客户区县编码 |
| contact_address | 具体地址 | string | 具体地址 |
| totalunsettleamount | 已核销金额 | string | 已核销金额 |
| totalunsettleamountfor | 已核销金额（本位币） | string | 已核销金额（本位币） |
| exchangerate | 汇率 | string | 汇率 |
| settlestatus | 本单核销状态 | string | 本单核销状态 |
| alldebt | 应付款余额 | string | 应付款余额 |
| lastdebt | 上次欠款余额 | string | 上次欠款余额 |
| totalamount | 本单成交 | string | 本单成交 |
| edit_pay_type_id | 付款方式id | string | 付款方式id |
| edit_pay_type_name | 付款方式名称 | string | 付款方式名称 |
| edit_pay_type_number | 付款方式编码 | string | 付款方式编码 |
| totalpreamount | 抵扣预付款 | string | 抵扣预付款 |
| bill_dis_amount | 整单折扣额 | string | 整单折扣额 |
| edit_pay_account_id | 付款账户id | string | 付款账户id |
| edit_pay_account_name | 付款账户名称 | string | 付款账户名称 |
| edit_pay_account_number | 付款账户编码 | string | 付款账户编码 |
| bill_dis_rate | 整单折扣率 | string | 整单折扣率 |
| totalinsamount | 付款合计 | string | 付款合计 |
| material_entity | 商品分录 | array | 商品分录 |
| material_entity.picture | 图片url | string | 图片url |
| material_entity.seq | 分录序号 | string | 分录序号 |
| material_entity.id | 分录ID | string | 分录ID |
| material_entity.materialid_id | 商品id | string | 商品id |
| material_entity.materialid_name | 商品名称 | string | 商品名称 |
| material_entity.materialid_number | 商品编码 | string | 商品编码 |
| material_entity.materialid_ismulti_unit | 商品是否多单位 | string | 商品是否多单位 |
| material_entity.materialid_isserial | 商品是否序列号 | string | 商品是否序列号 |
| material_entity.materialid_isasstattr | 商品是否启用辅助属性 | string | 商品是否启用辅助属性 |
| material_entity.materialid_iskfperiod | 商品是否开启保质期 | string | 商品是否开启保质期 |
| material_entity.materialid_isbatch | 商品是否开启批次 | string | 商品是否开启批次 |
| material_entity.materialid_model | 商品规格 | string | 商品规格 |
| material_entity.stockid_id | 仓库id | string | 仓库id |
| material_entity.stockid_name | 仓库名称 | string | 仓库名称 |
| material_entity.stockid_number | 仓库编码 | string | 仓库编码 |
| material_entity.stockid_isallowfreight | 仓库启用仓位管理 | string | 仓库启用仓位管理 |
| material_entity.spid_id | 仓位id | string | 仓位id |
| material_entity.spid_name | 仓位名称 | string | 仓位名称 |
| material_entity.spid_number | 仓位编码 | string | 仓位编码 |
| material_entity.auxpropid_id | 辅助属性id | string | 辅助属性id |
| material_entity.auxpropid_name | 辅助属性名称 | string | 辅助属性名称 |
| material_entity.auxpropid_number | 辅助属性编码 | string | 辅助属性编码 |
| material_entity.auxid1_id | 辅助属性1id | string | 辅助属性1id |
| material_entity.auxid1_name | 辅助属性1名称 | string | 辅助属性1名称 |
| material_entity.auxid1_number | 辅助属性1编码 | string | 辅助属性1编码 |
| material_entity.auxid2_id | 辅助属性2id | string | 辅助属性2id |
| material_entity.auxid2_name | 辅助属性2名称 | string | 辅助属性2名称 |
| material_entity.auxid2_number | 辅助属性2编码 | string | 辅助属性2编码 |
| material_entity.auxid3_id | 辅助属性3id | string | 辅助属性3id |
| material_entity.auxid3_name | 辅助属性3名称 | string | 辅助属性3名称 |
| material_entity.auxid3_number | 辅助属性3编码 | string | 辅助属性3编码 |
| material_entity.barcode | 条形码 | string | 条形码 |
| material_entity.batchno | 批次号 | string | 批次号 |
| material_entity.proplace | 产地 | string | 产地 |
| material_entity.proregno | 注册证号 | string | 注册证号 |
| material_entity.prolicense | 生产许可证号 | string | 生产许可证号 |
| material_entity.kfdate | 生产日期 | string | 生产日期 |
| material_entity.validdate | 有效日期 | string | 有效日期 |
| material_entity.kftype | 保质期类型，1：天，2：月，3：年 | string | 保质期类型，1：天，2：月，3：年 |
| material_entity.kfperiod | 保质期天数 | string | 保质期天数 |
| material_entity.sn | 序列号 | string | 序列号 |
| material_entity.snlistid | 序列号流转ID | string | 序列号流转ID |
| material_entity.baseunit_id | 基本单位id | string | 基本单位id |
| material_entity.baseunit_name | 基本单位名称 | string | 基本单位名称 |
| material_entity.baseunit_number | 基本单位编码 | string | 基本单位编码 |
| material_entity.unit_id | 单位id | string | 单位id |
| material_entity.unit_name | 单位名称 | string | 单位名称 |
| material_entity.unit_number | 单位编码 | string | 单位编码 |
| material_entity.auxunitid_id | 辅助单位id | string | 辅助单位id |
| material_entity.auxunitid_name | 辅助单位名称 | string | 辅助单位名称 |
| material_entity.auxunitid_number | 辅助单位编码 | string | 辅助单位编码 |
| material_entity.conversionrate | 换算公式 | string | 换算公式 |
| material_entity.qty | 数量 | string | 数量 |
| material_entity.inv_qty | 库存数量 | string | 库存数量 |
| material_entity.baseqty | 基本数量 | string | 基本数量 |
| material_entity.inv_baseqty | 基本库存数量 | string | 基本库存数量 |
| material_entity.auxqty | 辅助单位数量 | string | 辅助单位数量 |
| material_entity.deffloatqty | 辅助基本数量 | string | 辅助基本数量 |
| material_entity.auxcoefficient | 辅助换算率 | string | 辅助换算率 |
| material_entity.coefficient | 换算率 | string | 换算率 |
| material_entity.price | 单价 | string | 单价 |
| material_entity.discount | 折扣（小数） | string | 折扣（小数） |
| material_entity.comment | 行备注 | string | 行备注 |
| material_entity.srcbillno | 源单编码 | string | 源单编码 |
| material_entity.srcbilltypeid_id | 源单类型id | string | 源单类型id |
| material_entity.srcbilltypeid_name | 源单类型名称 | string | 源单类型名称 |
| material_entity.srcbilltypeid_number | 源单类型编码 | string | 源单类型编码 |
| material_entity.srcinterid | 源单内码 | string | 源单内码 |
| material_entity.src_billdate | 源单日期 | string | 源单日期 |
| material_entity.srcseq | 源单行号 | string | 源单行号 |
| material_entity.srcentryid | 源单分录内码 | string | 源单分录内码 |
| material_entity.entrysettlestatus | 分录核销状态 | string | 分录核销状态 |
| material_entity.cursettleamountfor | 本次核销金额 | string | 本次核销金额 |
| material_entity.returnable_qty | 可退数量 | string | 可退数量 |
| material_entity.disrate | 折扣率 | string | 折扣率 |
| material_entity.cess | 增值税率 | string | 增值税率 |
| material_entity.cost_view | 入库成本 | string | 入库成本 |
| material_entity.unitcost_view | 入库单位成本 | string | 入库单位成本 |
吉客云接口明细
- 调用接口：crm.customer.add
- 接口名称：客户新增
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|---|---|---|
| customerCode | 客户编号 | string | |
| nickname | 客户名称 | string | |
| alias | 别名 | string | |
| vipLevel | 会员等级id | string | |
| vipLevelName | 会员等级名称 | string | |
| contacts | 联系人 | string | |
| country | 国家 | string | |
| state | 省份 | string | |
| city | 城市 | string | |
| district | 区 | string | |
| town | 镇 | string | |
| address | 基本信息地址-地址 | string | |
| detailedAddress | 基本信息地址-详细地址 | string | |
| zip | 邮编 | string | |
| gender | 性别（枚举） | string | |
| age | 年龄 | string | |
| birthday | 生日 | string | |
| calendarType | 生日日期类型（枚举） | string | |
| phone | 联系电话 | string | |
| string | |||
| string | |||
| weiXin | 微信 | string | |
| taxNumber | 开票税号 | string | |
| customerManager | 客户经理id | string | |
| customerManagerName | 客户经理名称 | string | |
| refereeId | 客户经理名称 | string | |
| referee | 推荐人名称 | string | |
| specialReminding | 特别提醒 | string | |
| customerType | 客户类别id | string | |
| customerTypeName | 客户类别名称 | string |
数据对接价值
将传统的统计分析转变为预测分析，从被动分析到主动分析，从非实时分析转变为实时分析，从结构化的数据变成多元化的数据。精准查询数据流同步状况，实时监管队列任务以及数据资产的有序管理。为业务赋能，降本增效，让企业能够更加合理的布局团队；结合业务需求实现与OA，CRM，WMS等系统之间的数据交流与同步，为企业定制自定义的数据管理方案，用技术拓展商业边界，为新业务、新部门提供成长空间。
