Boletim Tcnico

Integrao do Atendimento com Venda Direta

Produto : Microsiga Protheus Veculos verso 11

Chamado : TGDHFX Data da publicao : 21/11/12

Pas(es) : Todos Banco(s) de Dados : Todos

Esta melhoria depende de execuo do update de base UPDVEID9, conforme Procedimentos para
Implementao.

Implementada melhoria na rotina Atendimento Modelo 2 (VEIXA018) com a disponibilizao da integrao com a
rotina Venda Direta (FATA701), que permite utilizar formas de pagamento de entradas, como carto de crdito/dbito,
dinheiro ou cheque, que esto disponveis na rotina Venda Direta. Desta maneira, os valores referentes a essas formas de
pagamento so transferidas diretamente do atendimento para a rotina Venda Direta (FATA701), que possibilita efetuar o
pagamento de veculos/equipamentos.

PROCEDIMENTOS PARA IMPLEMENTAO

Para viabilizar essa melhoria, necessrio aplicar o pacote de atualizaes (Patch) deste chamado.

necessrio que os updates UPDLOJ11, UPDLOJ13 e UPDFAT23 estejam aplicados no ambiente.

Antes de executar o UPDVEID9 imprescindvel:
a) Realizar o backup da base de dados do produto que ser executado o UPDVEID9 (diretrio \PROTHEUS11_DATA\DATA) e
dos dicionrios de dados SXs (diretrio \PROTHEUS11_DATA\SYSTEM).
b) Os diretrios acima mencionados correspondem instalao padro do Protheus, portanto, devem ser alterados conforme
o produto instalado na empresa.
c) Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usurio deve estar utilizando o sistema.
d) Se os dicionrios de dados possurem ndices personalizados (criados pelo usurio), antes de executar o compatibilizador,
certifique-se de que esto identificados pelo nickname. Caso o compatibilizador necessite criar ndices, ir adicion-los a
partir da ordem original instalada pelo Protheus, o que poder sobrescrever ndices personalizados, caso no estejam
identificados pelo nickname.
e) O compatibilizador deve ser executado com a Integridade Referencial desativada*.

SIGAVEI Integrao do Atendimento com Venda Direta 1

 Boletim Tcnico

O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de
Dados (DBA) ou equivalente!

A ativao indevida da Integridade Referencial pode alterar drasticamente o relacionamento entre tabelas no
banco de dados. Portanto, antes de utiliz-la, observe atentamente os procedimentos a seguir:

i. No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opo

Integridade/Verificao (APCFG60A).
ii. Se no h Integridade Referencial ativa, so relacionadas em uma nova janela todas as empresas e filiais
cadastradas para o sistema e nenhuma delas estar selecionada. Neste caso, E SOMENTE NESTE, no
necessrio qualquer outro procedimento de ativao ou desativao de integridade, basta finalizar a
verificao e aplicar normalmente o compatibilizador, conforme instrues.
iii. Se h Integridade Referencial ativa em todas as empresas e filiais, exibida uma mensagem na janela
Verificao de relacionamento entre tabelas. Confirme a mensagem para que a verificao seja concluda,
ou;
iv. Se h Integridade Referencial ativa em uma ou mais empresas, que no na sua totalidade, so relacionadas
em uma nova janela todas as empresas e filiais cadastradas para o sistema e, somente, a(s) que possui(em)
integridade estar(ro) selecionada(s). Anote qual(is) empresa(s) e/ou filial(is) possui(em) a integridade
ativada e reserve esta anotao para posterior consulta na reativao (ou ainda, contate nosso Help Desk
Framework para informaes quanto a um arquivo que contm essa informao).
v. Nestes casos descritos nos itens iii ou iv, E SOMENTE NESTES CASOS, necessrio desativar tal integridade,
selecionando a opo Integridade/Desativar (APCFG60D).
vi. Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instrues.
vii. Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE SE tiver sido
desativada, atravs da opo Integridade/Ativar (APCFG60). Para isso, tenha em mos as informaes da(s)
empresa(s) e/ou filial(is) que possua(m) ativao da integridade, selecione-a(s) novamente e confirme a
ativao.

Contate o Help Desk Framework EM CASO DE DVIDAS!

1. Em Microsiga Protheus Smart Client, digite U_UPDVEID9 no campo Programa Inicial.

Para a correta atualizao do dicionrio de dados, certifique-se que a data do UPDVEID9 seja igual ou superior a
28/08/12.
2. Clique em Ok para continuar.

3. Ao confirmar exibida uma mensagem de advertncia sobre o backup e a necessidade de sua execuo em modo
exclusivo.

4. Clique em Processar para iniciar o processamento. O primeiro passo da execuo a preparao dos arquivos,
conforme mensagem explicativa apresentada na tela.

2 SIGAVEI Integrao do Atendimento com Venda Direta

 Boletim Tcnico

5. Em seguida, exibida a janela Atualizao concluda com o histrico (log) de todas as atualizaes processadas.
Nesse log de atualizao so apresentados somente os campos atualizados pelo programa. O
update/compatibilizador cria os campos que ainda no existem no dicionrio de dados.

6. Clique em Gravar para salvar o histrico (log) apresentado.

7. Clique em Ok para encerrar o processamento.

ATUALIZAES DO COMPATIBILIZADOR

1. Criao de Campos no arquivo SX3 Campos:

Tabela VV0 Sadas de Veculos:

Campo VV0_VENVDI VV0_PESQLJ VV0_NUMTIT

Tipo Caractere Caractere Caractere

Tamanho 6 6 9

Decimal 0 0 0

Formato @! @! @!

Contexto Real Real Real

Propriedade Alterar Visualizar Visualizar

Ttulo Vend.Vda.Dir Orc.VdDireta Nro. Titulo

Vendedor Venda Oramento Venda Nro. Titulo

Descrio
Direta Direta

Informe o Vendedor Nro do Oramento Nro do Titulo

a ser utilizado na do Venda Direta. referente ao
Venda Direta. Este Atendimento.
campo ser
considerado
Help somente nos casos
de integrao do
Atendimento com a
rotina de Venda
Direta.

Cons. Padro SA3

vazio().or.FG_Seek("
Val. Sistema SA3","M-
>VV0_VENVDI",1,.f.)

Nvel 1 1 1

Obrigatrio No No No

Usado Sim Sim Sim

Browse Sim Sim Sim

Mdulos TODOS TODOS TODOS

SIGAVEI Integrao do Atendimento com Venda Direta 3

 Boletim Tcnico

Tabela VZ7 Reg de Vendas Itens Campanha:

Campo VZ7_TIPTIT

Tipo Caractere

Tamanho 2

Decimal 0

Formato @!

Contexto Real

Propriedade Alterar

Ttulo Tipo Titulo

Descrio Tipo de Titulo

Help Informe o Tipo de Titulo que ser gerado.

Modo Edio M->VZ7_COMPAG=="1"

Cons. Padro SAVX

Val. Sistema FG_Seek("VSA","M->VZ7_TIPTIT",1,.f.)

Nvel 1

Obrigatrio No

Usado Sim

Browse Sim

Mdulos TODOS

2. Alterao de Campos no arquivo SX3 Campos:

Tabela VSA Parmetros Formas Pagamento:

Campo VSA_TIPPAG

Tipo Caractere

Tamanho 2

Decimal 0

Formato @!S2

Contexto Real

Propriedade Alterar

Ttulo Tipo Pagto

Descrio Tipo de Pagamento

Help Tipo de Pagamento

EXISTCHAV("VSA") .and. !(M->VSA_TIPPAG $ MVABATIM) .and.

Val. Sistema
!FG_Seek("SX5","'24'+M->VSA_TIPPAG",1,.f.)

4 SIGAVEI Integrao do Atendimento com Venda Direta

 Boletim Tcnico

Nvel 1

Obrigatrio Sim

Usado Sim

Browse Sim

Mdulos SIGAOFI, SIGAPEC, SIGAVEI.

O tamanho dos campos que possuem grupo podem variar conforme ambiente em uso.

PROCEDIMENTOS PARA UTILIZAO

A utilizao da rotina Atendimento Modelo 2 (VEIXA018) integrada rotina Venda Direta no pode ser realizada na interface
SIGAMDI, pois a rotina de Venda Direta restringe o acesso. Portanto, ao utilizar o Atendimento Modelo 2, utilize a interface
SIGAADV ou SIGAVEI.

Pr-Requisitos:

1. No Configurador (SIGACFG) acesse Ambientes/Cadastros/Parmetros (CFGX017). Configure os parmetros a seguir:

Parmetro Contedo

MV_LOJAPED UNI

MV_LOJAVEI NNS

MV_LJPEDVE .T.

MV_LJTESPE 501

MV_VEICULO S

MV_LJTPPED 1

MV_LJCONDP 001

MV_LJALTEN .F.

MV_LJVACC .F.

1. No Faturamento (SIGAFAT) acesse Atualizaes/Venda Direta/Adm. Financeira (LOJA070).

Esta rotina deve ser utilizada para realizar cadastros de administradoras financeiras que so relacionadas com cada
forma de pagamento utilizada no atendimento. A forma de pagamento cadastrada atravs da rotina Forma Pgto
Entrada (OFIOM200).

2. Clique em Incluir.

3. Preencha os seguintes campos:

SIGAVEI Integrao do Atendimento com Venda Direta 5

 Boletim Tcnico

Cod Adm (AE_COD): Informe o mesmo cdigo informado no campo Tipo Pagto (VSA_TIPPAG).
Tipo Adminis (AE_TIPO): Informe o mesmo cdigo informado no campo Tipo Pagto (VSA_TIPPAG).
Financ. Prop (AE_FINPRO): Informe a opo N=No.

4. Confirme a incluso.

5. Refaa o procedimento de cadastro de administradora financeira para todas as modalidades de pagamento a serem
utilizadas no atendimento.

6. No Controle de Lojas (SIGALOJA) acesse Atualizaes/Gerencia Vendas/Identif.de Lojas (LOJA080).

7. Clique em Incluir.

Esse cadastro ser utilizado para relacionar a filial onde est sendo realizado o atendimento com uma loja, que ser
utilizada na rotina de Venda Direta.

8. Preencha os seguintes campos:

Cod.Empresa (LJ_RPCEMP): Informe o cdigo da empresa onde ser realizada a venda.

Cod.Filial (LJ_RPCFIL) : Informe o cdigo da filial onde ser realizada a venda.
Armazm (LJ_LOCAL): Informe os possveis armazns (separados por vrgulas) a serem utilizados para venda dos
veculos no atendimento.
Reserva (LJ_RESERVA) : Informe a opo 1=Sim.
Ambiente Lj. (LJ_AMBIENT): Informe a opo 2=Faturamento.
Tip.Pagto (LJ_TPPAGTO) : Informe a opo 3=Ambos.

9. Confirme a incluso.

10. Refaa o procedimento de cadastro de identificao de lojas para todas as filiais a serem utilizadas no atendimento.

11. Em Veculos (SIGAVEI) acesse Atualizaes/Cad Gerais/Equipe Tcnica (OFIOA180).

12. Inclua um novo cadastro. Este novo cadastro de tcnico ser referente ao usurio que ser responsvel por acessar a
rotina de venda direta e receber o pagamento. Portanto, esse cadastro deve ser relacionado a um cdigo de usurio do
Sistema atravs do campo Cod. Usurio (VAI_CODUSR) e a um cdigo de vendedor atravs do campo Cod Vendedor
(VAI_CODVEN).

13. Acesse Atualizaes/Mov Atendimento/Atend. Modelo 2 (VEIXA018).

14. Pressione a tecla [F12].

15. Preencha os parmetros conforme orientao dos helps de campo, com especial no preenchimento do novo
parmetro:

Vendedor Venda Direta: Informe o cdigo do vendedor referente ao usurio que ser responsvel por acessar a
rotina de Venda Direta e receber o pagamento, conforme cadastrado anteriormente.

16. Clique em Incluir.

6 SIGAVEI Integrao do Atendimento com Venda Direta

 Boletim Tcnico

Observe que ao ativar a integrao, a rotina no permite vender dois veculos ou mais em um mesmo atendimento.

17. Selecione o veculo desejado.

18. No momento de selecionar a forma de pagamento, importante ressaltar que:

Todo tipo de pagamento vista, ou seja, todo vencimento igual data base do atendimento, ser enviado rotina de
Venda Direta. As outras formas de pagamento no sero enviadas e permanecem no atendimento.
As formas de pagamento enviadas venda Direta ter seus ttulos gerados no momento em que o oramento de
Venda Direta for finalizado. Quanto s formas de pagamento que permanecerem no atendimento, seus ttulos so
gerados no momento em que o atendimento for finalizado. Assim, o contedo do parmetro MV_TITATEN ser
desconsiderado pela rotina quanto estiver integrada com a rotina Venda Direta.

19. Para exemplificar, neste caso selecione a opo Entradas e informe um valor parcial da venda do veculo com
vencimento vista.

20. Em seguida, selecione um financiamento, atravs da opo Financiamento/Leasing com o restante do valor.

21. Confirme. Avance e aprove o atendimento.

Observe que o Sistema apresenta uma janela com o nmero de oramento de venda direta gerado, referente a este
atendimento.

22. No browse da rotina, o atendimento permanece como Aprovado.

23. Ao utilizar o usurio que ficou responsvel por acessar a rotina de Venda Direta e receber o pagamento gerados pelo
atendimento no Faturamento (SIGAFAT) acesse Atualizaes/Venda Direta/Venda Direta (FATA701).

Observe atravs do browse da rotina que o oramento foi criado.

24. Posicione sobre o oramento e clique em Finaliza Venda.

25. Observe que o total das parcelas no ser o mesmo do total da venda, pois somente os pagamentos a vista so
enviados a venda direta.

26. Aps realizar os pagamentos, finalize a venda clicando em Gravao>Como venda (F5).

Observe que no browse da rotina foi criado um oramento filho, e a legenda do oramento pai foi alterado para
Pedidos Encerrados.

27. Retorne a rotina de atendimento e altere o registro do atendimento.

28. Confirme o faturamento do veculo.

29. Verifique que o atendimento foi faturado. Clique em Visualizar.

30. Clique na pasta Dados Adicionais Para Venda.

31. Observe o preenchimento dos novos campos:

Orc.VdDireta (VV0_PESQLJ): Exibe o nmero do oramento do venda direta gerado referente a este atendimento.

SIGAVEI Integrao do Atendimento com Venda Direta 7

 Boletim Tcnico

Vend.Vda.Dir (VV0_VENVDI): Informe o cdigo do vendedor responsvel por acessar a rotina de venda direta e
receber o pagamento. Ser sugerido o contedo do parmetro Vendedor Venda Direta da opo [F12] da rotina.
Porm, possvel alterar este campo conforme necessidade.
Nro. Titulo (VV0_NUMTIT): Exibe o nmero dos ttulos gerados para este atendimento. A numerao do ttulo
gerada a partir da utilizao do parmetro MV_LOJAPED. Portanto, deve ser utilizada uma numerao que se refere a
uma srie existente na tabela genrica de chave 01 (Series de N. Fiscais) que no conflite com uma srie de
numerao de nota fiscal utilizada pela empresa.

INFORMAES TCNICAS

VV0 Sadas de Veculos;

VVA Itens de Sadas de Veculos;
SL1 Oramento;
SL2 Itens do Oramento;
Tabelas Utilizadas SAE Administrao Financeira;
VZ7 Reg de Vendas Itens Campanha;
VSA Parmetros Formas Pagamento;
SLJ Identificao de Lojas;
VAI Tcnicos.

VEIXA018 Atendimento Modelo 2;

LOJA070 Adm. Financeira;
OFIOM200 Forma Pgto Entrada;
Funes Envolvidas
LOJA080 Identif.de Lojas;
OFIOA180 Equipe Tcnica;
FATA701 Venda Direta.

Sistemas Operacionais Windows/Linux .

8 SIGAVEI Integrao do Atendimento com Venda Direta