Consultar empresa por CNPJ
SOAP
ConsultarEmpresaPorCnpj
Consultar os dados da empresa
🔎 Descrição
Este serviço permite consultar os dados cadastrais de uma empresa a partir do CNPJ informado.
A consulta retorna informações como razão social, nome fantasia, situação cadastral, endereço e outros dados vinculados ao cadastro da empresa.
Esse tipo de consulta é comum em integrações com bases públicas ou sistemas ERP para validação cadastral.
🌐 Endpoint
POST https://<URL_DO_SERVICO>/wsces
⚠️ Substitua
<URL_DO_SERVICO>pelo endpoint correto fornecido pela CES.
📦 Headers
| Nome | Valor |
|---|---|
| Content-Type | text/xml; charset=utf-8 |
| SOAPAction | http://www.cessistemas.com.br/wsces/ConsultarEmpresaPorCNPJ |
📥 Requisição
🔹 Estrutura SOAP
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ConsultarEmpresaPorCNPJ xmlns="http://www.cessistemas.com.br/wsces">
<xml>
<![CDATA[
<ConsultaEmpresaCNPJReq xmlns="http://www.cessistemas.com.br/wsces">
<cnpj>10.654.646/0001-46</cnpj>
</ConsultaEmpresaCNPJReq>
]]>
</xml>
</ConsultarEmpresaPorCNPJ>
</soap:Body>
</soap:Envelope>
📌 Parâmetros
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| cnpj | string | Sim | CNPJ da empresa no formato 00.000.000/0000-00 |
📤 Resposta (Exemplo)
<ConsultarEmpresaPorCNPJResponse xmlns="http://www.cessistemas.com.br/wsces">
<ConsultarEmpresaPorCNPJResult>
<![CDATA[
<ConsultaEmpresaCNPJResp>
<cnpj>10654646000146</cnpj>
<razaoSocial>EMPRESA TESTE LTDA</razaoSocial>
<nomeFantasia>EMPRESA TESTE</nomeFantasia>
<situacao>ATIVA</situacao>
<dataAbertura>2010-05-10</dataAbertura>
<endereco>
<logradouro>Rua Exemplo</logradouro>
<numero>123</numero>
<bairro>Centro</bairro>
<cidade>São Paulo</cidade>
<uf>SP</uf>
<cep>00000000</cep>
</endereco>
</ConsultaEmpresaCNPJResp>
]]>
</ConsultarEmpresaPorCNPJResult>
</ConsultarEmpresaPorCNPJResponse>
📌 Campos de Retorno
| Campo | Descrição |
|---|---|
| cnpj | Número do CNPJ |
| razaoSocial | Nome empresarial |
| nomeFantasia | Nome fantasia |
| situacao | Situação cadastral |
| dataAbertura | Data de abertura |
| endereco | Objeto com dados de localização |
⚠️ Possíveis Erros
| Código / Mensagem | Causa |
|---|---|
| ORA-12154 | Problema de conexão com banco Oracle (TNS não resolvido) |
| XML mal formatado | Erro de sintaxe no SOAP ou CDATA |
| CNPJ inválido | Formato incorreto ou inexistente |
🧪 Exemplo no Postman
- Método: POST
- URL:
https://<URL_DO_SERVICO>/wsces - Aba Headers:
Content-Type: text/xmlSOAPAction: http://www.cessistemas.com.br/wsces/ConsultarEmpresaPorCNPJ
- Aba Body → raw → XML:
- Cole o XML completo da requisição
💡 Observações técnicas
- O XML interno deve estar dentro de
CDATA, senão quebra o SOAP - O namespace precisa bater exatamente
- SOAPAction é obrigatório em muitos servidores (principalmente .NET / Oracle)
- O erro que você pegou (
ORA-12154) não tem relação com o XML — é infraestrutura (TNS / conexão Oracle)
Criado em 04/11/2026 17:24 • por admin@cssistemas.com.br