Histórico da Página

ÍNDICE

Visão GeralExemplo de utilização
Configuração via Job
Configuração do appserver.inivia Schedule
Configuração do Wizard do TSS
Exemplo de utilização
Importante! / Perguntas Frequentes
Tabelas utilizadas

Âncora

	visao_geral
	visao_geral

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 habilitadoseja configurado, também 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 aqui, tem como processo realizar o envio de e-mail do DANFE gerado no ERP - que possibilita customizações - através do TSS.

* Disponível para impressão modo RETRATO

02. EXEMPLO DE UTILIZAÇÃO

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

Após habilitado, o JOB receberá pelos serviços do TSS os documentos autorizados e emitidos dentro do período de 30 dias para os Status de envio de E-Mail 0, 1, 2 e 3.

Legenda Status:

0 - Aguardando envio do E-MAIL da DANFE do ERP

1 - Aguardando envio do E-MAIL TSS (XML ou XML e PDF)

2 - E-mail enviado com sucesso

3 - Erro no envio do E-mail

(customização disponível via RDMake).

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

Informações

title	Aviso

Esta melhoria foi disponibilizada para impressão em modo RETRATO.

Âncora

	appserver
	appserver

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

Informações
title Observação
1 - Em caso de balanceamento, não é necessário informar a configuração em todos os slaves, recomendamos informar apenas em um único appserver.ini, ou um dos slaves, que será utilizado para distribuição de e-mail.
2 - Caso seja utilizada acentuação no diretório em que está seu ambiente PROTHEUS, a rotina não funcionará corretamente.
Aviso
title Nome do ambiente
Evite a utilização de espaços na configuração do seu ambiente PROTHEUS (appserver.ini), pois isso pode acarretar mau funcionamento ou erros na rotina de envio do DANFE Customizado, conforme exemplo abaixo:
Image Added

Âncora
schedule
schedule
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

Image Added

Nota
title Monitor
Foram implementados logs para acompanhamento via Monitor.
Obs.: para que as mensagens sejam demonstradas corretamente é necessário que a LIB utilizada seja a versão 20211116 ou maior ou basta utilizar a versão 12.1.33 do PROTHEUS.
Inclusão de empresa/filial no SQLite:
Inicializando cadastro/atualizacao de distribuicao de email(DISTMAIL). Total de empresas/filiais:
Cadastrando empresas/filiais:
Processamento de envio de e-mail:
Inicializando o processo de envio de email de danfe customizado para a empresa/filial
Finalizando o processo de envio de email de danfe customizado para a empresa/filial

Image Added

Nota
icon false
title Observação
Foram implementados alguns logs de erros para análise:
Caso a Empresa/Filial informada não estiver configurada para o envio do DANFE customizado, ou seja, quando não executou o passo de Configuração do Wizard do TSS.
Image Added

Caso o artefato Printer, não estiver na pasta do binário.
Image Added
Link de download do artefato do Windows:
Printer Windows X64
Printer Windows X32
Link de download do artefato do MAC:
Printer MAC
Link de download do artefato do Linux:
Printer Linux X64
PDF Printer X64
Printer Linux X32
PDF Printer X32

Caso sejam configuradas as duas opções dos processos de distribuição de NF-e automática, assim, foi implementada a configuração MODO na seção DISTMAIL, onde seus valores são:
1 - Configuração via Schedule
Vazio ou 2 - Configuração via Job
A configuração MODO via Schedule é realizada de forma automática, desde que seja efetuada a configuração do agendamento da rotina (Schedule).
Image Added

Caso esteja com MODO configurado via Schedule (MODO=1) e sendo executado também via JOB:
Image Added
Caso esteja com MODO configurado via JOB (MODO=2) e sendo executado também via Schedule:
Image Added

Importante:
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

Âncora
wizard
wizard
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.

Image Modified

Image Modified

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 "Distr. Email NF-e Enviar DANFE por e-mail?" preencher com a opção "2 - Enviar DANFE do ERP"
...
.

Image Added

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

Aviso
title Diretório inválido
Caso a pasta utilizada para instalação do seu ambiente Protheus possua acentuação, a configuração de envio de e-mail não será realizada corretamente.
Será exibido o alerta abaixo na rotina e a mensagem a seguir no console do seu Appserver.

Image Added

Image Added

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

Distr. Email NF-e XML DANFE TSS (PDF) DANFE PROTHEUS (PDF)
0 X - -
1 X X -
2 X - X

Informações
title Importante
O envio do XML é realizado obrigatoriamente devido a legislação, independente da opção selecionada acima.

Âncora
exemplo_utilizacao
exemplo_utilizacao

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.

Deck of Cards

effectDuration	0.3
id	danfe_ERP
tabLocation	left
effectType	fade

Card

id	danfe_erp_1
label	Passo 1

Realizar um pedido de venda e preparar o documento de saída.

Módulo Faturamento > Atualizações > Pedidos de Venda

Image Added

Card

id	danfe_erp_2
label	Passo 2

Realizar a transmissão do pedido de venda gerado

Módulo Faturamento > Atualizações > Nf-e e Nfs-e > Nf-e Sefaz (Rotina SPEDNFE)

Transmitir

Image Added

2. Monitorar

Image Added

Card

id	danfe_erp_3
label	Passo 3

Aguardar o envio do XML e do DANFE gerado pelo ERP ao seu e-mail.

Image Added

DANFE encaminhado por e-mail

Image Added

Âncora

	importante
	importante

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?"

06. TABELAS UTILIZADAS

SF3
SFT

...

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.

Image Added

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.

Image Added

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:

- Image Added
- 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.

Âncora

	tabelas
	tabelas

07. TABELAS UTILIZADAS

SF3
SFT

...

HTML

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>

...

Árvore de páginas

Versões comparadas

Versão antiga 8

Nova versão Atual

Chave

ÍNDICE

01. VISÃO GERAL

02. EXEMPLO DE UTILIZAÇÃO

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

05. EXEMPLO DE UTILIZAÇÃO

06. IMPORTANTE!

PERGUNTAS FREQUENTES (FAQ)

06. TABELAS UTILIZADAS

07. TABELAS UTILIZADAS

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 8

Nova versão Atual

Chave

ÍNDICE

01. VISÃO GERAL

02. EXEMPLO DE UTILIZAÇÃO

02. CONFIGURAÇÃO VIA JOB

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

[DistMail]Main=DistMailEnvironment=

NomeDoSeuAmbiente

[IPC_DISTMAIL]Main=prepareIPCWAITEnvironment=NomeDoSeuAmbienteinstances=1,10,1,1ExpirationTime=120ExpirationDelta=1

[OnStart]jobs=DistMail, IPC_DISTMAILRefreshRate=10

05. EXEMPLO DE UTILIZAÇÃO

06. IMPORTANTE!

PERGUNTAS FREQUENTES (FAQ)

06. TABELAS UTILIZADAS

07. TABELAS UTILIZADAS

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=

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

[OnStart]
jobs=DistMail, IPC_DISTMAIL
RefreshRate=10