Consulta Cadastro Centralizado de Contribuinte - Consulta Cadastro API Rest
A Consulta ao Cadastro do Contribuinte na Sefaz através da API Rest será permitido para o usuário que já possuir o x-auth-token. No artigo Autenticação na API Rest damos mais detalhes sobre o x-auth-token.
Existe apenas um Endpoint para o serviço de Consulta Cadastro.
Consultar Cadastro Contribuinte junto à Sefaz (GET)
A Consulta ao Cadastro do Contribuinte apresentará informações sobre a situação de um CNPJ junto a Sefaz. Muito utilizado antes da emissão de um documento para validar se os interessados nos documentos estão com o cadastro ativo e habilitado, evitando que documentos sejam rejeitados/denegados previamente.
A URL é construída da seguinte forma:
http:// ou https:// + /endereço da API Rest + /api/empresas/{empresa}/consulta-cadastro/{uf}/{tipoArgumento}/{doc}
Os valores sublinhados devem ser substituídos pelos valores correspondentes abaixo:
- {empresa} : CNPJ da Empresa
- {uf} : Sigla da UF da consulta
- {tipoArgumento} : Informação utilizada para a pesquisa (CPF, CNPJ ou Inscrição Estadual)
- {doc} : Documento a ser consultado
Exemplo com o parâmetro opcional layoutDFe preenchido:
http://rest.oobj-dfe.com.br/api/empresas/07385111000102/consulta-cadastro/GO/CNPJ/0000000000000
Exemplo de Retorno da Consulta à um Cadastro de Contribuinte
<retConsCad> <infCons> <verAplic>RSb20200214101151</verAplic> <cStat>257</cStat> <xMotivo>Rejeicao: Solicitante nao habilitado para emissao da NF-e [CNPJ-CD:00000000000000]</xMotivo> <UF>RS</UF> <CNPJ>07385111000102</CNPJ> <dhCons>2021-01-14T22:09:14</dhCons> <cUF>43</cUF> </infCons> </retConsCad>
Para realizar testes com a API Rest, e ter mais detalhes sobre a Emissão de Eventos Fiscais, acesse a documentação completa através do link: http://rest.oobj-dfe.com.br/swagger-ui.html#/Evento32Fiscal