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.
POST https://<URL_DO_SERVICO>/wsces
⚠️ Substitua
<URL_DO_SERVICO>pelo endpoint correto fornecido pela CES.
| Nome | Valor |
|---|---|
| Content-Type | text/xml; charset=utf-8 |
| SOAPAction | http://www.cessistemas.com.br/wsces/ConsultarEmpresaPorCNPJ |
<?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>
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| cnpj | string | Sim | CNPJ da empresa no formato 00.000.000/0000-00 |
<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>
| 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 |
| 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 |
https://<URL_DO_SERVICO>/wscesContent-Type: text/xmlSOAPAction: http://www.cessistemas.com.br/wsces/ConsultarEmpresaPorCNPJCDATA, senão quebra o SOAPORA-12154) não tem relação com o XML — é infraestrutura (TNS / conexão Oracle)