> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base39.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Favorecidos

> Ferramenta MCP get_business_public_payee da Base39.

Dados cadastrais dos favorecidos pessoa jurídica, enriquecidos pelos dicionários de CNAE e natureza jurídica do próprio arquivo oficial. Cadastro empresarial publicado pela Controladoria-Geral da União na área de CNPJ do Portal da Transparência. Preço: R\$ 0,00 (gratuito).

## Ferramenta

`get_business_public_payee`

## Exemplo de chamada

```json theme={null}
{
  "method": "tools/call",
  "params": {
    "name": "get_business_public_payee",
    "arguments": {
      "document": "19131243000197"
    }
  }
}
```

## Exemplo de resultado

> [tab] Resumo
>
> ```markdown theme={null}
> ### Favorecidos
>
> - **Razão social:** Empresa de teste
> - **Nome fantasia:** Exemplo
> - **Tipo de pessoa:** Pessoa Jurídica
> - **Código CNAE da atividade econômica:** 6201501
> - **Descrição da atividade econômica:** Desenvolvimento de programas de computador sob encomenda
> - **Código da seção CNAE:** J
> - **Descrição da seção CNAE:** Informação e comunicação
> - **Código da natureza jurídica:** 2062
> - **Descrição da natureza jurídica:** Sociedade Empresária Limitada
> - **Código do tipo de natureza jurídica:** 2
> - **Descrição do tipo de natureza jurídica:** Entidade empresarial
> ```

> [tab] Dados
>
> ```json theme={null}
> {
>   "object": "public_payee",
>   "legal_name": "Empresa de teste",
>   "trade_name": "Exemplo",
>   "person_type": "Pessoa Jurídica",
>   "address": {
>     "street": "Rua de teste",
>     "number": "1",
>     "neighborhood": "Centro",
>     "postal_code": "01001000",
>     "city": "São Paulo",
>     "state": "SP"
>   },
>   "activity_code": "6201501",
>   "activity": "Desenvolvimento de programas de computador sob encomenda",
>   "activity_section_code": "J",
>   "activity_section_description": "Informação e comunicação",
>   "legal_nature_code": "2062",
>   "legal_nature": "Sociedade Empresária Limitada",
>   "legal_nature_type_code": "2",
>   "legal_nature_type_description": "Entidade empresarial",
>   "document": "19131243000197",
>   "updated_at": "2026-11-01T00:00:00Z"
> }
> ```

> [accordion] Parâmetros
>
> ```json theme={null}
> {
>   "$schema": "https://json-schema.org/draft/2020-12/schema",
>   "type": "object",
>   "properties": {
>     "document": {
>       "type": "string",
>       "pattern": "^(?:[0-9A-Za-z]{12}\\d{2}|[0-9A-Za-z]{2}\\.[0-9A-Za-z]{3}\\.[0-9A-Za-z]{3}\\/[0-9A-Za-z]{4}-\\d{2})$",
>       "description": "CNPJ completo, com ou sem pontuação.",
>       "title": "CNPJ"
>     }
>   },
>   "required": [
>     "document"
>   ],
>   "additionalProperties": false,
>   "examples": [
>     {
>       "document": "19131243000197"
>     }
>   ]
> }
> ```

> [accordion] Resultado
>
> ```json theme={null}
> {
>   "$schema": "https://json-schema.org/draft/2020-12/schema",
>   "type": "object",
>   "properties": {
>     "object": {
>       "type": "string",
>       "const": "public_payee",
>       "description": "Tipo do objeto Base39."
>     },
>     "legal_name": {
>       "type": "string",
>       "minLength": 1,
>       "description": "Razão social."
>     },
>     "trade_name": {
>       "type": "string",
>       "description": "Nome fantasia."
>     },
>     "person_type": {
>       "type": "string",
>       "description": "Tipo de pessoa."
>     },
>     "address": {
>       "type": "object",
>       "properties": {
>         "street": {
>           "type": "string",
>           "description": "Logradouro."
>         },
>         "street_type": {
>           "type": "string",
>           "description": "Tipo de logradouro."
>         },
>         "number": {
>           "type": "string",
>           "description": "Número do endereço."
>         },
>         "complement": {
>           "type": "string",
>           "description": "Complemento do endereço."
>         },
>         "neighborhood": {
>           "type": "string",
>           "description": "Bairro."
>         },
>         "postal_code": {
>           "type": "string",
>           "description": "Código postal."
>         },
>         "city": {
>           "type": "string",
>           "description": "Município."
>         },
>         "state": {
>           "type": "string",
>           "description": "Unidade federativa."
>         },
>         "country": {
>           "type": "string",
>           "description": "País informado pela fonte."
>         },
>         "active": {
>           "type": "boolean",
>           "description": "Indica se o endereço está ativo na fonte."
>         }
>       },
>       "additionalProperties": false,
>       "description": "Endereço cadastral."
>     },
>     "activity_code": {
>       "type": "string",
>       "description": "Código CNAE da atividade econômica."
>     },
>     "activity": {
>       "type": "string",
>       "description": "Descrição da atividade econômica."
>     },
>     "activity_section_code": {
>       "type": "string",
>       "description": "Código da seção CNAE."
>     },
>     "activity_section_description": {
>       "type": "string",
>       "description": "Descrição da seção CNAE."
>     },
>     "legal_nature_code": {
>       "type": "string",
>       "description": "Código da natureza jurídica."
>     },
>     "legal_nature": {
>       "type": "string",
>       "description": "Descrição da natureza jurídica."
>     },
>     "legal_nature_type_code": {
>       "type": "string",
>       "description": "Código do tipo de natureza jurídica."
>     },
>     "legal_nature_type_description": {
>       "type": "string",
>       "description": "Descrição do tipo de natureza jurídica."
>     },
>     "document": {
>       "type": "string",
>       "minLength": 1,
>       "description": "CPF ou CNPJ informado pela fonte; pode estar mascarado."
>     },
>     "updated_at": {
>       "type": "string",
>       "format": "date-time",
>       "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
>       "description": "Data e hora da última atualização publicada, em ISO 8601."
>     }
>   },
>   "required": [
>     "object",
>     "legal_name",
>     "document",
>     "updated_at"
>   ],
>   "additionalProperties": false,
>   "examples": [
>     {
>       "object": "public_payee",
>       "legal_name": "Empresa de teste",
>       "trade_name": "Exemplo",
>       "person_type": "Pessoa Jurídica",
>       "address": {
>         "street": "Rua de teste",
>         "number": "1",
>         "neighborhood": "Centro",
>         "postal_code": "01001000",
>         "city": "São Paulo",
>         "state": "SP"
>       },
>       "activity_code": "6201501",
>       "activity": "Desenvolvimento de programas de computador sob encomenda",
>       "activity_section_code": "J",
>       "activity_section_description": "Informação e comunicação",
>       "legal_nature_code": "2062",
>       "legal_nature": "Sociedade Empresária Limitada",
>       "legal_nature_type_code": "2",
>       "legal_nature_type_description": "Entidade empresarial",
>       "document": "19131243000197",
>       "updated_at": "2026-11-01T00:00:00Z"
>     }
>   ]
> }
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.