小满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第几页，默认 = 11第几页，默认 = 1 count每页记录数，默认 = 1010每页记录数，默认 = 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业务对象表单IdSAL_SaleOrder必须填写金蝶的表单ID如😛UR_PurchaseOrder FSaleOrderEntry.Operation执行的操作BatchSave FSaleOrderEntry.IsAutoSubmitAndAudit提交并审核true FSaleOrderEntry.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录）

数据对接效果

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

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