# 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:

Planos e Preços
/platform/pricing/


# 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á:

Plano Consultas Atual Novo*
FREE 6 / min 300 / dia 8.640 / dia
BASIC 20 / min 3.500 / dia 28.800 / dia
PRO 60 / min 50.000 / dia 86.400 / dia
PREMIUM 180 / min 250.000 / dia 259.200 / dia

*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:

Plano Consultas Créditos (por dia) Preço (por mês)
FREE 6 / min 30 ₪ R$ 0,00
BASIC 20 / min 500 ₪ R$ 19,99
BASIC 20 / min 1.000 ₪ R$ 29,99
PRO 60 / min 2.000 ₪ R$ 49,99
PRO 60 / min 5.000 ₪ R$ 99,99
PRO 60 / min 10.000 ₪ R$ 179,99
PREMIUM 180 / min 20.000 ₪ R$ 299,99
PREMIUM 180 / min 50.000 ₪ R$ 619,99
PREMIUM 180 / min 100.000 ₪ R$ 1249,99

# 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:

Plano Atual Plano Novo Diferença
BASIC BASIC (500) +150 ₪ / dia
ESSENTIAL PRO (2K) +400 ₪ / dia
PRO PRO (5K) -
PREMIUM PREMIUM (27.5K) +2.500 ₪ / dia
40K PREMIUM (50K) +10.000 ₪ / dia, -R$ 20,00 / mês

# 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:

Plano Legado Plano Novo Diferença
BUDGET BASIC (200) -800 ₪ / dia, +R$ 0,99 / mês
COVID BASIC (500) -2000 ₪ / dia, +R$ 0,99 / mês
BASIC BASIC (1K) -4000 ₪ / dia, +R$ 0,99 / mês
PRO PRO (5K) -15.000 ₪ / dia, +R$ 0,99 / mês

# 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:

Consulta Custo Atual Custo Novo
Cache 0,1 ₪ 0 ₪
Receita Federal 1 ₪ 1 ₪
Receita Federal (Comprovante) 1 ₪ 1 ₪
Simples Nacional 9 ₪ 10 ₪
Simples Nacional (Histórico) - 45 ₪
Simples Nacional (Comprovante) - 45 ₪
⚠️ Cadastro de Contribuintes (IEs) 1 ₪ (Todas UFs) 0,2 ₪ (Por UF)
⚠️ Mapa dos Arredores 5 ₪ 30 ₪
⚠️ Visão da Rua 15 ₪ 100 ₪

# 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:

Postman
/api/postman/


# 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:

Autenticação
/api/core/auth/


# 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:

Assinatura de URLs
/api/util/signature/


# 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:

Créditos Restantes
/api/util/credit/


# 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:

Estratégias de Cache
/api/core/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:

Depreciações
/api/reference/deprecation/#consulta-cnpj

Caso tenha interesse em migrar para o novo formato, confira os detalhes em Estabelecimentos:

Estabelecimentos
/api/data/office/


# 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:

Estabelecimentos
/api/data/office/

Empresas
/api/data/company/

Pessoas
/api/data/person/


# 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:

Receita Federal
/api/portal/rfb/

Simples Nacional
/api/portal/simples/

Cadastro de Contribuintes
/api/portal/ccc/


# 4.10. 🎉 Busca CEP

Adicionamos a rota /zip/:code para buscar CEPs brasileiros.

Confira os detalhes em Busca CEP:

Código Postal
/api/util/zip/


# 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:

Simples Nacional
/api/portal/simples/


# 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.