NFeConsultarDadosCNPJ

A função NFeConsultarDadosCNPJ recebe um CNPJ e retorna os dados associados a ele.

Esta função utiliza a DLL Newtonsoft.Json.dll conforme os termos de uso descrito no fim desta documentação e devem ser salva, no diretório programs da sua aplicação.

Tipo de Retorno

Boolean

Pacote

A função NFeConsultarDadosCNPJ está definida dentro do pacote NF-eConsultarDadosCNPJ.pkg.

Sintaxe

Move (NFeConsultarDadosCNPJ(&vParams)) to bOk 

Onde:

  • &{vParams} é uma variável do tipo tNFeConsultarDadosCNPJ_Param. Deve ser passada por referência. Contém os parâmetros para execução da função e também os retornos, conforme abaixo:
    • sCNPJConsultar:é o CNPJ cujas informações serão consultadas;
    • sCNPJLicenciado: é o CNPJ da empresa licenciada para utilizar a NFeLibrary;
    • sChaveLicenca: é usado para informar a chave da licença de uso quando a função é utilizada em ambiente de produção;
    • bExibeErro: indica se as mensagens de erro ocorridas devem ser mostradas (TRUE) ou não (FALSE);
    • sToken: é o token fornecido. Caso não tenha, não informe;
    • sRetMsgResultado: é o texto contendo a mensagem de retorno de acordo com iRetCodRetorno;
    • iRetCodRetorno: é o código que representa o resultado da consulta. Código 0 (zero), representa consulta realizada com sucesso, código diferente de zero, representa erro;
    • vtDadosCNPJ: estrutura do tipo tNFeDadosCNPJ que contém as informações retornadas pelo webservice, conforme detalhado abaixo:
      • sUltimaAtualizacao: string, contendo a data e hora da última consulta a base de dados da receita no formato, "aaaa-mm-ddThh:mm:ss.000Z";
      • sAbertura: string, contendo a data de abertura da instituição no formato, "dd/mm/aaaa";
      • sCnpj: string, contendo o CNPJ consultado;
      • sTipo: string, contendo o tipo "MATRIZ" ou "FILIAL";
      • sPorte: string, contendo o porte da instituição;
      • sNome: string, contendo o nome/razão social da instituição;
      • sFantasia: string, contendo o nome fantasia da instituição;
      • sAtividadePrincipal: é um array de estrutura do tipo tNFeAtividadeEmpresa que contém as informações conforme detalhado abaixo:
        • sCode: string, contendo o código de atividade (CNAE), no formato, "NN.NN-N-NN";
        • sText: string, contendo a descrição correspondente ao CNAE;
      • sAtividadesSecundarias: é um array de estrutura do tipo tNFeAtividadeEmpresa que contém as informações conforme detalhado abaixo:
        • sCode: string, contendo o código de atividade (CNAE), no formato, "NN.NN-N-NN";
        • sText: string, contendo a descrição correspondente ao CNAE;
      • sQsa é um array de estrutura do tipo tNFeQuadroSocial que contém as informações conforme detalhado abaixo:
        • sNome: string, contendo o nome do sócio;
        • sQual: string, contendo o código e a desccrição da qualificação do sócio;
      • sNaturezaJuridica: string, contendo a natureza jurídica do CNPJ consultado;
      • sLogradouro: string, contendo o logradouro da instituição consultada;
      • sNumero: string, contendo o número do logradouro da instituição;
      • sComplemento: string, contendo o complemento do logradouro da instituição;
      • sCep: string, contendo o CEP da instituição;
      • sBairro: string, contendo o bairro da instituição;
      • sMunicipio: string, contendo o nome do município da instituição;
      • sUf: string, contendo a sigla da unidade federativa da instituição;
      • sEmail: string, contendo o e-mail de contato da instituição;
      • sTelefone: string, contendo o telefone de contato da instituição;
      • efr: string, contendo o ente federativo responsável;
      • sSituacao: string, contendo a situação da instituição na Receita Federal;
      • sDataSituacao: string, contendo a data em que a situação da instituição foi atualizada no formato, "dd/mm/aaaa";
      • sMotivoSituacao: string, contendo o motivo da situação;
      • sSituacaoEspecial: string, contendo a situação especial da instituição na Receita Federal;
      • sDataSituacaoEspecial: string, contendo a data em que a situação especial da instituição foi atualizada no formato, "dd/mm/aaaa";
      • sCapitalSocial: string, contendo o valor do capital social da instituição no formato, "NNNNN.NN";
      • sSimples: é uma estrutura do tipo tNFeSimplesSimei que contém as informações conforme detalhado abaixo:
        • sOptante: string, contendo "true" ou "false", indicando se a instituição está enquadrada no Simples Nacional;
        • sDataOpcao: string, contendo a data em que a instituição ingressou no Simples Nacional no formato, "dd/mm/aaaa";
        • sDataExclusao: string, contendo a data em que a instituição saiu do Simples Nacional no formato, "dd/mm/aaaa";
        • sUltimaAtualizacao: string, contendo a data da última atualização das informações referentes ao Simples Nacional no formato, "aaaa-mm-ddThh:mm:ss.000Z";
      • sSimei: é uma estrutura do tipo tNFeSimplesSimei que contém as informações conforme detalhado abaixo:
        • sOptante: string, contendo "true" ou "false", indicando se a instituição está enquadrada no SIMEI;
        • sDataOpcao: string, contendo a data em que a instituição ingressou no SIMEI no formato, "dd/mm/aaaa";
        • sDataExclusao: string, contendo a data em que a instituição saiu do SIMEI no formato, "dd/mm/aaaa";
        • sUltimaAtualizacao: string, contendo a data da última atualização das informações referentes ao SIMEI no formato, "aaaa-mm-ddThh:mm:ss.000Z";
  • {bOk} indica se a consulta foi realizada com sucesso.

Exemplo

Um exemplo de uso da função pode ser encontrado dentro da Workspace de Exemplo na view CosultarDadosCNPJ.vw.

ExemploBuscarCEP

Observações

  • Função adicionada na versão 2025/01;
  • Limitado o uso a 3 consultas por minuto. Caso necessite realizar mais consultas, entre em contato pelo e-mail: suporte@developerflex.com.br. 

Termo de uso da DLL

Newtonsoft.Json.dll

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL ACRONSOFT BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

O SOFTWARE É FORNECIDO "COMO ESTÁ", SEM GARANTIA DE QUALQUER TIPO, EXPRESSA OU IMPLÍCITA, INCLUINDO MAS NÃO LIMITADO ÀS GARANTIAS DE COMERCIALIZAÇÃO, ADEQUAÇÃO A UM DETERMINADO FIM E NÃO VIOLAÇÃO. EM NENHUM CASO A ACRONSOFT SERÁ RESPONSÁVEL POR QUALQUER RECLAMAÇÃO, DANOS OU OUTRA RESPONSABILIDADE, SEJA EM UMA AÇÃO DE CONTRATO, ATO ILÍCITO OU DE OUTRA FORMA, DECORRENTE DE, DE OU EM CONEXÃO COM O SOFTWARE OU O USO OU OUTRAS NEGOCIAÇÕES NO SOFTWARE.

Não encontrou o que precisava, entre em contato conosco.