Exibir código-fonte para Manual de Configuração

== '''Importação de Pedidos OptiClick''' ==



Atualmente é possível realizar a Importação de Pedidos feitos no site OptiClick (Essilor) para o sistema SGO. A importação é feita através da integração via arquivos XML que são trazidos para um determinado computador pelo EssilorWSClient ''(Nota 1)'' e em seguida são inseridos no SGO através do ImpOptiClickSGO.



=== '''Configurações SGO''' ===

No Cadastro de Produtos (Estoque > Produtos), no Cadastro das Linhas dos Produtos (Estoque > Linhas do Produto) e Cadastro de Serviços (Cadastro > Serviços) existe uma rotina chamada “Configurar Integração com Sistemas Externos”. Nesta rotina configuramos o código dos produtos e serviços Essilor ''(Nota 2)'' no SGO para que a integração possa ser feita.
	
Ex.: Linha do Produto

[[Arquivo:LinhaSisExt.png|frame|center]]
 

	
No campo “Sistema” sempre será informado o sistema “OptiClick” enquanto no campo “Código” deverá ser informado o Código do Produto na Essilor para que seja feita a integração com o SGO.

O mesmo procedimento segue para o Cadastro de Serviços e para o Cadastro de Produtos. Vale lembrar que existe a Integração dentro do Cadastro de Produtos para associar Serviços que são vendidos como Produtos.

=== '''Exceções que valem para Serviços do tipo “Coloração” e “Corte”''' ===


Para o Serviço “Coloração” é necessário informar o código equivalente à Coloração dentro do “Cadastro de Integração de Serviços com Sistemas Externos” ''(Nota 3)''  . Exemplo:

 00    SEM COLORACAO
 01    TINTING 
 1000  CINZA 50 

Para o Serviço “Corte” existe uma configuração dentro dos “Parâmetros Locais” do sistema “ImpOptiClickSGO” onde será informado qual o código que será utilizado na integração do Serviço de Corte no SGO. 
Isso é necessário, pois assim como a “Coloração”, a única informação que vem no arquivo XML é se a Lente terá Corte ou não (Tag <EDGE>).

O código informado nos “Parâmetros Locais” do “ImpOptiClickSGO” deverá ser informado também no “Cadastro de Integração de Serviços com Sistemas Externos” dentro do serviço de Corte no SGO para que o sistema faça a integração.

Vale lembrar também que para a importação funcionar corretamente é necessário que os Clientes (Óticas) estejam com seus cadastros devidamente preenchidos no SGO com:

*'''CNPJ''' (pois é o campo que vai definir o cliente no arquivo XML);
*'''Vendedor''';
*'''Plano de Pagamento''';
*'''Tabela de Fechamento''';
*'''Banco para enviar Cobrança e Cobrança''' (campo obrigatório na inclusão para inclusão de pedidos);
*'''Endereços''';

 

=== '''Configurações ImpOptiClickSGO''' ===


Abaixo será explicada a funcionalidade de cada parâmetro dentro da tela de Parâmetros Locais. Lembre-se que qualquer alteração feita aqui só terá efeito após a reabertura do aplicativo.
 
[[Arquivo:ParamImp.png|frame|center]]

*'''Iniciar automaticamente a importação e/ou exportação''': O processo de importação/exportação será iniciado automaticamente quando o aplicativo for aberto.
*'''Reiniciar Automaticamente o Aplicativo''': O aplicativo será reiniciado pelo menos uma vez por dia ''(Nota 4)''. Isso ajuda no desempenho e funcionará apenas se a importação for automática.
*'''Importar os pedidos da Essilor''': Indica que os pedidos digitados no Opticlick deverão ser importados para o SGO.
**''Pasta padrão para Importação'': Local onde serão buscados os arquivos XML gerados pelo EssilorWSClient.
*'''Dividir os arquivos por Empresa''': Se marcado, irá realizar a separação dos pedidos para subpastas de acordo com a Empresa do Cliente.
**''Pasta padrão para a divisão'': Pasta raiz a partir de onde serão criadas as subpastas para os arquivos das filiais
*'''Importar Receita do OptiClick (Work-Ticket)''': Quando habilitado, faz com que o aplicativo importe a Receita do Work-Ticket. Os dados importados serão inseridos no pedido previamente digitado no SGO.
**''Pasta padrão para Importação das Receitas'': O EssilorWSClient gera os arquivos do Work-Ticket em uma pasta. Essa pasta deverá ser informada aqui.

[[Arquivo:ParamExp.png|frame|center]]


*'''Exportar os pedidos de tratamento para Essilor''': Marcando essa opção, os pedidos de Tratamento de Terceiros serão enviados para o Opticlick automaticamente.
**''Pasta padrão para exportação dos pedidos de tratamento'': Local onde serão gerados os arquivos XML com os dados do pedido do SGO.
**''Código da Empresa padrão'': Código da Empresa no sistema SGO onde deverá ser buscado os pedidos a serem exportados;
**''Código da célula de tratamento do Cliente'': Código da célula do SGCel onde são realizados os Tratamentos de Terceiros;
**''Código do fornecedor Essilor do Cliente'': Código do Cliente Essilor no cadastro do SGO que é informado na abertura da célula de Tratamento
**''Siglas da Filial do Laboratório de Tratamento'': Sigla da filial da Essilor que receberá o pedido para efetuar o Tratamento ''(Nota 5)''.
*'''Exportar os Acompanhamentos para Essilor''': Se marcado, faz com que o aplicativo gere um XML com os Acompanhamentos do Pedido do SGO ''(Nota 6)''.
**''Pasta padrão para exportação dos acompanhamentos'': Nessa pasta serão colocados o arquivos de acompanhamento gerados para serem importados posteriormente pelo EssilorWSClient;
*'''Exportar Arquivos para N-CAMADAS''': Quando habilitado, fará com que o sistema exporte os pedidos digitados no SGO para o OptiClick ''(Nota 7)''.
**''Pasta padrão para onde serão exportados os arquivos'': Os arquivos gerados serão exportados nessa pasta.


[[Arquivo:ParamGeral2.png|frame|center]]
 

*'''Verificar Pedido exportado no Site do Opticlick''': Se marcado, irá consultar o status dos pedidos no site do Opticlick.
**''URL para expedição na Essilor'': Inserir endereço da URL onde será consultado o pedido ''(Nota 8)'';
*'''Tipo de Pedido para Laboratório''': Tipo que será utilizado na inclusão do pedido no SGO;
*'''Tipo de Pedido para Montagem''': Tipo que será utilizado na inclusão do pedido no SGO quando tiver serviço de montagem;
*'''Nº do Serviço para Corte''': Código do Serviço de Surfaçagem;
*'''Atendente''': Código do Atendente que deverá ser utilizado na inclusão do pedido no SGO;
*'''Intervalo de tempo para importação''': Indica o tempo que deverá ser aguardado entre cada ciclo de importação/exportação.

=== '''Configurações no Cadastro de Usuários''' ===

[[Arquivo:acessos.png|frame|center]]

A única configuração a ser feita dentro do “Cadastro de Usuário” é qual usuário irá receber mensagens quando ocorrer algum erro na importação. As mensagens serão enviadas através da Agenda (F2).
	

=== '''Configurações no arquivo ini do aplicativo''' ===

As configurações presentes no arquivo ini do ImpOptiClickSGO que não estão na tela de Parâmetros Locais são:
*'''Caminho do Banco de Dados''': Caminho da conexão com o banco de dados do SGO.

 [CONFIG]
 DADOS = caminhodobancodedados


*'''Número de Instâncias''': Para que mais de um aplicativo seja aberto no mesmo computador, deve ser modificada/adicionada a chave abaixo. <font color=#CE0318>Atenção: nunca deixe mais de uma instância em execução simultaneamente realizando as mesmas funções (Ex.: Dois aplicativos executando a Importação de Pedido).</font>

 [INICIALIZACAO]
 INSTANCIAS = numerodeinstanciaspermitidas

=== '''Rotinas ImpOptiClickSGO''' ===



==== '''Rotinas > Importar...''' ====


Nessa rotina é feita a importação manual de somente um arquivo XML. Se ocorrer algum erro na importação o sistema irá retornar qual o problema para o usuário. Caso importe normalmente o sistema irá retornar mensagem de “Importação Concluída com Sucesso!”.
O arquivo XML lido com sucesso terá sua extensão alterada para “lei” e um registro de que esse arquivo foi importado será gravado na tabela “PEDIDARQ” do SGO.
Caso seja feita a importação de um arquivo já importado anteriormente, o sistema irá renomear a extensão do arquivo para “lei” para que não ocorra a importação novamente.


==== '''Rotinas > Importar/Exportação Automática''' ====


Nessa rotina o sistema irá fazer a importação/exportação dos pedidos automaticamente. O que será importado/exportado dependerá de como o aplicativo está configurado nos Parâmetros Locais.
Se ocorrer algum erro na Importação, o sistema irá enviar uma Mensagem para os usuários (configurados no tópico “Configurações no Cadastro de Usuários”). Informações como: Nome do arquivo e mensagem de erro serão colocados na Mensagem.



==== '''Rotinas > Acompanhamentos para Exportação''' ====


Toda vez que é feita a expedição de um Pedido que teve origem do Opticlick no SGO, o sistema irá preencher uma tabela no banco de dados para que seja exportada a informação de que a Expedição desse Pedido foi realizada no SGO.
Nessa rotina podem ser consultados quais acompanhamentos do tipo “Expedição” ainda não foram expedidos para o site do OptiClick ou retornaram com erros.
Esses acompanhamentos são exportados para o site ''(Nota 9)'' quando utilizada a rotina “Importação/Exportação Automática”, e toda vez que forem exportados com sucesso sumirão da lista.


==== '''Utilitários > Incluir dados de Integração''' ====


Através dessa rotina o usuário poderá efetuar a importação dos códigos de integração diretamente para o SGO. O arquivo para importação deve ser uma planilha do Excel, em formato “xls” com uma coluna com o Código para a Linha fornecido pela Essilor e outra coluna com o código da Linha do Produto correspondente no SGO.


=== '''Observações Finais''' ===



==== '''Como é feita a busca de Produtos no SGO''' ====


Ao realizar a importação dos pedidos, os produtos serão localizados no SGO da seguinte maneira:
*Dentro do XML de Importação são localizadas as TAGS da Linha do Produto, Código do Serviço de AR e se possui Corte ou não;
*Baseado nessas informações o sistema será buscado qual Lente possui o Tratamento AR e Serviço de Corte e que seja da linha correspondente localizada acima;
*As buscas são feitas obedecendo a seguinte ordem:
**Buscar Produto Fabricado com AR;
**Buscar Produto Fabricado sem AR;
**Busca Produto Chave pelo RPF Code e em seguida:
***Busca um Produto Fabricado com AR que tenha esse Produto Chave na composição;
***Busca um Produto Fabricado sem AR que tenha esse Produto Chave na composição;
**Item de Referência ''(Nota 10)'';
**Item de Estoque buscando pela Escala;


==== '''Instalação do Aplicativo''' ====

O usuário deverá efetuar os ajustes necessários nos Cadastros dos Clientes, nas integrações da Linha, Produtos, Serviços e principalmente a inclusão das Escalas dos Produtos.
É recomendável que os Scripts para o sistema ImpOptiClickSGO sejam executados no Banco de Dados do cliente para garantir que não faltarão Campos, Tabelas, Triggers e Procedures.
As pastas configuradas no aplicativo são as mesmas configuradas no EssilorWSClient.
Em alguns casos é interessante que seja criado um arquivo “bat” para apagar os arquivos já lidos (com extensão “lei”), pois conforme a quantidade de arquivos na pasta vai aumentando, a busca dos arquivos não lidos começa a ficar mais demorada.
O ImpOptiClickSGO pode ser executado em computadores com qualquer versão do Windows acima de Windows 98.
É importante que o usuário da sessão onde o aplicativo está sendo executado tenha acesso às pastas da rede necessárias para a importação dos arquivos.

=== ''' Mais Informações ''' ===

Para informações mais detalhadas veja o doc desse manual:

 \\xenon\PUB\Suporte\Regras dos Sistemas\SGO\ImpOptiClickSGO\Essilor\Manual ImpOptiClickSGO.doc


== ''' Notas ''' ==

#A instalação desse aplicativo é feita pela Essilor;
#A Essilor fornece um arquivo para os Laboratórios que contém o código de todas as Linhas de Produto em seu cadastro. Para os Serviços, existe o manual do Opticlick que possui uma tabela de quais são os códigos dos Tratamentos feitos em seu laboratório. Entre em contato com a Essilor para solicitar instruções sobre como obter esse arquivo;
#A informação dos códigos correspondentes a cada tipo de Coloração é encontrada no site do OptiClick;
#É necessário que o aplicativo Reinicia.exe esteja na mesma pasta do ImpOptiClickSGO para que o recurso funcione;
#Essa informação deve ser fornecida pela Essilor;
#Para o funcionamento correto, é necessário informar o código de Integração com Sistemas Externos dentro da Localização do Pedido e também a opção “Incluir automaticamente Referência ao Arquivo ‘. LAB’”. Nem todos os Acompanhamentos do SGO existem no OptiClick;
#Os pedidos serão exportados somente se possuírem um acompanhamento marcado como “Enviar para N-CAMADAS (OptiClick)”. Uma vez apontados no Pedido de Clientes, eles serão colocados na tabela INTOPTICLICK. Assim que forem exportados, será marcada a data de exportação nessa mesma tabela e o pedido não será mais exportado. Pedidos de Tratamento serão lançados nessa tabela também assim que tiverem o processo de Tratamento de Terceiros iniciado.;
#Geralmente o endereço utilizado é: http://www.opticlickmaster.com.br/opticlick;
#Acompanhamentos serão exportados desde que a opção “Exportar os Acompanhamentos para Essilor” esteja marcada. Os acompanhamentos somente serão consultados no site caso a “URL para expedição na Essilor” esteja configurada;
#O serviço de Tratamento AR deve estar na composição do Item de Referência se necessário.