POST

api/genericos/ge/Pessoa/ValidarCnpjCpf

Notas de Implementação:

Método para validação do CNPJ ou CPF informado e controla sua repetição através da configuração 'GE - EM - 244 - Controle de repetições do CNPJ/CPF no cadastro de empresas'.

Informações de Envio:

Cabeçalhos de Envio:

Parâmetro Valor Descrição Tipo de parâmetro Tipo de dados
Authorization Bearer Hash gerado no login Header String

Acesse o método de login para mais informações: api/genericos/ge/Login/Autenticar

Modelo:

Informar o CnpjCpf, PessoaFisica, Codigo, Inscricao e usuário a ser validado a configuração no UsuarioCriacao.

PessoaDTO

NomeDescriçãoTipoInformação Adicional
Codigo

Código de empresa/pessoa. O valor deve ser único.

 string

Obrigatório

Somente enviar se for alteração, não enviar se for inclusão
NomeCompleto

Nome completo exibido na empresa/pessoa.

 string

Opcional
CnpjCpf

CNPJ/CPF da empresa/pessoa.

 string

Obrigatório
Uf

UF onde a empresa/pessoa está situada.

 string

Obrigatório
UsuarioCriacao

Usuário de criação da empresa/pessoa.

 string

Obrigatório
Inscricao

Incrição estadual da empresa/pessoa.

 string

Obrigatório
PessoaFisica

Define se a pessoa é física ou jurídica.

 boolean

Obrigatório
Fantasia

Nome fantasia da empresa/pessoa.

 string

Opcional
Endereco

Endereço da empresa/pessoa.

 string

Opcional
Numero

Número do endereço da empresa/pessoa.

 string

Opcional
Bairro

Bairro onde a empresa/pessoa está situada.

 string

Opcional
Municipio

Município onde a empresa/pessoa está situada.

 string

Opcional
Telefone

Telefone da empresa/pessoa.

 string

Opcional
Ativo

Define se a empresa/pessoa está ativa.

 boolean

Opcional
Divisao

Divisão da empresa/pessoa.

 string

Opcional
FaxFone

Fax/Fone da empresa/pessoa.

 string

Opcional
Cep

Fax/Fone da empresa/pessoa.

 string

Opcional
Aniversario

Data de aniversário da empresa/pessoa.

 date

Opcional
Faturamento

Valor de faturamento da empresa/pessoa.

 decimal number

Opcional
CodigoPais

Código do país da empresa/pessoa.

 string

Opcional
Complemento

Complemento da empresa/pessoa.

 string

Opcional
Cnae

CNAE informado na empresa/pessoa.

 string

Opcional
Contato

Contato da empresa/pessoa.

 string

Opcional
Conceito

Conceito da empresa/pessoa.

 string

Opcional
Cadastro

Data do cadastro da empresa/pessoa.

 date

Opcional
CodigoRepresentante

Código de representante da empresa/pessoa.

 string

Opcional
PercentualComissaoBaixa

Percentual de comissão baixa da empresa/pessoa.

 decimal number

Opcional
ContabilCliente

Contabil cliente da empresa/pessoa.

 string

Opcional
Responsavel

Código de responsável da empresa/pessoa.

 string

Opcional
Indicacao

Indicacao da empresa/pessoa.

 string

Opcional
ContabilFornecedor

Contabilidade do fornecedor da empresa/pessoa.

 string

Opcional
CodigoCondicaoPagamento

Código da condição de pagamento da empresa/pessoa.

 string

Opcional
CodigoTipoPagamento

Código do tipo de pagamento da empresa/pessoa.

 string

Opcional
Inscrito

Indicação de inscrição da empresa/pessoa.

 boolean

Opcional
IrrfAcumulado

Valor acumulado de IRRF.

 decimal number

Opcional
TipoEmpresa

Tipo de empresa/pessoa.

 string

Opcional
Atividade

Atividade da empresa/pessoa.

 string

Opcional
Funcionarios

Número de funcionários da empresa/pessoa.

 integer

Opcional
LimiteCredito

Limite de crédito da empresa/pessoa.

 decimal number

Opcional
CodigoMercado

Código do mercado da empresa/pessoa.

 string

Opcional
EnviarCarta

Indicação de envio de carta.

 string

Opcional
CodigoTabelaPreco

Código da tabela de preço da empresa/pessoa.

 string

Opcional
AgendaInterna

Agenda interna da empresa/pessoa.

 string

Opcional
Centralizadora

Indicação de centralizadora.

 string

Opcional
AtrasoMedio

Atraso médio da empresa/pessoa.

 integer

Opcional
InscricaoMunicipal

Inscrição municipal da empresa/pessoa.

 string

Opcional
Suframa

Número Suframa da empresa/pessoa.

 string

Opcional
TipoFrete

Tipo de frete da empresa/pessoa.

 string

Opcional
PercentualIndenizacao

Percentual de indenização da empresa/pessoa.

 decimal number

Opcional
PercentualDescontoSugestaoItens

Percentual de desconto sugerido em itens da empresa/pessoa.

 decimal number

Opcional
PercentualDesconto2

Segundo percentual de desconto da empresa/pessoa.

 decimal number

Opcional
JurosPadrao

Juros padrão da empresa/pessoa.

 decimal number

Opcional
UnidadeNegocio

Unidade de negócio da empresa/pessoa.

 string

Opcional
PortadorPadrao

Portador padrão da empresa/pessoa.

 string

Opcional
ContabilAdiantamentoCliente

Conta contábil de adiantamento do cliente da empresa/pessoa.

 string

Opcional
ContabilAdiantamentoFornecedor

Conta contábil de adiantamento do fornecedor da empresa/pessoa.

 string

Opcional
CentroArmazenagem

Centro de armazenagem da empresa/pessoa.

 string

Opcional
IndiceCredito

Índice de crédito da empresa/pessoa.

 string

Opcional
RegiaoEntrega

Região de entrega da empresa/pessoa.

 string

Opcional
RegimeTributario

Regime tributário da empresa/pessoa.

 string

Opcional
Setor

Setor da empresa/pessoa.

 string

Opcional
PrefixoCnae

Prefixo do CNAE da empresa/pessoa.

 string

Opcional
BasePrazoDiferenciado

Base de prazo diferenciado da empresa/pessoa.

 string

Opcional
PossuiRetencaoIss

Indica se a empresa/pessoa possui retenção de ISS.

 string

Opcional
CentroArmazenagemMaterialAlternativo

Centro de armazenagem de material alternativo da empresa/pessoa.

 string

Opcional
FiltroDataDirf

Filtro de data para DIRF da empresa/pessoa.

 string

Opcional
TipoImovel

Tipo de imóvel da empresa/pessoa.

 string

Opcional
ListarIss

Lista ISS da empresa/pessoa.

 string

Opcional
DiaVencimento

Dia de vencimento da empresa/pessoa.

 string

Opcional
LimiteFaturado

Limite faturado da empresa/pessoa.

 string

Opcional
GrauRelacionamento

Grau de relacionamento da empresa/pessoa.

 string

Opcional
SufixoCnae

Sufixo do CNAE da empresa/pessoa.

 string

Opcional
ToleranciaVencimento

Tolerância de vencimento da empresa/pessoa.

 string

Opcional
NivelCredito

Nível de crédito da empresa/pessoa.

 string

Opcional
ListarDirf

Indica se a empresa/pessoa está listada na DIRF.

 boolean

Opcional
Conveniada

Indica se a empresa/pessoa é conveniada.

 boolean

Opcional
CreditoLiberado

Indica se o crédito está liberado para a empresa/pessoa.

 boolean

Opcional
PercentualFrete

Percentual de frete da empresa/pessoa.

 decimal number

Opcional
CodigoEan

Código EAN da empresa/pessoa.

 decimal number

Opcional
PercentualAcrescimoLimite

Percentual de acréscimo no limite da empresa/pessoa.

 decimal number

Opcional
PercentualAcrescimoPreco

Percentual de acréscimo no preço da empresa/pessoa.

 decimal number

Opcional
UtilizaPrazoDiferenciado

Indica se a empresa/pessoa utiliza prazo diferenciado.

 decimal number

Opcional
TgPadraoNfs

TG padrão para notas fiscais da empresa/pessoa.

 decimal number

Opcional
LimiteCreditoMensal

Limite de crédito mensal da empresa/pessoa.

 decimal number

Opcional
OptantePeloSimples

Indica se a empresa/pessoa é optante pelo Simples Nacional.

 decimal number

Opcional
Usrempr1

Usuário responsável pela empresa/pessoa (campo extra 1).

 string

Opcional
Usrempr2

Usuário responsável pela empresa/pessoa (campo extra 2).

 string

Opcional
CnaeServico

CNAE de serviço da empresa/pessoa.

 string

Opcional
ValorFrete

Valor de frete da empresa/pessoa.

 decimal number

Opcional
TipoOperacao

Tipo de operação da empresa/pessoa.

 string

Opcional
Email

Email da empresa/pessoa.

 string

Opcional
OpcoesAuxiliares

Opções auxiliares da empresa/pessoa.

 string

Opcional
NotificacaoBloquetoEmail

Email para notificação de boleto da empresa/pessoa.

 string

Opcional
RecebeEmailCartaCobranca

Indica se a empresa/pessoa recebe email de carta de cobrança.

 string

Opcional
CodigoIbge

Código IBGE da empresa/pessoa.

 string

Opcional
ValidarIbgeInformado

Indica se deve validar o código IBGE informado.

 boolean

Opcional
UsaMaiusculaMunicipio

Indica se o município da empresa/pessoa usa maiúsculas.

 boolean

Opcional
PermiteCriarComErro

Indica se permite criar com erro.

 boolean

Opcional
PermiteSobrescreverComBranco

Indica se permite sobrescrever com branco.

 boolean

Opcional
Latitude

Latitude da localização da empresa/pessoa.

 decimal number

Opcional
Longitude

Longitude da localização da empresa/pessoa.

 decimal number

Opcional
Nif

NIF da empresa/pessoa.

 string

Opcional
IdentificacaoSCP

Identificação do SCP da empresa/pessoa.

 string

Opcional
ContabilClienteLongoPrazo

Conta contábil do cliente de longo prazo da empresa/pessoa.

 string

Opcional
BoletoRetencao

Boletos de retenção da empresa/pessoa.

 string

Opcional
IndicativoNif

Informação é necessária em algumas obrigações acessórias no caso de beneficiários com domicílio no exterior.

 string

Opcional

Tamanho Único: 1

" " Nenhum, "1" = Beneficiário com NIF , "2" = Beneficiário dispensado do NIF, "3" = País não exige NIF
FormaTributacao

Código da forma de tributação sobre rendimentos de beneficiários domiciliados no exterior, conforme tabela 02 da EFD REINF.

 string

Opcional

Tamanho Único: 2
SobreFontePagadora

Código da fonte pagadora. Representa as nformações relativas à fonte pagadora dos rendimentos de beneficiários domiciliados no exterior, conforme tabela 03 da EFD REINF.

 string

Opcional

Tamanho Único: 3
CpfProdutorRural

Cpf utilizado na EFD-REINF, registro 20 do evento R-2055. Informação válida apenas para empresas do estado de SP e que sejam pessoa jurídica.

 string

Opcional
OrgaoPublico

Indicador se o cadastro de Empresa/Pessoa é orgão público.

 boolean

Opcional
TipoAssinanteNfcom

Indicador de tipo de assinante NFCom.

 integer

Opcional
MunicipioPrestacao

Município de prestação da Empresa

 string

Opcional

Formato de Envio:

application/json, text/json

Exemplo: 
{
  "Codigo": "string 1",
  "NomeCompleto": "string 2",
  "CnpjCpf": "string 3",
  "Uf": "string 4",
  "UsuarioCriacao": "string 5",
  "Inscricao": "string 6",
  "PessoaFisica": true,
  "Fantasia": "string 8",
  "Endereco": "string 9",
  "Numero": "string 10",
  "Bairro": "string 11",
  "Municipio": "string 12",
  "Telefone": "string 13",
  "Ativo": true,
  "Divisao": "string 15",
  "FaxFone": "string 16",
  "Cep": "string 17",
  "Aniversario": "2026-01-13",
  "Faturamento": 1.1,
  "CodigoPais": "string 18",
  "Complemento": "string 19",
  "Cnae": "string 20",
  "Contato": "string 21",
  "Conceito": "string 22",
  "Cadastro": "2026-01-13",
  "CodigoRepresentante": "string 23",
  "PercentualComissaoBaixa": 24.1,
  "ContabilCliente": "string 25",
  "Responsavel": "string 26",
  "Indicacao": "string 27",
  "ContabilFornecedor": "string 28",
  "CodigoCondicaoPagamento": "string 29",
  "CodigoTipoPagamento": "string 30",
  "Inscrito": true,
  "IrrfAcumulado": 32.1,
  "TipoEmpresa": "string 33",
  "Atividade": "string 34",
  "Funcionarios": 35,
  "LimiteCredito": 36.1,
  "CodigoMercado": "string 37",
  "EnviarCarta": "string 38",
  "CodigoTabelaPreco": "string 39",
  "AgendaInterna": "string 40",
  "Centralizadora": "string 41",
  "AtrasoMedio": 42,
  "InscricaoMunicipal": "string 43",
  "Suframa": "string 44",
  "TipoFrete": "string 45",
  "PercentualIndenizacao": 46.1,
  "PercentualDescontoSugestaoItens": 47.1,
  "PercentualDesconto2": 48.1,
  "JurosPadrao": 49.1,
  "UnidadeNegocio": "string 50",
  "PortadorPadrao": "string 51",
  "ContabilAdiantamentoCliente": "string 52",
  "ContabilAdiantamentoFornecedor": "string 53",
  "CentroArmazenagem": "string 54",
  "IndiceCredito": "string 55",
  "RegiaoEntrega": "string 56",
  "RegimeTributario": "string 57",
  "Setor": "string 58",
  "PrefixoCnae": "string 59",
  "BasePrazoDiferenciado": "string 60",
  "PossuiRetencaoIss": "string 61",
  "CentroArmazenagemMaterialAlternativo": "string 62",
  "FiltroDataDirf": "string 63",
  "TipoImovel": "string 64",
  "ListarIss": "string 65",
  "DiaVencimento": "string 66",
  "LimiteFaturado": "string 67",
  "GrauRelacionamento": "string 68",
  "SufixoCnae": "string 69",
  "ToleranciaVencimento": "string 70",
  "NivelCredito": "string 71",
  "ListarDirf": true,
  "Conveniada": true,
  "CreditoLiberado": true,
  "PercentualFrete": 75.1,
  "CodigoEan": 76.1,
  "PercentualAcrescimoLimite": 77.1,
  "PercentualAcrescimoPreco": 78.1,
  "UtilizaPrazoDiferenciado": 79.1,
  "TgPadraoNfs": 80.1,
  "LimiteCreditoMensal": 81.1,
  "OptantePeloSimples": 82.1,
  "Usrempr1": "string 83",
  "Usrempr2": "string 84",
  "CnaeServico": "string 85",
  "ValorFrete": 86.1,
  "TipoOperacao": "string 87",
  "Email": "string 88",
  "OpcoesAuxiliares": "string 89",
  "NotificacaoBloquetoEmail": "string 90",
  "RecebeEmailCartaCobranca": "string 91",
  "CodigoIbge": "string 92",
  "ValidarIbgeInformado": true,
  "UsaMaiusculaMunicipio": true,
  "PermiteCriarComErro": true,
  "PermiteSobrescreverComBranco": true,
  "Latitude": 97.1,
  "Longitude": 98.1,
  "Nif": "string 99",
  "IdentificacaoSCP": "string 100",
  "ContabilClienteLongoPrazo": "string 101",
  "BoletoRetencao": "string 102",
  "IndicativoNif": "string 103",
  "FormaTributacao": "string 104",
  "SobreFontePagadora": "string 105",
  "CpfProdutorRural": "string 106",
  "OrgaoPublico": true,
  "TipoAssinanteNfcom": 108,
  "MunicipioPrestacao": "string 109"
}

Informações de Retorno:

Cabeçalhos Adicionais:

Nome Descrição Valor
cigam-api-version Versão do build/compilação dessa versão da API 2.1.8565.21067

Modelo:

HttpCustomResponse

NomeDescriçãoTipoInformação Adicional
success

boolean

Opcional
hash

string

Opcional
messages

string

Opcional
data

Object

Opcional
tipoLogin

string

Opcional

Formato de Resposta:

Objeto JSON com a informação true se o CNPJ/CPF é válido.

Código de status HTTP Descrição Modelo de resposta
200 OK

application/json, text/json

Exemplo: 
{
  "success": true,
  "hash": "string 2",
  "messages": [
    "string 1"
  ],
  "data": {},
  "tipoLogin": "string 4"
}
400 Requisição inválida

application/json, text/json

Exemplo:
{ 
                    "success": false,
                    "hash": "string 2",
                    "messages": [
                     "string 1"
                    ],
                     "data": {},
                     "tipoLogin": "string 4"
}
401 Não autorizado

application/json, text/json

Exemplo:
{ 
                    "success": false,
                    "hash": "string 2",
                    "messages": [
                     "string 1"
                    ],
                     "data": {},
                     "tipoLogin": "string 4"
}
500 Requisição falhou

application/json, text/json

Exemplo:
{ 
                    "success": false,
                    "hash": "string 2",
                    "messages": [
                     "string 1"
                    ],
                     "data": {},
                     "tipoLogin": "string 4"
}
502 Falha de comunicação

application/json, text/json

Exemplo:
{ 
                    "success": false,
                    "hash": "string 2",
                    "messages": [
                     "string 1"
                    ],
                     "data": {},
                     "tipoLogin": "string 4"
}