小满OKKICRM对接打通金蝶云星空订单列表查询接口与销售订单新增接口

小满OKKICRM对接打通金蝶云星空订单列表查询接口与销售订单新增接口

对接系统小满OKKICRM

深圳市小满科技有限公司（简称：小满科技）成立于2013年3月，公司位于深圳市南山区高新园区，是一家国家级高新技术企业。公司旗下产品OKKICRM聚焦外贸客户管理与销售管理，帮助企业实现从线索到订单的全生命周期管理。

对接目标平台:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

配置集成方案

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：小满OKKICRM，然后选择对应的连接器。选择对应的/v1/invoices/order/list作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器（关于金蝶云星空的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。

小满OKKICRM接口明细

• API：/v1/invoices/order/list
• NAME：订单列表查询
• METHOD：GET

请求参数

接口字段	字段名称	预设值	描述
start_time	时间查询范围：开始日期	2020-03-01 00:00:00	时间查询范围：开始日期
end_time	时间查询范围：结束日期	{{CURRENT_TIME datetime}}	时间查询范围：结束日期
start_index	第几页，默认 = 1	1	第几页，默认 = 1
count	每页记录数，默认 = 10	10	每页记录数，默认 = 10
removed	默认值: 0，设置=1时查询已删除的数据列表		默认值: 0，设置=1时查询已删除的数据列表
approval	默认值: 0，设置=1时查询通过审批的数据列表		默认值: 0，设置=1时查询通过审批的数据列表
status	默认值: 0，设置对应的状态值可以查询相关状态的数据列表，支持以半角逗号分割的多个状态值		默认值: 0，设置对应的状态值可以查询相关状态的数据列表，支持以半角逗号分割的多个状态值
info_api	详情接口	/v1/invoices/order/info
info_key	详情主键	order_id

响应参数

接口字段	字段名称	预设值	描述
order_id	订单ID		订单ID
order_no	订单号		订单号
name	订单名称		订单名称
exchange_rate	汇率		汇率
exchange_rate_usd	汇率美元		汇率美元
users	业绩归属人		业绩归属人
users.rate	业绩归属人业绩占比		业绩归属人业绩占比
users.user_id	业绩归属人UserId		业绩归属人UserId
users.users_info	业绩归属人信息		业绩归属人信息
users.users_info.rate	业绩归属人业绩占比		业绩归属人业绩占比
users.users_info.user_id	业绩归属人UserId		业绩归属人UserId
users.users_info.nickname	业绩归属人昵称		业绩归属人昵称
users.users_info.handler_info	订单跟进人信息		订单跟进人信息
users.users_info.handler_info.user_id	订单跟进人UserId		订单跟进人UserId
users.users_info.handler_info.nickname	订单跟进人昵称|	订单跟进人昵称|
users.users_info.handler_info.company	客户公司信息		客户公司信息
users.users_info.handler_info.company.company_id	客户ID		客户ID
users.users_info.handler_info.company.name	客户公司名称		客户公司名称
users.users_info.handler_info.company.status_info	订单状态信息		订单状态信息
users.users_info.handler_info.company.status_info.id	订单状态ID		订单状态ID
users.users_info.handler_info.company.status_info.name	订单状态名称		订单状态名称
users.users_info.handler_info.company.status_info.currency	货币		货币
users.users_info.handler_info.company.status_info.amount	订单金额		订单金额
users.users_info.handler_info.company.status_info.amount_rmb	订单金额（RMB）		订单金额（RMB）
users.users_info.handler_info.company.status_info.amount_usd	订单金额（美元）		订单金额（美元）
users.users_info.handler_info.company.status_info.addition_cost_amount	附加费用总金额		附加费用总金额
users.users_info.handler_info.company.status_info.product_total_amount	产品总金额		产品总金额
users.users_info.handler_info.company.status_info.product_total_count	产品总数量		产品总数量
users.users_info.handler_info.company.status_info.price_contract	价格条款		价格条款
users.users_info.handler_info.company.status_info.receive_remittance_way	收汇方式		收汇方式
users.users_info.handler_info.company.status_info.price_contract_remark	价格条款说明		价格条款说明
users.users_info.handler_info.company.status_info.receive_remittance_remark	收汇方式说明		收汇方式说明
users.users_info.handler_info.company.status_info.insurance_remark	保险说明		保险说明
users.users_info.handler_info.company.status_info.bank_info	银行信息		银行信息
users.users_info.handler_info.company.status_info.order_contract	订单条款		订单条款
users.users_info.handler_info.company.status_info.company_name	客户名称		客户名称
users.users_info.handler_info.company.status_info.company_phone	客户电话		客户电话
users.users_info.handler_info.company.status_info.company_fax	客户传真		客户传真
users.users_info.handler_info.company.status_info.company_address	客户地址		客户地址
users.users_info.handler_info.company.status_info.customer_name	联系人名称		联系人名称
users.users_info.handler_info.company.status_info.customer_phone	联系人电话		联系人电话
users.users_info.handler_info.company.status_info.customer_email	联系人邮箱		联系人邮箱
users.users_info.handler_info.company.status_info.customer_address	联系人地址		联系人地址
users.users_info.handler_info.company.status_info.transport_mode	运输方式		运输方式
users.users_info.handler_info.company.status_info.shipment_deadline	装运期限		装运期限
users.users_info.handler_info.company.status_info.shipment_port	装运港口		装运港口
users.users_info.handler_info.company.status_info.target_port	目的港口		目的港口
users.users_info.handler_info.company.status_info.shipment_deadline_remark	装运期限说明		装运期限说明
users.users_info.handler_info.company.status_info.more_or_less	溢短装		溢短装
users.users_info.handler_info.company.status_info.package_remark	包装说明		包装说明
users.users_info.handler_info.company.status_info.marked	唛头		唛头
users.users_info.handler_info.company.status_info.account_date	结单日期		结单日期
users.users_info.handler_info.company.status_info.create_time	创建日期		创建日期
users.users_info.handler_info.company.status_info.update_time	更新日期		更新日期
users.users_info.handler_info.company.status_info.product_list	产品明细数据
users.users_info.handler_info.company.status_info.product_list.unit	单位
users.users_info.handler_info.company.status_info.product_list.count	数量
users.users_info.handler_info.company.status_info.product_list.product_id	产品id
users.users_info.handler_info.company.status_info.product_list.product_no	产品编码
users.users_info.handler_info.company.status_info.product_list.unit_price	单价
users.users_info.handler_info.company.status_info.product_list.cost_amount	金额
users.users_info.handler_info.company.status_info.product_list.description	描述
users.users_info.handler_info.company.status_info.product_list.package_unit	装箱单位
users.users_info.handler_info.company.status_info.product_list.product_name	产品名称
users.users_info.handler_info.company.status_info.product_list.cost_with_tax	税率

金蝶云星空接口明细

• API：batchSave
• NAME：销售订单新增
• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FBillNo	单据编号	{{order_no}}
FSaleOrgId	销售组织	100
FDate	日期	{{create_time}}
FCustId	客户	_findCollection find serial_id from d461c1ce-df74-3568-9674-6f64baaecc5f where company_id={{company_id}}
FBillTypeID	单据类型	XSDD01_SYS
FNote	备注
FLinkMan	收货人姓名
FLinkPhone	联系电话
FSaleOrderEntry	订单明细
FSaleOrderEntry.FMaterialId	物料编码	{{product_list.product_no}}
FSaleOrderEntry.FQty	销售数量	{{product_list.count}}
FSaleOrderEntry.FPrice	单价	{{product_list.unit_price}}
FSaleOrderEntry.FTaxPrice	含税单价	{{product_list.unit_price}}
FSaleOrderEntry.FSettleOrgIds	结算组织	100
FSaleOrderEntry.FEntryNote	备注
FSaleOrderEntry.FSalerId	销售员	008_GW000002_100052
FSaleOrderEntry.FormId	业务对象表单Id	SAL_SaleOrder	必须填写金蝶的表单ID如 UR_PurchaseOrder
FSaleOrderEntry.Operation	执行的操作	BatchSave
FSaleOrderEntry.IsAutoSubmitAndAudit	提交并审核	true
FSaleOrderEntry.IsVerifyBaseDataField	验证基础资料	false	是否验证所有的基础资料有效性，布尔类，默认false（非必录）

数据对接效果

基于轻易云的连接器和数据服务能力，轻松实现供应链异构系统的“相互沟通”，通过数据应用自动化业务流程管理，全面管控供应链的每一环节。从要货、销售出库、退货入库、到盘点、调拨，无需人工参与，实时更新，自动化流转。通过快速连接小满OKKICRM接口抽取数据后再自动分发到金蝶云星空， 解放生产力，自动生成数据、并分发推送到业务应用，数据传递时效性提升10倍以上。