--- title: "Compliance Basic PJ" description: "API Compliance para Pessoa Jurídica - Decisão Segura em Segundos A Compliance Basic PJ é a API ideal para acelerar análises de risco de empresas, permitindo que seu sistema consulte dados de compliance de pessoa jurídica em tempo real com apenas um input cadastral. Com integração rápida e documentação clara, você incorpora o serviço à sua jornada de cadastro, onboarding, crédito ou monitoramento contínuo sem grandes ajustes na sua arquitetura. O retorno da api-compliance-basic-pj traz informações estruturadas para apoiar decisões automáticas ou semi-automáticas, reduzindo retrabalho manual e riscos regulatórios. Ao incluir a API no seu fluxo, você ganha eficiência operacional, melhora a qualidade das análises e eleva a segurança das decisões de negócio em escala." lang: pt-BR canonical: https://doc.apibrasil.io/apis/creditos/8f99d6dc-993c-480f-b62c-b0a9b2030e33 markdown: https://doc.apibrasil.io/apis/creditos/8f99d6dc-993c-480f-b62c-b0a9b2030e33.md source: apibrasil-documentation --- # Compliance Basic PJ > API Compliance para Pessoa Jurídica - Decisão Segura em Segundos > A Compliance Basic PJ é a API ideal para acelerar análises de risco de empresas, permitindo que seu sistema consulte dados de compliance de pessoa jurídica em tempo real com apenas um input cadastral. Com integração rápida e documentação clara, você incorpora o serviço à sua jornada de cadastro, onboarding, crédito ou monitoramento contínuo sem grandes ajustes na sua arquitetura. O retorno da api-compliance-basic-pj traz informações estruturadas para apoiar decisões automáticas ou semi-automáticas, reduzindo retrabalho manual e riscos regulatórios. Ao incluir a API no seu fluxo, você ganha eficiência operacional, melhora a qualidade das análises e eleva a segurança das decisões de negócio em escala. - **Categoria:** Análise de Crédito - **Cobrança:** por consulta, só com o Bearer Token - **Preço:** R$ 5,68 por consulta - **Limite:** 999.000 por mês - **Cadastro:** exige CNPJ - **Versão:** v1 - **Publicada por:** APIBrasil - **Especificação OpenAPI:** https://doc.apibrasil.io/apis/creditos/8f99d6dc-993c-480f-b62c-b0a9b2030e33/openapi.json ## Como chamar **Endereço base:** `https://gateway.apibrasil.io/api/v2` Autenticação: cabeçalho `Authorization: Bearer `. Nada além disso. Com `homolog: true` no corpo, o gateway responde de uma base fixa, com a forma real da resposta, e não cobra. O CPF 00000000000 é dessa base e não é de ninguém: use-o nos testes, nunca em produção. ## Endpoints (1 endpoint) ### 1. POST /consulta/cnpj/credits API Compliance para Empresas - Decisão Segura e Ágil A Compliance Basic PJ conecta seu sistema a uma análise de compliance de pessoa jurídica robusta, entregando informações essenciais com apenas um chamado via POST e um CNPJ. Em poucos minutos, a integração é realizada, permitindo que sua equipe automatize o onboarding, análise de crédito e monitoramento recorrente sem esforço e com alto padrão de segurança. O retorno da API compliance-basic-pj é estruturado e claro, possibilitando a tomada de decisões automáticas e eliminando retrabalho manual, o que reduz custos, riscos regulatórios e acelera processos críticos do seu negócio. Ganhe eficiência operacional, promova agilidade e aumente a confiabilidade das suas análises ao incorporar essa solução pronta e escalável ao seu sistema. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/cnpj/credits` - **Versão da rota:** v1 **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```json { "tipo": "compliance-basic-pj", "cnpj": "44.959.669/0001-80", "homolog": true } ``` **Em cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/cnpj/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"compliance-basic-pj","cnpj":"44.959.669/0001-80","homolog":true}' ``` Este endpoint aceita `homolog: true` no corpo: a resposta volta com dados válidos, `api_limit_for` igual a `homolog` e sem tarifação. **Resposta de exemplo, do catálogo** ```json { "user": { "first_name": "[omitido]", "email": "[omitido]", "cellphone": "[omitido]", "notification": "yes" }, "balance": "105,660", "balance_before": "105,660", "tax": "0,000", "status_code": 200, "error": false, "message": "Dados validos em homologacao! Voce nao foi tarifado e a requisicao nao foi contabilizada.", "valor_consulta": 0, "api_limit_for": "homolog", "homolog": true, "data": { "resultado": { "cnpj": "44959669000180", "compliance": { "ceis": [], "cepim": [], "cnep": [], "ibama": [], "mpf_leniencia": [], "mpt_lista_suja": [], "pep": [], "tcu": [] }, "dados_cadastrais": { "cd_cnae_fiscal_principal": "6201501", "cd_cnae_fiscal_secundarios": [ "6202300", "6203100", "6319400", "6399200" ], "cd_natureza_juridica": "2062", "cd_qualificacao_responsavel": "49", "cd_ramo_atividade": "J", "classificacao_td": "Comercio e Servicos", "cnpj_basico": "44959669", "cnpj_completo": "44959669000180", "cnpj_dv": "80", "cnpj_ordem": "0001", "data_inicio_atividade": "2021-09-15", "ds_cnae_fiscal_principal": "Desenvolvimento de programas de computador sob encomenda", "ds_cnae_fiscal_secundarios": [ "Desenvolvimento e licenciamento de programas de computador customizaveis", "Desenvolvimento e licenciamento de programas de computador nao-customizaveis", "Portais, provedores de conteudo e outros servicos de informacao na internet", "Outras atividades de prestacao de servicos de informacao nao especificadas anteriormente" ], "ds_natureza_juridica": "Sociedade Empresaria Limitada", "ds_ramo_atividade": "INFORMACAO E COMUNICACAO", "ente_federativo_responsavel": null, "identificador_matriz_filial": "MATRIZ", "nome_cidade_exterior": null, "nome_fantasia": "EXEMPLO CLOUD", "pais": null, "razao_social_nome_empresarial": "EXEMPLO SOLUCOES DIGITAIS LTDA" }, "dados_contato": { "emails": [ { "emails": "[omitido]", "ordem": "0", "rfb": true } ], "faxs": [ { "_up": "2026-02-20", "ddd": "11", "numero": "32324567", "ordem": "0", "rfb": true, "tipo": "FAX" } ], "logradouros": [ { "logradouro_bairro": "Vila Exemplo", "logradouro_cep": "04567000", "logradouro_complemento": "Sala 402", "logradouro_endereco": "Alameda das Empresas", "logradouro_geo_composed": { "lat": "-23.6022112", "lon": "-46.6915148" }, "logradouro_latitude": "-23.6022112", "logradouro_longitude": "-46.6915148", "logradouro_municipio": "Sao Paulo", "logradouro_numero": "450", "logradouro_tipo": "Avenida", "logradouro_uf": "SP", "logradouro_uf_iso": "BR-SP", "ordem": "0", "rfb": true } ], "telefones": [ { "_up": "2026-02-20", "ddd": "11", "ddi": null, "numero": "988776655", "ordem": "0", "rfb": true, "tipo": "CELULAR" } ] }, "dividas_publicas": { "pgfn_fgts": { "quantidade": "0", "ultimas_ocorrencias": [], "valor": "0,00" }, "pgfn_nao_previdenciario": { "quantidade": "0", "ultimas_ocorrencias": [], "valor": "0,00" }, "pgfn_previdenciario": { "quantidade": "0", "ultimas_ocorrencias": [], "valor": "0,00" } }, "filiais": [], "firmografico": { "capital_social": "150000.00", "cd_porte_empresa": "03", "ds_faixa_faturamento": "De R$ 360.000,01 ate R$ 4.800.000,00", "ds_porte_empresa": "EMPRESA DE PEQUENO PORTE", "faixa_funcionarios_presumidos": "6 ate 20 funcionarios", "porte_td": "Empresa de Pequeno Porte (EPP)", "quantidade_funcionarios_presumidos": "12", "quantidade_funcionarios_rais_1": null, "quantidade_funcionarios_rais_2": null, "valor_faturamento_presumido": "1245000.90" }, "patrimonio": { "aeronaves": [], "grupo_economico": [], "multiempresarial": [ { "cnpj_basico": "44959669", "cnpj_completo": "44959669000180", "nome_fantasia": "EXEMPLO CLOUD", "razao_social": "LUCAS GOMES ALMEIDA" } ] }, "quadro_societario": { "mei_proprietario_cpf": null, "mei_proprietario_nome": null, "socios": [ { "cd_faixa_etaria_socio": "5", "cd_identificador_socio": "2", "cd_qualificacao_socio": "49", "cd_representante_legal_qualificacao": "00", "cpf_cnpj_socio": "***123456**", "cpf_cnpj_socio_tratado": "12345678901", "data_entrada_sociedade": "2021-09-15", "ds_faixa_etaria_socio": "41 A 50 ANOS", "ds_identificador_socio": "PESSOA FISICA", "ds_qualificacao_socio": "Socio-Administrador", "ds_representante_legal_qualificacao": "Nao informada", "nome_socio_razao_social": "LUCAS GOMES ALMEIDA", "pais": null, "representante_legal_cpf": "***000000**", "representante_legal_cpf_tratado": null, "representante_legal_nome": null } ] }, "regime_tributario": { "opcao_mei": false, "opcao_mei_data_exclusao": null, "opcao_mei_data_opcao": null, "opcao_simples": true, "opcao_simples_data_exclusao": null, "opcao_simples_data_opcao": "2021-09-15", "regime_tributario": [] }, "situacao_cadastral": { "cd_situacao_cadastral": "2", "cd_situacao_cadastral_motivo": "00", "ds_situacao_cadastral": "ATIVA", "ds_situacao_cadastral_motivo": null, "situacao_cadastral_data": "2021-09-15", "situacao_especial": null, "situacao_especial_data": null } } } } ``` Nos exemplos de resposta, os campos da conta que gerou o exemplo (`user.first_name`, `user.email`, `user.cellphone`) saem como `[omitido]`. O resto é o que o catálogo publica. ## Armadilhas: o que uma integração erra sem avisar Apuradas nas respostas que o próprio catálogo publica. Em todas elas o código funciona no caminho feliz e falha em silêncio no resto: 1. **O erro chega no CORPO, com HTTP 200.** A resposta traz um campo `error` booleano e uma `message`. Checar só `response.ok` ou o status HTTP deixa passar falha como sucesso. Confira SEMPRE `error === false` antes de ler `data`. 2. **`balance`, `tax` e `extra_charges.total` são STRING em formato brasileiro — e o formato varia entre APIs.** Valores observados no catálogo: `"154,380"`, `"497,84"`, `"0,000"` e `"0.19"`. Vírgula em umas, ponto em outra; três casas decimais em umas, duas em outra. Em JavaScript, `parseFloat("154,380")` devolve `154` e perde os centavos sem erro nenhum, e `Number("154,380")` devolve `NaN`. Escreva um conversor que trate os dois separadores, e nunca use esses campos numa decisão financeira sem convertê-los. 3. **Cada chamada custa dinheiro.** Retry cego multiplica a conta. Nunca repita automaticamente um 4xx: parâmetro errado repetido continua errado e continua cobrando. Repita só tempo esgotado e 5xx, com recuo exponencial e um teto pequeno de tentativas. 4. **HTTP 402 é saldo insuficiente, e repetir não resolve.** É o único status que exige ação humana — recarregar. Trate-o como erro terminal, com mensagem própria, e não o jogue no mesmo balde dos 4xx genéricos. 5. **`extra_charges` cobra à parte do preço da consulta.** Quando o corpo pede serviços adicionais, a resposta traz cada um com o preço e um `total` que NÃO está incluso no valor base. Se você mostra custo a quem usa, some os dois. ## Ver também - Especificação OpenAPI: https://doc.apibrasil.io/apis/creditos/8f99d6dc-993c-480f-b62c-b0a9b2030e33/openapi.json - Catálogo de APIs: [Catálogo de APIs](https://doc.apibrasil.io/apis.md) - SDKs oficiais: [SDKs oficiais](https://doc.apibrasil.io/sdks.md) - Índice da documentação: https://doc.apibrasil.io/llms.txt - Versão HTML desta página: https://doc.apibrasil.io/apis/creditos/8f99d6dc-993c-480f-b62c-b0a9b2030e33