关于业务对象
在有成CRM系统中,对于客户,订单等业务实体,我们统称为业务对象,因此对于具体业务数据的操作,可以理解为就是对业务对象的操作,第三方开发人员可通过 有成CRM业务对象操作接口 对业务对象进行查询,新增,更新,删除,更换负责人等操作。
企业可通过 开放业务对象列表 获取当前可操作的业务对象列表(注意返回中的deployId,业务对象操作接口通过deployId区分各个业务对象)。通过 开放业务对象字段列表 获取对各个业务对象字段的字段类型,释义,取值范围等描述内容。
目前各个业务对象支持的开放操作如下(不同企业可能存在差异,请以 开放业务对象列表 返回的数据范围为准):
列表查询:线索、客户、协议、计划回款、实际回款、工单、产品、产品明细、销售机会、销售机会产品、合同订单、合同订单产品、联系人、跟进记录、拜访签到、报价单、报价单产品、仓库、供应商、实际付款、采购退货单、采购退货单产品、盘点单、盘点单产品、入库单(4个)、入库单产品(4个)、出库单(4个)、出库单产品(4个)、销售退货单、销售退货单产品、核算维度、日报、周报、月报、开票申请、开票申请明细、调拨单、调拨单产品、发票信息、期初应收款、期初应付款、期初存货、项目、采购单、采购单产品、组装单、组装单产品
详情查询:线索、客户、协议、计划回款、实际回款、工单、产品、产品明细、销售机会、销售机会产品、合同订单、合同订单产品、联系人、跟进记录、拜访签到、报价单、报价单产品、仓库、采购单、出库单(4个)、入库单(4个)、实际回款、采购退货单、销售退货单、核算维度、日报、周报、月报、开票申请、开票申请明细、供应商、调拨单、调拨单产品、发票信息、组装单、组装单产品
新增:客户、销售机会、协议、合同订单、计划回款、实际回款、产品、工单、联系人、线索、跟进记录、出库单(4个)、入库单(4个)、开票申请、销售退货单、采购单
更新:客户、销售机会、协议、合同订单、计划回款、实际回款、产品、工单、线索、联系人、跟进记录、开票申请、销售退货单、采购单
删除:客户、销售机会、协议、合同订单、计划回款、实际回款、产品、产品明细、工单、线索、联系人、跟进记录、开票申请、销售退货单、采购单、日报、周报、月报
更换负责人:客户、销售机会、协议、合同订单
关于单据模板
在不同的业务场景下,同一个业务对象所包含的内容是不一样的,这个可以在PC端 设置-> 业务模板 中对各个业务对象进行设置。

同样的,对于业务对象的操作 我们也可以通过templateId 来指定需使用的模板,可通过 企业人员可见模板列表 获取到具体的模板templateId。
可通过 开放业务对象字段列表 获取对各个业务模板下的字段类型,释义,取值范围等描述内容。
所有业务对象中系统预设的默认模板 对应的templateId 为:default_template
接入说明
第三方开发者第一次接入CRM对外开放接口,需先在PC端 设置 -> 开发者中心 提交申请,以获取请求 corpAccessToken所需的必要信息。 具体的接入步骤 请参照 服务端接入指南
corpAccessToken是获取企业数据的合法性凭证,在每次主动调用开放接口拉取企业数据时需要带上corpAccessToken和corpId建立链接, 详见 获取corpAccessToken。
访问频次控制说明
开放接口的访问频次不能超过60次/20秒,数据新增接口,5秒内提交完全相同的参数会进行幂等性过滤。
对外接口访问根域名为http://crmapi.superboss.cc/。