Developers


Cadastrar Cidade

O método CadastraCidade realiza o cadastro de uma cidade no C&S Gestor. A cidade é identificada pelo código IBGE, nome e UF. Caso a cidade já exista na base, o serviço poderá retornar mensagem de duplicidade.

⚙️ Importante: A requisição é do tipo POST.

📡 Endpoint

POST /wsces/CadastraCidade

📋 Parâmetros

Campo Tipo Obrigatório Descrição
codigoMunicipio string Código IBGE da cidade.
nome string Nome da cidade (recomendado em maiúsculo).
uf string Sigla do estado (ex: SP, GO, RJ).

📥 Exemplo de XML de Requisição

<?xml version="1.0" encoding="UTF-8"?>
<CadastraCidadeReq xmlns="http://www.cessistemas.com.br/wsces">
    <codigoMunicipio>3550308</codigoMunicipio>
    <nome>SAO PAULO</nome>
    <uf>SP</uf>
</CadastraCidadeReq>

📤 Exemplo de Resposta

<CadastraCidadeResp xmlns="http://www.cessistemas.com.br/wsces">
    <sucesso>true</sucesso>
    <mensagem>Cidade gravado com sucesso</mensagem>
</CadastraCidadeResp>

💻 Exemplo de Consumo (C#)

using var client = new HttpClient();

var xml = @"<?xml version=""1.0"" encoding=""UTF-8""?>
<CadastraCidadeReq xmlns=""http://www.cessistemas.com.br/wsces"">
    <codigoMunicipio>3550308</codigoMunicipio>
    <nome>SAO PAULO</nome>
    <uf>SP</uf>
</CadastraCidadeReq>";

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

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

var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
Autor: Felipe Haberl  |  Última edição: Felipe Haberl