Como utilizar o Consulta Cadastro?

Por meio do Consulta Cadastro você pode saber, antes mesmo da emissão de um documento, a situação de um CNPJ, CPF ou Inscrição Estadual (IE) na Sefaz.

Dessa forma, você diminui as chances de ter documentos rejeitados ou denegados por problemas de cadastro, garantindo que os interessados estão ativos e habilitados no Fisco.

---

Realize uma consulta à Sefaz

1. Para começar, faça uma requisição tipo GET ao endpoint de consultar o cadastro de contribuintes;

   [URL_BASE]/api/empresas/{empresa}/consulta-cadastro/{uf}/{tipoArgumento}/{doc}

2. Preencha as seguintes informações:

   • {empresa}*: CNPJ da empresa que está realizando a consulta;
   • {uf}*: AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG, PA, PB, PR, PE, PI, RJ, RN, RS, RO, RR, SC, SP, SE, TO;
   Observação

   Se não for possível mencionar a UF, utilize a sigla AN (Ambiente Nacional).

   • {tipoArgumento}*: CNPJ, CPF ou inscricao;
   • {doc}*: CNPJ, CPF ou IE da empresa a ser consultada.

3. No cabeçalho da requisição Accept, informe o tipo de conteúdo (content-type) a ser retornado:

   • {application/xml};
   • {application/json;charset=UTF-8}.

4. Informe o x-auth-token no cabeçalho (header parameters) da requisição.

Exemplo de requisição

O exemplo abaixo traz um modelo de requisição preenchido para consulta de cadastro.

Observação

A requisição contém dados fictícios, somente para demonstração.

curl -L -X GET 'https://rest-teste.oobj.com.br/api/empresas/07385111000102/consulta-cadastro/GO/cnpj/0000000000000' \
-H 'Accept: application/xml'
-H 'x-auth-token: eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiI3Yjc2OTg1ZGQ2MTNhOWVlYTFiN2RmZTNiZjRhMTRiZiIsImF1ZCI6IndlYiIsImV4cCI6MTYyOTI5MDcwNiwiaWF0IjoxNjI5Mjg4OTA2fQ.-Dj91d6fBZYcZpy1-zKzohAWd5dgW2CAS5BBfwGilemUYcOVDm8CnrDJHbwsFyixI5ohphy-65fqeobXkimtCg'

Exemplo de retorno

<?xml version="1.0" encoding="UTF-8"?>
<RetConsultaCadastroDto>
    <infCons>
        <CNPJ>string</CNPJ>
        <CPF>string</CPF>
        <IE>string</IE>
        <UF>string</UF>
        <ativPrincipal>
            <cnae>0</cnae>
            <nome>string</nome>
        </ativPrincipal>
        <ativSecundarias>
            <cnae>0</cnae>
            <nome>string</nome>
        </ativSecundarias>
        <cStat>string</cStat>
        <cUF>string</cUF>
        <capitalSocial>string</capitalSocial>
        <dhAtualizacao>string</dhAtualizacao>
        <dhCons>string</dhCons>
        <infCad>
            <CNAE>string</CNAE>
            <CNPJ>string</CNPJ>
            <CPF>string</CPF>
            <IE>string</IE>
            <IEAtual>string</IEAtual>
            <IEUnica>string</IEUnica>
            <UF>string</UF>
            <cSit>string</cSit>
            <dBaixa>string</dBaixa>
            <dIniAtiv>string</dIniAtiv>
            <dUltSit>string</dUltSit>
            <ender>
                <CEP>string</CEP>
                <cMun>string</cMun>
                <emails>string</emails>
                <nro>string</nro>
                <xBairro>string</xBairro>
                <xCpl>string</xCpl>
                <xLgr>string</xLgr>
                <xMun>string</xMun>
                <xTel>
                    <ddd>string</ddd>
                    <numero>string</numero>
                </xTel>
            </ender>
            <indCredCTe>string</indCredCTe>
            <indCredNFe>string</indCredNFe>
            <xFant>string</xFant>
            <xNome>string</xNome>
            <xRegApur>string</xRegApur>
        </infCad>
        <verAplic>string</verAplic>
        <xMotivo>string</xMotivo>
    </infCons>
</RetConsultaCadastroDto>

Pronto! Você acaba de completar a consulta do cadastro de uma empresa.