Visão Geral

Developers

ConsultarClientePorId

Consulta um cliente cadastrado no C&S Gestor conforme o ID informado.

⚙️ Importante: A requisição deve ser enviada via POST, utilizando XML no corpo da mensagem.

Endpoint

POST /wsces/ConsultarClientePorId

Corpo da Requisição (XML)

<?xml version="1.0" encoding="UTF-8"?>
<ConsultaClienteIdReq xmlns="http://www.cessistemas.com.br/wsces">
  <clienteId>10.654.646/0001-46</clienteId>
  <complId>1</complId>
</ConsultaClienteIdReq>

Parâmetros

Campo Tipo Obrigatório Descrição
clienteId string ✅ Identificador único do cliente no sistema (pode ser CNPJ ou CPF).
complId int ✅ Código complementar, usado para consultas específicas ou filiais.

Exemplo de Resposta (XML)

<?xml version="1.0" encoding="UTF-8"?>
<ConsultaClienteIdResp xmlns="http://www.cessistemas.com.br/wsces">
  <clienteId>10.654.646/0001-46</clienteId>
  <nome>CIS SISTEMAS E CONSULTORIAS LTDA</nome>
  <fantasia>CIS SISTEMAS</fantasia>
  <endereco>R 18, n° 283 QUADRA52 LOTE 02</endereco>
  <cidade>Goiânia</cidade>
  <uf>GO</uf>
  <ativo>true</ativo>
</ConsultaClienteIdResp>

Campos da resposta

Campo Tipo Descrição
clienteId string Identificador do cliente consultado.
nome string Nome completo ou razão social do cliente.
fantasia string Nome fantasia do cliente (se houver).
endereco string Endereço principal do cliente.
cidade string Cidade cadastrada para o cliente.
uf string Unidade Federativa (UF).
ativo boolean Indica se o cliente está ativo no sistema.

Observações Técnicas

  • A comunicação é feita via POST com conteúdo XML.
  • O namespace utilizado é http://www.cessistemas.com.br/wsces.
  • O serviço pode retornar erro se o clienteId for inválido ou inexistente.

Exemplo de Consumo (C#)

var xml = @"<?xml version=""1.0"" encoding=""UTF-8""?>
<ConsultaClienteIdReq xmlns=""http://www.cessistemas.com.br/wsces"">
  <clienteId>10.654.646/0001-46</clienteId>
  <complId>1</complId>
</ConsultaClienteIdReq>";

using var client = new HttpClient();
var content = new StringContent(xml, Encoding.UTF8, "application/xml");

var response = await client.PostAsync("https://api.cessistemas.com.br/wsces/ConsultarClientePorId", content);
var result = await response.Content.ReadAsStringAsync();

Console.WriteLine(result);
Autor: Felipe Haberl  |  Última edição: Felipe Haberl