Changelog
Back to All
added

Inclusão do saldo do conta corrente na API do Alíquotas

8 days ago by Angela Santos

Adicionado o campo ContaCorrente no corpo da requisição da API de alíquotas. Esse campo informa o valor de saldo em conta corrente utilizado no carrinho, permitindo aos integradores identificar quando houve desconto aplicado via saldo.

🧾 Como era antes?

Antes da atualização, a API de alíquotas não informava se um carrinho havia recebido desconto via saldo de conta corrente. Ou seja:

  • Não existia o campo ContaCorrente no corpo da requisição da API;
  • Os parceiros não tinham visibilidade sobre o uso desse tipo de desconto;
  • Isso dificultava ações automatizadas, como regras de cashback, auditoria de pedidos ou análises personalizadas sobre o comportamento de compra.

✅ O que mudou?

Parceiros passam a ter visibilidade sobre a utilização de saldo de conta corrente em compras, o que possibilita o desenvolvimento de novas funcionalidades, como validação de cashback, entre outras.

🧪 Exemplo de payload com saldo do conta corrente

{
   "Id":null,
   "Fechado":false,
   "Cep":0,
   "Produtos":[
      {
         "PrecoDe":0.0,
         "PrecoPor":10.00,
         "ProdutoVarianteId":1,
         "Quantidade":0,
         "CentroDistribuicaoId":0,
         "Sku":null
      }
   ],
   "ValorFrete":0.0,
   "ValorTotal":0.0,
   "ContaCorrente":10.00,
   "FreteEscolhido":{
      "Valor":0.0,
      "Ajuste":0.0,
      "Prazo":0,
      "ValorCotacaoTodos":0.0
   },
   "Cotacoes":[
      {
         "CotacaoFreteId":null,
         "Nome":null,
         "Produtos":[
            {
               "ProdutoVarianteId":0,
               "Nome":null,
               "CentroDistribuicaoId":0,
               "IsReseller":false,
               "Ajustavel":false,
               "ValorAjuste":0.0,
               "Valor":0.0,
               "Prazo":0,
               "TabelaFreteId":0
            }
         ],
         "TabelaFreteId":0,
         "Prazo":0,
         "Valor":0.0,
         "Ajuste":0.0,
         "ValorCotacaoTodos":0.0
      }
   ],
   "Usuario":{
      "Cpf":null,
      "Email":null,
      "Id":0,
      "Nome":null,
      "Enderecos":[
         {
            "Bairro":null,
            "Cep":0,
            "Cidade":null,
            "Complemento":null,
            "Estado":null,
            "Numero":null,
            "Logradouro":null,
            "Id":0
         }
      ],
      "PessoaJuridica":false,
      "InscricaoEstadual":false
   },
   "EnderecoEntrega":{
      "Bairro":null,
      "Cep":0,
      "Cidade":null,
      "Complemento":null,
      "Estado":null,
      "Numero":null,
      "Logradouro":null,
      "Id":0
   }
}

📘

Nota técnica

Nenhuma alteração é necessária por parte dos integradores, exceto se desejarem consumir o novo campo.

📚 Documentação

Confira como utilizar essa funcionalidade na documentação oficial da API de alíquotas.