~~NOTOC~~

====== Transmissão automática de XMLs e SPED (antigo Radagast) ======

A transmissão automática de XMLs e do SPED, que antes era feita por um programa separado chamado Radagast, agora faz parte do **Gollum**. O programa ''Radagast.exe'' não existe mais e não deve mais ser instalado nem agendado.

A função continua a mesma: enviar para o servidor FTP da Ello os XMLs das notas fiscais (NF-e e NFC-e) que ainda não foram transmitidas e, quando chegar a hora, o SPED Fiscal (EFD ICMS/IPI) de cada empresa ativa.

**Importante:** Esta transmissão deverá ser configurada **apenas** no servidor Ello.

Diferenças em relação ao Radagast:
  * Não é mais um serviço que fica rodando o tempo todo. Cada execução envia o que está pendente e termina sozinha.
  * Não existe mais pasta de XMLs monitorada: os XMLs são lidos direto do banco de dados do Ello. Por isso as opções de pasta e de geração do SPED que existiam no ''Ello.ini'' não são mais usadas.
  * As empresas ativas são todas tratadas na mesma execução. Se uma empresa falhar, as demais continuam e o problema fica registrado no log.
  * Não aparecem janelas de erro: quando algo falha, o programa termina sinalizando erro (útil para o Agendador de Tarefas do Windows) e o detalhe fica no log.

\\
===== Instalação =====

Não há mais uma opção separada no instalador. A transmissão vem junto com o Gollum e basta o Gollum estar instalado no servidor Ello.

\\

===== Configurações =====

As configurações ficam no arquivo **Gollum.ini**, que fica na mesma pasta do ''Gollum.exe'' (e **não** mais no ''Ello.ini''). Adicione as informações abaixo:

<code ini>
[FTP]
UserName = sped
Password = ello1133
Host     = ftp.ellotecnologia.net.br
</code>

Se o arquivo não tiver essa seção, o programa usa os dados padrão da Ello.

A seção ''[Radagast]'' guarda a data do último SPED enviado. Ela é **preenchida automaticamente** pelo programa após cada envio de SPED, não precisa ser digitada.

O SPED do mês anterior é gerado e enviado no primeiro dia útil do mês ou, se o último SPED enviado tiver 15 dias ou mais, na próxima execução.

\\
===== Executando manualmente =====

Para testar, abra o Prompt de Comando na pasta do Gollum e execute:

<code>
start /wait Gollum.exe transmite-xmls-e-sped-ftp -v
</code>

Opções:
  * ''-i'' ou ''--skip-sped'': envia só os XMLs, sem gerar o SPED.
  * ''-f'' ou ''--force'': reenvia também os XMLs que já foram transmitidos.
  * ''-v'' ou ''--verbose'': mostra na tela mais detalhes do andamento.
  * ''-?'' ou ''--help'': mostra a ajuda.

Para ver todos os comandos do Gollum, execute ''Gollum.exe -h''. Se o Gollum for aberto fora do Prompt de Comando (por exemplo, pela barra do Explorer), a ajuda aparece numa janelinha.

\\
===== Agendamento de Execução =====

Utilize o agendador de tarefas do Windows para agendar a execução.

O recomendado é criar um agendamento para executar de hora em hora sem gerar o SPED e outro agendamento
para executar com o SPED todo dia primeiro de cada mês.

Abaixo um exemplo de arquivo .bat do Windows para criar os agendamentos:

<code>
@echo off
set AppPath=C:\Ello\Gollum\Gollum.exe
set TaskNameHourly=TransmiteXMLsHourly
set TaskNameMonthly=TransmiteXMLsMonthly

REM Exclui tarefas existentes, se já houverem com os mesmos nomes
schtasks /delete /tn "%TaskNameHourly%" /f
schtasks /delete /tn "%TaskNameMonthly%" /f

REM Exclui também as tarefas do antigo Radagast
schtasks /delete /tn "RadagastHourly" /f
schtasks /delete /tn "RadagastMonthly" /f

REM Cria a tarefa para executar de hora em hora, sem o SPED
schtasks /create /tn "%TaskNameHourly%" /tr "\"%AppPath%\" transmite-xmls-e-sped-ftp -i" /sc hourly /mo 1 /f

REM Cria a tarefa para executar no dia 1 de cada mês às 08:00, com o SPED
schtasks /create /tn "%TaskNameMonthly%" /tr "\"%AppPath%\" transmite-xmls-e-sped-ftp" /sc monthly /d 1 /st 08:00 /f

echo Tarefas criadas com sucesso.
pause
</code>

Ajuste a variável ''AppPath'' para o local onde o Gollum está instalado. Salve como ''AdicionaTarefaTransmissaoXMLs.bat'' e execute para criar os agendamentos.

\\
===== Migrando de um Radagast já instalado =====

  - Remova as tarefas agendadas antigas do Radagast (o exemplo acima já faz isso).
  - Se o Radagast estava instalado como serviço, pare e remova o serviço.
  - Copie as informações da seção ''[FTP]'' e a data do último SPED (seção ''[Radagast]'') do ''Ello.ini'' para o ''Gollum.ini''.
  - Crie os novos agendamentos.