Cadastro de alíquota usando API

A fórmula da alíquota poderá ser criada utilizando sua API, para isso, você precisará configurá-la para que ela retorne os ajustes necessários e também respeite o modelo de retorno.

No cadastro de alíquotas na plataforma, será necessário ativar a opção Usar API, definir o Tipo de Cálculo e o Tipo de ajuste será definido automaticamente, sendo por item.

Abaixo em Dados da API, será necessário informar a URL da sua API no campo Endpoint. Caso haja necessidade de adicionar alguma informação de autenticação, por exemplo, insira nos campos chave e valor, clicando no botão Adicionar Header.

A sua API criada deve respeitar os métodos disponíveis no formulário de Dados da API, não sendo aceito quaisquer outros métodos que não sejam inclusos na opção do formulário.

Abaixo os exemplos dos objetos de envio e retorno para sua API:

Objeto JSON que será enviado para sua API:

{
   "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,
   "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
   }
}

Objeto JSON que deverá ser retornado pela sua API:

[
    {
        ProdutoVarianteId: 123,
        Valor: 10,
        Nome: "Nome do ajuste",
        CentroDistribuicaoId: 1
    },
    {
        ProdutoVarianteId: 456,
        Valor: 20,
        Nome: "Nome do ajuste",
        CentroDistribuicaoId: 1
    },
    {
        ProdutoVarianteId: 789,
        Valor: 30,
        Nome: "Nome do ajuste",
        CentroDistribuicaoId: 1
    }
]

🚧
Informamos que a API da Alíquotas possui um tempo de timeout de 2 segundos.