49 Manual do Usuário Integrador FC Store V.1.0.0 ACSN Desenvolvimento de Software do Brasil Ltda. Av. Dom Pedro II, 1211 Salto SP www.acsn.com.br
Conteúdo Módulo 1: Visão Geral... 3 INTRODUÇÃO... 3 PROCEDIMENTO DE INSTALAÇÃO... 3 ENVIO DE INFORMAÇÕES... 3 RECEBIMENTO DE INFORMAÇÕES... 3 Módulo 2: Integração... 4 TIPOS DE INTEGRAÇÃO... 4 LAYOUTS DE EXPORTAÇÃO... 4 LAYOUTS DE IMPORTAÇÃO... 5 TIPOS DE DADOS... 5 FLUXOGRAMA DE ENVIO DE DADOS... 6 FLUXOGRAMA DE RECEBIMENTO DE DADOS... 7 SUGESTÃO DE FLUXOGRAMA DE IMPORTAÇÃO PARA O SOFTWARE DE GESTÃO... 8 SUGESTÃO DE FLUXOGRAMA DE EXPORTAÇÃO PARA O SOFTWARE DE GESTÃO... 9 Página 2
Módulo 1: Visão Geral INTRODUÇÃO O Integrador é o aplicativo que realiza a troca de informações entre a base de dados da Frente de Caixa Store e o software de gestão. Essa troca de informações é feita através de um sistema de exportação e importação de dados. Quando o Integrador envia informações ele gera a exportação de dados para ser importada no software de gestão e quando ele recebe informações ele importa os dados contidos na exportação gerada pelo software de gestão. Portanto, para a troca de informações para ser completa passa por 2 etapas: 1. Envio de Informações Gera a exportação da Frente de Caixa Store 2. Recebimento de Informações Realiza a importação na Frente de Caixa Store PROCEDIMENTO DE INSTALAÇÃO Para instalar, siga os passos: 1. Execute o Setup.exe do CD de instalação 2. Clique em Next 3. Confirme o caminho de instalação (é recomendado que o Integrador seja instalado no servidor do Frente de Caixa Store) 4. Clique em Next 5. Clique em Finish para finalizar a instalação ENVIO DE INFORMAÇÕES O envio de informações é controlado através do gerenciamento de um arquivo texto para impedir que uma exportação seja gerada sem que a anterior tenha sido importada. Esse arquivo sempre será salvo automaticamente após a exportação na pasta do Integrador com o nome de FCS_EXP.TXT e terá como seu conteúdo a data e hora da exportação. Consulte o fluxograma do processo de envio de dados. RECEBIMENTO DE INFORMAÇÕES O recebimento de informações é controlado através do gerenciamento de um arquivo texto para somente importar os dados se existir uma exportação realizada. Esse gerenciamento consiste em verificar a existência do arquivo com o nome de FCS_IMP.TXT na pasta do Integrador que deve ter como seu conteúdo a data e hora da exportação. Caso o arquivo não esteja na pasta do Integrador, o recebimento de informações não será realizado. Consulte o fluxograma do processo de recebimento de dados. Página 3
Módulo 2: Integração TIPOS DE INTEGRAÇÃO O Integrador pode operar em dois tipos de integração: 1. Automática Neste tipo de integração o Integrador irá executar automaticamente os comandos de importação e exportação de dados do software de gestão. Dessa forma, ao realizar o envio de informações o Integrador irá exportar os dados e em seguida executará automaticamente o comando de importação do software de gestão. E ao realizar o recebimento de informações irá executar automaticamente a exportação do software de gestão antes de importar os dados. Na integração automática, o integrador irá executar o comando de importação ou exportação do software de gestão e aguardar o seu retorno indicativo de erro ou sucesso de execução. O controle desse retorno será realizado pelo arquivo ICS_RET.TXT. Nesse arquivo deverá constar na primeira posição o caracter 0 (zero) caso tenha ocorrido erro e 1 (um) caso tenha sido realizado com sucesso. Para as ocasiões de erro uma mensagem pode ser exibida concatenando a partir da posição 2 do arquivo a mensagem antecedida de, (EX: 0,Arquivo de controle de exportação não localizado.) 2. Individual Nesta forma de integração o software de gestão deverá possuir um Integrador que realize o mesmo procedimento que o Integrador da Frente de Caixa Store e processe as exportações e importações de dados conforme os fluxogramas de envio e recebimento de informações. ATENÇÃO: Para integração com o ConnectStore será adotada obrigatoriamente o tipo de integração Automática. LAYOUTS DE EXPORTAÇÃO O layout de exportação é o formato como o Integrador irá gerar os arquivos textos necessários para troca de informações entre a Frente de Caixa Store e o software de gestão. Para obter os layouts de exportação, acesse a opção de configurações do Integrador e selecione a guia Arquivos enviados (para que essa guia esteja visível, o software de gestão selecionado deve ser do tipo Outro ) Na guia de Arquivos enviados estará disponível uma lista com os arquivos que serão gerados. Para consultar o layout de cada arquivo, basta selecionar o arquivo desejado na lista e clicar em Consultar layout do arquivo. Nesta guia também é possível configurar quais os arquivos serão exportados e o nome e o caminho onde ele será gravado. Página 4
LAYOUTS DE IMPORTAÇÃO O layout de importação é o formato como o Integrador irá ler os arquivos textos gerados pelo software de gestão para troca de informações com a Frente de Caixa Store. Para obter os layouts de importação, acesse a opção de configurações do Integrador e selecione a guia Arquivos recebidos (para que essa guia esteja visível, o software de gestão selecionado deve ser do tipo Outro ) Na guia de Arquivos recebidos estará disponível uma lista com os arquivos que serão lidos. Para consultar o layout de cada arquivo, basta selecionar o arquivo desejado na lista e clicar em Consultar layout do arquivo. Nesta guia também é possível configurar quais os arquivos serão importados e o nome e o caminho onde ele será localizado. TIPOS DE DADOS Os tipos de dados gerenciados pelo integrador são: Tipo de dado Sigla Exemplo Observações Caractere C PRODUTO 1 Numérico Data Time N D T 0000000001.00 (exemplo para um layout de Tamanho 13 com 2 decimais) 20100131 (exemplo para 31/01/2010) 20100131235959 (exemplo para 31/01/2010 23:59:59) Colocar zeros à esquerda. Usar ponto para indicar casa decimal (o ponto decimal é considerado no tamanho do campo conforme demonstrado no exemplo) Usar o formato AAAAMMDD Usar o formato AAAAMMDDHHMMSS Página 5
FLUXOGRAMA DE ENVIO DE DADOS Início Exibe aviso de exportação pendente de recebimento Existe o arquivo FCS_EXP.TXT na pasta do Integrador? Gerar nova exportação Integração é com o ConnectStore? *Executa Importação no Software de Gestão Existe comando de importação configurado? Fim * Consulte a sugestão de fluxograma para o processo de importação do software de gestão. Página 6
FLUXOGRAMA DE RECEBIMENTO DE DADOS Início Integração é com o ConnectStore? Existe comando de exportação configurado? *Executa exportação do Software de Gestão Exibe aviso de arquivo de controle de importação não localizado Existe arquivo FCS_IMP.TXT na pasta do Integrador? Realiza importação dos dados Importação realizada com sucesso? Apaga o arquivo FCS_IMP.TXT Exibe mensagem de erro Fim * Consulte a sugestão de fluxograma para o processo de exportação do software de gestão. Página 7
SUGESTÃO DE FLUXOGRAMA DE IMPORTAÇÃO PARA O SOFTWARE DE GESTÃO Início conteúdo 0,Arquivo de controle de exportação não localizado. Existe o arquivo FCS_EXP.TXT na pasta do Integrador? Realiza Importação Importação realizada com sucesso? conteúdo 1 Apaga o arquivo FCS_EXP.TXT da pasta do integrador conteúdo 0, + mensagem de erro Fim Página 8
SUGESTÃO DE FLUXOGRAMA DE EXPORTAÇÃO PARA O SOFTWARE DE GESTÃO Início conteúdo 0,Importação ainda não realizada na Frente de Caixa. Existe o arquivo FCS_IMP.TXT na pasta do Integrador? Realiza Exportação Exportação realizada com sucesso? conteúdo 1 Gera o arquivo FCS_IMP.TXT na pasta do integrador conteúdo 0, + mensagem de erro Fim Página 9