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:

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



Nº do Artigo: 1071
Postado: 14/01/2021 21:48:27
Última atualização: 15/01/2021 12:29:48
Postado: Isabel Cavalcanti [isabel.cavalcanti@oobj.com.br]

URL: https://backupbc.novooobj.xyz/article/consulta-cadastro-centralizado-de-contribuinte-consulta-cadastro-api-rest-1071.html