Distribuição de DANFE e DANFSE 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 ou NFS-e, o TSS envia automaticamente por e-mail o XML da nota fiscal emitida e também, caso seja configurado, anexa o PDF do documento a esse mesmo e-mail. 

O PDF que é encaminhado via TSS tem leiaute padrão, e não é aberto a customizações. Desta forma, a funcionalidade liberada para customização, tem como processo realizar o envio de e-mail do RPD 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 *
• A configuração via JOB não funcionar para NFS-e.  A configuração deve ser exclusivamente via SCHEDULE no tópico 03.

[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: poder ser informado AUTDSTMAIL apenas para NF-e ou AUTODISTMAIL e configurar o modelo do documento a ser distribuído. 
• Empresa/Filial: Empresas/filiais que irão realizar o processo de envio dos PDFs customizados.

Schedule - Como agendar a execução de rotinas

Ao configurar AUTDSTMAIL não abre o botão Parâmetros para configuração do modelo do documento.

Se configurado o AUTODISTMAIL é possível informar nos parâmetros o modelo do documento para distribuição.

• Para que seja exibida a tela de parâmetros onde serão informados os modelos de documentos que serão atendidos pela rotina, é obrigatório criar o grupo de perguntas. Conforme instruções abaixo:

Acesse o cadastro de perguntas: Base de Dados\ Base de Dados. Depois clique em Perguntas, em seguida no ícone de "novo".

              Grupo: AUTDSTMAIL

              Pergunta: Qual modelo do Documento ?

              Tamanho: 9

              Tipo: Caracter

              CONTEUDO DO HELP: 
                    Qual modelo do Documento deseja
                    utilizarpara realizar o envio de e-mail
                    do      DANFE/DANFSE gerado no ERP?
                    Exemplo:
                    55; (Para Considerar somente NF-e)
                    55;56; (Para considerar NF-e e NFS-e)
                    56; (Para Considerar somente NFS-e)

• Print de como deve ficar:

04. CONFIGURAÇÃO DO WIZARD DO TSS

• Inicie o Protheus no módulo Faturamento (SIGAFAT);
• Para NF-e acesse a rotina SPEDNFE no menu Atualizações → Nf-e e Nfs-e → Nf-e Sefaz;
• Para NFS-e acesse a rotina FISA022 no menu Atualizações → Nf-e e Nfs-e → Nfs-e;
• 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".

• Para NFS-e Preencher a opção "Enviar DANFSE por e-mail?" conforme a sua necessidade.

• 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*:

• Demonstrativo do funcionamento para cada opção de envio ao transmitir uma NFS-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).

Para NFS-e não será considerado, as informações do preenchimento do PDF serão coletados do XML UNICO e dados de autorização da NFS-e.

• 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

Para NFS-e deve ser utilizado exclusivamente vis schedule.

• 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".

Para correto funcionamento da NFS-e via SCHEDULE,  será considerado apenas na opção do item "Enviar DANFE por e-mail?" com a opção "3 - Enviar XML + DANFSE do ERP" ou "5 - DANFSE 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

      IMPORTANTE: Para NFS-e é validado apenas o XML Único. 

• SF3
• SFT