As rotas da API V2 do Escavador destinadas à listagem de processos, especificamente para Pessoas (envolvidos/processos) e Advogados (advogados/processos), possuem uma estrutura de tarifação desenhada para oferecer o melhor custo-benefício.
Elas diferenciam o acesso inicial da navegação de grandes volumes de dados retornados, bem como separam a chamada inicial das demais chamadas subsequentes idênticas no mesmo dia.
Abaixo, detalhamos como funciona a dinâmica de custos para esses recursos.
1. Estrutura de Cobrança por Volume de Itens
A cobrança da rota é segmentada com base na quantidade de informações de processos acessadas pelo cliente:
Até 200 itens: O valor base da consulta cobre o acesso dos primeiros 200 processos encontrados;
Itens Adicionais: Para pesquisas que excedam este volume retornado, é cobrado um valor complementar, fixo e reduzido, para cada bloco adicional de 200 itens acessados.
Assim, supondo um valor de consulta em R$4,50 para a primeira chamada (até 200 itens acessados) e de R$0,05 para cada bloco adicional (de 200 itens cada), consultas que gerem acesso para um cenário exemplo de 430 processos de uma pessoa serão cobradas da seguinte forma:
Retorno e acesso dos primeiros 200 itens: débito de R$4,50;
Retorno e acesso dos 200 itens subsequentes: débito de R$0,05;
Retorno e acesso dos 30 itens finais: débito de R$0,05;
Desta forma, e após acessar todos os itens em questão, a consulta completa ficaria no valor total de R$4,60.
Ainda é importante destacar o fato de que o relatório de consumo da API (acessível em Painel API - consumo) irá indicar separadamente cada uma das cobranças, facilitando o controle e transparência.
2. Chamadas idênticas realizadas dentro do período de 24 horas
Além da cobrança por volume de itens acima, existe uma segunda estrutura de tarifação voltada ao custo-benefício nas rotas em questão: a cobrança reduzida em caso de repetição de chamada idêntica para a rota, dentro do período de 24 horas.
Este também é um benefício interessante das rotas mencionadas, possibilitando ao usuário da API acessar os mesmos dados já consultados anteriormente no mesmo dia, a um custo reduzido. Ele segue uma lógica bem parecida com a cobrança por volume de itens explicada anteriormente.
Utilizando os mesmos valores de serviço acima - R$4,50 na consulta inicial e R$0,05 na consulta reduzida - e supondo que seja realizada consulta por um nome de pessoa ("Antonio Jose Luis") na rota GET api/v2/envolvido/processos; e depois seja realizada idêntica consulta, na mesma rota, com o mesmo parâmetro de nome, e dentro de 24 horas, o valor total para as duas consultas seria de R$4,55, divididos da seguinte forma:
- Retorno e acesso na primeira consulta, para os primeiros 200 itens: débito de R$4,50;
- Retorno e acesso aos mesmos 200 itens, agora em consulta repetida no mesmo dia: débito de R$0,05;
Quer dizer, ao invés de ser cobrado o valor inicial da chamada, a API Escavador entende que já houve o acesso anterior para aquelas informações naquele dia, e reduz a cobrança da chamada repetida de forma a possibilitar novo acesso a um custo-benefício melhor para o cliente.
Sobre esse tema, ainda é importante pontuar que a redução é válida apenas para chamadas idênticas - leia-se, com o mesmo parâmetro de pesquisa - em rota para o mesmo dia.
Ou seja, caso pesquisado primeiramente o nome de uma pessoa, mas depois seja realizada a consulta pelo documento (CPF/CNPJ) desta mesma pessoa, a API do Escavador entende como duas pesquisas diferentes no mesmo dia, já que o parâmetro buscado em nossa base foi diferente. Em resumo, dentro dos custos avaliados, as duas consultas representariam o débito de R$9,00 (ou duas vezes a consulta inicial de R$4,50).
3. Utilizando a paginação da rota
Ao realizar uma busca, a API utiliza um sistema de paginação para organizar os resultados. É fundamental entender que o custo maior, conforme visto, ocorre na primeira chamada (solicitação inicial do dia), enquanto as chamadas seguintes, seja para navegar nos mesmos resultados ou seja repetir a mesma chamada já realizada no dia, possuem custo reduzido ou inexistente, dependendo do volume total já pago e acessado.
Chamada Inicial: É o gatilho da pesquisa que processa o termo (nome, CPF/CNPJ ou OAB) e gera a listagem de processos associados.
Navegação (Paginação): Ao acessar as páginas seguintes através do parâmetro de cursor ou links de paginação, você está apenas recuperando itens que já foram contabilizados na lógica de blocos mencionada acima.
Ainda interessante mencionar que, por padrão (default), as rotas em questão retornam 20 resultados por página, mas é possível utilizar um parâmetro opcional nas rotas (limit) aumentando para 50 ou 100 resultados na página.
4. Rotas Envolvidas
Essa lógica se aplica aos seguintes endpoints da API V2:
Envolvido/Processos (
GET api/v2/envolvido/processos): Lista processos vinculados a uma pessoa ou empresa, através do Nome ou CPF/CNPJ.Advogado/Processos (
GET api/v2/advogado/processos): Lista todos os processos em que um determinado registro de OAB (Número e UF) está vinculado.
Para mais informações, indicamos ainda a leitura da nossa documentação oficial em:
Comentários
0 comentário
Artigo fechado para comentários.