#
Comunicado
Publicado 30/07/2021
Olá!
Neste último ano acompanhamos e analisamos de perto todas as críticas e sugestões feitas por vocês via canais de atendimento.
Identificamos que muitas delas abordam tópicos que não conseguíamos atacar de maneira granular devido à forma como a atual plataforma está estruturada.
Ao mesmo tempo, houve um crescimento significante na quantidade de usuários diariamente ativos, o que nos motiva a adotar padrões de estabilidade e segurança mais elevados.
Com estas duas considerações em mente, redesenhamos internamente nossa plataforma por completo, e iremos entregar a nova versão de forma transparente e com o mínimo de impacto possível.
Em 27 de agosto de 2021 às 18h faremos a implementação das mudanças presentes neste comunicado.
Em caso de dúvidas estamos a disposição para esclarecimentos!
E-mail: contato@cnpja.com
WhatsApp: (11) 97156-4144
#
1. Plataforma
#
1.1. Documentação
A documentação foi completamente rescrita e agora restringe as informações que requerem conhecimentos técnicos apenas a seção "API".
O novo endereço é aqui mesmo! Você pode navegar através do menu ao lado esquerdo.
#
1.2. Notificações Centralizadas
Todas as notificações financeiras (boletos e NFs) passam a ser enviadas pelo no-reply@cnpja.com.
Você não receberá mais e-mails dos domínios contabilizei.com.br e iugu.com.
Será possível alterar seu e-mail e outros dados financeiros pela página de conta no site principal.
#
1.3. 🎉 Boleto em Todos Planos
O fornecedor IUGU será removido e os boletos passam a ser emitidos diretamente em nome de CNPJA TECNOLOGIA LTDA sem intermédios.
A restrição de R$ 90 foi removida e todos os planos passam a aceitar pagamento via boleto!
#
2. Planos e Créditos
Todas as mudanças descritas nos tópicos a seguir estão documentadas na nova página de precificação:
#
2.1. 🎉 Cache Gratuito
As consultas realizadas em cache que previamente custavam 0,1 ₪ passam a custar zero.
Para controlar o limite que o usuário pode realizar, estamos introduzindo uma restrição de consultas por minuto onde a taxa é determinada pelo plano contratado.
Por exemplo, no plano gratuito que oferece 30 créditos por dia:
- Atual: (30 ₪/dia) / (0,1 ₪/consulta) = 300 consultas/dia
- Novo: (6 consultas/minuto) * (1440 minutos/dia) = 8.640 consultas/dia
A quantidade máxima de consultas em cache por dia, por plano, será:
*quantidade por dia se usufruído ao máximo cada minuto
#
2.2. Novos Planos
Os planos passam a ser BASIC, PRO e PREMIUM, não utilizaremos mais a denominação ESSENTIAL.
Entretanto, cada plano terá variantes com diferentes quantidades de créditos diários:
#
2.3. Adaptação de Assinantes
Todos os assinantes que contrataram após julho de 2020 serão beneficiados com aumento de créditos.
Os planos serão migrados conforme:
#
2.4. ⚠️ Adaptação de Legado
Denominamos legado as assinaturas realizadas antes de julho de 2020.
Estes planos possuem uma cobrança em créditos diferente dos atuais, por exemplo, a consulta Simples custa 45 créditos ao invés de 9. Em contrapartida, a quantidade de créditos diária é superior.
Essa diferenciação é um impeditivo para a funcionalidade mais solicitada em nossa plataforma: o suporte a créditos avulsos ou reserva em caso de exceder a cota em um dia.
Todos os assinantes legado serão migrados conforme:
#
2.5. ⚠️ Custo das Consultas
Os custos em créditos das consultas serão reajustados conforme tabele passam a ser homogêneos entre todos os assinantes:
#
3. Excel
#
3.1. 🎉 Add-In
Estamos desenvolvendo um add-in para Excel que funcionará como substituto a atual ferramenta baseada em Power Query.
Nesta primeira versão o mesmo será baseada em VBA e instalável em Office 2016+ ou 365.
Futuramente, se aplicável, o mesmo será aprimorado e disponibilizado gratuitamente na loja da Microsoft.
#
3.2. ⚠️ Power Query
A atual ferramenta baseada em Power Query permanece funcional, entretanto não faremos mais atualizações.
Os seguintes pontos influenciaram nesta decisão:
- Falta de controle sobre como o Power Query orquestra as consultas: não é possível controlar cadência, tentativas, e tratativas de exceções.
- Frequentes erros de privacidade: grande parte dos usuários encontram, ou já encontraram, a mensagem de erro "não foi possível conectar-se a base de dados". Este problema está relacionado a configurações de privacidade entre a planilha e API e não conseguimos suportar remotamente.
#
4. API
#
4.1. Postman
Uma nova coleção do Postman está disponível incluindo todas as rotas e consultas da API:
#
4.2. ⚠️ Limites de Utilização
O limite de requisições deixa de ser de 25 requisições concorrentes e passa a ser X por minuto, onde X é definido pelo plano atual (ver itens 2.1 e 2.2).
Esta alteração tem o objetivo de endereçar abuso de chutes que resultam em bad request ou not found, bem como aumentar a performance no cálculo de créditos remanescentes.
#
4.3. Autenticação JWT
Além de chave de API, o serviço passa a suportar também autenticação via JWT emitido com seu usuário e senha.
Confira os detalhes na página de Autenticação:
#
4.4. 🛑 Links Públicos
A rota /files/:token
para visualização pública de arquivos será descontinuada.
A implementação atual não é assinada, o que não condiz com nossas novas políticas de segurança.
Para gerar arquivos que podem ser visualizados publicamente o usuário deverá utilizar Assinatura de URLs:
#
4.5. 🛑 Consulta de Créditos
A rota /me
deixa de exibir a quantidade de créditos restantes.
Esta funcionalidade agora é acessível através da consulta de Créditos Restantes:
#
4.6. Estratégias de Cache
A API passa a suportar múltiplas estratégias de cache para otimizar seu consumo de créditos e tempo de resposta da maneira que melhor atenda sua aplicação:
- Sempre online
- Cache se recente
- Cache se erro
- Sempre cache
Confira os detalhes em Estratégias de Cache:
#
4.7. ⚠️ Consulta CNPJ
A rota /companies/:taxId
passa a apontar para a nova /office/:taxId
e não é recomendada para novos desenvolvimentos.
Não há mudança no JSON, entretanto atente-se aos detalhes mencionados na página de depreciação:
Caso tenha interesse em migrar para o novo formato, confira os detalhes em Estabelecimentos:
#
4.8. Dados Empresariais
Passamos a disponibilizar consulta direta a modelagem de empresas, estabelecimentos e pessoas através das rotas /company/:id
, /office/:taxId
e /person/:id
.
Confira os detalhes em Empresas, Estabelecimentos e Pessoas:
#
4.9. Portais Públicos
As consultas a portais públicos agora são disponibilizadas individualmente através das rotas /rfb
, /simples
e /ccc
.
Confira os detalhes em Receita Federal, Simples Nacional e Cadastro de Contribuintes:
#
4.10. 🎉 Busca CEP
Adicionamos a rota /zip/:code
para buscar CEPs brasileiros.
Confira os detalhes em Busca CEP:
#
4.11. Melhorias no Simples
A consulta ao Simples Nacional possui novas funcionalidades:
- Emissão do comprovante de consulta
- Dados de períodos anteriores
Confira os detalhes em Simples Nacional:
#
4.12. Melhorias nos Mapas
A geração de mapas dos arredores e visão da rua passa a suportar customizações como tamanho, zoom e campo de visão.