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

5 (2)
Avaliação do Artigo (2 Votos)
Avaliar esse artigo
Anexos
Não há anexos para este artigo.
Artigos Relacionados RSS Feed
API REST: Ano contido no documento não é o mesmo do informado no serviço - Como resolver?
Visualizado 290 vezes desde 08/01/2019
Emissão de Eventos Fiscais na API Rest
Visualizado 334 vezes desde 16/03/2018
Inutilização de Numeração na API Rest
Visualizado 451 vezes desde 16/03/2018
Manutenção de CSC (Código de Segurança do Contribuinte) na API Rest
Visualizado 296 vezes desde 16/03/2018
Geração de DADFe sem valor fiscal na API Rest
Visualizado 370 vezes desde 25/05/2020
Relatórios na API Rest
Visualizado 698 vezes desde 19/08/2021
Como funciona o processo de emissão na API Rest?
Visualizado 236 vezes desde 06/08/2019
Integração API Rest
Visualizado 607 vezes desde 09/03/2018
Importação e Conciliação de DFes na API Rest
Visualizado 356 vezes desde 16/03/2018
Emissão de DFes na API Rest
Visualizado 446 vezes desde 13/03/2018