Skip to content
Vai integrar a API REST da Zarv com ajuda de IA? Copie a instrução que aponta o modelo para esta documentação.
Ver a instrução
Você vai integrar a API REST da Zarv. Use a documentação oficial como fonte da verdade.

- Página desta integração: https://developers.zarv.com/api/id-v3/datasets/person-finance-1-1
- Autenticação Bearer JWT e hosts: https://developers.zarv.com/setup
- Índice das APIs: https://developers.zarv.com/api
- Índice da documentação em markdown: https://developers.zarv.com/llms.txt
- Documentação completa em um arquivo: https://developers.zarv.com/llms-full.txt

Os specs OpenAPI publicados são a fonte da verdade para rotas e schemas — use o spec da API que você escolher antes de escrever qualquer request.

Antes de escrever qualquer código, leia a página desta integração. Siga exatamente os nomes de campos, endpoints, callbacks e formatos que estiverem documentados — não invente parâmetros nem endpoints, e não deduza comportamento a partir de outras APIs que você conhece. Se algo de que você precisa não estiver na documentação, diga que não está em vez de supor.

Minha tarefa: [ex.: escolher a API certa e fazer a primeira chamada autenticada]

finance 1.1 · Pessoa ​

Renda estimada de um CPF convertida em reais, patrimonio, historico de declaracao de imposto de renda e beneficios sociais com extrato de pagamentos.

EntidadePessoa (CPF, entity: pf)
Módulofinance
Versão1.1 (mais recente)
Datasetperson-finance-1.1
ExecuçãoRoda quando o perfil inclui o módulo

Este é o formato de data.finance em GET /api/v3/enrichments/{id}?include=finance e o corpo de GET /api/v3/enrichments/{id}/modules/finance. 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.finance.

Envelope ​

CampoTipoObservação
datasetstringsempre person-finance-1.1
modulestringsempre finance
financeobjectos dados do módulo (abaixo)
rulesarray<object>os indicadores avaliados pelo dataset (abaixo)

Dados ​

income ​

CampoTipoObservação
finance.income.monthlyBRLnumber
finance.income.bandstring
finance.income.basisstring
finance.assetsstring

taxReturns ​

CampoTipoObservação
finance.taxReturns.yearsinteger
finance.taxReturns.filedinteger
finance.taxReturns.lateststring
finance.taxReturns.itemsarray<object>
finance.taxReturns.items[].filedboolean
finance.taxReturns.items[].statusstring
finance.taxReturns.items[].yearstring

assistance ​

CampoTipoObservação
finance.assistance.receivingboolean
finance.assistance.totalinteger
finance.assistance.activeinteger
finance.assistance.amountReceivednumber
finance.assistance.installmentsinteger
finance.assistance.itemsarray<object>
finance.assistance.items[].activeboolean
finance.assistance.items[].amountnumber
finance.assistance.items[].contextstring
finance.assistance.items[].endDatestringdate
finance.assistance.items[].installmentsinteger
finance.assistance.items[].namestring
finance.assistance.items[].paymentsobject
finance.assistance.items[].payments.countinteger
finance.assistance.items[].payments.duplicateReferenceDatesinteger
finance.assistance.items[].payments.firstnumber
finance.assistance.items[].payments.lastnumber
finance.assistance.items[].payments.sumnumber
finance.assistance.items[].payments.valuesarray<object>
finance.assistance.items[].payments.values[].countinteger
finance.assistance.items[].payments.values[].valuenumber
finance.assistance.items[].startDatestringdate
finance.assistance.items[].statestring
finance.assistance.items[].totalAmountnumber

Indicadores (rules) ​

CampoTipoObservação
rules[].evidenceobjectOs dados que sustentam o indicador, quando disparou.
rules[].firedbooleantrue quando o indicador se aplica aos dados.
rules[].magnitudenumberIntensidade do achado, quando ele tem uma (ex.: uma contagem ou um valor).
rules[].notApplicablebooleantrue 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[].reasonstringPor que o indicador não pôde ser avaliado (com notApplicable).
rules[].rulestringFINANCE_PERSON_ASSISTANCES, FINANCE_PERSON_INCOME, FINANCE_PERSON_NO_TAX_RETURNS, FINANCE_PERSON_SOCIAL_ASSISTANCES — Nome do indicador.

Indicadores publicados por este dataset:

  • FINANCE_PERSON_ASSISTANCES
  • FINANCE_PERSON_INCOME
  • FINANCE_PERSON_NO_TAX_RETURNS
  • FINANCE_PERSON_SOCIAL_ASSISTANCES