Manual de Configuração - Histórico de revisão

Adm: /* Configurações ImpOptiClickSGO */

2012-06-01T12:20:13Z

‎Configurações ImpOptiClickSGO

Adm em 12h12min de 1 de junho de 2012

2012-06-01T12:12:10Z

Adm: /* Notas */

2012-05-14T11:21:35Z

‎Notas

Adm em 16h36min de 11 de maio de 2012

2012-05-11T16:36:48Z

Adm em 14h29min de 11 de maio de 2012

2012-05-11T14:29:30Z

Adm: /* Configurações no arquivo ini do aplicativo */

2012-05-11T14:15:58Z

‎Configurações no arquivo ini do aplicativo

Adm: /* Configurações no arquivo ini do aplicativo */

2012-05-11T14:15:11Z

‎Configurações no arquivo ini do aplicativo

Adm: /* Configurações SGO */

2012-05-11T14:10:27Z

‎Configurações SGO

Adm: Criou página com '== '''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 ...'

2012-05-11T14:00:58Z

Criou página com '== '''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 ...'

Página nova

== '''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 e em seguida são inseridos no SGO através do ImpOptiClickSGO.

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

No Cadastro de Produtos (Estoque > Produtos), Linhas do Produto (Estoque > Linhas do Produto) e Serviços (Cadastro > Serviços) uma rotina chamada “Configurar Integração com Sistemas Externos”. Nesta rotina é onde será feita a associação do código do Produto ou Serviço na Essilor com o SGO.

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” . 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 . 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 .
*'''Exportar os Acompanhamentos para Essilor''': Se marcado, faz com que o aplicativo gere um XML com os Acompanhamentos do Pedido do SGO .
**''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 .
**''Pasta padrão para onde serão exportados os arquivos'': Os arquivos gerados serão exportados nessa pasta.

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

*'''URL para expedição na Essilor''': Inserir endereço da URL onde será consultado o pedido ;
*'''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. 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).

[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 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 ;
**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.

← Edição anterior		Edição das 12h12min de 1 de junho de 2012
Linha 77:		Linha 77:


−	[[Arquivo:~~ParamGeral~~.png\|frame\|center]]	+	[[Arquivo:ParamGeral2.png\|frame\|center]]

@@ Linha 188: / Linha 188: @@
 #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)”;
+#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.

← Edição anterior		Edição das 14h29min de 11 de maio de 2012
Linha 172:		Linha 172:
	O ImpOptiClickSGO pode ser executado em computadores com qualquer versão do Windows acima de Windows 98.		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.		É 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

@@ Linha 80: / Linha 80: @@
-*'''URL para expedição na Essilor''': Inserir endereço da URL onde será consultado o pedido ''(Nota 8)'';
+*'''Verificar Pedido exportado no Site do Opticlick''': Se marcado, irá consultar o status dos pedidos no site do Opticlick.
 *'''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;
@@ Linha 86: / Linha 87: @@
 *'''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''' ===

@@ Linha 3: / Linha 3: @@
-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  e em seguida são inseridos no SGO através do ImpOptiClickSGO.
+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.
@@ Linha 9: / Linha 9: @@
 === '''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 no SGO para que a integração possa ser feita.
+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
@@ Linha 24: / Linha 24: @@
-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”  . Exemplo:
+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:
     SEM COLORACAO
@@ Linha 54: / Linha 54: @@
 *'''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 . Isso ajuda no desempenho e funcionará apenas se a importação for automática.
+*'''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.
@@ Linha 70: / Linha 70: @@
 **''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 .
+**''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 .
+*'''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 .
+*'''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.
@@ Linha 80: / Linha 80: @@
-*'''URL para expedição na Essilor''': Inserir endereço da URL onde será consultado o pedido ;
+*'''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;
@@ Linha 135: / Linha 135: @@
 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 quando utilizada a rotina “Importação/Exportação Automática”, e toda vez que forem exportados com sucesso sumirão da lista.
+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.
@@ Linha 160: / Linha 160: @@
 ***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 ;
+**Item de Referência ''(Nota 10)'';
 **Item de Estoque buscando pela Escala;
@@ Linha 178: / Linha 178: @@
   \\xenon\PUB\Suporte\Regras dos Sistemas\SGO\ImpOptiClickSGO\Essilor\Manual ImpOptiClickSGO.doc

@@ Linha 99: / Linha 99: @@
 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.
+*'''Caminho do Banco de Dados''': Caminho da conexão com o banco de dados do SGO.
   [CONFIG]

@@ Linha 105: / Linha 105: @@
-*'''Número de Instâncias''': Para que mais de um aplicativo seja aberto no mesmo computador, deve ser modificada/adicionada a chave abaixo. 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).
+*'''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''' ===