Developers


📄 Consulta de Empresa por CNPJ (SOAP)

🔎 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

NomeValor
Content-Typetext/xml; charset=utf-8
SOAPActionhttp://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

CampoTipoObrigatórioDescrição
cnpjstringSimCNPJ 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

CampoDescrição
cnpjNúmero do CNPJ
razaoSocialNome empresarial
nomeFantasiaNome fantasia
situacaoSituação cadastral
dataAberturaData de abertura
enderecoObjeto com dados de localização


⚠️ Possíveis Erros

Código / MensagemCausa
ORA-12154Problema de conexão com banco Oracle (TNS não resolvido)
XML mal formatadoErro de sintaxe no SOAP ou CDATA
CNPJ inválidoFormato incorreto ou inexistente


🧪 Exemplo no Postman

  1. Método: POST
  2. URL: https://<URL_DO_SERVICO>/wsces
  3. Aba Headers:
    • Content-Type: text/xml
    • SOAPAction: http://www.cessistemas.com.br/wsces/ConsultarEmpresaPorCNPJ
  4. 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)
Autor: Felipe Haberl  |  Última edição: