Workflow para processos de importação e exportação

Características do Requisito

Descrição

A implementação de Workflow permite que o sistema envie e-mails com detalhes de processos do sistema, listados acima, que estejam habilitadas para o envio do e-mail. O e-mail do workflow pode ser informativo ou de tomada de decisão para processos dos módulo Easy Import Control (SIGAEIC) e Easy Export Control (SIGAEEC). Quando habilitado é possível enviar dois tipos de workflow diferentes: Informativo e Tomada de Decisão.

Workflow Informativo é aquele que é enviado via e-mail para apenas informar a um usuário ou grupo de usuários, não sendo necessário nenhuma ação por parte dos mesmos.

Workflow de Tomada de Decisão é aquele que é enviado via e-mail para um usuário ou grupo de usuários, em que este aguarda a ação por parte dos mesmos para aprovação, liberação, desbloqueio, etc de um processo. Neste workflow é enviado um link em que o destinatário pode clicar e, com isso, iniciar a integração com o Protheus para executar a ação no processo descrito no próprio workflow.

Abaixo a tabela com as rotinas e suas especificações sobre o módulo que atende, tipo e rotinas que os processam quando ativados:

Configurando o Workflow

Inicia-se a configuração de Parâmetros no arquivo SX6 – Parâmetros:

1. Configuração Parâmetros

No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017) e configure o(s) parâmetro(s) a seguir:

Importante:

No parâmetro MV_EASYSRV, deve ser informado um servidor válido para acesso ao Protheus + porta (a ser informada no Servidor Internet (HTTP)), a ser definido a critério do administrador do Protheus da empresa. (Exemplo: http://10.197.24.171:9020). Quando o campo "Servidor" (EJ7_SERVID) do cadastro de workflow estiver vazio será considerado o que estiver no parâmetro.

Os Parâmetros MV_EASYSRV, MV_HTMLWF e MV_HTMLWFA serão utilizados apenas quando o workflow habilitado estiver com o campo "Tipo Servidor" (EJ7_TIPSRV)  for igual a "2 - Web" e .o campo "Tipo Env. WF" (EJ7_TIPO) estiver preenchido como tipo de envio "Anexo" ou "Link".

2. Configuração do arquivo .INI

Abra o arquivo appserver.ini localizado no diretório "BIN\APPSERVER\" e insira as Tags abaixo para configurar o envio de e-mail, no caso de já existir alguma dessas Tags, consulte um especialista para que não tenha problemas nas configurações de seu sistema Protheus:

Para maiores informações sobre como configurar seu ambiente para Workflow acesse a FAQ de Workflow no seguinte Link: - FAQ - Workflow

[LOCALHOST:8080/wf]

ENABLE=1

PORT=8080

PATH=C:\AmbientesProtheus\Protheus\V12Rede\Protheus Data_WF\Messenger

ENVIRONMENT=12_1_17_WF

INSTANCENAME=WF

RESPONSEJOB=JOB_WF_LINK

Nessa Tag [LOCALHOST:8080/wf] deve-se apontar para o servidor mais a porta de onde está configurado o ambiente que será o de workflow.

Parâmetros:

PATH deve conter o caminho da pasta protheus_data do ambiente;

ENVIRONMENT deve conter o nome do ambiente que será usado;

[JOB_WF_LINK]

TYPE=WEB

ENVIRONMENT=12_1_17_WF

INSTANCES=1,10

SIGAWEB=WF

INSTANCENAME=WF

ONSTART=STARTWEBEX

ONCONNECT=CONNECTWEBEX

ONEXIT=FINISHWEBEX

NameSpace=http://localhost:8080/WF

URLLocation=http://localhost:8080/WF

Nessa Tag [JOB_WF_LINK] é onde se configura o JOB que será responsável pelo envio dos e-mails do workflow:

Parâmetros:

ENVIRONMENT deve conter o nome do ambiente que será usado;

[ONSTART]

JOBS=JOB_WF_LINK

RefreshRate=120

Tag [ONSTART] é responsável por executar o Job toda vez que tiver o serviço iniciado, caso já tenha o mesmo configurado consulte o especialista do sistema Protheus.

[MAIL]

Protocol=POP3

Nessa Tag [MAIL] são determinadas as configurações de e-mail e pode variar de acordo com o ambiente de rede de cada empresa, nesse caso para configurar a mesma é necessário a presença de um especialista no sistema Protheus para sua devida configuração. No caso de dúvidas acesse o link da TDN para ser direcionado ao site que explica o uso da seção MAIL no arquivo de configuração ".INI".

Seção [MAIL]

Quando utilizar o tipo de conexão TLS a configuração acima deve funcionar por padrão, caso tenha que conectar usando somente a porta SSL adicione na TAG [MAIL] o parâmetro SSLVersion=2, ficando da seguinte forma:

[MAIL]

Protocol=POP3

SSLVersion=2

Para configurar o retorno dos Workflows adicione a seguinte Tag no arquivo de configuração, em caso de dúvida consulte a FAQ do Workflow para maiores informações:

[schedulerwf]
Main=WFONSTART
Environment=12_1_17_WF
nParms=4
parm1=99
parm2=01
parm3=12_1_17_WF
parm4=T

Nessa TAG [schedulerwf] são definidas as empresas e filiais que terão seus retornos observados pelo sistema, desse modo a seguinte Tag deve estar no parâmetro JOB da TAG [ONSTART] da seguinte forma: 

[ONSTART]

JOBS=JOB_WF_LINK,[schedulerwf]

Parâmetros 

ENVIRONMENT deve conter o nome do ambiente que será usado;

PARM3 deve conter o nome do ambiente que será usado;

3. Configuração de Contas de Email

No Configurador (SIGACFG), acesse Ambientes/WorkFlow/Contas de E-mails preencha os campos com os dados de seu e-mail.

Em seguida acesse o acesse Ambientes/WorkFlow/Parâmetros do Workflow e preencha os campos da seguinte forma para o funcionamento básico.

4. Configuração de cadastro de Workflow

Usando como exemplo o Workflow informativo do Pedido de Exportação, acesse o Easy Export Control (SIGAEEC) e em Atualizações->Tabelas->Cadastro Workflow altere o cadastro de código EX do Pedido de Exportação e preencha os campos de "WF Ativo" como sim e o campo "Destinatário" com o e-mail daqueles que vão receber o e-mail separando os mesmo por ";" ou usando os campos de "Cópia" e ou "Cópia Oculta", em seguida salve o cadastro.

Procedimento para Utilização

Sequencia 001: Workflow - Solicitação de Importação

1. 1. No Easy Import Control (SIGAEIC) acesse Atualizações/Solic. Importacao/Manutenção (EICSI400).
   2. Clique em Incluir.
   3. Informe os dados do registro e clique em Confirmar.
   4. O sistema efetua a gravação do registro.
   5. O workflow é enviado ao destinatario.

Pre-Requisitos - Sequencia 002: Workflow - Itens Anuentes do Purchase Order

• • Possuir uma SI cadastrada, com itens anuentes.

Sequencia 002: Workflow - Itens Anuentes do Purchase Order

1. 1. No Easy Import Control (SIGAEIC) acesse Atualizações/Purchase Order/Manutenção (EICPO400).
   2. Clique em Incluir.
   3. Informe os dados do registro e clique em Confirmar.
   4. Informe a SI de Referencia e clique em Confirmar.
   5. Marque os itens e clique em Confirmar.
   6. Clique em Confirmar para salvar o processo.
   7. O sistema efetua a gravação do registro.
   8. O workflow é enviado ao destinatario.

Pre-Requisitos - Sequencia 003: Workflow - Previsão de Embarque dos itens do Purchase Order

• • Possuir uma SI cadastrada.

Sequencia 003: Workflow - Previsão de Embarque dos itens do Purchase Order

1. 1. No Easy Import Control (SIGAEIC) acesse Atualizações/Purchase Order/Manutenção (EICPO400).
   2. Clique em Incluir.
   3. Informe os dados do registro e clique em Confirmar.
   4. Informe a SI de Referencia e clique em Confirmar.
   5. Marque os itens e clique em Confirmar.
   6. Clique em Confirmar para salvar o processo.
   7. O sistema efetua a gravação do registro.
   8. O workflow é enviado ao destinatario.

Pre-Requisitos - Sequencia 004: Workflow - Licença de Importação

• • Possuir um PO cadastrado, com itens anuentes.

Sequencia 004: Workflow - Licença de Importação

1. 1. No Easy Import Control (SIGAEIC) acesse Atualizações/Licenca de Import/Manutenção (EICGI400).
   2. Clique em Incluir.
   3. Informe os dados do registro e clique em Confirmar.
   4. Informe o PO de Referencia e clique em Confirmar.
   5. Marque os itens e clique em Confirmar.
   6. Clique em Confirmar para salvar o processo.
   7. O sistema efetua a gravação do registro.
   8. O workflow é enviado ao destinatario.

Pre-Requisitos - Sequencia 005: Workflow - Inclusão Embarque

• • Possuir um PO cadastrado.

Sequencia 005: Workflow - Inclusão Embarque

1. 1. No Easy Import Control (SIGAEIC) acesse Atualizações/Embarque/Manutenção (EICDI501).
   2. Clique em Incluir.
   3. Informe os dados do registro e clique em Confirmar.
   4. Informe o PO de Referencia e clique em Confirmar.
   5. Marque os itens e clique em Confirmar.
   6. Clique em Confirmar para salvar o processo.
   7. O sistema efetua a gravação do registro.
   8. O workflow é enviado ao destinatario.

Pre-Requisitos - Sequencia 006: Workflow - Encerramento de Embarque

• • Possuir um Embarque cadastrado.

Sequencia 006: Workflow - Encerramento de Embarque

1. 1. No Easy Import Control (SIGAEIC) acesse Atualizações/Desembaraço/Manutenção (EICDI502).
   2. Selecione o processo e clique em Alterar.
   3. Na aba Cadastrais, preencha o campo Encerramento (W6_DT_ENCE).
   4. Clique em Confirmar para salvar o processo.
   5. O sistema efetua a gravação do registro.
   6. O workflow é enviado ao destinatario.

Pre-Requisitos - Sequencia 007: Workflow - Previsão de Entrega

• • Criar um Job no Sistema para executar a função WFSchEICPrev()

Sequencia 007: Workflow - Previsão de Entrega

1. 1. No Configurador (SIGACFG) acesse Ambiente/Schedule/Schedule (CFG010).
   2. Em agendamentos crie um para executar a função WFSchEICPrev()
   3. Nos parâmetros dessa função deve ser enviado a empresa e filial como um array simples {empresa,filial}
   4. O agendamento pode ser feito para rodar quantas vezes o usuário precisar.
   5. A função busca e lista todas as Declarações de Importação que estejam atrasadas, se baseando pela data do sistema
   6. O Workflow é enviado em seguida com todos os processo que ainda não foram entregues.

Pre-Requisitos - Sequencia 008: Workflow - Nota Fiscal

• • Possuir um Embarque cadastrado, preparado para a geração de Nota Fiscal.

Sequencia 008: Workflow - Nota Fiscal

1. 1. No Easy Import Control (SIGAEIC) acesse Atualizações/Desembaraço/Receb.Importacao (EICDI154).
   2. Selecione o processo e clique em Primeira.
   3. Clique em Itens.
   4. Marque os itens, informe o número e série da Nota Fiscal e clique em Confirmar.
   5. Ao retornar a tela anterior, clique em Gerar NFE.
   6. O sistema efetua a geração da Nota Fiscal.
   7. O sistema exibe o numero da Nota Fiscal em tela.
   8. O workflow é enviado ao destinatario.

Pre-Requisitos - Sequencia 009: Workflow - Adiantamento de Numerário

• • Possuir um Embarque cadastrado.

Sequencia 009: Workflow - Adiantamento de Numerário

1. 1. No Easy Import Control (SIGAEIC) acesse Atualizações/Embarque/Solicit.numerario (EICNU400).
   2. Selecione o processo e clique em Manutenção.
   3. Em Ações Relacionadas clique em Incluir.
   4. Informe os dados da despesa e clique em Confirmar.
   5. Ao retornar a tela anterior, selecione a despesa e em Ações Relacionadas clique em Liberar Adiantamento.
   6. Informe a data de vencimento e clique em Ok.
   7. Clique em Confirmar para salvar o processo.
   8. O sistema efetua a gravação do registro.
   9. O workflow é enviado ao destinatario.

Pre-Requisitos - Sequencia 010: Workflow - Previsão de Entrega

• • Criar um Job no Sistema para executar a função WFSchEICCambio()

Sequencia 010: Workflow - Atraso em Parcela de Câmbio

1. 1. No Configurador (SIGACFG) acesse Ambiente/Schedule/Schedule (CFG010).
   2. Em agendamentos crie um para executar a função WFSchEICCambio()
   3. Nos parâmetros dessa função deve ser enviado a empresa e filial como um array simples {empresa,filial}
   4. O agendamento pode ser feito para rodar quantas vezes o usuário precisar.
   5. A função busca e lista todas as parcelas de Câmbio em atraso, se baseando pela data do sistema
   6. O Workflow é enviado em seguida com todos as parcelas de Câmbio em atraso.

Pre-Requisitos - Sequencia 011: Workflow - Liquidação de Câmbio

• • Possuir um Embarque, com câmbio gerado.

Sequencia 011: Workflow - Liquidação de Câmbio

1. 1. No Easy Import Control (SIGAEIC) acesse Atualizações/Financeiro/Controle Cambio (EICAP100).
   2. Selecione o processo e clique em Alterar.
   3. Selecione a parcela e em Ações Relacionadas clique em Liquidar.
   4. Informe os dados de liquidação e clique em Confirmar.
   5. Clique em Confirmar para salvar o processo.
   6. O sistema efetua a gravação do registro.
   7. O workflow é enviado ao destinatario.

Pre-Requisitos - Sequencia 012: Workflow - Aprovação de Numerário

• • Possuir um Embarque cadastrado.

Sequencia 012: Workflow - Aprovação de Numerário

1. 1. No Easy Import Control (SIGAEIC) acesse Atualizações/Embarque/Solicit.numerario (EICNU400).
   2. Selecione o processo e clique em Manutenção.
   3. Em Ações Relacionadas clique em Incluir.
   4. Informe os dados da despesa e clique em Confirmar.
   5. Clique em Confirmar para salvar o processo.
   6. O sistema efetua a gravação do registro.
   7. O workflow é enviado ao destinatario.
   8. Por ser um workflow de tomada de decisão, além da mensagem informativa no corpo do e-mail, este workflow acompanha um link que ao ser selecionado, inicia a integração com o Protheus para executar a liberação dos adiantamentos automaticamente.
   9. Ao receber o workflow, o destinatário poderá ou não aprovar a liberação dos adiantamentos.
      - Caso queria aprová-los, o destinatário deve clicar no link para iniciar a integração com o Protheus e executar a liberação dos adiantamentos automaticamente.
   10. O sistema apenas liberará os adiantamentos após a aprovação do destinatário.
   11. Após clicar no link, o Protheus efetua o processamento necessário.
   12. No Easy Import Control (SIGAEIC) acesse Atualizações/Embarque/Solicit.numerario (EICNU400).
   13. Selecione o processo e clique em Manutenção.
   14. Note que as despesas foram liberadas.

Pre-Requisitos - Sequencia 013: Workflow - Aprovação de Crédito

• • Possuir um Embarque cadastrado com data de Solicitação de Crédito preenchida.

Sequencia 013: Workflow - Aprovação de Crédito

1. 1. No Easy Export Control (SIGAEEC) acesse Atualizações/Pedido Export./Manutenção (EECAP100).
   2. Selecione o processo e clique em outras Ações e Apr. Crétdito.
   3. Preencha o campo de Dt.Aprov. Cred. com a data da aprovação.
   4. Clique em Confirmar para salvar o processo.
   5. O sistema efetua a gravação do registro.
   6. O workflow é enviado ao destinatário.
   7. Por ser um workflow de tomada de decisão, além da mensagem informativa no corpo do e-mail, este workflow tem um botão aprovar.
   8. Ao receber o workflow, o destinatário poderá ou não aprovar crédito.
      - Caso queria aprová-los, o destinatário deve clicar no no botão aprovar, onde o mesmo dispara uma resposta para o sistema.
   9. O sistema interpreta a resposta e caso seja positiva a data de aprovação de crédito é preenchida.
   10. Caso contrário o processo permanece sem data de aprovação de crédito preenchida.

Sequencia 014: Workflow - Aprovação de Preços

1. 1. No Easy Export Control (SIGAEEC) acesse Atualizações/Tabelas de Preço/Aprovação de Preço (EECTP100).
   2. Preencha a tela de parâmetros iniciais e confirme.
   3. A rotina vai efetivar os preços e gravar os dados.
   4. O workflow é enviado ao destinatário.

Pre-Requisitos - Sequencia 015: Workflow - Liberação de Crédito

• • Possuir um Embarque cadastrado com data de Solicitação de Crédito preenchida.

Sequencia 015: Workflow - Liberação de Crédito

1. 1. No Easy Export Control (SIGAEEC) acesse Atualizações/Pedido Export./Manutenção (EECAP100).
   2. Selecione o processo e clique em outras Ações e Apr. Crétdito.
   3. Preencha o campo de Dt.Aprov. Cred. com a data da aprovação.
   4. Clique em Confirmar para salvar o processo.
   5. O sistema efetua a gravação do registro.
   6. O workflow é enviado ao destinatário.

Pre-Requisitos - Sequencia 016: Workflow - Carta de Crédito

• • Possuir um Embarque, com câmbio gerado.

Sequencia 016: Workflow - Carta de Crédito

1. 1. No  Easy Export Control (SIGAEEC) acesse Atualizações//Financeiro/Carta de Crédito (EECAF100).
   2. Inclua um processo de Carta de Crédito e salve o mesmo.
   3. Acesse o embarque criado como requisito.
   4. Na aba Financeiro preencha o campo No. L/C.
   5. Clique em Salvar para confirmar o processo.
   6. O sistema efetua a gravação do registro.
   7. O workflow é enviado ao destinatário.

Sequencia 017: Workflow - Inclusão de Pedido de Exportação

1. 1. No Easy Export Control (SIGAEEC) acesse Atualizações/Pedido de Exportação/Manutenção (EECAP100).
   2. Clique em incluir e preencha todos os campos necessários.
   3. Após preencher os dados da capa do pedido inclua itens para o pedido.
   4. Após a inclusão dos itens clique em Salvar.
   5. O sistema efetua a gravação do registro.
   6. O workflow é enviado ao destinatario.

Pre-Requisitos - Sequencia 018: Workflow - Inclusão de Embarque

• • Possuir um Pedido de Exportação cadastrado.

Sequencia 018: Workflow - Inclusão de Embarque

1. 1. No Easy Export Control (SIGAEEC) acesse Atualizações/Embarque/Manutenção (EECAE100)
   2. Clique em incluir e preencha todos os campos necessários.
   3. Após preencher os dados da capa do pedido inclua itens para o pedido.
   4. Após a inclusão dos itens clique em Salvar.
   5. O sistema efetua a gravação do registro.
   6. O workflow é enviado ao destinatario.
      

Pre-Requisitos - Sequencia 019: Workflow - Liberação para Siscomex

• • Possuir um Pedido de Exportação cadastrado.

Sequencia 019: Workflow - Liberação para Siscomex

1. 1. No Easy Export Control (SIGAEEC) acesse Atualizações/Embarque/Manutenção (EECAE100).
   2. Selecione o processo e clique em Alterar.
   3. Na aba Siscomex preencha o campo Dt. Lib. Sis. (Data de liberação Siscomex).
   4. Clique em Salvar para confirmar o processo.
   5. O sistema efetua a gravação do registro.
   6. O workflow é enviado ao destinatário.

Pre-Requisitos - Sequencia 020: Workflow - Adiantamento de Numerário

• • Possuir um Embarque cadastrado.

Sequencia 020: Workflow - Adiantamento de Numerário

1. 1. No Easy Export Control (SIGAEEC) acesse Atualizações/Embarque/Solicit.numerario (EECNU400).
   2. Selecione o processo e clique em Manutenção.
   3. Em Ações Relacionadas clique em Incluir.
   4. Informe os dados da despesa e clique em Confirmar.
   5. Ao retornar a tela anterior, selecione a despesa e em Ações Relacionadas clique em Efetiva.
   6. Informe a data de vencimento e clique em Ok.
   7. Clique em Confirmar para salvar o processo.
   8. O sistema efetua a gravação do registro.
   9. O workflow é enviado ao destinatário.

Pre-Requisitos - Sequencia 021: Workflow - Previsão de Entrega

• • Criar um Job no Sistema para executar a função WFSchEECCambio()

Sequencia 021: Workflow - Atraso em Parcela de Câmbio

1. 1. No Configurador (SIGACFG) acesse Ambiente/Schedule/Schedule (CFG010).
   2. Em agendamentos crie um para executar a função WFSchEECCambio()
   3. Nos parâmetros dessa função deve ser enviado a empresa e filial como um array simples {empresa,filial}
   4. O agendamento pode ser feito para rodar quantas vezes o usuário precisar.
   5. A função busca e lista todas as parcelas de Câmbio em atraso, se baseando pela data do sistema
   6. O Workflow é enviado em seguida com todas as parcelas de Câmbio em atraso.

Pre-Requisitos - Sequencia 022: Workflow - Liquidação de Câmbio

• • Possuir um Embarque, com câmbio gerado.

Sequencia 022: Workflow - Liquidação de Câmbio

1. 1. No Easy Export Control (SIGAEEC) acesse Atualizações//Financeiro/Cambio (EECAF200).
   2. Selecione o processo e clique em Alterar.
   3. Selecione a parcela e em Ações Relacionadas clique em Liquidar.
   4. Informe os dados de liquidação e clique em Confirmar.
   5. Clique em Confirmar para salvar o processo.
   6. O sistema efetua a gravação do registro.
   7. O workflow é enviado ao destinatario.