---
url: https://developers.zarv.com/api/id-v3/datasets/company-related-1-0.md
description: >-
  Zarv ID v3: formato de data.related do dataset company-related-1.0. Quadro
  societario de um CNPJ: quem e socio dela, o que ela detem, e quem a
  representa…
---

# related 1.0 · Empresa

Quadro societario de um CNPJ: quem e socio dela, o que ela detem, e quem a representa sem ser socio.

|          |                                      |
| -------- | ------------------------------------ |
| Entidade | Empresa (CNPJ, `entity: pj`)         |
| Módulo   | `related`                            |
| Versão   | `1.0`                                |
| Dataset  | `company-related-1.0`                |
| Execução | Roda quando o perfil inclui o módulo |

Este é o formato de `data.related` em [`GET /api/v3/enrichments/{id}?include=related`](/api/id-v3/getEnrichment) e o corpo de [`GET /api/v3/enrichments/{id}/modules/related`](/api/id-v3/getEnrichmentModule). Os campos são publicados como o dataset os entrega: um campo ausente significa que o dado não foi obtido, não que o valor é falso ou zero. Os caminhos abaixo são relativos a `data.related`.

## Envelope

| Campo     | Tipo            | Observação                                     |
| --------- | --------------- | ---------------------------------------------- |
| `dataset` | `string`        | sempre `company-related-1.0`                   |
| `module`  | `string`        | sempre `related`                               |
| `related` | `object`        | os dados do módulo (abaixo)                    |
| `rules`   | `array<object>` | os indicadores avaliados pelo dataset (abaixo) |

## Dados

### `totals`

| Campo                     | Tipo      | Observação |
| ------------------------- | --------- | ---------- |
| `related.owners.count`    | `integer` |            |
| `related.owned.count`     | `integer` |            |
| `related.employees.count` | `integer` |            |
| `related.indirect.count`  | `integer` |            |
| `related.foreign.count`   | `integer` |            |

### `character`

| Campo                           | Tipo      | Observação |
| ------------------------------- | --------- | ---------- |
| `related.isFamilyCompany`       | `boolean` |            |
| `related.isFamilyOperated`      | `boolean` |            |
| `related.truncated`             | `boolean` |            |
| `related.oldestStartDate`       | `string`  | date       |
| `related.lastOwnershipChangeAt` | `string`  | date       |

### `parties`

| Campo                         | Tipo            | Observação |
| ----------------------------- | --------------- | ---------- |
| `related.parties`             | `array<object>` |            |
| `related.parties[].active`    | `boolean`       |            |
| `related.parties[].country`   | `string`        |            |
| `related.parties[].endDate`   | `string`        | date       |
| `related.parties[].level`     | `string`        |            |
| `related.parties[].name`      | `string`        |            |
| `related.parties[].role`      | `string`        |            |
| `related.parties[].startDate` | `string`        | date       |
| `related.parties[].taxId`     | `string`        |            |
| `related.parties[].taxIdType` | `string`        |            |
| `related.parties[].type`      | `string`        |            |
| `related.parties[].via`       | `string`        |            |
| `related.parties[].viaRole`   | `string`        |            |

## Indicadores (`rules`)

| Campo                   | Tipo      | Observação                                                                                                                   |
| ----------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `rules[].evidence`      | `object`  | Os dados que sustentam o indicador, quando disparou.                                                                         |
| `rules[].fired`         | `boolean` | `true` quando o indicador se aplica aos dados.                                                                               |
| `rules[].magnitude`     | `number`  | Intensidade do achado, quando ele tem uma (ex.: uma contagem ou um valor).                                                   |
| `rules[].notApplicable` | `boolean` | `true` quando o indicador não pôde ser avaliado porque o dado que ele lê está ausente. Não é o mesmo que não disparar.       |
| `rules[].reason`        | `string`  | Por que o indicador não pôde ser avaliado (com `notApplicable`).                                                             |
| `rules[].rule`          | `string`  | `RELATED_COMPANY_FOREIGN_OWNER`, `RELATED_COMPANY_INDIRECT_CONTROL`, `RELATED_COMPANY_OWNERSHIP_CHANGE` — Nome do indicador. |

Indicadores publicados por este dataset:

* `RELATED_COMPANY_FOREIGN_OWNER`
* `RELATED_COMPANY_INDIRECT_CONTROL`
* `RELATED_COMPANY_OWNERSHIP_CHANGE`