Developers

Consultar condições por descrição

O método ConsultarCondicoesPorDescricao realiza a consulta das condições de pagamento cadastradas no C&S Gestor conforme as iniciais da descrição informadas.

⚙️ Importante: A requisição é do tipo POST, mesmo sendo uma consulta. A tag tipos é opcional. A sequência de escape ' corresponde a aspas simples. Não inclua essa sequência no início ou fim da lista de tipos de pagamento.

📡 Endpoint

POST /wsces/ConsultarCondicoesPorDescricao

📥 Exemplo de XML de Requisição

<?xml version="1.0" encoding="UTF-8"?>
<ConsultaCondicoesDescricaoReq xmlns="http://www.cessistemas.com.br/wsces">
  <descricao>CART</descricao>
  <empresaId>10.654.646/0001-46</empresaId>
  <tipos>BO','CH','CC</tipos>
</ConsultaCondicoesDescricaoReq>

📋 Parâmetros

📤 Exemplo de XML de Resposta

<?xml version="1.0" encoding="UTF-8"?>
<ConsultaCondicoesDescricaoResp xmlns="http://www.cessistemas.com.br/wsces">
  <condicoes>
    <condicao>
      <condicaoId>1</condicaoId>
      <descricao>CARTÃO BOLETO</descricao>
      <parcelas>3</parcelas>
    </condicao>
    <condicao>
      <condicaoId>2</condicaoId>
      <descricao>CARTÃO CH</descricao>
      <parcelas>2</parcelas>
    </condicao>
  </condicoes>
</ConsultaCondicoesDescricaoResp>

🧠 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.
• A tag tipos é opcional; se usada, liste os tipos sem aspas no início ou no fim.
• O serviço retorna todas as condições de pagamento que correspondem à descrição e filtros aplicados.

💻 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""?>
<ConsultaCondicoesDescricaoReq xmlns=""http://www.cessistemas.com.br/wsces"">
  <descricao>CART</descricao>
  <empresaId>10.654.646/0001-46</empresaId>
  <tipos>BO','CH','CC</tipos>
</ConsultaCondicoesDescricaoReq>";

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

        Console.WriteLine(result);
    }
}