Boletim Tcnico

Reg Roteiro Visita

Produto

Microsiga Protheus - Auto Peas - Oficina e Veculos - Verso 11

Chamado

TEZJAV

Data da publicao

17/05/12

Pas(es)

Brasil

Banco(s) de Dados

Todos

Esta melhoria depende de execuo do update de base

Implementao

UPDOFII2, conforme Procedimentos para

Criada a rotina Reg. Roteiro Visita (VEICM660) para que os gestores cadastrem e gerenciem roteiros de viagens. Assim,
os supervisores de cada departamento podem conhecer e aprovar os roteiros de cada vendedor.

PROCEDIMENTOS PARA IMPLEMENTAO

Para viabilizar essa melhoria, necessrio aplicar o pacote de atualizaes (Patch) deste chamado.
Aplicar atualizao do(s) programa(s) VEICM660 e UPDOFII2.

Antes de executar o update UPDOFII2 imprescindvel:

a)

Realizar o backup da base de dados do produto que ser executado o update \PROTHEUS11_DATA\ DATA e dos dicionrios
de dados SXs \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*.

SIGAOFI - SIGAVEI e SIGAPEC Reg Roteiro Visita.

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_UPDOFII2 no campo Programa Inicial.

Para a correta atualizao do dicionrio de dados, certifique-se que a data do UPDOFII2 seja igual ou superior a
11/05/2012.

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.

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.

SIGAOFI, SIGAVEI e SIGAPEC Reg Roteiro Visita.

Boletim Tcnico

6.

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

7.

Clique em Ok para encerrar o processamento.

ATUALIZAES DO UPDATE
1.

2.

3.

Criao de Perguntas no arquivo SX1 Cadastro de Perguntes:

Pergunte

Dados do Cliente

Grupo

VCM660

Ordem

01

Tipo

Tamanho

Criao de Tabelas no Dicionrio de dados SX2:

Chave

VCN

VCO

Nome

CABECALHO DOS ROTEIROS DE VISI

ROTEIROS DE VISITAS

Modo

Exclusivo

Exclusivo

nico

VCN_FILIAL+VCN_CODIGO

Pyme

Sim

Sim

Mdulo

Oficina

Oficina

Criao de Campos no arquivo SX3 Campos:

Tabela VCN Cabealho dos Roteiros de Visi:

Campo

VCN_FILIAL

VCN_CODIGO

Tipo

Caracter

Caracter

Tamanho

Decimal

Formato

@!

@!

Contexto

Real

Real

Propriedade

Alterar

Alterar

Ttulo

Filial

Cod Sequen

Descrio

Filial

Cdigo Sequencial

Help

Informe aqui a Filial.

Informe o Cdigo Sequencial.

Nvel

Obrigatrio

No

No

SIGAOFI - SIGAVEI e SIGAPEC Reg Roteiro Visita.

Boletim Tcnico

Usado

No

No

Browse

No

No

Campo

VCN_CODVEN

VCN_DATINI

Tipo

Caracter

Data

Tamanho

Decimal

Formato

@!

Contexto

Real

Real

Propriedade

Alterar

Alterar

Ttulo

CdVendedor

Dt Inicial

Descrio

Cdigo do Vendedor

Data Inicial

Help

Informe Cdigo do Vendedor.

Informe a Data Inicial.

Nvel

Obrigatrio

Sim

Sim

Usado

Sim

Sim

Browse

Sim

Sim

Mdulos

Todos

Todos

Campo

VCN_DATFIN

VCN_STATUS

Tipo

Data

Caracter

Tamanho

Decimal

Formato

@!

Contexto

Real

Real

Propriedade

Alterar

Visualizar

Ttulo

Dt Final

Status

Descrio

Data Final

Status do Roteiro

Help

Informe a Data Final.

Informe o Status do Roteiro.

Lista Opes

1=Digitado; 2=Finalizado;
3=Aprovado.

Val. Sistema

Pertence("123")

Nvel

Obrigatrio

Sim

No

Usado

Sim

No

SIGAOFI, SIGAVEI e SIGAPEC Reg Roteiro Visita.

Boletim Tcnico

Browse

Sim

Mdulos

Todos

No

Tabela VCO Roteiros de Visitas:

Campo

VCO_FILIAL

VCO_CODIGO

VCO_DATVIS

Tipo

Caracter

Caracter

Data

Tamanho

Decimal

Formato

@!

@!

Contexto

Real

Real

Real

Propriedade

Alterar

Alterar

Alterar

Ttulo

Filial

Cod Sequen

Dt Visita

Descrio

Filial

Cdigo Sequencial

Data da Visita

Informe aqui a Filial.

Informe o Cdigo
Sequencial.

Informe a Data da
Visita.

Nvel

Obrigatrio

No

No

Sim

Usado

No

No

Sim

Browse

No

No

Sim

Help

Mdulos

Todos

Campo

VCO_CODCLI

VCO_LOJCLI

VCO_ORIGEM

Tipo

Caracter

Caracter

Caracter

Tamanho

30

Decimal

Formato

@!

@!

@!

Contexto

Real

Real

Real

Propriedade

Alterar

Alterar

Alterar

Ttulo

Cliente

Loja

Origem

Descrio

Cdigo do Cliente

Loja do Cliente

Origem do Roteiro

Help

Informe o Cdigo do
Cliente.

Informe a Loja do
Cliente.

Informe a Origem do
Roteiro.

Nvel

Obrigatrio

Sim

Sim

Sim

Usado

Sim

Sim

Sim

SIGAOFI - SIGAVEI e SIGAPEC Reg Roteiro Visita.

Boletim Tcnico

Browse

Sim

Sim

Sim

Mdulos

Todos

Todos

Todos

Campo

VCO_DESTIN

VCO_KMINIC

VCO_KMPERC

Tipo

Caracter

Numrico

Numrico

Tamanho

30

Decimal

Formato

@!

@E 99999999

@E 99999999

Contexto

Real

Real

Real

Propriedade

Alterar

Alterar

Alterar

Ttulo

Destino

Km Inicial

Km Percorr

Destino do Roteiro

Km Inicial do Roteiro

Km Percorrida do
Roteiro

Help

Informe o Destino do
Roteiro.

Informe a KM Inicial
do Roteiro.

Informe a KM
Percorrida do Roteiro.

Nvel

Obrigatrio

Sim

Sim

Sim

Usado

Sim

Sim

Sim

Browse

Sim

Sim

Sim

Mdulos

Todos

Todos

Todos

Campo

VCO_KMACUM

Tipo

Numrico

Tamanho

Decimal

Formato

@E 99999999

Contexto

Real

Propriedade

Alterar

Ttulo

Km Acumula

Descrio

Km Acumulada do Roteiro

Help

Informe a KM Acumulada do Roteiro.

Nvel

Obrigatrio

Sim

Usado

Sim

Browse

Sim

Descrio

SIGAOFI, SIGAVEI e SIGAPEC Reg Roteiro Visita.

Boletim Tcnico

Mdulos

Todos

Tabela VAI Permis Usurios Concessionria:

Campo

VAI_CEVROT

Tipo

Caracter

Tamanho

Decimal

Formato

@!

Contexto

Real

Propriedade

Alterar

Ttulo

Roteiro CEV

Descrio

Roteiro CEV
Informe 1 se o usurio puder s Digitar.

Help

2 se puder Digitar e Finalizar.

3 se puder Digitar, Finalizar e
Aprovar o Roteiro.

Lista Opes

1=Digita;2=Digita/Finaliza;3=Digita/Finaliza/Aprova

Val. Sistema

Pertence("123")

Nvel

Obrigatrio

No

Usado

Sim

Browse

Sim

Mdulos

Todos

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

Criao de ndices no arquivo SIX ndices:

ndice

VCN

VCN

Ordem

Chave

VCN_FILIAL+VCN_CODIGO

VCN_FILIAL+VCN_CODVEN+DT
OS(VCN_DATINI)

Descrio

Cdigo Sequencial

Vendedor+Data inicial

Proprietrio

ndice

VCN

SIGAOFI - SIGAVEI e SIGAPEC Reg Roteiro Visita.

Boletim Tcnico

Ordem

Chave

VCN_FILIAL+DTOS(VCN_DATINI)

Descrio

Data inicial

Proprietrio

ndice

VCO

Ordem

Chave

VCO_FILIAL+VCO_CODIGO+DTOS(VCO_DATVIS)

Descrio

Data da Visita

Proprietrio

PROCEDIMENTOS PARA CONFIGURAO

1.

No Configurador (SIGACFG) acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opo de menu do Auto Peas,
Oficina e Veculos, conforme instrues a seguir:
Menu

Atualizaes

Submenu

Mov C E V

Nome da Rotina

Reg Roteiro Visita

Programa

VEICM660

Mdulo

Auto Peas

Tipo

Funo Protheus

Tabelas

VAO, VAP e VC1

Menu

Atualizaes

Submenu

Mov C E V

Nome da Rotina

Reg Roteiro Visita

Programa

VEICM660

Mdulo

Oficina

Tipo

Funo Protheus

Tabelas

VAO, VAP e VC1

Menu

Atualizaes

Submenu

Mov C E V

Nome da Rotina

Reg Roteiro Visita

SIGAOFI, SIGAVEI e SIGAPEC Reg Roteiro Visita.

Boletim Tcnico

Programa

VEICM660

Mdulo

Veculos

Tipo

Funo Protheus

Tabelas

VAO, VAP e VC1

PROCEDIMENTOS PARA UTILIZAO

1.

No Oficina (SIGAOFI) acesse Atualizaes/ Cad Gerais/ Equipe Tcnica (OFIOA180).

2.

Selecione um tcnico e clique em Alterar.

3.

Na aba Cev, observe o preenchimento do campo Roteiro CEV (VAI_CEVROT) e selecione uma das seguintes opes:

1=Digita: Permite ao tcnico digitar o roteiro de visitas.

2=Digita/Finaliza: Permite ao tcnico digitar o roteiro de visitas, bem como finalizar o mesmo. O roteiro
ficar aguardando a aprovao.

3=Digita/Finaliza/Aprova: Permite ao tcnico digitar o roteiro de visitar, bem como finalizar e aprovar.

4.

Em Atualizaes/ Mov C e V/ Gerao de Agenda (VEICM500), clique em Agendar.

5.

Gere uma agenda informando o cdigo do tcnico alterado anteriormente.

6.

Em Atualizaes/ Mov C e V/ Reg Roteiro Visita (VEICM660), clique em Incluir.

7.

Na parte superior da rotina, preencha os campos Vendedor e Perodo.

8.

Clique em Filtrar.
O Sistema apresenta todas as agendas do vendedor informado anteriormente que esteja dentro do perodo informado.

9.

D duplo clique sobre um registro.

O Sistema apresenta a janela Roteiro de Visitas Digitao.

10. Preencha os seguintes campos:

Data? O Sistema preenche automaticamente com a data da digitao do roteiro de visitas.

Cliente? O Sistema traz o cdigo e nome do cliente a ser visitado.

Origem? Informe o local de origem do roteiro.

A primeira origem deve ser informada pelo usurio. As origens seguintes so preenchidas automaticamente,
utilizando o destino da agenda anterior, podendo ser alteradas conforme necessidade.

KM inicial Informe a quilometragem inicial do veculo a partir da origem do roteiro.

SIGAOFI - SIGAVEI e SIGAPEC Reg Roteiro Visita.

Boletim Tcnico

A primeira quilometragem deve ser informada pelo usurio. As quilometragens posteriores so preenchidas
automaticamente, utilizando a quilometragem acumulada, como anterior, podendo ser alteradas conforme
necessidade.

KM percorrida? Informe a quilometragem a ser percorrida at o destino.

KM acumulada? O Sistema preenche automaticamente os dados com a soma dos valores informados nos
campos KM inicial e KM percorrida. Pode-se alterar este campo lembrando que o Sistema calcular a diferena
do valor informado com o valor da KM Inicial, alterando o campo KM percorrida.

No permitido informar um valor menor do que o obtido entre a soma dos campos KM inicial e KM percorrida.

Destino Informe o destino final do roteiro de viagem.

11. Confira os dados informados e confirme.

Na parte inferior da rotina, so apresentadas as informaes sobre o cliente da agenda programada com as seguintes
informaes:

Dados do Cliente
o

CNPJ/CPF

Telefone

Endereo

Bairro

CEP

Municpio

Visitas para o Cliente

o

Ultima do vendedor

Ultima geral

Em Verificar todas as visitas, pode-se visualizar todas as agendas j realizadas e registradas no Sistema. possvel alterar
os roteiros criados em Alterar na janela inicial da rotina.
12. Para excluir um roteiro, posicione o cursor no registro em questo e clique em Excluir.
13. O roteiro de visitas ser visualizado para excluso.
14. Clique e confirme.
15. Na janela inicial da rotina, selecione um roteiro com o status Digitado e clique em Finalizar.

10

SIGAOFI, SIGAVEI e SIGAPEC Reg Roteiro Visita.

Boletim Tcnico

16. Visualize uma de alerta, questionando se deseja finalizar o roteiro.

17. Clique em Sim.

Os roteiros finalizados podem ser alterados. Entretanto, aps alterar um roteiro finalizado, seu status volta para
digitado.
18. Verifique que o status do roteiro ficar como finalizado.
19. Clique em Aprovar.
apresentada uma mensagem de alerta, questionando a aprovao do roteiro.
20. Confirme.
21. No menu inicial da rotina clique em Imprimir.
22. Clique em Param.
23. O Sistema disponibiliza dois tipos de relatrios:
Dados do Cliente: Selecione uma das opes.
No: Listagem simplificada do roteiro com as seguintes informaes:
o

Vendedor/Perodo

Ordem de visitas

Cdigo e nome do cliente

Cidade origem

Quilometragem inicial

Quilometragem percorrida

Quilometragem acumulada

Cidade destino

Sim: Alm dos dados exibidos no relatrio simplificado, so exibidas as seguintes informaes:
o

Endereo do Cliente

Bairro do cliente

Telefone do cliente

Cidade do cliente

Estado do cliente
SIGAOFI - SIGAVEI e SIGAPEC Reg Roteiro Visita.

11

Boletim Tcnico

24. Confirme e gere o relatrio.

INFORMAES TCNICAS
VAI Permis Usurios Concessionria
Tabelas Utilizadas

VAO Reg Anlise Insatisf Cliente

VAP Departamentos
VC1 Agenda do Cliente
OFIOA180 - Equipe Tcnica

Funes Envolvidas

VEICM500 - Gerao de Agenda

VEICM660 - Reg Roteiro Visita

Sistemas Operacionais

12

Windows/Linux

SIGAOFI, SIGAVEI e SIGAPEC Reg Roteiro Visita.