shade-plugins-documentos-fiscais

Lê a NF-e (XML e DANFE em PDF), confere a chave de acesso e decompõe a linha digitável do boleto. É um plugin do shade-sdk; roda offline, sem credencial, sem nenhuma operação com efeito e sem modelo de IA: só leitura e conta.

No shade.toml do robô:

[plugins]
documentos-fiscais = "0.1.0"

import shade_plugins_documentos_fiscais as fiscais

nota = fiscais.nfe_xml("nota.xml")
nota["emitente"]["nome"], nota["totais"]["nota"], nota["chave"]

danfe = fiscais.nfe_danfe("danfe.pdf")  # os mesmos campos, do PDF
chave = fiscais.chave_de_acesso("3526 1011 2223 3300 0181 5500 1000 0001 2311 2345 6783")
boleto = fiscais.boleto("23793.45677 89012.345677 89012.345677 5 16360000123456")
boleto["banco"], boleto["valor"], boleto["vencimento"]

• Recusa com motivo: o que não confere levanta DocumentoInvalido (um ErroDeNegocio: o item termina com falha, sem repetir) com motivo: digito_verificador, tamanho, formato, uf, emissao, modelo, emitente, chave_diverge, protocolo_diverge, doctype, xml_malformado, nao_e_nfe, estrutura, chave_nao_encontrada, pdf_ilegivel, arrecadacao.
• XML seguro: a NF-e não tem DOCTYPE. O arquivo que traz um é recusado (doctype) antes de qualquer entidade ser expandida: nenhuma entidade externa lê arquivo do disco, e a cascata de entidades não estoura a memória. O arquivo passa de 10 MB → recusado.
• Valores: dinheiro e quantidade saem em texto decimal ("215.00"), sem arredondar; o campo ausente é None.
• Vencimento do boleto: o fator volta ao 1000 a cada 9.000 dias (o 1000 é 22/02/2025). O vencimento é o do ciclo mais próximo da referencia (a data de hoje, se omitida); fator 0000 e valor zero saem None (sem vencimento, valor livre).
• Limites: boleto de arrecadação (48 dígitos: consumo e tributo) é recusado (arrecadacao). O DANFE só entrega, sempre, a chave e o que ela carrega; destinatário, totais e itens saem dos rótulos oficiais com o valor na linha de baixo e da tabela DADOS DOS PRODUTOS / SERVIÇOS, e o campo que o desenho do PDF não entrega sai None (o XML é a fonte completa).
• DANFE escaneado: o PDF só imagem é lido pelo Tesseract da imagem do run (português, sem rede e sem IA), e leitura sai "ocr" ("texto" no PDF com camada de texto). A chave lida passa pelo mesmo dígito verificador: um dígito mal lido vira digito_verificador, nunca chave errada. O OCR não devolve a tabela desenhada, então itens sai vazio (o XML é a fonte). Página com confiança abaixo de 0,8 retém o item (ocr_baixa_confianca), com o documento anexado. Sem o Tesseract, ocr_indisponivel.