Pular para o conteúdo
#desenvolvimento-de-software
#fundadores
#produto
Empreendedorismo

NFS-e padrão nacional, IBS e CBS: ajuste de campo no seu sistema ou projeto?

A NFS-e padrão nacional é ajuste de campo quando a nota já nasce no seu sistema, e projeto quando o dado do serviço não existe. A régua e as três perguntas antes do orçamento.

Por Victhor Araújo

Fundador da Revin. Engenheiro de formação, especialista em desenvolvimento de software e produtos digitais.

A nota de serviço parece simples até alguém contar quantos campos o sistema não sabe preencher

A nota de serviço parece simples até alguém contar quantos campos o sistema não sabe preencher

É ajuste de campo quando a nota já nasce dentro do seu sistema. O cliente vem do cadastro, o serviço vem do contrato, o tributo vem de uma regra que alguém escreveu uma vez, e o que muda é o endereço para onde a mensagem vai, o formato dela e a assinatura. É projeto quando a nota sai por fora: alguém digitando no emissor da prefeitura, alguém colando dados numa planilha, alguém escolhendo o código do serviço de cabeça. No segundo caso o trabalho não é o layout novo. É construir um dado que nunca existiu no seu sistema.

A diferença entre as duas contas é de ordem de grandeza. Trocar canal de transmissão e formato de mensagem num sistema que já emite nota fica em algo como dez a quinze dias de trabalho de uma pessoa que conhece a base, e você consegue estimar isso multiplicando pelo valor da hora de um desenvolvedor sênior no Brasil hoje. Fazer a nota passar a nascer dentro do sistema, com cadastro de serviço, código de tributação, regra de retenção e município de incidência, passa de dois meses com mais de uma pessoa, e no meio disso cabe homologação, teste com nota real e uma reunião com o seu contador. O resto deste texto é a régua para você descobrir em qual das duas está antes de pedir preço.

Trocar tomada e puxar fiação nova custam diferente, e a proposta não distingue

Toda nota digitada por fora é uma nota que o seu sistema não sabe que existe

Toda nota digitada por fora é uma nota que o seu sistema não sabe que existe

Quem te manda o orçamento olhou a obrigação, não o seu sistema. A obrigação é pública e bem documentada: existe um layout de declaração de prestação de serviço, existe o ambiente nacional para transmitir, existe certificado digital, existe o PDF da nota no fim. Dá para ler tudo isso num sábado. É por isso que a frase "é só integrar" sai tão fácil da boca de quem vai cobrar por ela.

O que ninguém olhou é se o seu sistema tem o que preencher. Eu já estive do outro lado dessa mesa. Na primeira empresa que eu montei, contratei desenvolvedores sem conseguir julgar o que eles me diziam. Ouvia que era rápido, aceitava a data, e na sexta a entrega não estava lá. Não faltava competência deles nem boa vontade minha. Faltava eu saber qual pergunta separa um ajuste de uma obra.

A pergunta é essa: o dado existe? Layout se lê em um fim de semana. Dado se constrói em semanas, e às vezes em meses, porque ele depende de decisão humana que a sua empresa nunca formalizou.

Quando o emissor de fora resolve a obrigação, ele também cria a planilha paralela

Um desenvolvedor publicou no TabNews um emissor gratuito que roda no Windows e fala direto com o ambiente nacional. O motivo que ele deu caberia em qualquer reunião de diretoria: sem sistema próprio, você redigita cliente, serviço e tributo em cada nota. O post juntou dez comentários, e a conversa toda girou em volta de gente que faz exatamente isso hoje.

Funciona. E é a escolha certa para quem emite dez notas por mês. O problema aparece quando a sua empresa emite trezentas e o faturamento mora no seu sistema. Toda nota digitada por fora é uma nota que o seu sistema não sabe que existe. Você perde a conciliação entre o que foi contratado, o que foi faturado e o que foi pago. Perde o relatório. Ganha uma pessoa cuja função virou copiar campo de um lugar para o outro, e é dela que sai o erro que o seu contador descobre no mês seguinte.

O custo não está na licença do emissor. Está na redigitação.

As três perguntas que mudam o orçamento

Trocar tomada e puxar fiação nova custam diferente, e a proposta chega com o mesmo prazo

Trocar tomada e puxar fiação nova custam diferente, e a proposta chega com o mesmo prazo

Antes de aceitar qualquer prazo, responda estas três olhando as suas notas dos últimos doze meses, não a sua intuição:

  1. De onde sai hoje o código de tributação do serviço que você vende, e quem decide esse código quando entra um serviço novo na tabela? Se a resposta é "o pessoal do financeiro sabe", esse dado não está no sistema, está na cabeça de alguém.
  2. Quantos municípios diferentes aparecem nas suas notas, e em quantos deles o serviço é prestado no endereço do cliente e não no seu? Cada município com regra própria de retenção é uma regra que precisa virar linha de código com data de vigência.
  3. Quando a transmissão falha, quem fica sabendo e em quanto tempo? Se a resposta é "a gente descobre quando o cliente cobra a nota", você vai precisar de fila de reenvio e de alerta, e isso é escopo que ninguém colocou na proposta.

Três respostas ruins não significam projeto impossível. Significam projeto, com prova de conceito antes do contrato fechado.

Comprar a integração é quase sempre a decisão certa, e não tira o projeto da sua mesa

Eu raramente recomendo escrever a comunicação com o ambiente nacional dentro de casa. Existe provedor que faz isso, cobra por nota, mantém o layout atualizado quando a regra muda e absorve a dor de cada versão nova do schema. Comprar essa parte é barato comparado a manter uma equipe acompanhando nota técnica de calendário fiscal.

O que o provedor não faz é o seu lado do balcão. Ele recebe um pacote de dados pronto e devolve a nota autorizada. Quem monta o pacote é o seu sistema, e é aí que o projeto vive: cadastro de serviço com código, regra de retenção por município, vínculo entre contrato e item faturado, tratamento de rejeição. Isso é mexer na sua regra de faturamento, que em geral é a parte mais antiga e mais remendada do sistema.

E isso também não é motivo para reescrever nada. Eu quase nunca aprovo reescrever um sistema do zero, e uma obrigação fiscal com data é o pior gatilho possível para começar uma reescrita. Você entra num projeto de dezoito meses para resolver um prazo de seis.

Transmitiu com sucesso não quer dizer nota autorizada

O jeito mais barato de parecer pronto é mandar a mensagem, receber um retorno qualquer e escrever "enviado" na tela. Eu tenho um exemplo favorito desse teatro, de outro contexto: vender monitoramento entregando um endereço que responde 200 e um painel bonito sem dado nenhum atrás. Por fora, completo. Sob o capô, nada.

Na nota de serviço o teatro cobra rápido, porque existe um terceiro conferindo. O mínimo que o seu sistema precisa ter: validação da declaração contra o schema oficial antes de transmitir, com a mensagem de erro em português para quem está no balcão, não o código cru. Guarda do XML autorizado, que é o documento, e não o PDF, que é só a representação. Fila para quando a internet cai ou o ambiente está fora. E um lugar onde alguém vê as rejeições do dia sem precisar pedir para o time de tecnologia rodar uma consulta.

Se o seu fornecedor não mencionou rejeição, ele orçou o caminho felizardo.

O prazo que morde é a convivência de dois regimes, não a data da prefeitura

Campo novo é fácil. O que quebra a estimativa é que, durante a transição, a mesma operação carrega o imposto antigo e os novos ao mesmo tempo, com percentuais que mudam de ano em ano e com o ISS saindo de cena só no fim do cronograma, lá em 2033. Na prática, o seu sistema precisa calcular tributo por data de competência, manter versão de regra, e recalcular corretamente uma nota de competência passada quando alguém cancela ou substitui em março o que foi emitido em dezembro.

Isso não é campo. É regra de negócio versionada, e é o tipo de coisa que um sistema escrito com cálculo espalhado em vinte lugares não suporta sem antes juntar o cálculo num lugar só. Se você não sabe onde o imposto é calculado no seu sistema hoje, essa é a primeira tarefa, e ela tem prazo próprio. É o mesmo trabalho de entrar num sistema sem documentação e mapear o que ele faz de verdade, só que com data marcada no calendário fiscal.

"Mas o meu sistema é velho, dá para mexer nele?"

Dá, e na maioria dos casos é mais rápido do que o seu time estima. Legado não é questão de idade, é questão de quanta gente ainda consegue explicar como aquela parte funciona. Um sistema de 2014 com cálculo centralizado e teste em volta recebe tributo novo sem drama. Um sistema de 2021 com regra fiscal copiada em cinco telas é pior.

O que pesa de verdade é a versão da linguagem e das bibliotecas, porque assinatura digital e comunicação segura dependem disso. Já vi esse ser o custo escondido inteiro de uma integração fiscal, e é a mesma discussão de subir uma versão antiga de PHP ou refazer. Descubra isso na primeira semana, não na véspera da homologação.

O que fazer na segunda-feira

Exporte as notas dos últimos doze meses e tire três números: quantos municípios distintos aparecem, quantos códigos de serviço diferentes você usou, e quantas dessas notas alguém digitou fora do sistema. Leve esses três números para a reunião de orçamento antes de ouvir qualquer prazo.

Com eles na mesa, você para de comprar promessa e passa a comprar escopo. E se o fornecedor não pedir esses números antes de dar a data, você já sabe o que a data vale.

Pronto para elevar o seu negócio?

Agendar uma reunião
Compartilhe
Link de compartilhamento LinkedinLink de compartilhamento XLink de compartilhamento WhatsappLink de compartilhamento Facebook

Newsletter

A cada quinze dias. As decisões técnicas que tomamos, e o que aprendemos.