--- title: "Define Negócio PJ" description: "Análise de crédito empresarial por CNPJ: decisão, score, faturamento presumido, comportamento de pagamento mês a mês, compromissos futuros, sócios, participações, consultas recebidas e restrições (pendências, protestos, cheques, ações e falências). Cobrada quando a base identifica a empresa ou devolve o score; CNPJ inválido é recusado sem cobrança. Disponível para contas PJ." lang: pt-BR canonical: https://doc.apibrasil.io/apis/creditos/41a65bc2-de0e-11f1-98bb-bc24118aba26 markdown: https://doc.apibrasil.io/apis/creditos/41a65bc2-de0e-11f1-98bb-bc24118aba26.md source: apibrasil-documentation --- # Define Negócio PJ > Análise de crédito empresarial por CNPJ: decisão, score, faturamento presumido, comportamento de pagamento mês a mês, compromissos futuros, sócios, participações, consultas recebidas e restrições (pendências, protestos, cheques, ações e falências). Cobrada quando a base identifica a empresa ou devolve o score; CNPJ inválido é recusado sem cobrança. Disponível para contas PJ. - **Categoria:** Análise de Crédito - **Cobrança:** por consulta, só com o Bearer Token - **Preço:** R$ 121,90 por consulta - **Limite:** 990.000 por mês - **Cadastro:** exige CNPJ - **Versão:** v2 - **Publicada por:** APIBrasil - **Especificação OpenAPI:** https://doc.apibrasil.io/apis/creditos/41a65bc2-de0e-11f1-98bb-bc24118aba26/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 Envie um POST com tipo=define-negocio-pj e o cnpj (com ou sem máscara). O campo data traz o cnpj consultado e define_negocio_positivo, um objeto com um bloco por assunto. As chaves vêm no formato prefixo:nome: decisao:decisao, scor:score, idenc:identificacao_completo, fat:faturamento_presumido, credobt:credito_obtido, compro:compromissos, pgtpont:pagamento_pontual, pgtatra:pagamento_atrasado, compfut:comprometimento_futuro, soc:socios, parsc:participacoes_socios_adm_outras_empresas, con:consultas, pen:pendencias_restricoes, prot:protestos, cheq1:cheques_sem_fundo, aco:acoes_civeis e rec:falencias_recuperacao_judicial, entre outros. Bloco sem informação vem nulo ou só com a mensagem (prefixo:mensagem). CNPJ inválido é recusado com HTTP 400, sem cobrança; empresa não identificada e sem score na base devolve HTTP 404, sem cobrança. Base de dados indisponível devolve HTTP 502, 503 ou 504, sem cobrança. Disponível para contas PJ. Em homologação (homolog=true), sem cobrança e com qualquer CNPJ válido, a resposta traz dados fictícios. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/cnpj/credits` - **Versão da rota:** v2 **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```json { "tipo": "define-negocio-pj", "cnpj": "11222333000181", "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":"define-negocio-pj","cnpj":"11222333000181","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": "278,100", "balance_before": "400,000", "tax": "121,900", "status_code": 200, "error": false, "message": "Dados validos! Voce foi tarifado em R$ 121,90.", "valor_consulta": 121.9, "api_limit_for": "credit", "homolog": false, "data": { "define_negocio_positivo": { "decisao:decisao": { "decisao:flag": "0000", "decisao:descricao": "TEXTO FICTICIO" }, "statcon:status_consumidor": { "statcon:mensagem": "TEXTO FICTICIO" }, "demaisin:demais_informacoes": { "demaisin:tempo_relacionamento_fornecedores": { "demaisin:historico_periodo": [ { "demaisin:periodo": "TEXTO FICTICIO", "demaisin:valor": "0" }, { "demaisin:periodo": "TEXTO FICTICIO", "demaisin:valor": "0" } ] }, "demaisin:acontecimentos_importantes": { "demaisin:historico_periodo_pontuacao": [ { "demaisin:indicador": "TEXTO FICTICIO", "demaisin:periodo": "TEXTO FICTICIO", "demaisin:pontuacao": "TEXTO FICTICIO" }, { "demaisin:indicador": "TEXTO FICTICIO", "demaisin:periodo": "TEXTO FICTICIO", "demaisin:pontuacao": "650" } ] } }, "credobt:credito_obtido": { "credobt:pontuacao": "650", "period:lista_indicador_comportamento": { "period:item_indicador": [ { "period:mes_ano": "TEXTO FICTICIO", "period:pontuacao_mensal": "650" }, { "period:mes_ano": "TEXTO FICTICIO", "period:pontuacao_mensal": "650" } ] } }, "compro:compromissos": { "compro:pontuacao": "650", "period:lista_indicador_comportamento": { "period:item_indicador": [ { "period:mes_ano": "TEXTO FICTICIO", "period:pontuacao_mensal": "650" }, { "period:mes_ano": "TEXTO FICTICIO", "period:pontuacao_mensal": "650" } ] } }, "pgtpont:pagamento_pontual": { "pgtpont:pontuacao": "650", "period:lista_indicador_comportamento": { "period:item_indicador": [ { "period:mes_ano": "TEXTO FICTICIO", "period:pontuacao_mensal": "650" }, { "period:mes_ano": "TEXTO FICTICIO", "period:pontuacao_mensal": "650" } ] } }, "pgtatra:pagamento_atrasado": { "pgtatra:periodo_6_a_15_dias": { "period:lista_indicador_comportamento": { "period:item_indicador": [ { "period:mes_ano": "TEXTO FICTICIO", "period:pontuacao_mensal": "650" }, { "period:mes_ano": "TEXTO FICTICIO", "period:pontuacao_mensal": "650" } ] } }, "pgtatra:periodo_16_a_30_dias": { "period:lista_indicador_comportamento": { "period:item_indicador": [ { "period:mes_ano": "TEXTO FICTICIO", "period:pontuacao_mensal": "650" }, { "period:mes_ano": "TEXTO FICTICIO", "period:pontuacao_mensal": "650" } ] } }, "pgtatra:periodo_31_a_60_dias": { "period:lista_indicador_comportamento": { "period:item_indicador": [ { "period:mes_ano": "TEXTO FICTICIO", "period:pontuacao_mensal": "650" }, { "period:mes_ano": "TEXTO FICTICIO", "period:pontuacao_mensal": "650" } ] } }, "pgtatra:mais_de_60_dias": { "period:lista_indicador_comportamento": { "period:item_indicador": [ { "period:mes_ano": "TEXTO FICTICIO", "period:pontuacao_mensal": "650" }, { "period:mes_ano": "TEXTO FICTICIO", "period:pontuacao_mensal": "650" } ] } }, "pgtatra:atraso_medio_dias": { "period:lista_indicador_comportamento": { "period:item_indicador": [ { "period:mes_ano": "TEXTO FICTICIO", "period:pontuacao_mensal": "650" }, { "period:mes_ano": "TEXTO FICTICIO", "period:pontuacao_mensal": "650" } ] } } }, "compfut:comprometimento_futuro": { "compfut:lista_compromissos": { "compfut:compromisso": [ { "compfut:periodo": "TEXTO FICTICIO", "compfut:pontuacao": "650" }, { "compfut:periodo": "TEXTO FICTICIO", "compfut:pontuacao": "650" } ] }, "compfut:lista_credito": { "compfut:credito": [ { "compfut:periodo": "TEXTO FICTICIO", "compfut:pontuacao": "650" }, { "compfut:periodo": "TEXTO FICTICIO", "compfut:pontuacao": "650" } ] } }, "cred:limite_credito": null, "idenc:identificacao_completo": { "idenc:cnpj": "00000000000000", "idenc:razao_social": "EMPRESA FICTICIA LTDA", "idenc:nome_fantasia": "EMPRESA FICTICIA", "idenc:situacao_cnpj": "TEXTO FICTICIO", "idenc:data_situacao": "01/01/2020", "idenc:data_consulta_receita_federal": "01/01/2020", "idenc:numero_nire": "00000000000", "idenc:uf_nire": "MG", "idenc:data_fundacao": "01/01/2020", "idenc:codigo_natureza_juridica": "0000", "idenc:natureza_juridica": "TEXTO FICTICIO", "idenc:moeda_capital_inicial": "TEXTO FICTICIO", "idenc:capital_inicial": "00000.00", "idenc:data_registro": "01/01/2020", "idenc:orgao": "ORGAO FICTICIO", "idenc:moeda_capital_atual": "TEXTO FICTICIO", "idenc:capital_atual": "000000.00", "idenc:data_alteracao_capital": "01/01/2020", "idenc:orgao_atual": "ORGAO FICTICIO", "idenc:quantidade_filiais": 0, "idenc:razao_social_anterior": "EMPRESA FICTICIA LTDA", "idenc:data_alteracao_razao_social": "01/01/2020", "idenc:ramo_atividade_primario": { "idenc:cnae": "TEXTO FICTICIO", "idenc:atividade": "TEXTO FICTICIO" }, "idenc:fgts": { "idenc:dataConsulta": "01/01/2020", "idenc:situacao": "TEXTO FICTICIO" } }, "exsin:extra_sintegra": null, "locc:localizacao_completo": { "locc:matriz": { "locc:endereco_matriz": "RUA FICTICIA, 100", "locc:bairro_matriz": "BAIRRO FICTICIO", "locc:cidade_matriz": "CIDADE FICTICIA", "locc:uf_matriz": "MG", "locc:cep_matriz": "00000000", "locc:codigo_ibge_matriz": "00000000" }, "locc:filial": { "locc:endereco_filial": "", "locc:bairro_filial": "", "locc:cidade_filial": "", "locc:uf_filial": "", "locc:cep_filial": "", "locc:codigo_ibge_filial": "" } }, "fra:alerta_fraudes": null, "scor:score": { "scor:score_pj": { "scor:classificacao_alfabetica": "C", "scor:classificacao_numerica": "0", "scor:modelo_score": "MODELO FICTICIO", "scor:nome_score": "MODELO FICTICIO", "scor:probabilidade": "0.0", "scor:score": "650", "scor:texto": "TEXTO FICTICIO" } }, "fat:faturamento_presumido": { "fat:faixa": "00", "fat:faturamento_anual": "TEXTO FICTICIO", "fat:mensagem": "TEXTO FICTICIO" }, "mesmoe:empresas_situada_no_mesmo_endereco": { "mesmoe:empresa_situada_no_mesmo_endereco": [ { "mesmoe:cnpj": "00000000000000", "mesmoe:razao_social": "EMPRESA FICTICIA LTDA", "mesmoe:nome_fantasia": "EMPRESA FICTICIA", "mesmoe:endereco": "RUA FICTICIA, 100" }, { "mesmoe:cnpj": "00000000000000", "mesmoe:razao_social": "EMPRESA FICTICIA LTDA", "mesmoe:nome_fantasia": "EMPRESA FICTICIA", "mesmoe:endereco": "RUA FICTICIA, 100" } ] }, "soc:socios": { "soc:socio": [ { "soc:nome_empresa": "NOME FICTICIO DE TESTE", "soc:cpf_cnpj": "00000000000000", "soc:tipo_documento": "1", "soc:situacao_documento": "TEXTO FICTICIO", "soc:participacao": "00.00", "soc:data_entrada": "01/01/2020", "soc:assina_empresa": "TEXTO FICTICIO", "soc:indicador_debito": "TEXTO FICTICIO", "soc:indicador_fraude": "TEXTO FICTICIO" }, { "soc:nome_empresa": "NOME FICTICIO DE TESTE", "soc:cpf_cnpj": "00000000000000", "soc:tipo_documento": "1", "soc:situacao_documento": "TEXTO FICTICIO", "soc:participacao": "00.00", "soc:data_entrada": "01/01/2020", "soc:assina_empresa": "TEXTO FICTICIO", "soc:indicador_debito": "TEXTO FICTICIO", "soc:indicador_fraude": "TEXTO FICTICIO" } ] }, "adm:administradores": { "adm:mensagem": "TEXTO FICTICIO" }, "par:participacoes_em_outras_empresas": null, "parsc:participacoes_socios_adm_outras_empresas": { "parsc:socio": [ { "parsc:cpf": "00000000000000", "parsc:nome_socio": "NOME FICTICIO DE TESTE", "parsc:socios_participantes": { "parsc:cnpj": "00000000000000", "parsc:razao_social": "EMPRESA FICTICIA LTDA", "parsc:situacao_cnpj": "TEXTO FICTICIO", "parsc:participacao": "000.00", "parsc:entrada": "01/01/2020", "parsc:indicador_debito": "TEXTO FICTICIO", "parsc:indicador_fraude": "TEXTO FICTICIO" } }, { "parsc:cpf": "00000000000000", "parsc:nome_socio": "NOME FICTICIO DE TESTE", "parsc:socios_participantes": { "parsc:cnpj": "00000000000000", "parsc:razao_social": "EMPRESA FICTICIA LTDA", "parsc:situacao_cnpj": "TEXTO FICTICIO", "parsc:participacao": "000.00", "parsc:entrada": "01/01/2020", "parsc:indicador_debito": "TEXTO FICTICIO", "parsc:indicador_fraude": "TEXTO FICTICIO" } } ] }, "parc:participacoes_empresas_consultadas": { "parc:mensagem": "TEXTO FICTICIO" }, "con:consultas": { "con:quantidade_total": 0, "con:periodo_inicial": "01/01/2020", "con:periodo_final": "01/01/2020", "con:consultas_mes": [ { "con:mes_ano": "000000", "con:quantidade": 0 }, { "con:mes_ano": "000000", "con:quantidade": 0 } ], "con:ultimas_consultas": { "con:consulta": [ { "con:cnpj": "00000000000000", "con:data": "01/01/2020", "con:razao_social": "EMPRESA FICTICIA LTDA" }, { "con:cnpj": "00000000000000", "con:data": "01/01/2020", "con:razao_social": "EMPRESA FICTICIA LTDA" } ] } }, "anvis:anvisa": null, "hisci:historico_cheque_informados": null, "hiscc:historico_conta_correntes": null, "enda:endereco_telefones_agencia_bancaria": null, "pen:pendencias_restricoes": { "pen:mensagem": "TEXTO FICTICIO" }, "cheq1:cheques_sem_fundo": { "cheq1:mensagem": "TEXTO FICTICIO" }, "cheq2:cheques_sustados": { "cheq2:mensagem": "TEXTO FICTICIO" }, "cheq3:cheques_devolvidos_informados_usuario": { "cheq3:mensagem": "TEXTO FICTICIO" }, "prot:protestos": { "prot:mensagem": "TEXTO FICTICIO" }, "aco:acoes_civeis": { "aco:mensagem": "TEXTO FICTICIO" }, "rec:falencias_recuperacao_judicial": { "rec:mensagem": "TEXTO FICTICIO" } }, "cnpj": "11222333000181" } } ``` 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/41a65bc2-de0e-11f1-98bb-bc24118aba26/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/41a65bc2-de0e-11f1-98bb-bc24118aba26