Distribuição de DANFE Protheus automática

ÍNDICE

1. Visão Geral
2. Configuração via Job
   
3. Configuração via Schedule
4. Configuração do Wizard do TSS
   
5. Exemplo de utilização
6. Importante! / Perguntas Frequentes
7. Tabelas utilizadas

01. VISÃO GERAL

Atualmente, após a emissão de uma NFe, o TSS envia automaticamente por e-mail o XML da nota fiscal emitida e também, caso seja configurado, anexa o PDF do DANFE a esse mesmo e-mail. 

O DANFE que é encaminhado via TSS tem leiaute padrão, e não é aberto a customizações. Desta forma, a funcionalidade liberada, tem como processo realizar o envio de e-mail do DANFE gerado no ERP (customização disponível via RDMake).

Pré-Requisito: TSS versão 3.0 ou superior. 

02. CONFIGURAÇÃO VIA JOB

• Abra o arquivo appserver.ini localizado na pasta \bin\appserver\  do seu PROTHEUS
• Inclua a seguinte chave e a ativação na inicialização do server *

[DistMail]
Main=DistMail
Environment=NomeDoSeuAmbiente

[IPC_DISTMAIL]
Main=prepareIPCWAIT
Environment=NomeDoSeuAmbiente
instances=1,10,1,1
ExpirationTime=120
ExpirationDelta=1

[OnStart]
jobs=DistMail, IPC_DISTMAIL
RefreshRate=10

Como funciona a configuração da chave instances?

O processamento do envio de DANFE customizado será proporcional ao configurado na chave INSTANCES da seção IPC_DISTMAIL.

No exemplo acima o PROTHEUS terá até 10 threads para uso no envio do DANFE customizado e sempre no mínimo uma thread sempre disponível. 

Ressaltamos que a configuração inicial de 1, 10, 1, 1 é a mínima sugerida, porém você poderá ajustar esse valor conforme a sua necessidade. 

Consulte documentação completa aqui: Instances

03. CONFIGURAÇÃO VIA SCHEDULE

Para realizar a configuração do envio da Danfe Customizada, basta criar a rotina em agendamentos, onde as principais informações são os campos:

• Rotina: informar a rotina AUTDSTMAIL.
• Empresa/Filial: Empresas/filiais que irão realizar o processo de envio dos DANFEs customizados.

Schedule - Como agendar a execução de rotinas

04. CONFIGURAÇÃO DO WIZARD DO TSS

• Inicie o Protheus no módulo Faturamento (SIGAFAT);
• Acesse o menu Atualizações → Nf-e e Nfs-e → Nf-e Sefaz;
• Clique no botão +Wiz.Config. localizado no menu superior.

• Execute o processo de configuração padrão do TSS, para informação da URL do serviço e o certificado da empresa que irá ser utilizada;
• Preencha os campos para configuração do envio de e-mail;
• No procedimento final de configuração estará disponível o campo "Enviar DANFE por e-mail?" preencher com a opção "2 - Enviar DANFE do ERP".

• Será exibida a mensagem de alerta para que seja realizada a configuração;

• Demonstrativo do funcionamento para cada opção do que é enviado ao transmitir uma NF-e*:

05. EXEMPLO DE UTILIZAÇÃO

A execução será feita conforme parametrização no Wizard de configuração do TSS, no Protheus, para ativação do JOB incluído no appserver.ini

Após habilitado, o JOB consultará no TSS os documentos autorizados (NF-e) e emitidos dentro do período de até 30 dias.

O envio de e-mail será realizado para os documentos em que ainda não houveram a solicitação do envio de e-mail. 

06. IMPORTANTE! PERGUNTAS FREQUENTES (FAQ)

• Parâmetro MV_IMPDIR

Não será considerado o conteúdo do parâmetro, quando habilitado a distribuição de e-mail via ERP, independente do seu conteúdo ocorrerá a consulta dos documentos eletrônicos nos livros fiscais (SF3).

• Configuração de MODO - Schedule ou JOB

A configuração é única por appserver, ou seja:

Se for configurado MODO 1 = Configuração via Schedule, a configuração de todos os ambientes presentes no appserver.ini poderá ser feito apenas via Schedule

Se for configurado MODO Vazio ou 2 = Configuração via Job, a configuração de todos os ambientes presentes no appserver.ini poderá ser feito apenas via Job

• Configuração

Para correto funcionamento, importante que o item 02 referente a configuração do JOB informado acima, será considerado apenas na opção do item "Enviar DANFE por e-mail?" com a opção "2-Enviar DANFE do ERP".

• O que significa a mensagem "não foi possível liberar o job" ?

A mensagem a seguir não se trata de um erro necessariamente: "Thread-XXXXXX: nao foi possivel acessar o job: \xxxxxx\xxxx pois ja esta em uso por outro processo."

Para o processamento da distribuição de e-mail do ERP essa mensagem pode indicar apenas que a geração dos DANFE para envio por e-mail daquela Filial ainda está em andamento.

No exemplo acima, a filial X TSS01 ainda está em processamento.

Você poderá identificar que os arquivos .PDF de DANFE estarão sendo criados e apagados dentro da pasta do PROTHEUS abaixo. Isso indica que o processamento dessa filial ainda não terminou.

Para verificar, acesse a pasta \protheus_data\DANFETEMP\ localizado na pasta raiz do seu PROTHEUS, em seguida acesse a pasta com o nome da sua filial utilizada que apresentou a mensagem acima.

• A mensagem "nao foi possivel acessar o job" está apresentando, mas não está gerando o DANFE ou enviando o e-mail, o que fazer?

Caso você não esteja recebendo e-mails com o DANFE customizado e seja identificado a mensagem "nao foi possível acessar o job pois ja esta em uso por outro processo" o sugerido é seguir os passos abaixo:

• • Interrompa o serviço utilizado para executar o PROTHEUS;
  • Abra a pasta \Protheus_data\semaforo, localizado dentro da pasta raíz da sua instalação PROTHEUS:

• •  
  • Localize e apague todos arquivos com a nomenclatura "procsend" presentes na pasta.
  • Inicie o serviço do PROTHEUS novamente;

• Caso após o procedimento acima o problema persista, por gentileza entre em contato com nosso suporte. 

07. TABELAS UTILIZADAS

• SF3
• SFT