FireDAC na Prática: conheça meu livro sobre acesso a dados com Delphi

Imagine receber duas notas do mesmo fornecedor, uma em dezembro de 2026 e outra em janeiro de 2027. Os PDFs podem usar o mesmo leiaute, mas trazer valores diferentes para o Imposto sobre Bens e Serviços (IBS) estadual e municipal. A diferença faz sentido quando se olha para duas datas. A Nota Técnica 2026.010 v1.00 prevê a entrada do novo leiaute em produção em 1º de dezembro de 2026. Já o início de 2027 traz regras tributárias próprias, inclusive para a divisão do IBS. (Projeto Nota Fiscal Eletrônica, 2026, p. 3–4. Brasil, 2025, art. 343–344.)

O Documento Auxiliar da Nota Fiscal Eletrônica (DANFE) é a representação da NF-e que você recebe em papel ou PDF. Neste artigo, o foco é a NF-e modelo 55. Vamos localizar o código do regime tributário, os novos totais e os campos por item, depois conferir três exemplos. O mesmo exercício serve para quem recebe mercadoria e para quem mantém o relatório no ERP.

Você tem as informações necessárias para orientar uma revisão, mas elas estão num parágrafo que mistura objetivo, regras, exceções e resultado esperado. Quem lê precisa reconstruir essa organização mentalmente. Quando o documento cresce, surgem referências vagas, instruções repetidas e dúvidas sobre o que realmente deve ser feito. Trocar a extensão do arquivo não resolve essa dificuldade.

Markdown ajuda a organizar texto sem exigir um editor sofisticado. Ele permite indicar títulos, listas, links e trechos de código usando caracteres comuns. Mas a qualidade do arquivo depende também de decisões de escrita: explicar o contexto, separar responsabilidades e oferecer critérios que permitam conferir o trabalho. Formatação e entendimento precisam caminhar juntos.

Neste segundo capítulo da série sobre instruções para IA, vamos aprender a sintaxe essencial e aplicá-la ao exemplo fictício de revisão de uma importação Delphi. O objetivo não é decorar todos os recursos do formato, mas construir um documento que uma pessoa consiga revisar e uma ferramenta consiga apresentar de forma previsível. Também veremos os limites desse cuidado.

Para aprofundar a passagem de uma solicitação vaga para requisitos, contratos e critérios de aceite, conheça SDD em Delphi. O sumário e a degustação gratuita ajudam a avaliar esse método antes de escolher a edição. A conexão com este capítulo é direta: um arquivo bem apresentado só ganha valor técnico quando registra um entendimento verificável.

Metade do preço para adiantar a próxima entrega do seu sistema. De 11 a 20 de novembro de 2026, o cupom BLACKNOVEMBRO dá 50% de desconto nos produtos participantes da Loja do Régys. Escolha os fontes que resolvem a próxima tarefa da sua equipe e comece pela adaptação ao seu ERP, em vez de escrever cada rotina do zero.

Abrir a Loja do Régys com o cupom BLACKNOVEMBRO

Quando um ERP consulta a apuração da CBS, a resposta interessa a duas equipes. Quem mantém a integração precisa saber se todos os retornos chegaram e se foram gravados uma única vez. Quem fecha a apuração precisa explicar por que um valor apareceu, mudou ou deixou de estar disponível para uso. A migração das consultas de débitos e créditos para a versão 2.0 reúne essas duas responsabilidades.

A Receita Federal informou que liberou as consultas em 28 de outubro de 2026, em produção restrita e em produção beta. O comunicado também informa que quem já tem chaves deve cancelá-las e gerar novas para usar as APIs. Para organizar a mudança, vale separar três decisões: como renovar o acesso, como registrar cada consulta e como reconciliar os dados antes de liberar o resultado para o fiscal.

O artigo sobre webhook e download assíncrono no ERP descreve o transporte dos retornos. Aqui, a pergunta começa depois que a integração tem acesso ao serviço: como demonstrar que a migração trouxe os dados esperados, preservou o histórico e deixou um caminho de recuperação para quando uma consulta falhar?

Você pede à inteligência artificial que revise uma rotina de importação. Acrescenta as regras de negócio, explica como executar os testes, cola uma página de documentação e lembra que ela não deve gravar no banco. Na revisão seguinte, monta quase a mesma mensagem. Depois de algumas semanas, existem versões diferentes dessas orientações, e ninguém sabe qual delas continua válida.

O problema não começa na falta de um arquivo especial. Começa quando informações com funções diferentes são tratadas como se fossem uma única mensagem. Um pedido descreve o trabalho de agora; uma regra orienta o projeto; um documento fornece evidência; um procedimento organiza uma tarefa repetível. Separar essas funções ajuda tanto o leitor humano quanto o assistente que recebe o contexto.

Este artigo abre a série sobre instruções para IA, do Markdown às skills. Vamos construir essas distinções usando uma manutenção Delphi fictícia, mostrar onde cada informação pode ficar e propor um exercício de organização. Não é preciso conhecer agentes ou formatos de arquivos para acompanhar. Os exemplos são propostas didáticas, não resultados medidos de uma integração.

Quando a dificuldade é transformar uma intenção em regras e critérios verificáveis, SDD em Delphi oferece um aprofundamento em especificações, contratos e rastreabilidade. Consulte o sumário e a degustação gratuita para avaliar esse percurso. Para estudar as camadas de contexto, ferramentas e operação ao redor do modelo, a leitura complementar é IA Além da Conversa.