Páginas filhas
  • DI_MANUAL_TOTVS_Educacional_Saida_Inteligente

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

  Integração TOTVS Educacional x Filho sem Fila

        A integração TOTVS Educacional com o aplicativo  Filho sem Fila tem por objetivo avisar a portaria que o responsável do aluno esta próximo ao colégio, trazendo mas segurança e organizando o transito nas mediações do colégio.

       

Sistemas Envolvidos

      TOTVS Educacional - O módulo Educacional gerencia escolas e faculdades (ensino básico e superior), por meio de ferramentas que permitem maior agilidade nos processos que envolvem os alunos, responsáveis, professores e os funcionários.

      Aplicativo Filho sem Fila - Com este aplicativo, pais de alunos podem, com seus smartphones, avisar à portaria que estão próximos ao Colégio. Os sistemas suportados iOS, Android e Windows Phone.

Integração

Cadastro Unidade de Ponto

Foi implementando no TOTVS Educacional o cadastro de unidade de ponto de chamada, esse cadastro indica o local(portaria) onde o responsável irá fazer a retirada do aluno.

Esse cadastro está disponível nos menus:

Menu: Currículo e Oferta - Turmas. Campo:  Unidade de Ponto.

Menu: Atividades acadêmicas - Assistente - Cadastro de turmas e turmas/disciplinas. Campo: Unidade de Ponto.

Menu: Integração - Filho sem Fila - Cadastro Unidade de Ponto.

 

 Processo Sincronismo de dados para aplicação Filho sem Fila       

O processo de sincronismos dos dados tem como objetivo principal enviar os dados do aluno/responsável do TOTVS Educacional para o Aplicativo Filho sem Fila, o processo tem a possibilidade de ser agendado. Neste processo serão enviados todos alunos que possuem unidade de ponto cadastrada.

O processo esta disponível no Menu: Integração - Filho sem Fila.

Os dados enviados são:

    • Envio de Ra do Aluno, módulo TOTVS Educacional, para o Filho sem Fila. 
    • Envio de Nome do Aluno,módulo TOTVS Educacional, para o Filho sem Fila. 
    • Envio de Período do Aluno, módulo TOTVS Educacional, para o Filho sem Fila. 
    • Envio de Série do Aluno, módulo TOTVS Educacional, para o Filho sem Fila. 
    • Envio de Turma do Aluno, módulo TOTVS Educacional, para o Filho sem Fila. 
    • Envio de Data Nascimento do Aluno, módulo TOTVS Educacional, para o Filho sem Fila. 
    • Envio de idRepPrincipal do Responsável , módulo TOTVS Educacional, para o Filho sem Fila. 
    • Envio de Status do Aluno,módulo TOTVS Educacional, para o Filho sem Fila. 
    • Envio de pontoChamado Unidade/Ponto de chamada da turma, módulo TOTVS Educacional, para o Filho sem Fila. 
    • Envio de Id Responsável do aluno, módulo TOTVS Educacional, para o Filho sem Fila. 
    • Envio de Nome do Responsável , módulo TOTVS Educacional, para o Filho sem Fila. 
    • Envio de Tipo (Pai/Mãe/Responsável Acadêmico/ Responsável Financeiro,módulo TOTVS Educacional, para o Filho sem Fila. 
    • Envio de TipoOperacao A ser realizar no bando de dados do aplicativo,para o Filho sem Fila.

Processo Exportação de dados para aplicação Filho sem Fila

        

          O processo esta disponível no Menu: Integração - Filho sem Fila.

          O processo de exportação dos dados do aluno para aplicação filho sem fila enviara os mesmo dados do processo anterior, com o diferencial de poder filtrar os alunos que o usuário deseja realmente enviar.

 

Escopo

As entidades e os pontos de integração que farão parte do escopo dessa integração são: 

Entidade

Pontos de Integração

Turma/Disciplina

  • Cadastro de turma/disciplina
  • Cadastrar turmas e turmas/disciplinas através do assistente em Atividades Acadêmicas
Matricula
  • Exclusão da matricula

Pré-requisitos instalação/implantação/utilização

Atenção: Não é escopo desse documento descrever as instalação do ERP RM e nem sua configuração.

Para que a integração possa funcionar, deve-se preencher todos os parâmetros das integração.

 

 

Versões RM / Filho sem Fila

Utilizar a versão RM 12.1.14 ou superior / Utilizar a versão Filho sem Fila XXXX ou superior

RM    

          Nos Parâmetros (TOTVS Educacional) acesse Integração/  Filho sem Fila / Filho s. Fila - Geral

  • Configure o parâmetro WebService de manutenção dos dados de aluno e responsáveis com o endereço do serviço de WebService do ambiente em que o TOTVS Educacional será integrado.

Exemplo: https://www.filhosemfila.com.br/usuario/API/importacaoExterna.php.

  • Configure o parâmetro Usuário/Projeto com o nome do cliente WebService do Filho sem Fila.
  • Configure o parâmetro Senha com a senha do cliente WebService do Filho sem Fila.
  • Configure o parâmetro Endereço FTP para envio das fotos alunos com o nome do FTP Filho sem Fila.

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos TOTVS Educacional estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Observação: Este modelo de suporte está sendo revisado pela TOTVS

Fluxo das Informações

Exporta aluno/responsável para a aplicação Filho sem Fila

Método

ID

Descrição

Origem

Destino

EnviaFilhoSemFila

01

RA

RM

Filho sem Fila

02

NOME

RM

Filho sem Fila

03

PERIODO

RM

Filho sem Fila

04

SERIE

RM

Filho sem Fila

05

TURMA

RM

Filho sem Fila

06

DATA NASCIMENTO

RM

Filho sem Fila

07

IDRESPPRINCIPAL

RM

Filho sem Fila

08

STATUS

RM

Filho sem Fila

09

PONTOCHAMADO

RM

Filho sem Fila

10

ID *

*Id Responsável

RM

Filho sem Fila

11

NOME *

*Nome Responsável

RM

Filho sem Fila

12

TIPO*

*Tipo Responsável

RM

Filho sem Fila

13

TIPOOPERACAO*

*Tipo Operação

RM

Filho sem Fila

Processos

15

Exporta aluno/responsável para a aplicação Filho sem Fila

RM

Filho sem Fila

16

Sincroniza aluno/responsável para a aplicação Filho sem Fila

RM

Filho sem Fila

 

 

Limitações / Restrições Gerais

  • O TOTVS Educacional envia um pacote de 200 alunos para o aplicativo Filho sem Fila caso o limite seja o ultrapassado o JSON será quebrado enviando novamente.

 

Como fazer

(opcional)

Descreva os passos que viabilizem a integração.

Exemplo:

Os passos para viabilizar a integração são:

  • No Logix ou no Protheus efetue o cadastro das seguintes informações: Clientes, fornecedores, transportadores, cidades, cotação de moeda e unidades de medida.
  • No Logix cadastrar um novo depositante e efetuar toda a parametrização necessária para a operação de WMS.
  • No Logix cadastrar um novo produto que seja controlado pelo WMS, para o depositante cadastrado anteriormente.
  • No Logix efetuar um processo de recebimento para o produto cadastrado anteriormente, utilizando uma nota fiscal provisória (tipo “A”).
  • No Protheus consultar a nota fiscal de recebimento que foi registrada no Logix, validando as informações recebidas.
  • No Logix efetuar um processamento de regularização fiscal, efetuando a cobertura dos produtos recebidos anteriormente.
  • No Protheus verificar se foi efetuado corretamente o relacionamento entre os dois documentos.
  • No Logix efetuar um processo de expedição para o novo produto cadastrado, até o momento do envio da mensagem de integração de pedido de venda.
  • No Protheus efetuar o faturamento do pedido de venda recebido.
  • No Protheus verificar se a nota fiscal gerada contém todas as informações necessárias para o segmento de operador logístico (armazém geral).
  • No Protheus efetuar a escrituração fiscal das notas fiscais, verificando se as regras da legislação deste segmento foram respeitadas.
  • No Logix é possível consultar o número do pedido de venda gerado para as notas fiscais de retorno simbólico e conta/ordem no programa WMS6333 (Consulta de Documentos). Para os processos de faturamento de serviço o número do pedido está disponível no programa WMS6411 (Movimentos a Faturar).

 

Situações comuns (opcional)

Descreva situações problemáticas comuns que podem ocorrer durante o funcionamento da integração e como solucioná-los. Neste ponto também é importante dar instruções de como reconhecer e investigar problemas que podem vir a ocorrer durante a integração. Se houver, apresente tabelas de códigos e descrições de erros que a integração poderá apresentar.

Este tópico possivelmente será alimentado com as experiências durante o desenvolvimento da integração e poderá ser realimentado durante o uso da integração no cliente.

Exemplo 1:

Tratamento de erros de integração (Produto A)

 

Erro

Mensagem

Solução

Código do erro

Mensagem exibida

Ação a ser tomada para resolução do erro.

 

Tratamento de erros de integração (Produto B)

Erro

Mensagem

Solução

Código do erro

Mensagem exibida

Ação a ser tomada para resolução do erro.

 

 

Exemplo 2:

Quando uma mensagem é enviada do Logix para o Protheus, podem ocorrer situações em que o WebService não estará totalmente funcional. Nestes casos uma mensagem de erro genérica irá aparecer na tela:

Exemplo:

Erro ao enviar a mensagem de Cidade via Integração

Se o arquivo de log for analisado, poderemos ver a falha na comunicação com o sistema destino:

-------------------------------------------------------------------------------

WSCERR044 / Não foi possível POST : URL http://172.16.31.57:8011/ws/FWWSEAI.apw

ADVPL WSDL Client 1.080707 / tst on 20120315 08:49:51

-------------------------------------------------------------------------------

 

Para resolver este problema, verifique as configurações do sistema de destino, analisando o funcionamento do servidor utilizado para esta comunicação e a habilitação do endereço do WebService. 

Checklist de suporte da aplicação

Crie um check-list de verificação de alguns pontos importantes para o funcionamento e atendimento da integração.

Instalação/Configuração

Relacione itens de verificação para garantir que a integração está corretamente instalada e configurada. Isto não pode ser uma cópia do procedimento de instalação/configuração, mas verificações pontuais que podem remeter aos itens da instalação.

 

Checklist de Verificações:

Relacione itens de verificações para que o atendente possa:

  • Identificar o funcionamento da integração;
  • Identificar a ocorrências de problemas;
  • Coletar evidências do mau funcionamento relatado pelo cliente;
  • Realizar possíveis ajustes na integração quanto à configuração ou negócio.

Checklist de suporte da aplicação

 

Itens para   conferência no TOTVS Educacional

Instalação da Biblioteca RM versão 12.1.14 ou superior.

Integração TOTVS Educacional x Filho sem Fila ativa.

Configura o Usuário/Projeto - Senha.

Configuração do endereço do Webservice do Filho sem Fila.

Configuração do endereço do FTP do para envio das fotos do aluno/responsável para o Filho sem Fila

.

Anexos