Anda di halaman 1dari 43

INSTALAO

ACELERADOR WORKFLOW DE COMPRAS

ACELERADOR WORKFLOW DE COMPRAS

Sumrio
Etapas simplificadas ...................................................................................................................... 4
1.

2.

Processo cotao ................................................................................................................... 4


1.1.

Envio de e-mail aos fornecedores ................................................................................. 4

1.2.

Reenvio .......................................................................................................................... 5

1.3.

E-mail sem resposta ...................................................................................................... 5

1.4.

Retorno de e-mail dos fornecedores ............................................................................ 6

1.5.

Informao ao Comprador ............................................................................................ 6

Processo pedido de compra .................................................................................................. 7


2.1.

Envio de e-mail para aprovao do pedido................................................................... 7

2.2.

Retorno de e-mail dos aprovadores (primeiros nveis) ................................................. 8

2.3.

Retorno de e-mail dos aprovadores (ltimo nvel) ....................................................... 8

2.3.1.

3.

Resultado da Aprovao............................................................................................ 8

2.4.

Pedido de compra ao fornecedor ................................................................................. 9

2.5.

Excluso do pedido de compra ................................................................................... 10

Processo Nota Fiscal de Entrada ......................................................................................... 10


3.1.

Informao de Solicitao Atendida ........................................................................... 10

4.

Premissas............................................................................................................................. 11

5.

Instalao ............................................................................................................................ 12
5.1.

Configuraes Iniciais .................................................................................................. 12

5.1.1.

Aplicar o patch WF_COMPRAS ............................................................................ 12

5.1.2.

Compatibilizador U_UPDWF ................................................................................ 14

5.1.3.

Classe FSWLicenas ................................................................................................. 18

5.1.4.

Pontos de Entrada ................................................................................................... 18


2

ACELERADOR WORKFLOW DE COMPRAS


5.1.5.

Campos Gerados ..................................................................................................... 18

5.1.5.1.

Campos no SC7 (Pedidos de Compras): .............................................................. 18

5.1.5.2.

Campos no SC8 (Cotaes): ................................................................................. 19

5.1.5.3.

Campos no SCR (Documentos com Alada) ........................................................ 19

5.1.6.

ndices Gerados ....................................................................................................... 19

5.1.7.

Parmetros .............................................................................................................. 20

6.

Pastas .................................................................................................................................. 23

7.

Configurao de E-mail ....................................................................................................... 24


7.1.

Parmetros .................................................................................................................. 24

7.2.

Contas de E-mail .......................................................................................................... 26

8.

Configurao do WorkFlow no AppServer.ini ..................................................................... 30

9.

Utilizando os pontos de entrada ......................................................................................... 31


9.1.

Cotao........................................................................................................................ 31

9.2.

Pedido de compra ....................................................................................................... 32

9.3.

Nota fiscal de entrada ................................................................................................. 33

10.

Funo adicional.............................................................................................................. 34

10.1.
11.

EnvPed() .................................................................................................................. 34

Problemas Adversos ........................................................................................................ 35

..................................................................................................................................................... 37
12.

Pontos de Entrada Especficos ........................................................................................ 38

12.1.
13.

Exemplo de utilizao.............................................................................................. 41

Pontos de Ateno .......................................................................................................... 42

ACELERADOR WORKFLOW DE COMPRAS

Etapas simplificadas
GRUPO

PROCESSO
Enviar Cotao aos fornecedores
Ponto de entrada quando se incluir um novo participante ou uma nova
proposta na anlise da cotao.
Reenvio de cotao

Cotao

E-mail sem resposta

Informa ao Comprador que todas as cotaes foram realizadas


Anlise da cotao para gerar o pedido de compra. Necessitando passar
pelo controle de aladas.
Informa se o Pedido de Compra foi aprovado ou reprovado.
Pedido de
Compra

NF entrada

Envio do Pedido de Compra ao Fornecedor


Envio de e-mail de vencedor ao fornecedor, quando pedido for liberado
via rotina padro(MATA097)
Executado na excluso manual do pedido de compra
Informao de solicitao atendida (Documento de entrada foi inserido
com o pedido de compra gerado atravs da cotao)

P.E. RESPONSAVEL POR


DISPARAR
Cadastrar Job
U_WFLOW04() ou PE
MT130WF
MT150END
Cadastrar Job
U_WFLOW04() ou PE
MT130WF
Cadastrar Job
U_WFLOW04() ou PE
MT130WF
No precisa de JOB pois o
retorno da aprovao j
dispara este e-mail.
MT160WF ou MT120GOK
No precisa de JOB pois o
retorno da aprovao j
dispara este e-mail.
No precisa de JOB pois o
retorno da aprovao j
dispara este e-mail.
MT097END
MTA120G1
MT100AGR

1. Processo cotao
1.1. Envio de e-mail aos fornecedores
Ao final da gerao das cotaes sero enviados e-mails para os fornecedores
selecionados efetuem a cotao das solicitaes.
Ponto de Entrada: MT130WF

ACELERADOR WORKFLOW DE COMPRAS


1.2. Reenvio
Caso o campo C8_ZZDTENV (Data de Envio) no esteja preenchido ou a Data de envio
seja menor que (Data Base - ZZ_WFCOTRE (Dias antes da data atual para as cotaes a serem
consideradas)) a cotao ser reenviada.
Cadastrar JOB U_WFLOW04()

1.3. E-mail sem resposta


Caso o campo C8_EMISSAO (Emisso) seja menor que a Data Base - ZZ_WFCOTSR

ser enviado um e-mail ao comprador informando que o fornecedor no respondeu a


cotao.
Cadastrar Job U_WFLOW04()

ACELERADOR WORKFLOW DE COMPRAS

Ateno
O prprio Ponto de Entrada MT130WF utiliza a funo U_WFLOW04, portanto quando forem geradas
as cotaes da solicitao de compra, tambm ser reenviado e-mails no respondidos no prazo, como
tambm o tratamento de e-mails sem resposta, alm de enviar o e-mail ao fornecedor desta nova
solicitao.

1.4. Retorno de e-mail dos fornecedores


Neste ponto sero atualizados os dados das cotaes conforme as informaes
respondidas pelos fornecedores.
Caso o parmetro ZZ_EXCCOT esteja configurado como verdadeiro (.T.) e o ponto de
entrada MT150CHV esteja compilado, a opo de excluso de cotaes com o valor
zerado durante o retorno ser habilitada.
No precisa de JOB pois o retorno da cotao j dispara este e-mail.

1.5. Informao ao Comprador


Aps todos os fornecedores responderem, ser enviado um e-mail ao
comprador informando que as cotaes esto disponveis para anlise.

No precisa de JOB pois o retorno da cotao j dispara este e-mail, caso todos os
fornecedores responderem.

ACELERADOR WORKFLOW DE COMPRAS

2. Processo pedido de compra


2.1. Envio de e-mail para aprovao do pedido
Aps o comprador efetuar a anlise das cotaes e selecionar o(s)
fornecedor(es) vencedor(es), o pedido ser gerado bloqueado e ser enviado e-mail
para o grupo de aprovao do comprador para este efetuar a aprovao ou no do
pedido de compra (Controle de aladas).
Obs.: Caso no haja grupo de aprovao para o comprador o pedido estar
liberado e no passar pelos processos do Workflow.
Se o parmetro ZZ_WFAUTH estiver como .T. e o appserver.ini devidamente
configurado para essa funcionalidade(vide pgina 29) ser exibida a seguinte tela
antes de abrir a pgina de aprovao do pedido de compra:

Nessa tela dever ser informado o login e senha do aprovador (a mesma do protheus).

ACELERADOR WORKFLOW DE COMPRAS

2.2. Retorno de e-mail dos aprovadores (primeiros


nveis)
Neste ponto sero atualizados os dados respondidos pelo aprovador.
 Prximo nvel de aprovao - Caso haja algum aprovador acima do nvel

do(s) aprovador(es) que aprovou o pedido de compra o pedido continuar


bloqueado e ser enviado um novo e-mail para os aprovadores deste nvel.

2.3. Retorno de e-mail dos aprovadores (ltimo nvel)


Neste ponto, se todos os aprovadores do ltimo nvel efetuaram a aprovao
do pedido, este estar liberado.

2.3.1.

Resultado da Aprovao

Ser enviado um e-mail ao comprador e outro e-mail ao solicitante informando


o resultado da aprovao do pedido de compra.

ACELERADOR WORKFLOW DE COMPRAS

No precisa de JOB pois o retorno da cotao j dispara este e-mail.

Ateno
O envio de e-mail aos aprovadores automtico, enviado aps a resposta de cada
aprovao.

2.4. Pedido de compra ao fornecedor


Aps a aprovao do pedido, caso o parmetro de envio de pedido automtico
(ZZ_WFHPCIF) este marcado como verdadeiro, um e-mail com os dados do pedido ser
enviado automaticamente ao fornecedor.

ACELERADOR WORKFLOW DE COMPRAS

2.5. Excluso do pedido de compra


Quando um pedido cancelado, um e-mail com a data de excluso e o nmero
do pedido ser enviado automaticamente para o solicitante e comprador.
Ponto de Entrada: MTA120G1

3. Processo Nota Fiscal de Entrada

3.1. Informao de Solicitao Atendida

10

ACELERADOR WORKFLOW DE COMPRAS


Aps a confirmao de uma nota fiscal de entrada que foi fruto de um pedido
de compra, ser enviado um e-mail ao solicitante informando a entrada do material.

Ponto de Entrada: MTA100AGR

Todos os processos possuem parmetros para habilitar ou desabilitar o envio dos e-mails.

4. Premissas
Existem diversos pontos de entrada para que o HTML seja personalizado com incluso
de novos campos, porm essa personalizao no est contemplada no preo inicial devendo
ser negociada separadamente.

11

ACELERADOR WORKFLOW DE COMPRAS

5. Instalao
5.1. Configuraes Iniciais
5.1.1.

Aplicar o patch WF_COMPRAS

Abrir o TDS;
Clicar no cone para aplicar o patch (Imagem abaixo);

Selecionar o patch WF_COMPRAS disponibilizado (Imagens abaixo),


atravs do item em destaque.

12

ACELERADOR WORKFLOW DE COMPRAS

Aguardar e clicar no boto

13

ACELERADOR WORKFLOW DE COMPRAS

5.1.2.

Compatibilizador U_UPDWF

Fazer backup da base de dados e dicionrios.


Rodar compatibilizador U_UPDWF para criar os campos e parmetros
personalizados.
Abra o Smart Client.
Defina o Programa inicial como U_UPDWF (Imagem abaixo).
Defina o Ambiente no servidor.

Click no boto

14

ACELERADOR WORKFLOW DE COMPRAS

Se j foi efetuado todo os Backups necessarios clicar no boto

Selecionar a Empresa (Imagem abaixo);

15

ACELERADOR WORKFLOW DE COMPRAS

Clicar no boto

Clicar no boto

16

ACELERADOR WORKFLOW DE COMPRAS

Aguardar atualizaes, conforme imagens:

17

ACELERADOR WORKFLOW DE COMPRAS

5.1.3.

Classe FSWLicenas

Para o funcionamento do WorkFlow essa classe deve estar compilada no ambiente:

tttp110_FSWLicencas-2013-08-06.ptm

5.1.4.

Pontos de Entrada

Os pontos de entrada presentes na pasta PE do kit de entrega devem ser compilados.


ATENO: Caso o cliente j utilize esses PEs , adicione a chamada das funes do workflow.
Verifique nos fontes da pasta PE do kit de entrega a chamada das funes e adicione-as nos
PEs do cliente.

5.1.5.

Campos Gerados

Abaixo os campos gerados atravs do compatibilizador U_UPDWF

5.1.5.1. Campos no SC7 (Pedidos de Compras):


Campo

C7_ZZDTENV

Descrio
Data do envio do e-mail

18

ACELERADOR WORKFLOW DE COMPRAS


5.1.5.2. Campos no SC8 (Cotaes):
Campo

C8_ZZDTENV
C8_ZZDTRET
C8_ZZWFID
C8_ZZUSRGC
C8_ZZINCOT
C8_ZZCOTOK

Descrio
Data do envio da cotao
Data do retorno da cotao
Id do processo
Usurio que ira mandar o e-mail
Incoterm
Cot.final?

5.1.5.3. Campos no SCR (Documentos com Alada)


Campo

CR_ZZDTENV

Descrio
Data de envio para o Primeiro Aprovador.

5.1.5.4. Campos no SA2 (Fornecedores)

Campo

A2_ZZOPER

Descrio
Operao de Compra.

IMPORTANTE
Preencher os campos C7_ZZDTENV e C8_ZZDTENV, com a data atual. Caso contrrio na
primeira vez que for executado o WorkFlow Compras, ser enviado um e-mail para
todos os fornecedores do histrico, inteiro, da base do cliente.

5.1.6.

ndices Gerados

Tabela SCR:
CR_FILAIL+CR_TIPO+CR_NUM+CR_NIVEL+CR_USER
Tabela SY6:
Y6_FILIAL + Y6_SIGSE4

19

ACELERADOR WORKFLOW DE COMPRAS


5.1.7.

Parmetros

Prints e telas

Abaixo imagens que exibem a localizao dos parmetros, acessado pelo configurador.
Abrir o Protheus no modulo SIGACFG
Abri o Menu Ambiente>Cadastro>Parmetros
Clicar no boto

Abaixo os parmetros necessrios para o correto funcionamento do WorkFlow


Compras e para o envio de e-mail.
Ateno ao parmetros com destaque em amarelo
Parmetro
ZZ_WFLOGO
ZZ_WFIPEXT
ZZ_WFRES
ZZ_WFCOTRE
ZZ_WFCOTSR
ZZ_WFCPAGT
ZZ_WFHTML

ZZ_WFPST
ZZ_WFHCTEF
ZZ_WFHCTNP
ZZ_WFHCTPP
ZZ_WFHCTRE

Descrio
Exemplo
Logo para o workflow (Tem http://www.totvs.com/image/company_logo
que ser um .JPG da Web)
?img_id=10209&t=1368996217181
Exemplo : 10.0.1.39:9191 (IP Local e Porta referente a seo
IP para acesso externo
HTTP) Verificar Configurao do WorkFlow no AppServer.ini.
Caminho dos HTMLs gerados
pelo workflow
Dias antes da data atual para
as cotaes a serem
consideradas
Dias at quando considerar
as cotaes
Condies de Pagamentos
que entram no workflow
Caminho padro do para os
modelos
HTMLs
do
Workflow
Nome da caixa de correio
cadastrada na tabela WF7
atravs do configurador
Envia WF na cotao para
fornecedor?
Envia WF na incluso de
nova proposta?
Envia WF na incluso de
novo participante?
Reenvia WF na cotao para
fornecedor?

\messenger\
2
1
001;002;003
\Workflow\Compras

Exemplo: WORKFLOW TOTVSIP


S=Sim; N=No
S=Sim; N=No
S=Sim; N=No
S=Sim; N=No

20

ACELERADOR WORKFLOW DE COMPRAS

ZZ_WFHCTSR

ZZ_WFHNFNO

ZZ_WFHPCEN

ZZ_WFHPCIS

ZZ_WFHPCIC

ZZ_WFHPCIF

ZZ_WFHPEXC

ZZ_WFHPEXS
ZZ_WFALCAD
ZZ_WFTOD
ZZ_WFTOH
ZZ_WFTOM
ZZ_WFESPNF
ZZ_WFCPOMF

ZZ_WFAUTH

ZZ_WFATCOT

ZZ_WFHTV

Envia WF de aviso sem


resposta para o usurio que
gerou a cotao?
Envia WF para notificao
do solicitante avisando a
entrada do material?
Envia WF para aprovador
apos gerao de pedido de
compra?
Envia WF para solicitante
avisando aprovao ou
reprovao do pedido?
Envia WF para comprador
avisando aprovao ou
reprovao do pedido?
Envia WF para fornecedor,
vencedor, com os dados do
pedido?
Envia WF para comprador
avisando sobre excluso do
pedido de compra?
Envia WF para solicitante
avisando sobre excluso do
pedido de compra?
Informa se o cliente tem
controle de aladas
Dias para time out
Horas para time out
Minutos para time out
Definir espcies da Nota
Entrada
Campo e-mail que ser
usado
no
cadastro
fornecedor
Autentica aprovador do
pedido de compra via
navegador web ?
Proteo para no permitir
atualizar uma cotao, que
foi atualizado manualmente.
True no permite atualizar e
False permite atualizar.
Define o Nome do Arquivo
Modelo html para o E-mail
do Pedido de Compra ao
Fornecedor
Vencedor.
Usado para Definir modelos
especficos por Empresa.

S=Sim; N=No

S=Sim; N=No

S=Sim; N=No

S=Sim; N=No

S=Sim; N=No

S=Sim; N=No

S=Sim; N=No

S=Sim; N=No
S=Sim; N=No
Numrico, Ex.: 5
Numrico, Ex.: 1
Numrico, Ex.: 10
Ex.: NFE, NF, NFP, ETC (Caso haja mais que uma espcie separar
por virgula)
Ex.: A2_EMAIL

.T. ou .F.

.T. ou .F.

Padro = Vencedor.htm

21

ACELERADOR WORKFLOW DE COMPRAS

ZZ_WFHTVI

ZZ_WFOPECO

ZZ_WFPEOPE

ZZ_EXCCOT

Define o Nome do Arquivo


Modelo html para o E-mail
do Pedido de Compra ao
Fornecedor Vencedor em
Ingls. Usado para Definir
modelos especficos por
Empresa.
Operao padro a ser
utilizada na cotao via
workflow caso o campo
A2_ZZOPER
no
esteja
preenchido
Indica
se
preenche
automaticamente a opera
no workflow de compras
Indica se exclui o item da
cotao durante o retorno,
caso o mesmo esteja com os
valores
zerados.
Este
parmetro funciona em
conjunto com o ponto de
entrada MT150CHV.

Padro = Vencedor_ing.htm

Exemplo: 001,002

S=Sim; N=No

.T. = Exclui
.F. = No exclui

ATENO -> Revisar todos os parmetros de acordo com a necessidade do cliente.

Obs.: Configurar Parmetros de acordo com configurao de e-mail (ver sumrio).

22

ACELERADOR WORKFLOW DE COMPRAS

6. Pastas
Criar dentro da pasta Protheus_Data a estrutura abaixo
1 Criar pasta web
2 Criar pasta workflow e dentro a pasta Compras
Dentro da pasta (Compras) deve estar os arquivos e pastas abaixo:

Esses arquivos so disponibilizados no arquivo HTML.rar


Obs.: Aps executada a rotina de workflow, ser criada a estrutura de pastas
abaixo, com exceo das pastas PROCESSADOS e REJEITADOS que devem ser
criadas manualmente:

Caso o servidor protheus seja LINUX, o caminho e os nomes dos arquivos HTML devem
estar minsculos, caso contrrio ele no consegue localizar esses arquivos, assim no
gerando o objeto oHTML, gerando erro (variable is not an object).

23

ACELERADOR WORKFLOW DE COMPRAS

7. Configurao de E-mail
Abaixo segue os prints das telas para configurao da conta de e-mail no Protheus.
Configurar de acordo com o servidor de e-mail.

7.1. Parmetros

24

ACELERADOR WORKFLOW DE COMPRAS

25

ACELERADOR WORKFLOW DE COMPRAS

7.2. Contas de E-mail

26

ACELERADOR WORKFLOW DE COMPRAS

27

ACELERADOR WORKFLOW DE COMPRAS

28

ACELERADOR WORKFLOW DE COMPRAS

29

ACELERADOR WORKFLOW DE COMPRAS

8. Configurao do WorkFlow no AppServer.ini


Adicionar ao .INI do servidor Protheus.
[HTTP]
ENABLE=1
PORT=9191
path=D:\Protheus\Workflow\Sistema\Protheus_data\web
[10.0.1.39:9191] (IP Local e Porta referente a sesso HTTP)
ENABLE=1
path=D:\Protheus\Workflow\Sistema\Protheus_data\web
ENVIRONMENT=WORKFLOW
INSTANCENAME=WF
RESPONSEJOB=JOB_WF
;Trecho referente a autenticacao do aprovador do pedido de compra via web
[10.0.1.39:9191/AUT]
ENABLE=1
PATH=C:\Protheus115\PROTHEUS_DATA\WEB
ENVIRONMENT=TOP
INSTANCENAME=wf
RESPONSEJOB=JOB_AUT_WF
[JOB_WF]
TYPE=WEB
ENVIRONMENT=WORKFLOW
INSTANCES=1,10
SIGAWEB=WF
ONSTART=STARTWEBEX
ONCONNECT=CONNECTWEBEX
ONEXIT=FINISHWEBEX
WEBHOST=http://10.0.1.39:9191 (IP Local e Porta referente a sesso HTTP)
PREPAREIN=99,01
;Trecho referente a autenticacao do aprovador do pedido de compra via web
[JOB_AUT_WF]
TYPE=WEBEX
ENVIRONMENT=TOP
INSTANCES=1,10
INSTANCENAME=wf
ONSTART=STARTWEBEX
ONCONNECT=CONNECTWEBEX
ONEXIT=FINISHWEBEX
30

ACELERADOR WORKFLOW DE COMPRAS


WEBHOST=http://10.0.1.39:9191
PREPAREIN=99,01

9. Utilizando os pontos de entrada


9.1. Cotao
PEWFCOT Ponto de entrada para tratamento e manipulao dos arquivos HTML
(Incluso de e alterao de campos) durante o processo de cotao
Em que ponto
Envio de e-mail para fornecedor (Cabealho do HTML)
Envio de e-mail para fornecedor (Itens do HTML)

Parmetro
HTML_COTEN_CAMPOS_CAB
HTML_COTEN_CAMPOS_ITEM

Envio de e-mail avisando que no houve resposta para a


HTML_COTSR_CAMPOS_CAB
cotao
Envio de e-mail avisando que uma cotao foi gerada
HTML_COTAV_CAMPOS
Envio de e-mail avisando que a cotao foi respondida
HTML_COTRESP_CAMPOS
Envio de e-mail avisando que uma cotao foi gerada
HTML_COTAV_CAB_CAMPOS
(Alterao nas informaes do cabealho de e-mail)

Como utilizar: Identificar pelas condies acima o momento onde o HTML deve ser
alterado e adicionar no array o novo campo e o valor desejado, conforme exemplo
abaixo:
Envio de Workflow para fornecedor (Cabealho do HTML)
If Alltrim(cPonto) == "HTML_COTEN_CAMPOS_CAB"
aRet:= {{"TESTE","0001"}} -------------------- [ARRAY]
Endif
Este ponto de entrada adicionar o valor 0001 ao campo TESTE do HTML.

31

ACELERADOR WORKFLOW DE COMPRAS


9.2. Pedido de compra
PEWFPC Ponto de entrada para tratamento e manipulao dos arquivos HTML
(Incluso de e alterao de campos) durante o processo de PEDIDO DE COMPRA.
Em que ponto
Envio de e-mail com o pedido de compra para
fornecedor vencedor.
Envio de e-mail avisando sobre aprovao do pedido.
Envio de e-mail avisando sobre o resultado da
aprovao do pedido para comprador.
Envio do e-mail para aprovao do pedido de compra
(Cabealho do HTML).
Envio do e-mail para aprovao do pedido de compra
(Itens do HTML).
Envio do e-mail para aprovao do pedido de compra
(Itens da Cotao).
Envio do e-mail para aprovao do pedido de compra
(Itens do Aprovador).
Envio de e-mail avisando sobre o resultado da
aprovao do pedido para solicitante.
Envio de e-mail avisando sobre a excluso do pedido
para o comprador.
Envio de e-mail avisando sobre a excluso do pedido
para o solicitante.
Permite complementar informaes no retorno da
aprovao do pedido de compra.

Parmetro
HTML_PED_VENCEDOR
HTML_AVISO_APROV_PC
HTML_RESULT_APROV_PC_COMP
HTML_APROV_PC_CAB
HTML_APROV_PC_ITEM
HTML_APROV_PC_ITEMCT
HTML_APROV_PC_ITEMAP
HTML_RESULT_APROV_PC_SOLIC
HTML_PED_EXCLUI_COMP
HTML_PED_EXCLUI_SOLIC
RETORNO

Como utilizar: Identificar pelas condies acima o momento onde o HTML deve ser
alterado e adicionar no array o novo campo e o valor desejado, conforme exemplo
abaixo:
Envio de Workflow avisando sobre aprovao do pedido.
If Alltrim(cPonto) == "HTML_AVISO_APROV_PC"
aRet:= {{"TESTE","0001"}} -------------------- [ARRAY]
Endif
Este ponto de entrada adicionar o valor 0001 ao campo TESTE do HTML.

32

ACELERADOR WORKFLOW DE COMPRAS

9.3. Nota fiscal de entrada


PEWFNF Ponto de entrada para tratamento e manipulao dos arquivos HTML
(Incluso de e alterao de campos) durante o processo de PEDIDO DE COMPRA, ao
realizar a entrada da nota fiscal.
Em que ponto
Parmetro
Envio de Notificao sobre Atendimento da solicitao de
HTML_PC_INFATEND_SC
compra

Como utilizar: Identificar pelas condies acima o momento onde o HTML deve ser
alterado e adicionar no array o novo campo e o valor desejado, conforme exemplo
abaixo:
Envio de Notificao sobre Atendimento da solicitacao de compra.
If Alltrim(cPonto) == "HTML_PC_INFATEND_SC"
aRet:= {{"TESTE","0001"}} -------------------- [ARRAY]
Endif
Este ponto de entrada adicionar o valor 0001 ao campo TESTE do HTML.

33

ACELERADOR WORKFLOW DE COMPRAS

10. Funo adicional


10.1.

EnvPed()

Apesar deste e-mail j ser disparado automtico caso o pedido de compra seja
aprovado por todos os aprovadores, o boto Enviar e-mail um processo manual,
no requisitando, necessariamente, a incluso da funo EnvPed no menu do
Protheus.
Essa funo mostra as cotaes analisadas e seu pedido de compra automtico.
Tela apresentada:

Enchoice Bar

O boto Enviar e-mail (figura acima), envia um e-mail ao fornecedor, referente s


cotaes selecionadas, informando da gerao do pedido de compra.

34

ACELERADOR WORKFLOW DE COMPRAS

11. Problemas Adversos


Ateno aos problemas adversos que podem ser encontrados no momento
do fluxo de trabalho ou na prpria instalao:
Ponto de Entrada MT100AGR

Este Ponto de Entrada executado quando inserimos um documento de


entrada. Em algum momento pode ser que o mesmo no seja executado:
Ateno no momento do cadastro:

O ponto de entrada filtra o seu funcionamento atravs dos campos


destacados, conforme imagem acima, obrigando que o Tipo da Nota seja Normal, e
Espec.Docum. esteja informado no parmetro ZZ_WFESPNF, conforme mencionado
na seo parmetros deste documento.
Caso algum campo seja cadastrado diferentemente do padro, o envio de email ao solicitantes / compradores estar comprometido e ocasionar uma quebra no
WorkFlow Compras.

Caso ocorra o erro abaixo, necessrio aplicar o patch anexo no arquivo TQJBEJ.rar
(Patch de correo, contido no chamado TQJBEJ).
THREAD ERROR []
argument error in function Len() on
TWFPROCESS:SAVEVALFILE(WFPROCESS.PRW) 28/05/2014
19:41:26 line : 666
35

ACELERADOR WORKFLOW DE COMPRAS


Correo do erro:
on TWFMAIL:SENDMAIL(WFMAIL.PRW) 02/06/2014 17:26:59 line : 585
OBS: O erro ir ocorrer sem o parmetro MV_WFREPRO criado em base aps as atualizaes:
RPO (14-08-08-bra-chi-eua-par-uru-tttp110.rpo)
LIB (14-07-25-Lib_Label_20140526_P11-tttp110)
UPD (14-08-08-update-bra-chi-eua-par-uru-tttp110.zip)
Ele criado automaticamente ao marcar a opo Reprocessar arquivos da pasta error na
rotina Parmetros do WF via SIGACFG conforme print de tela abaixo.

Aps marcar a opo citada acima e confirmar, verifique se foi criado o parmetro
MV_WFREPRO.

36

ACELERADOR WORKFLOW DE COMPRAS


Inicialmente o parmetro criado como .T.
Ao desmarcar a opo citada acima, o parmetro automaticamente definido como .F.

37

ACELERADOR WORKFLOW DE COMPRAS

12. Pontos de Entrada Especficos


Ponto de Entrada

Descrio

PEWFCTQTD

Ponto de entrada que altera o valor


da quantidade (TB.QUANT) dos 2
html's

PEWFCTGR

Ponto de entrada executado


durante a gravao da tabela SC8.

PEWFCTPR

Ponto de entrada para manipulao


da descrio do produto nos
arquivos HTML (Incluso e alterao
de campos) durante o processo de
cotao

PEWFCT

Ponto de entrada que retorna os


endereos de e-mail para envio da
cotao.

Tabela Posicionada
COTAO
SC1, SC8 e SB1

SC8

Retorno

Caracter (Formatado com a


Picture)
Sem Retorno (Utilizado para
alterao da tabela SC8.

Parametro

passado o objeto oProcess(processo do


workflow)

SC7 e SC8

Caracter

passado um array de parmetros onde


o primeiro possu o cdigo do produto e
o segundo se no idioma ingles (.T. ou
.F.)

Caracter

EMAIL_COTACAO

38

ACELERADOR WORKFLOW DE COMPRAS

Ponto de Entrada

PEWFLOW04

Ponto de entrada que permite


preencher o array com os produtos
da cotao em questo.

Parametro
passado um array com 5 posies:
Primeira: Em que momento ocorre ("PRODUTOS
DA COTACAO" ou "ANEXA ARQUIVOS")
PRODUTOS DA COTACAO: Ocorre item a item da
Array de String
cotao e retorna um array de arquivos a serem
contendo os arquivos
anexados.
a serem anexados ANEXA ARQUIVOS: Ocorre uma unica vez antes de
com seu devido
anexar os arquivos.
caminho (absoluto ou
relativo)
Segunda: O numero da cotao
Terceira: Se em ingles (.T. ou .F.)
Quarta: Array de arquivos j preparados
anteriormente
Quinta: Array contendo os dados do cabealho
PEDIDO DE COMPRA

PEWFEPPR

Ponto de Entrada que permite


carregar uma descrio do
produto, diferente da padro.

SC7

PEWFITPC

Descrio

Ponto de Entrada que permite


alterar o valor total do Pedido.

Tabela Posicionada

Retorno

Caracter

Numrico

passado um array de parmetros onde o


primeiro identifica o ponto de ocorrncia (PC ou
COTACAO) e o segundo o objeto oHTML onde
DEVEM ser informados os campos de itens que
no sero preenchidos automaticamente no
HTML.

SB1 e SC7

39

ACELERADOR WORKFLOW DE COMPRAS

Ponto de Entrada

DSTEMLPC

Descrio
Ponto de Entrada que permite
informar um destinatrio de e-mail
diferente do padro do fornecedor.

Tabela Posicionada

SA2 e SC7

Retorno
Caracter, formato email (validao se
existe @)

Parametro

NOTA-FISCAL
PEWFNFPR

Ponto de Entrada que permite


carregar uma descrio do produto,
diferente da padro.

SB1, SC7 e SD1

Caracter

PEWFNFPR

Ponto de Entrada que permite


carregar uma descrio do
produto, diferente da padro.

SC7, SA2 e SE4

Caracter

Cdigo do produto (D1_CODIGO)

40

ACELERADOR WORKFLOW DE COMPRAS

12.1.

Exemplo de utilizao
PEWFCTPR

User Function PEWFCTPR()


Local cProd:=
PARAMIXB
Local cDescri
:= ""
cDescri := posicione("SB5",1,xFilial("SB5")+cProd,"B5_CEME")
Return(cDescri)
PEWFITPC
User Function PEWFITPC()
aAdd( (oHtml:ValByName( "tc.item"

)),AllTrim(VSC8->C8_ITEM) )

aAdd( (oHtml:ValByName( "tc.codigo" )),AllTrim(VSC8->C8_PRODUTO) )


aAdd( (oHtml:ValByName( "tc.descricao"

)),SB1->B1_DESC )

aAdd( (oHtml:ValByName( "tc.preco" )),Transform( VSC8->C8_PRECO,PesqPict(


"SC8", "C8_PRECO" )) )
aAdd( (oHtml:ValByName( "tc.total" )),Transform( VSC8->C8_TOTAL,PesqPict(
"SC8", "C8_TOTAL" )) )
Return VSC8->C8_TOTAL
DSTEMLPC
User Function DstEmlPC()
Local cDestEmail
Local cEmailDest
If cDestEmail == "C"
cEmailDest
EndIf
Return(cEmailDest)

:= Alltrim(SuperGetMv("ZZ_WFRETCF",, 'F'))
:= ""
// Manda email para o Comprador
:= Lower(Alltrim(UsrRetMail(SC7->C7_USER)))

41

ACELERADOR WORKFLOW DE COMPRAS


PEWFEPPR
User Function PEWFEPPR()
Local cMoeda := ""
Local cDescri := ""
Local lIngles
:= Upper(Posicione("SA2", 1, xFilial("SA2") + SC7->C7_FORNECE,
"A2_EST")) == "EX"
If lIngles
If SC7->C7_MOEDA == 1
cMoeda
:= "R$"
ElseIf SC7->C7_MOEDA == 2
cMoeda
:= "US$"
ElseIf SC7->C7_MOEDA == 4
cMoeda
:= "EUR"
ElseIf SC7->C7_MOEDA == 5
cMoeda
:= "JPY"
EndIf
EndIf
If lIngles .And. cMoeda == "US$"
cDescri
:= AllTrim(MSMM(SB1->B1_DESC_I))
ElseIf !lIngles .Or. (lIngles .And. cMoeda != "US$")
cDescri
:= SB1->B1_DESC
EndIf
Return(cDescri)

13. Pontos de Ateno


H casos em que o ponto de entrada MT160WF no funciona, sendo necessrio o
uso do MT120GOK.

Caso o envio de e-mail seja intermitente, ou seja, enviando e-mails para alguns
casos e outros no, verificar o log. Se a mensagem de erro for a abaixo, remover porta
das configuraes do servidor nas Contas de E-mails no sigacfg.
[ERROR][SERVER] [SOCKCLIENT] Error [12] There was no response from the server.
Remover contedo dos campos marcados abaixo:

42

ACELERADOR WORKFLOW DE COMPRAS

Obs.: Esta configurao pode ser especfica de acordo com o servidor de e-mail
utilizado pela empresa.

43