Company Profile, Linkage, and Executives（cmpelk）v2 中文版

Query Parameters

参数	类型	必填	示例	中文说明
productId	string	是	cmpelk	D&B 产品 ID，用于指定返回的产品类型。
versionId	string	是	v2	产品版本号。
tradeUp	string	否	hq	当传入分支机构 D-U-N-S 时，是否上卷为总部。可选：hq（上卷到总部）、domhq（上卷到本国总部）。若不传则返回原请求 D-U-N-S。
customerReference	string	否	customer reference text	客户自定义引用文本，最长 240 字符，用于后续订单/交易对账。

Header Parameters

参数	类型	必填	示例	中文说明
Authorization	string	是	Bearer alphanumerictoken	认证系统颁发的访问令牌。

Path Parameters

参数	类型	必填	示例	中文说明
dunsNumber	string	是	804735132	9 位数字的 D-U-N-S 编号，用于识别企业实体。

字段	类型	中文说明
transactionDetail	object	交易元数据，如交易 ID、时间戳、语言、产品 ID 与版本。
transactionDetail.transactionID	string	本次请求在 D&B 系统中的唯一交易号。
transactionDetail.transactionTimestamp	string	响应生成时间（ISO 8601 UTC）。
transactionDetail.inLanguage	string	响应语言（IETF BCP 47）。
transactionDetail.productID	string	生成响应所用产品 ID。
transactionDetail.productVersion	string	生成响应所用产品版本。
inquiryDetail	object	请求回显，包括 duns/productId/productVersion/tradeUp/customerReference。
organization	object	企业主体信息（本接口核心字段群）。

1）基础识别与状态控制

字段	类型	中文说明
organization.duns	string	企业 D-U-N-S® 唯一标识。
organization.primaryName	string	企业主名称。
organization.dunsControlStatus.operatingStatus.description	string	经营状态描述（如 Active / Out of Business）。
organization.dunsControlStatus.operatingStatus.dnbCode	integer	经营状态代码（参考代码表 166）。
organization.dunsControlStatus.isMarketable	boolean	是否满足市场营销可用规则。
organization.dunsControlStatus.isMailUndeliverable	boolean	是否存在邮件不可投递。
organization.dunsControlStatus.isTelephoneDisconnected	boolean	电话是否断开/不可接通。
organization.dunsControlStatus.isDelisted	boolean	是否要求不被用于直销名单（邮件/电话/邮件营销等）。
organization.dunsControlStatus.subjectHandlingDetails	array(object)	联系时需特殊处理的要求（如 Do not call）。
organization.dunsControlStatus.fullReportDate	string	最近一次完整信息复核日期。

2）名称、域名与联系方式

字段	类型	中文说明
organization.tradeStyleNames.name	string	商业经营别名/商号名（Trade Style）。
organization.tradeStyleNames.priority	integer	商号优先级，越小越重要。
organization.websiteAddress.url	string	企业网站 URL。
organization.websiteAddress.domainName	string	企业网站域名。
organization.telephone.telephoneNumber	string	主要电话（通常包含区号 + 本地号码）。
organization.telephone.isdCode	string	国际区号/国家码（拨打跨国电话时使用）。
organization.telephone.isUnreachable	boolean	电话是否不可接通。
organization.fax.faxNumber	string	传真号码。
organization.fax.isdCode	string	传真国家码。

3）地址信息（primary / registered / mailing）

三类地址结构高度相似：国家、大洲、城市、州省、区县、邮编、街道、PO Box、语言等字段基本对齐；以下为代表性字段（同名字段在 registered/mailing 语义一致）。

字段	类型	中文说明
organization.primaryAddress.language.description	string	地址记录所用语言。
organization.primaryAddress.addressCountry.name	string	国家/地区名称。
organization.primaryAddress.addressCountry.isoAlpha2Code	string	ISO 两位国家码。
organization.primaryAddress.continentalRegion.name	string	所属大洲（如 North America）。
organization.primaryAddress.addressLocality.name	string	城市/地方名。
organization.primaryAddress.minorTownName	string	小镇/郊区名。
organization.primaryAddress.addressRegion.name	string	州/省/地区名。
organization.primaryAddress.addressRegion.abbreviatedName	string	州/省缩写（如 NJ）。
organization.primaryAddress.addressCounty.name	string	县/郡名。
organization.primaryAddress.postalCode	string	邮政编码。
organization.primaryAddress.postalCodePosition.description	string	邮编展示位置（在城市前/后）。
organization.primaryAddress.streetNumber	string	门牌号。
organization.primaryAddress.streetName	string	街道名。
organization.primaryAddress.streetAddress.line1	string	街道地址第 1 行。
organization.primaryAddress.streetAddress.line2	string	街道地址第 2 行。
organization.primaryAddress.postOfficeBox.postOfficeBoxNumber	string	邮政信箱编号。
organization.primaryAddress.postOfficeBox.typeDescription	string	邮政信箱类型描述（PO Box / PMB）。
organization.primaryAddress.latitude	number	纬度。
organization.primaryAddress.longitude	number	经度。
organization.primaryAddress.geographicalPrecision.description	string	经纬度精度等级。
organization.primaryAddress.isRegisteredAddress	boolean	主营地址是否即注册地址。
organization.primaryAddress.isResidentialAddress	boolean	是否住宅地址。
organization.primaryAddress.locationOwnership	object	场地占用方式（自有/租赁等）。
organization.primaryAddress.premisesArea	object	场地面积及单位、可信度。
organization.primaryAddress.isManufacturingLocation	boolean	该字段标注为不再更新（DO NOT USE）。

4）证券、第三方评估、注册号、行业分类

字段	类型	中文说明
organization.stockExchanges.tickerName	string	交易所股票代码（如 NYSE:DNB）。
organization.stockExchanges.exchangeName.description	string	交易所名称。
organization.stockExchanges.exchangeCountry.isoAlpha2Code	string	交易所所在国家码。
organization.stockExchanges.isPrimary	boolean	是否主交易所。
organization.thirdPartyAssessment	array(object)	第三方评级/榜单（例如 Fortune/Forbes 指标）。
organization.thirdPartyAssessment.description	string	评估类型描述。
organization.thirdPartyAssessment.assessmentDate	string	评估日期。
organization.thirdPartyAssessment.value	string	评估值或排名。
organization.registrationNumbers.registrationNumber	string	注册号值。
organization.registrationNumbers.typeDescription	string	注册号类型描述（如税号）。
organization.registrationNumbers.registrationNumberClass	object	注册号所属大类（税务、商会、国家企业注册号等）。
organization.registrationNumbers.isPreferredRegistrationNumber	boolean	是否为 D&B 推荐首选注册号。
organization.industryCodes.code	string	行业代码。
organization.industryCodes.description	string	行业代码对应描述。
organization.industryCodes.typeDescription	string	行业编码体系（NAICS/SIC/NACE/D&B 等）。
organization.industryCodes.priority	integer	同编码体系下的优先级。

5）企业性质、员工、财务、高管与关键人

字段	类型	中文说明
organization.startDate	string	企业最初开始经营日期（不一定等于注册日期）。
organization.businessEntityType	object	企业实体类型（公司、合伙、政府、非营利等）。
organization.controlOwnershipDate	string	当前控制方接管日期。
organization.controlOwnershipType.description	string	控制权类型（私有/公有/国有等）。
organization.numberOfEmployees	array(object)	员工数量、统计口径、可信度、雇佣类别及趋势。
organization.numberOfEmployees.trend.growthRate	number	员工增长率（相对基准年的百分比变化）。
organization.financials	array(object)	财务摘要（实际/估算/建模），含口径、可靠性、单位、收入趋势等。
organization.financials.yearlyRevenue.value	number	年度收入值。
organization.financials.yearlyRevenue.currency	string	币种（ISO 4217，如 USD）。
organization.financials.yearlyRevenue.trend.growthRate	number	收入增长率。
organization.mostSeniorPrincipals	array(object)	最高级关键负责人（通常仅一条）。
organization.currentPrincipals	array(object)	当前关键人列表（姓名、称谓、职位、职责编码 MRC 等）。
organization.*Principals.managementResponsibilities.mrcCode	string	管理职责标准编码（MRC，参考代码表 27751）。

6）社会经济属性、集团关系、风险评估

字段	类型	中文说明
organization.socioEconomicInformation.isMinorityOwned	boolean	是否少数族裔控股企业。
organization.socioEconomicInformation.isSmallBusiness	boolean	是否符合“小型企业”标准（文档示例偏美国 SBA 标准）。
organization.isStandalone	boolean	是否独立实体（不在法定家族树中）。
organization.corporateLinkage.familytreeRolesPlayed	array(object)	企业在家族树中的角色（总部、母公司、子公司、分支等）。
organization.corporateLinkage.hierarchyLevel	integer	在全球最终母公司（Global Ultimate）树中的层级。
organization.corporateLinkage.globalUltimate*	object	全球最终母公司及其主地址信息。
organization.corporateLinkage.domesticUltimate*	object	本国最终母公司及其主地址信息。
organization.corporateLinkage.parent*	object	直接母公司（持股/控制超过 50%）信息。
organization.corporateLinkage.headQuarter*	object	总部信息（分支机构管理中枢）。
organization.dnbAssessment.marketingRiskClass	object	D&B 市场风险等级（描述 + 代码，参考代码表 238）。

当请求的 D-U-N-S 编号发生迁移时，接口可能返回 301，并在响应头提供新的查询 URL。

响应头	类型	示例	中文说明
location	string	https://plus.dnb.com/v1/data/duns/{dunsNumber}?productId={productId}&versionId={versionId}	跳转到新的 D-U-N-S 对应地址，按该 URL 重新请求即可。