LotiVisse XML — robô de notas fiscais (SEFAZ-PB e NFS-e do Portal Nacional)

Robô que entra no ATF da SEFAZ-PB com o login do contador, pesquisa cada empresa pela inscrição estadual e salva numa pasta do seu computador os XML da competência e os PDF de faturas, extrato de pagamentos, omissão e inadimplência e certidão de débitos. As NFS-e (emitidas e recebidas, com o relatório de retenções) vêm pela API oficial do Portal Nacional, com o certificado A1 da empresa: veja robo/NFSE.md e a seção 11 do web/IMPLANTACAO.md.

Na VPS (Hostinger, Ubuntu), ao lado do robô de certidões: siga servidor/LEIAME.md. O robô roda com um Chrome próprio (tela virtual :11, porta 9223), religa sozinho e manda os arquivos ao Google Drive a cada 10 minutos.

<pasta destino>/                   (padrão: a pasta Documentos do PC onde o robô roda \ RPA XML LotiVisse)
  Arquivos baixados/
    5-joao/                        (ID-NOME FANTASIA da planilha; sem ID, só o nome)
      2026-09/
        NF-e Saida - R$ 12.345,67/     NF-e Saida 2026-09.zip     (o ZIP do ATF, como veio)
        NF-e Entrada - R$ 8.900,00/    NF-e Entrada 2026-09.zip
        NFC-e - R$ 1.230,50/           NFC-e 2026-09.zip
        CT-e Remetente - R$ 400,00/    CT-e Remetente 2026-09.zip        (valor da prestação, sem os cancelados)
        CT-e Destinatario - R$ 950,00/ CT-e Destinatario 2026-09.zip
        Faturas/                       Faturas 2026-09.pdf               (DAR/PIX dos lançamentos em aberto)
        Extrato de Pagamentos/         Extrato de Pagamentos 2026-09.pdf
        Omissão e Inadimplência/       Omissão e Inadimplência 2026-09.pdf   (o relatório completo)
        Certidão de Débitos/           Certidão de Débitos 2026-09.pdf
        Conferência Cartão de Crédito/ Conferência Cartão de Crédito 2026-09.pdf
        NFS-e Emitidas/                XML e PDF de cada nota (Portal Nacional, sem as canceladas)
        NFS-e Recebidas/               XML e PDF de cada nota
        Retenções NFS-e 2026-09.xlsx   ISS, IRRF, PIS, COFINS, CSLL e INSS por nota e em totais
      Dossiê MEI/                      Faturamento MEI 2026.xlsx e .json (um mês por linha; só Optante SIMEI)
    _sem_empresa/        arquivo de empresa fora da rodada (ex.: consulta feita à mão no mesmo login)
    _nao_identificados/  arquivo baixado que não é XML/ZIP (guardado como veio, para conferir)
  _relatorios/           relatório de cada rodada
  _diagnostico/          telas e campos quando algo não é reconhecido

O ZIP baixado do ATF não é descompactado: fica do jeito que veio. O robô só lê o conteúdo para saber de qual empresa e tipo ele é e para somar o valor total (vNF das notas autorizadas, sem as canceladas), que aparece no nome da pasta. Rodar de novo a mesma competência não duplica o arquivo; um arquivo novo soma no total e a pasta é renomeada.

O robô é ativado pelo portal web: o cliente envia a planilha modelo na área de agendamento, escolhe a competência e o horário, e o robô no seu PC executa.

Peça	Onde roda	Pasta
Portal LotiVisse XML (login, agendamento, acompanhamento)	Vercel + Supabase próprio, em xml.lotivisse.com.br	web/
Robô (ATF, download, organização das pastas)	Seu PC, com o Chrome	robo/
Planilha modelo	Portal e robô	modelos/modelo_empresas_sefaz_pb.xlsx

Passo a passo de implantação: web/IMPLANTACAO.md.

Planilha modelo

O modelo já vem com X em todas as opções (ATIVA e serviços) nas linhas 2 a 101: o cliente preenche só os dados das empresas. Linha sem dados de empresa é ignorada. As colunas são achadas pelo nome do cabeçalho. O robô de XML usa:

Coluna	Uso
ATIVA	X (ou S, ou em branco) = ativa; N = ignorada
ID, ID_FILIAL	códigos do escritório; o ID entra no nome da pasta
CNPJ	opcional; ajuda a conferir os XML
INSCRICAO ESTADUAL	obrigatória: é por ela que o ATF pesquisa (dígito verificador da PB conferido)
NOME FANTASIA	nome da pasta
LOGIN, SENHA	acesso do contador ao ATF. A senha só precisa vir uma vez por login
NF-e Saida, NF-e Entrada, NFC-e	X (ou S, SIM) = baixar esse XML; apagar o X = não baixar
CT-e	X = baixar o XML dos CT-e em que a empresa é remetente e em que é destinatária (duas consultas, duas pastas)
Download Faturas, Extrato de Pagamentos, Omissão e Inadimplência, Certidão de Débitos, Conferência Cartão de Credito	X = emitir o PDF desse serviço
Dossiê MEI	X = entradas e saídas do mês (aba Docs fiscais do dossiê). O robô confere o Optante SIMEI na Identificação: quem não é MEI fica de fora

Serviços com PDF na hora (gravações de 18/10/2026)

Feitos na mesma sessão do login do contador, enquanto o ATF prepara os XML (não usam Minhas Mensagens). Cada tela é aberta pelo campo Função do topo (como na gravação) ou, se não der, pelo endereço direto; a IE vai no Número, Pesquisar confere a empresa (sem nome = IE não existe no ATF).

This is the beginning of the README. Read the rest at the original. Read the full README ↗