Developers


Consultar condicao por ID

O método ConsultarCondicaoPorId realiza a consulta de uma condição de pagamento cadastrada no C&S Gestor, com base no ID informado.

⚙️ Importante: A requisição é do tipo POST, mesmo sendo uma operação de consulta.

📡 Endpoint

POST /wsces/ConsultarCondicaoPorId

📥 Exemplo de XML de Requisição

<?xml version="1.0" encoding="UTF-8"?>
<ConsultaCondicaoIdReq xmlns="http://www.cessistemas.com.br/wsces">
  <condicaoId>1</condicaoId>
</ConsultaCondicaoIdReq>

📋 Parâmetros

Campo Tipo Obrigatório Descrição
condicaoId int Identificador único da condição de pagamento.

📤 Exemplo de XML de Resposta

<?xml version="1.0" encoding="UTF-8"?>
<ConsultaCondicaoIdResp xmlns="http://www.cessistemas.com.br/wsces">
  <condicaoId>1</condicaoId>
  <descricao>30/60/90 dias</descricao>
  <parcelas>3</parcelas>
</ConsultaCondicaoIdResp>

🧠 Observações Técnicas

  • Mesmo sendo uma consulta, o método utiliza o verbo POST.
  • O XML deve seguir o namespace http://www.cessistemas.com.br/wsces.
  • O campo condicaoId deve referenciar uma condição de pagamento existente no C&S Gestor.
  • Em caso de erro, o serviço retorna uma resposta XML com detalhes da falha.

💻 Exemplo de Consumo (C#)

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var xml = @"<?xml version=""1.0"" encoding=""UTF-8""?>
<ConsultaCondicaoIdReq xmlns=""http://www.cessistemas.com.br/wsces"">
  <condicaoId>1</condicaoId>
</ConsultaCondicaoIdReq>";

        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/ConsultarCondicaoPorId", content);
        var result = await response.Content.ReadAsStringAsync();

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