CNPJ - Sócios e Relacionamentos

Este Actor consulta relacionamentos de empresas no Brasil (CNPJ) e retorna informações como:

• Sócios / QSA
• Empregados
• Representantes legais
• Relações de propriedade/controle (Ownership)

Opcionalmente, também suporta consulta por CPF para retornar vínculos econômicos (Empregado, Dono/ownership, Sócio e representante legal).

---

Como usar

Você executa o Actor/Api informando o modo e um documento:

• mode = "empresa" → consulta por CNPJ
• mode = "pessoa" → consulta por CPF

---

Input (parâmetros)

Campo comum

Campo	Tipo	Obrigatório	Descrição
mode	string	não	"empresa" (padrão) ou "pessoa"

---

Modo Empresa (CNPJ)

Campo	Tipo	Obrigatório	Descrição
cnpj	string	sim	CNPJ com ou sem máscara (somente 14 dígitos são considerados).
relationshiptype	string	não	QSA, Ownership, Employee, RepresentanteLegal
relatedentitytaxidtype	string	não	cpf ou cnpj
relationshiplevel	string	não	Direto ou Indireto
limit	integer	não	Recomendado: 1..200
next	string	não	Token de paginação (NextPageId)

Exemplos

A) Sócios PF diretos

{
  "mode": "empresa",
  "cnpj": "00.000.000/0001-91",
  "relationshiptype": "QSA",
  "relatedentitytaxidtype": "cpf",
  "relationshiplevel": "Direto",
  "limit": 50
}

B) Empregados diretos

{
  "mode": "empresa",
  "cnpj": "00000000000191",
  "relationshiptype": "Employee",
  "relationshiplevel": "Direto",
  "limit": 100
}

C) Ownership indireto

{
  "mode": "empresa",
  "cnpj": "00000000000191",
  "relationshiptype": "Ownership",
  "relationshiplevel": "Indireto"
}

---

Modo Pessoa (CPF)

Campo	Tipo	Obrigatório	Descrição
cpf	string	sim	CPF com ou sem máscara (somente 11 dígitos são considerados).
relationshiptype	string	não	employment, partner, ownership, legal representative
relatedentitytaxidtype	string	não	CPF ou CNPJ
relationshiplevel	string	não	DIRECT, SECOND-LEVEL, THIRD-LEVEL
iscurrentlyactive	boolean	não	true somente ativos; false somente inativos
limit	integer	não	Recomendado: 1..1000
next	string	não	Token de paginação (NextPageId)

Exemplos

A) Vínculos com empresas (CNPJ), diretos e ativos

{
  "mode": "pessoa",
  "cpf": "123.456.789-09",
  "relatedentitytaxidtype": "CNPJ",
  "relationshiplevel": "DIRECT",
  "iscurrentlyactive": true
}

B) Somente empregos

{
  "mode": "pessoa",
  "cpf": "12345678909",
  "relationshiptype": "employment"
}

---

Paginação (next)

Quando existir próxima página, execute novamente informando next.

{
  "mode": "empresa",
  "cnpj": "00000000000191",
  "next": "SEU_NEXT_PAGE_ID"
}

Regras:

• O CNPJ/CPF deve ser o mesmo da consulta original.
• next tem precedência sobre filtros e limite (pagina a partir do token).

Output (retorno)

O Actor sempre retorna um objeto com:

• ok: true quando a consulta foi executada com sucesso
• mode: "empresa" ou "pessoa"
• Result: array com os dados retornados

---

Output — Modo Pessoa (mode: "pessoa")

{
  "ok": true,
  "mode": "pessoa",
  "Result": [
    {
      "MatchKeys": "doc{57994064191}",
      "BusinessRelationships": {
        "BusinessRelationships": [
          {
            "RelatedEntityTaxIdNumber": "05437257000129",
            "RelatedEntityTaxIdType": "CNPJ",
            "RelatedEntityTaxIdCountry": "Brazil",
            "RelatedEntityName": "ATIVOS S.A.SECURITIZADORA DE CREDITOS FINANCEIROS",
            "RelationshipName": "CONSELHEIRO DE ADMINISTRACAO",
            "RelationshipType": "OWNERSHIP",
            "RelationshipSubtype": "OTHER",
            "RelationshipLevel": "DIRECT",
            "RelationshipStartDate": "2020-06-14T00:00:00Z",
            "RelationshipEndDate": "2021-04-17T00:00:00Z",
            "IsCurrentlyActive": false,
            "IsFromHeadQuartersData": false,
            "CreationDate": "2020-06-14T00:00:00Z",
            "LastUpdateDate": "2021-04-17T00:00:00Z",
            "AdditionalDetails": []
          },
          {
            "RelatedEntityTaxIdNumber": "00038166000105",
            "RelatedEntityTaxIdType": "CNPJ",
            "RelatedEntityTaxIdCountry": "Brazil",
            "RelatedEntityName": "BANCO CENTRAL DO BRASIL",
            "RelationshipType": "EMPLOYMENT",
            "RelationshipLevel": "DIRECT",
            "RelationshipStartDate": "1998-01-02T00:00:00Z",
            "RelationshipEndDate": "9999-12-31T23:59:59.9999999",
            "IsCurrentlyActive": true,
            "CreationDate": "2021-11-22T00:00:00Z",
            "LastUpdateDate": "2024-01-17T00:00:00Z",
            "AdditionalDetails": []
          },
          {
            "RelatedEntityTaxIdNumber": "00000000000191",
            "RelatedEntityTaxIdType": "CNPJ",
            "RelatedEntityTaxIdCountry": "Brazil",
            "RelatedEntityName": "BANCO DO BRASIL SA",
            "RelationshipName": "CONSELHEIRO DE ADMINISTRACAO",
            "RelationshipType": "OWNERSHIP",
            "RelationshipSubtype": "OTHER",
            "RelationshipLevel": "DIRECT",
            "RelationshipStartDate": "2020-03-17T00:00:00Z",
            "RelationshipEndDate": "2020-03-17T00:00:00Z",
            "IsCurrentlyActive": false,
            "IsFromHeadQuartersData": false,
            "CreationDate": "2020-03-17T00:00:00Z",
            "LastUpdateDate": "2020-03-17T00:00:00Z",
            "AdditionalDetails": []
          },
          {
            "RelatedEntityTaxIdNumber": "37174034000102",
            "RelatedEntityTaxIdType": "CNPJ",
            "RelatedEntityTaxIdCountry": "Brazil",
            "RelatedEntityName": "INSTITUTO EURO-AMERICANO DE EDUCACAO, CIENCIA E TECNOLOGIA S.A.",
            "RelationshipType": "EMPLOYMENT",
            "RelationshipLevel": "DIRECT",
            "RelationshipStartDate": "2009-08-10T00:00:00Z",
            "RelationshipEndDate": "2014-02-10T00:00:00Z",
            "IsCurrentlyActive": false,
            "CreationDate": "2016-07-07T00:00:00Z",
            "LastUpdateDate": "2016-07-07T00:00:00Z",
            "AdditionalDetails": []
          },
          {
            "RelatedEntityTaxIdNumber": "00394460049230",
            "RelatedEntityTaxIdType": "CNPJ",
            "RelatedEntityTaxIdCountry": "Brazil",
            "RelatedEntityName": "MINISTERIO DA FAZENDA",
            "RelationshipType": "EMPLOYMENT",
            "RelationshipLevel": "DIRECT",
            "RelationshipStartDate": "2011-07-21T00:00:00Z",
            "RelationshipEndDate": "2021-02-22T00:00:00Z",
            "IsCurrentlyActive": false,
            "CreationDate": "2021-11-22T00:00:00Z",
            "LastUpdateDate": "2022-08-23T00:00:00Z",
            "AdditionalDetails": []
          }
        ],
        "TotalRelationships": 5,
        "TotalOwnerships": 2,
        "TotalEmployments": 3,
        "TotalPartners": 0,
        "TotalClients": 0,
        "TotalSuppliers": 0
      }
    }
  ]
}

Output — Modo Empresa (mode: "empresa")

{
  "ok": true,
  "mode": "empresa",
  "Result": [
    {
      "MatchKeys": "doc{00000000000191}",
      "Relationships": {
        "Relationships": [
          {
            "RelatedEntityTaxIdNumber": "00141590742",
            "RelatedEntityTaxIdType": "CPF",
            "RelatedEntityTaxIdCountry": "Brazil",
            "RelatedEntityName": "CARLOS ALBERTO ARAUJO NETTO",
            "RelationshipType": "QSA",
            "RelationshipName": "DIRETOR",
            "RelationshipLevel": "Direct",
            "RelationshipDataOrigin": "RECEITA FEDERAL",
            "CreationDate": "0001-01-01T00:00:00Z",
            "LastUpdateDate": "2021-01-02T00:00:00Z",
            "RelationshipStartDate": "0001-01-01T00:00:00Z",
            "RelationshipEndDate": "2021-01-02T00:00:00Z"
          },
          {
            "RelatedEntityTaxIdNumber": "00256322724",
            "RelatedEntityTaxIdType": "CPF",
            "RelatedEntityTaxIdCountry": "Brazil",
            "RelatedEntityName": "MARCIO LUIZ DE ALBUQUERQUE OLIVEIRA",
            "RelationshipType": "QSA",
            "RelationshipName": "CONSELHEIRO DE ADMINISTRACAO",
            "RelationshipLevel": "Direct",
            "RelationshipDataOrigin": "RECEITA FEDERAL",
            "CreationDate": "2025-06-14T00:00:00Z",
            "LastUpdateDate": "2026-01-23T00:00:00Z",
            "RelationshipStartDate": "2025-06-12T00:00:00Z",
            "RelationshipEndDate": "9999-12-31T23:59:59.9999999"
          },
          {
            "RelatedEntityTaxIdNumber": "58349138653",
            "RelatedEntityTaxIdType": "CPF",
            "RelatedEntityTaxIdCountry": "Brazil",
            "RelatedEntityName": "NILSON MARTINIANO MOREIRA",
            "RelationshipType": "QSA",
            "RelationshipName": "DIRETOR",
            "RelationshipLevel": "Direct",
            "RelationshipDataOrigin": "RECEITA FEDERAL",
            "CreationDate": "0001-01-01T00:00:00Z",
            "LastUpdateDate": "2021-01-02T00:00:00Z",
            "RelationshipStartDate": "0001-01-01T00:00:00Z",
            "RelationshipEndDate": "2021-01-02T00:00:00Z"
          }
        ],
        "IsFamilyCompany": false,
        "IsFamilyOperated": false,
        "TotalRelationships": 165,
        "TotalOwners": 132,
        "TotalEmployees": 4,
        "TotalOwned": 18,
        "NextPageId": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NzAzOTc0MzUsIlBhZ2luYXRpb25JZCI6IjIiLCJQYWdpbmF0aW9uVHlwZSI6ImludCIsIlVzZXJOYW1lIjoiIiwiUXVlcnlJbnB1dCI6IjAwMDAwMDAwMDAwMTkxIiwiTGltaXQiOjEwMCwiVG90YWxQcm9jZXNzZWQiOjEwMCwiVG90YWwiOjEzMn0.1xcwfotrAMwEIxluAB-kAsoEkJDT2CanC92QDU5guGk",
        "IsFromHeadQuartersData": false
      }
    }
  ]
}