Manual | Integração FGF Novo Avanço
Sistema Última Atualização Autor TécnicoSumário:
1 - Visualizando o Diagrama de Sequência da Implantação do FGF 2 - Incluindo Usuário para Acesso da FGF ao Novo Avanço 3 - Cadastrando Usuário para Acesso à API
4 - Enviando Produtos para FGF 5 - Utilizando a Rotina de Produtos FGF
5.1 - Pesquisando os Produtos 5.2 - Enviando Produtos para FGF
5.3 - Gerando Arquivo da Relação dos Produtos em Csv 6 - Validando as Alterações no Portal FGF
7 - Atualizando Dados Fiscais dos Produtos Retornados da FGF
Integração do FGF no Novo Avanço
1 - Visualizando o Diagrama de Sequência da Implantação do FGF
Abaixo segue a imagem do Diagrama de Sequência da implantação do FGF.
IMPORTANTE: Para que o produto seja enviado, é necessário que ele possua no mínimo NCM e TRIBUTAÇÃO ESTADUAL.
OBSERVAÇÃO:Esse documento ilustrará em seus tópicos o processo do diagrama até a etapa 6. Atualizações Fiscais de Produtos . .
Abaixo segue a explicação das colunas do diagrama:
Colunas Descrição Parceiro: Refere-se a Avanço Informática.
API FGF: Refere-se a comunicação entre os sistemas Avanço e FGF. Sist. Revisão: Refere-se a análise do produtos enviados à FGF.
Revisor FGF: Refere-se a pessoa responsável pelo Sistema de Revisão FGF.
Cliente / Portal: Refere-se ao Portal FGF, no qual o cliente deve acessar para validar as sugestões da revisão FGF.
2 - Incluindo Usuário para Acesso da FGF ao Novo Avanço
Rotina: Usuários
Localização : Co (Configurações Novo Avanço) / Acesso / Usuário
O primeiro passo é incluir um usuário no Novo Avanço para permitir o acesso da FGF e assim, realizar a comunicação de retorno dos . Para isso, acesse o sistema Novo Avanço através do link .
produtos corrigidos novo.avancoinfo.net/
Em seguida, verifique se a opção Co (Configurações Novo Avanço), situado no menu lateral do lado esquerdo, está habilitado, caso contrário clique na mesma para acessar as configurações de usuário.
Ao acessar a rotina Usuários, clique no símbolo de mais ( + ) envolto por um círculo, situado na lateral direita da parte superior, para criar um novo usuário.
Abaixo segue a descrição dos campos importantes da tela acima:
Campos Descrição
Nome: Clique no campo e informe um nome para o novo usuário. Email: Clique no campo e informe o email do novo usuário.
OBSERVAÇÃO: O e-mail deverá ser solicitado à FGF.
Nova senha: Clique no campo e informe uma senha para o usuário acessar o sistema.
OBSERVAÇÃO: A senha deverá ser solicitado à FGF.
Confirme a nova senha:
Clique no campo e informe a mesma senha do campo Nova senha para o usuário acessar o sistema.
Ativo: Marque essa opção para definir que o novo usuário estará ativo no sistema.
OBSERVAÇÃO: Essa opção só poderá ser marcada se o usuário não estiver como inativo.
Inativo: Marque essa opção para definir que o novo usuário estará inativo no sistema.
OBSERVAÇÃO: Essa opção só poderá ser marcada se o usuário não estiver como ativo.
Administrador: Marque essa opção para definir que o novo usuário será um administrador no sistema, caso contrário deixe-a
desmarcada.
Perfil de usuário:
Clique na seta e selecione o perfil de usuário. Para mais informações de como criar um perfil, acesse o documento: " Manual | Perfil Usuário Novo Avanço ".
OBSERVAÇÃO: Essa opção não aparecerá se a opção Administrador for selecionada.
Filiais: Clique no campo e selecione a filial desejada.
IMPORTANTE: Todos os campos com o símbolo de asterisco ( * ) são obrigatórios, ou seja, caso esses campos não forem preenchidos o sistema não confirmará os dados.
Assim que informar as opções descritas no quadro acima, clique na opção SALVAR para finalizar e confirmar os dados, caso contrário clique em CANCELAR, conforme o exemplo abaixo.
OBSERVAÇÃO: Para salvar os dados inseridos e imediatamente incluir mais usuários, sem sair da tela, CLIQUE na opção SALVAR +.
Ao sair da tela de inclusão, o sistema exibirá a mensagem de Dados salvos com sucesso!. Observe que o novo usuário será exibido na tela.
Será cadastrado o usuário e senha disponibilizados pela FGF no Novo Avanço.
Esse usuário e senha, são os responsáveis por autorizar a comunicação entre os sistemas Novo Avanço e FGF via API.
3 - Cadastrando Usuário para Acesso à API
Rotina: Configurações de Integrações
O segundo passo é cadastrar o usuário no Novo Avanço para acessar à FGF. O usuário e a senha são disponibilizados pela própria FGF, no qual são os responsáveis por autorizar a comunicação entre os sistemas Novo Avanço e FGF via API.
OBSERVAÇÃO: Será necessário solicitar a FGF o usuário e senha do cliente para o acesso à API.
Para realizar o cadastro, verifique se a opção Co (Configurações Novo Avanço), situado no menu lateral do lado esquerdo, está habilitado, caso contrário clique na mesma para acessar as configurações de integrações.
Logo após, clique na opção Integrações e, depois em Configurações de Integrações, conforme os exemplos abaixo.
Ao acessar a rotina Configurações de Integrações, clique no símbolo de mais ( + ) envolto por um círculo, situado na lateral direita da parte superior, para criar uma nova configuração.
Na aba Tipo da Integração, clique na seta do campo Integração e depois clique na opção FGF.
Ao abrir a tela da configuração, clique no campo Filiais e selecione a filial que contratou os serviços FGF. Em seguida, clique no campo L
e depois no campo , e informe o , respectivamente.
ogin Senha usuário e senha disponibilizados pelo parceiro FGF
Assim que informar os dados, clique na opção SALVAR para confirmar os dados e enviar uma requisição de autenticação ao FGF, caso contrário clique em CANCELAR para abortar o processo de configuração, conforme o exemplo abaixo.
Caso o usuário e senha sejam válidos, o sistema exibirá a pergunta " Deseja enviar todos produtos movimentados e ativos dos últimos ", no qual deverá clicar na opção para e enviar todos os produtos ativos (que não foram excluídos ou suspensos)
12 meses? Ok confirmar
e movimentados no último ano, ou na opção Cancelar para abortar.
OBSERVAÇÃO:Caso o usuário e senha não sejam válidos, o sistema exibirá a mensagem " Erro ao validar credenciais de login! ", no qual deverá informar os dados corretos e clicar na opção SALVAR, para que a FGF valide novamente os dados.
OBSERVAÇÃO:Essa rotina pode ser utilizada para verificar se o usuário e senha permanecem válidos. Para isso, clique na opção SALV com os dados já inseridos nos campos e .
AR Login Senha
4 - Enviando Produtos para FGF
Os produtos são adicionados a fila de envio para FGF de forma automática quando:
Motivo Descrição
Implantação Após configurado a integração com FGF, será enviado todos produtos ativos movimentados nos últimos 12 meses. Alteração Se existir alteração nos dados do produto.
Inclusão Quando for cadastrado um novo produto.
A cada 10 minutos, a fila é processada e os produtos são enviados. Para que o produto seja enviado, é necessário que possua no mínimo:
Campo Descrição
NCM NCM do produto.
Tributação Estadual Tributação Estadual cadastrada para o Estado da filial que enviará o produto.
O envio inicial também poderá ocorrer durante o cadastro da integração, conforme visto no tópico 3 - Cadastrando Usuário para Acesso à . Também é possível realizar o reenvio através da opção de botão do Novo Avanço, conforme será apresentado no subtópico
API 5.2 -
.
Enviando Produtos para FGF
Através da rotina abaixo, é possível visualizar reenviar, e gerar planilha contendo todos produtos enviados para FGF.
Rotina: Entrar com a Conta FGF
Localização : Op (Operacional Novo Avanço) / Integrações / Produtos FGF
Para consultar os produtos, clique na opção Po (Operacional Novo Avanço), situado no menu lateral do lado esquerdo. Logo após, no Menu Operacional clique na opção Integrações e, depois em Produtos FGF.
Para pesquisar os produtos, clique no ícone de lupa, situado na parte lateral superior da rotina.
Ao abrir a janela Pesquisar, preencha os campos conforme desejado.
OBSERVAÇÃO: Para realizar a pesquisa não é obrigatório preencher todas as datas.
Campos Descrição Data do
Ultimo Envio:
Clique no ícone de calendário e informe a data da última vez que o produto foi enviado para FGF, atualizada conforme visto no tópico 4 - Enviando Produtos para FGF.
Data do Ultimo Retorno:
Clique no ícone de calendário e informe a data da última vez que o produto foi retornado da FGF, conforme será visto no tópico 6 - Validando as Alterações no Portal FGF.
Data da Ultima Atualização:
Clique no ícone de calendário e informe a data da última vez que o produto foi atualizado com dados da FGF, conforme será visto no tópico 7 - Atualizando Dados Fiscais dos Produtos Retornados da FGF.
Após preencher a (s) data (s), conforme explicado no quadro acima, clique na opção PESQUISAR.
Para enviar todos os produtos listados para FGF, clique no ícone de seta para direita (botão de enviar produtos), situado na parte lateral superior da rotina.
O sistema exibirá a mensagem " Os produtos estão sendo enviados...". Aguarde a finalização do envio dos produtos.
Para gerar o arquivo csv dos produtos, clique no ícone de seta para baixo, situado na parte lateral superior da rotina.
Em seguida, dependendo da configuração do navegador, será aberto uma janela solicitado a ação a ser realizada no arquivo: Abrir
ou Salvar. Clique na opção desejada e, depois na opção OK.
6 - Validando as Alterações no Portal FGF
Após o envio dos produtos do Novo Avanço para a FGF, a FGF irá analisar os produtos e inserir as tributações consideradas corretas. O cliente por sua vez, deverá validar as sugestões da FGF.
OBSERVAÇÃO: Esses procedimentos deverão ser realizados pelo cliente.
Acesse o link Portal FGF. Clique no campo Usuário e informe o usuário de acesso a FGF. Depois clique no campo Senha e informe a sen
. Em seguida, clique em para acessar o sistema FGF.
ha correspondente ao usuário informado ENTRAR
OBSERVAÇÃO:O usuário e senha de acesso ao Portal FGF são diferentes do usuário e senha da API FGF utilizados no procedimento do tópico 3 - Cadastrando Usuário para Acesso à API.
Em sequência, clique na opção ITENS PENDENTES.
Na próxima tela o sistema exibirá os itens que aguardam revisão do cliente.
As ações que deverão ser realizadas são: marcar os itens desejados, aceitar as alterações da FGF, ignorar as alterações da FGF, ou as alterações da FGF.
Marcar todos visíveis: ao marcar essa caixa de opção, será selecionado todos os produtos disponíveis no site. Ação: ao marcar essa caixa de opção, será selecionado o produto individualmente.
ao clicar nessa opção, o sistema enviará as sugestões dos produtos marcados para o Novo Avanço.
ATRIBUIR VALORES FGF:
IGNORAR VALORES FGF: ao clicar nessa opção, o sistema pula essa opção e não envia retorno para o Novo Avanço. ATRIBUIR TODOS: ao clicar nessa opção, o sistema enviará todas as sugestões dos produtos para o Novo Avanço. REJEITAR: ao clicar nessa opção, o sistema rejeita as sugestões dos produtos marcados e não retorna para o Novo Avanço.
OBSERVAÇÃO:Os itens aceitos/atribuídos são enviados para o Novo Avanço, no qual será possível substituir o cadastro do produto com os dados enviados.
7 - Atualizando Dados Fiscais dos Produtos Retornados da FGF
Após validar as alterações no Portal FGF, o próximo passo é realizar a confirmação dos produtos retornados no Novo Avanço.
Rotina: Atualizações Fiscais FGF
Localização Integral Varejo: Op (Operacional Novo Avanço) / Integrações / Atualizações Fiscais FGF
Para atualizar os dados fiscais, verifique se a opção Op (Operacional Novo Avanço), situado no menu lateral do lado esquerdo, está habilitado, caso contrário clique na mesma.
Logo após, clique na opção Integrações e, depois em Atualizações Fiscais FGF, conforme os exemplos abaixo.
Na próxima tela o sistema exibirá os itens que foram retornados da FGF.
OBSERVAÇÃO: Os produtos que serão exibidos, serão somente os aprovados pelo cliente, visto no tópico 6 - Validando as Alterações .
no Portal FGF
As ações que deverão ser realizadas são: marcar os itens desejados e atualizar o cadastro.
Aceitar Todos: ao marcar essa caixa de opção, será selecionado todos os produtos retornados. ACEITAR: ao marcar essa caixa de opção, será selecionado o produto individualmente.
OBSERVAÇÃO: A linha na cor verde estão com os dados fiscais do Novo Avanço. A linha na cor rosa estão com os dados fiscais retornados pela FGF considerados corretos.
Ao definir quais os produtos que serão aceitos, clique na opção de comando ATUALIZAR para alterar o cadastro dos produtos marcados.
Posteriormente, se desejar visualizar os produtos que foram atualizados, clique na opção de comando VISUALIZAR PRODUTOS .
ATUALIZADOS
A seguir, o sistema exibirá todos os produtos atualizados até o momento.
OBSERVAÇÃO:Quando o produto desta lista for enviado novamente à FGF, será excluído da visualização dos produtos atualizados e, somente retornará se o procedimento de aceite e atualização for realizado novamente.
É possível verificar os detalhes do produto que foi alterado na rotina de Cadastro de Produtos, para isso consulte o documento Manual | .
