---
url: https://developers.zarv.com/api/id-v3/datasets/company-financeAdvanced-2-0.md
description: >-
  Zarv ID v3: formato de data.financeAdvanced do dataset
  company-financeAdvanced-2.0. Registro negativo de credito de uma empresa:
  dividas vencidas,…
---

# financeAdvanced 2.0 · Empresa

Registro negativo de credito de uma empresa: dividas vencidas, protestos em cartorio, cheques devolvidos e declaracao de contumacia, com a situacao cadastral do CNPJ.

|          |                                                                                           |
| -------- | ----------------------------------------------------------------------------------------- |
| Entidade | Empresa (CNPJ, `entity: pj`)                                                              |
| Módulo   | `financeAdvanced`                                                                         |
| Versão   | `2.0` (mais recente)                                                                      |
| Dataset  | `company-financeAdvanced-2.0`                                                             |
| Execução | Add-on: só roda quando pedido em `options.modules.financeAdvanced` e habilitado no perfil |

Este é o formato de `data.financeAdvanced` em [`GET /api/v3/enrichments/{id}?include=financeAdvanced`](/api/id-v3/getEnrichment) e o corpo de [`GET /api/v3/enrichments/{id}/modules/financeAdvanced`](/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.financeAdvanced`.

## Envelope

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

## Dados

### `overdueDebts`

| Campo                                               | Tipo            | Observação |
| --------------------------------------------------- | --------------- | ---------- |
| `financeAdvanced.overdueDebts.count`                | `integer`       |            |
| `financeAdvanced.overdueDebts.balanceBrl`           | `number`        |            |
| `financeAdvanced.overdueDebts.firstAt`              | `string`        | date       |
| `financeAdvanced.overdueDebts.lastAt`               | `string`        | date       |
| `financeAdvanced.overdueDebts.items`                | `array<object>` |            |
| `financeAdvanced.overdueDebts.items[].amountBrl`    | `number`        |            |
| `financeAdvanced.overdueDebts.items[].city`         | `string`        |            |
| `financeAdvanced.overdueDebts.items[].contractId`   | `string`        |            |
| `financeAdvanced.overdueDebts.items[].creditor`     | `string`        |            |
| `financeAdvanced.overdueDebts.items[].disputed`     | `boolean`       |            |
| `financeAdvanced.overdueDebts.items[].dueAt`        | `string`        | date       |
| `financeAdvanced.overdueDebts.items[].notaryOffice` | `string`        |            |
| `financeAdvanced.overdueDebts.items[].occurredAt`   | `string`        | date       |
| `financeAdvanced.overdueDebts.items[].recordedAt`   | `string`        | date       |
| `financeAdvanced.overdueDebts.items[].state`        | `string`        |            |
| `financeAdvanced.overdueDebts.truncated`            | `boolean`       |            |

### `protests`

| Campo                                           | Tipo            | Observação |
| ----------------------------------------------- | --------------- | ---------- |
| `financeAdvanced.protests.count`                | `integer`       |            |
| `financeAdvanced.protests.balanceBrl`           | `number`        |            |
| `financeAdvanced.protests.firstAt`              | `string`        | date       |
| `financeAdvanced.protests.lastAt`               | `string`        | date       |
| `financeAdvanced.protests.items`                | `array<object>` |            |
| `financeAdvanced.protests.items[].amountBrl`    | `number`        |            |
| `financeAdvanced.protests.items[].city`         | `string`        |            |
| `financeAdvanced.protests.items[].contractId`   | `string`        |            |
| `financeAdvanced.protests.items[].creditor`     | `string`        |            |
| `financeAdvanced.protests.items[].disputed`     | `boolean`       |            |
| `financeAdvanced.protests.items[].dueAt`        | `string`        | date       |
| `financeAdvanced.protests.items[].notaryOffice` | `string`        |            |
| `financeAdvanced.protests.items[].occurredAt`   | `string`        | date       |
| `financeAdvanced.protests.items[].recordedAt`   | `string`        | date       |
| `financeAdvanced.protests.items[].state`        | `string`        |            |
| `financeAdvanced.protests.truncated`            | `boolean`       |            |

### `badChecks`

| Campo                             | Tipo      | Observação |
| --------------------------------- | --------- | ---------- |
| `financeAdvanced.badChecks.count` | `integer` |            |

### `habitualBadChecks`

| Campo                                       | Tipo      | Observação |
| ------------------------------------------- | --------- | ---------- |
| `financeAdvanced.habitualBadChecks.count`   | `integer` |            |
| `financeAdvanced.habitualBadChecks.firstAt` | `string`  | date       |
| `financeAdvanced.habitualBadChecks.lastAt`  | `string`  | date       |

### `history`

| Campo                                    | Tipo      | Observação |
| ---------------------------------------- | --------- | ---------- |
| `financeAdvanced.history.oldestAt`       | `string`  | date       |
| `financeAdvanced.history.daysFromCutoff` | `integer` |            |
| `financeAdvanced.history.atEdge`         | `boolean` |            |

### `registration`

| Campo                                   | Tipo     | Observação |
| --------------------------------------- | -------- | ---------- |
| `financeAdvanced.registration.status`   | `string` |            |
| `financeAdvanced.registration.statusAt` | `string` | date       |

## 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`  | `FINANCE_ADVANCED_COMPANY_DISHONORED_CHECK`, `FINANCE_ADVANCED_COMPANY_HAS_OVERDUE_DEBTS`, `FINANCE_ADVANCED_COMPANY_HAS_PROTESTS`, `FINANCE_ADVANCED_COMPANY_HISTORY_AT_WINDOW_EDGE` — Nome do indicador. |

Indicadores publicados por este dataset:

* `FINANCE_ADVANCED_COMPANY_DISHONORED_CHECK`
* `FINANCE_ADVANCED_COMPANY_HAS_OVERDUE_DEBTS`
* `FINANCE_ADVANCED_COMPANY_HAS_PROTESTS`
* `FINANCE_ADVANCED_COMPANY_HISTORY_AT_WINDOW_EDGE`